sing-box

mirror of https://github.com/233boy/sing-box.git synced 2026-08-16 16:26:26 +08:00

Table of Contents

介绍
特点
设计理念
支持协议列表
机场推荐
搭建教程
安装
安装完成
管理面板
无法使用
快速入门
add
no-auto-tls
[name]
change
info
import
url
qr
del
ddel
gen
bbr
bin
fix-config.json
update
log
status
start, stop, restart
reinstall
uninstall
设置DNS
中转
帮助
目录
友情提醒
伪装网站
自动 TLS 说明
备份脚本
机场备用
关注我们
反馈问题

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

最好用的 sing-box 一键安装脚本 & 管理脚本，自动创建 REALITY 协议；支持 TUIC，Trojan，Hysteria2 等所有常见的协议

介绍

最好用的 sing-box 脚本

Github 地址：https://github.com/233boy/sing-box

特点

快速安装
无敌好用
零学习成本
自动化 TLS
简化所有流程
兼容 sing-box 命令
强大的快捷参数
支持所有常用协议
一键添加 VLESS-REALITY (默认)
一键添加 TUIC
一键添加 Trojan
一键添加 AnyTLS
一键添加 Hysteria2
一键添加 Shadowsocks 2022
一键添加 VMess-(TCP/HTTP/QUIC)
一键添加 VMess-(WS/H2/HTTPUpgrade)-TLS
一键添加 VLESS-(WS/H2/HTTPUpgrade)-TLS
一键添加 Trojan-(WS/H2/HTTPUpgrade)-TLS
一键启用 BBR
一键更改伪装网站
一键更改 (端口/UUID/密码/域名/路径/加密方式/SNI/等…)
还有更多…

设计理念

设计理念为：高效率，超快速，极易用

脚本基于作者的自身使用需求，以 多配置同时运行 为核心设计

并且专门优化了，添加、更改、查看、删除、这四项常用功能

你只需要一条命令即可完成添加、更改、查看、删除、等操作

例如，添加一个配置仅需不到 1 秒！瞬间完成添加！其他操作亦是如此！

脚本的参数非常高效率并且超级易用，请掌握参数的使用

请认真往下阅读脚本的参数使用，你就会发现可以如此美妙

支持协议列表

TUIC
Trojan
Hysteria2
VMess-WS
VMess-TCP
VMess-HTTP
VMess-QUIC
Shadowsocks
VMess-H2-TLS
VMess-WS-TLS
VLESS-H2-TLS
VLESS-WS-TLS
Trojan-H2-TLS
Trojan-WS-TLS
VMess-HTTPUpgrade-TLS
VLESS-HTTPUpgrade-TLS
Trojan-HTTPUpgrade-TLS
VLESS-REALITY
VLESS-HTTP2-REALITY
Socks

机场推荐

如果你只是单纯的翻，墙需求，可以购买机场的，不用自己搭建什么的，省心省力。

机场推荐： Just My Socks

Just My Socks 是搬瓦工提供的 Shadowsocks & V2Ray 服务，不怕跑路，非国人商家，无须担心 IP 被墙问题。

购买教程： Just My Socks 详细图文购买教程

搭建教程

如果是新手，请看：sing-box搭建详细图文教程

安装

系统支持：Ubuntu，Debian，CentOS，推荐使用 Ubuntu 22，谨慎使用 CentOS，脚本可能无法正常运行！

执行如下命令：

bash <(wget -qO- -o- https://github.com/233boy/sing-box/raw/main/install.sh)

如果需要指定 sing-box 版本，请在安装命令后面加 -v ver 参数

如需查看安装命令帮助，在安装命令后面加 -h 即可

安装完成

当你执行了上面的安装命令，并且没有错误提示的话，那么你就能看到类似下面的图片

脚本特意弄了一个时间显示，给反馈用来检测安装时间的…

理论上，绝大多数情况下 15 秒内会安装完成，条件允许的情况下仅需一秒即可完成安装！

超过 15 秒的你应该考虑换 VPS 了，推荐使用搬瓦工 VPS

为方便你快速使用，脚本在安装完成后会自动创建一个 VLESS-REALITY 配置

此时你可以复制 URL 到相关软件 (例如 v2rayN) 去测试一下是否正常使用。

如果无法正常使用，请尝试使用 sing-box add ss auto auto aes-256-gcm 添加一个 SS 来再测试一下

管理面板

安装完成后，输入 sing-box 或者 sb 就能看到管理面板，如下图片所示

提示，如果你不想执行任何功能，直接按 Enter 回车退出即可。

为方便输入，脚本自动创建 sb 快捷输入命令用来代替 sing-box （sing-box 太长了都

无法使用

无法使用一般都是两种情况，一是无法连接上端口，二是客户端内核支持有问题。

如果你的 VPS 有外部防火墙，请确保你已经开放了端口

测试端口是否能连接上：

打开：https://tcp.ping.pe/

写上你的 VPS IP 跟端口；内容为 ip:端口，示例：1.1.1.1:443，然后点击 Go；或者直接回车

如果显示 successful；证明端口能连接；如果显示 failed；那是无法连接上端口。

提醒，你可以使用 sb ip 查看 VPS IP。

关闭防火墙，执行如下命令：

systemctl stop firewalld; systemctl disable firewalld; ufw disable

关闭防火墙之后再测试一下端口是否通，如果不通，你可能还有外部防火墙没关，必须要能连接上端口才能正常使用。

如果能连接上端口，那就继续

使用 sb add ss auto auto aes-256-gcm 添加一个 SS 看看能不能正常使用，如果正常使用，证明运行没有问题。

提醒，默认安装的 sing-box 内核为最新版本

如果无法使用，可能是你客户端的内核太旧

请尝试使用不同的客户端进行测试；比如 v2rayN；v2rayNG 等

请尝试设置 VMessAEAD，某些客户端会有相关选项

某些客户端得把额外id(alterid) 填写为 0；比如垃圾苹果那边的东西

请更新你的客户端 sing-box 内核跟服务器端版本保持一致！

快速入门

sing-box 脚本简化了很多流程，例如我们常用的是 (添加、更改、查看、删除) 配置，以下内容让你可以快速掌握使用

添加配置：

sb add -> 添加配置
sb add reality -> 添加一个 VLESS-REALITY 配置
sb add reality 443 auto dl.google.com -> 同上，自定义参数：端口使用 443， SNI 使用 dl.google.com
sb add hy -> 添加一个 Hysteria2 配置
sb add ss -> 添加一个 Shadowsocks 2022 配置
sb add tcp -> 添加一个 VMess-TCP 配置

备注，使用 sb add 添加配置的时候，仅 *TLS 相关协议配置必须提供域名，其他均可自动化处理。

如需查看更多 add 参数用法，请查看下面的 add 说明

–

更改配置：

sb change -> 更改配置
sb change reality -> 更改 REALITY 相关配置
sb change reality sni 1.1.1.1 -> 更改 REALITY 相关配置的 SNI 为 1.1.1.1, 也可以使用 sb sni reality 1.1.1.1
sb change tcp -> 更改 TCP 相关配置
sb change tcp port auto -> 更改 TCP 相关配置的端口，端口使用自动创建，也可以使用 sb port tcp auto

如需查看更多 change 参数用法，请查看下面的 change 说明

–

查看配置：

sb info -> 查看配置
sb info REALITY -> 查看 REALITY 相关配置
sb info tcp -> 查看 TCP 相关配置

–

删除配置：

sb del -> 删除配置
sb del REALITY -> 删除 REALITY 相关配置
sb del tcp -> 删除 TCP 相关配置

提醒，谨慎使用 del 参数

–

非常棒！你已经掌握最常用的功能 (添加、更改、查看、删除)

add / change / info / del ：添加、更改、查看、删除

对于绝大多数用户来说

使用 sb add 添加配置，使用 sb change sb info sb del 来 (更改、查看、删除) 配置即可。

提醒，如果只匹配到一个配置时则自动选择该配置，否则将显示匹配到的配置列表，要求选择其中一个配置

add

add 是一个用来添加配置的参数

备注：可选参数中使用 auto 代替即是让脚本自动化处理相关参数

用法：sb add [protocol] [args... | auto]

举例：

sb add
sb add h2
sb add ws
sb add ss
sb add hy
sb add tcp
sb add tuic
sb add reality

提醒，当 可选参数 不存在时，即默认为 auto，仅 *TLS 协议配置的域名无法自动处理。

例如，sb add tcp 等于 sb add tcp auto auto auto

–

可选参数详细说明如下：

添加一个 VLESS-REALITY 配置
可选参数：端口，UUID，SNI
用法: sb add reality [port] [uuid] [sni]
举例:

sb add reality
sb add reality 443 auto dl.google.com -> 端口使用 443，SNI 使用 dl.google.com

备注，此处的 reality 可以直接写成 r，即是 sb add r 等于 sb add reality

–

添加一个 VLESS-HTTP2-REALITY 配置
可选参数：端口，UUID，SNI
用法: sb add rh2 [port] [uuid] [sni]
举例:

sb add rh2
sb add rh2 443 auto dl.google.com -> 端口使用 443，SNI 使用 dl.google.com

–

添加一个 TUIC 配置
可选参数：端口，UUID
用法: sb add tuic [port] [uuid]
举例:

sb add tuic
sb add tuic 443 -> 端口使用 443

–

添加一个 Trojan 配置
可选参数：端口，password
用法: sb add trojan [port] [password]
举例:

sb add trojan
sb add trojan 443 -> 端口使用 443

–

添加一个 AnyTLS 配置
可选参数：端口，密码，域名
用法: sb add anytls [port] [password] [domain]
举例:

sb add anytls
sb add anytls 443 -> 端口使用 443
sb add anytls 443 auto 233boy.com -> 端口使用 443，密码自动生成，域名使用 233boy.com

–

添加一个 Hysteria2 配置
可选参数：端口，password
用法: sb add trojan [port] [password]
举例:

sb add hy
sb add hy 443 -> 端口使用 443

备注，此处的 hy 可以换成 hy2 Hysteria2，但是明显没有必要多输入啊（

–

添加一个 Shadowsocks 配置
可选参数：端口，密码，加密方式
用法：sb add ss [port] [password] [method]
举例：

sb add ss
sb add ss auto auto 2022-blake3-aes-128-gcm -> 加密方式使用 2022-blake3-aes-128-gcm
sb add ss 233 233boy aes-128-gcm -> 端口使用 233，密码使用 233boy.com，加密方式使用 aes-128-gcm

–

添加一个 Socks 配置
可选参数：端口，密码，加密方式
用法：sb add socks [port] [username] [password]
举例：

sb add socks
sb add socks 233 233boy 233boy.com -> 端口使用 233，用户名使用 233boy，密码使用 233boy.com

–

添加一个 VMess-(WS/TCP/HTTP/QUIC) 配置
可选参数：端口，UUID，伪装类型
用法：sb add [ws | tcp | http | quic] [port] [uuid]
举例：

sb add ws -> 添加一个 VMess-WS 配置
sb add tcp -> 添加一个 VMess-TCP 配置
sb add http -> 添加一个 VMess-HTTP 配置
sb add quic -> 添加一个 VMess-QUIC 配置
sb add tcp 233 auto -> 端口使用 233，UUID 自动创建

–

添加一个 VMess-(WS/H2/HTTPUpgrade)-TLS 配置
可选参数：域名，UUID，路径
用法: sb add [ws | h2 | hu] [host] [uuid] [/path]
举例:

sb add wss -> 添加一个 VMess-WS-TLS 配置
sb add h2 -> 添加一个 VMess-H2-TLS 配置
sb add hu -> 添加一个 VMess-HTTPUpgrade-TLS 配置
sb add wss 233boy.com -> 域名使用 233boy.com
sb add h2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2
sb add hu 233boy.com auto /mypath -> 域名使用 233boy.com，路径使用 /mypath

–

添加一个 VLESS-(WS/H2/HTTPUpgrade)-TLS 配置
可选参数：域名，UUID，路径
用法: sb add [vws | vh2 | vhu] [host] [uuid] [/path]
举例:

sb add vws -> 添加一个 VLESS-WS-TLS 配置
sb add vh2 -> 添加一个 VLESS-H2-TLS 配置
sb add vhu -> 添加一个 VLESS-HTTPUpgrade-TLS 配置
sb add vws 233boy.com -> 域名使用 233boy.com
sb add vh2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2
sb add vhu 233boy.com auto /HTTPUpgrade -> 域名使用 233boy.com，路径使用 /HTTPUpgrade

–

添加一个 Trojan-(WS/H2/HTTPUpgrade)-TLS 配置
可选参数：域名，UUID，路径
用法: sb add [tws | th2 | vhu] [host] [uuid] [/path]
举例:

sb add tws -> 添加一个 Trojan-WS-TLS 配置
sb add th2 -> 添加一个 Trojan-H2-TLS 配置
sb add vhu -> 添加一个 Trojan-HTTPUpgrade-TLS 配置
sb add tws 233boy.com -> 域名使用 233boy.com
sb add th2 233boy.com auto /h2 -> 域名使用 233boy.com，路径使用 /h2
sb add vhu 233boy.com auto /HTTPUpgrade -> 域名使用 233boy.com，路径使用 /HTTPUpgrade

–

提醒，sb add [protocol] 的 protocol 也可以换完整的协议名称，名称看上面的支持协议列表

举例，sb add Hysteria2 跟 sb add hy 是一样的，但当然还是用简化的名称吧，简单好记。

举例，sb add Shadowsocks 跟 sb add ss 是一样的，但当然还是用简化的名称吧，简单好记。

再说一遍，当可选参数不存在时默认是自动化处理的 (除了 *TLS 的配置必须提供域名)，如非必要，可以省去使用可选参数的。

所以，绝大多数情况下，只要加上协议即可，举例： sb add tcp，sb add hy，sb add tuic

no-auto-tls

no-auto-tls 参数跟 add 参数用法一样，但禁止自动配置 TLS, 可用于 *TLS 相关协议

用法：sb no-auto-tls [protocol] [args... | auto]

举例：

sb no-auto-tls
sb no-auto-tls wss
sb no-auto-tls vh2 233boy.com
sb no-auto-tls vhu 233boy.com

提醒，如果你想要手动配置 TLS，请使用此选项，例如你想要用 NGINX 实现 TLS

帮助说明：sing-box 脚本 no-auto-tls 参数帮助说明

[name]

试想一虾，如果你当前有 233 个 VMess-TCP 配置的时候，如何快速选择其中一个配置呢

当你有多个配置时，你可以使用 [name] 关键词用来匹配相关配置，以便于快速执行 更改，查看，删除 等操作

推荐使用 端口 或者 域名 来匹配，这样更加容易筛选相关配置。

请往下查看会使用到 [name] 的举例

提醒，如果只匹配到一个配置时则自动选择该配置，否则将显示匹配到的配置列表，要求选择其中一个配置

change

change 是一个用来更改配置的参数

用法: sb change [name] [option] [args... | auto]

提醒：不同的配置可提供更改的相关选项是不同的

[option] 名称及选项说明参数如下：

名称	可选参数	用途	auto
full	[…]	更改多个参数	其他
id	[uuid]	更改 UUID	是
host	[domain]	更改域名	-
port	[port]	更改端口	是
path	[/path]	更改路径	是
passwd	[passowrd]	更改密码	是
key	[Private key] [Public key]	更改密钥	是
method	[method]	更改加密方式	是
sni	[domain]	更改 serverName	是
new	[…]	更改协议	其他
web	[domain]	更改伪装网站	-

备注，支持 auto 的即是可以将可选参数设置为 auto，以执行自动更改相关参数

如果 auto 为其他，可选参数请参考 add 参数用法，full 类似于 sb add 当前协议 [...]，new 类似于 sb add [...]

举例:

sb change -> 更改配置
sb change tcp -> 更改一个 tcp 相关的配置
sb change tcp port 233 -> 更改一个 TCP 配置的端口为 233
sb change tcp port auto -> 更改一个 TCP 配置的端口，并且端口自动创建
sb change tuic id auto -> 更改一个 TUIC 配置的 UUID，并且 UUID 自动创建
sb change tls host 233boy.com -> 更改一个 tls 配置的域名为 233boy.com
sb change tls web example.com -> 更改一个 tls 配置的伪装网站为 example.com
sb change reality sni 1.1.1.1 -> 更改一个 reality 配置的 SNI 为 1.1.1.1

提醒， [option] 名称也支持直接使用

用法：sb [option] [name] [...]

举例：

sb id -> 更改 UUID
sb port -> 更改端口
sb port tcp 233 -> 更改一个 tcp 配置的端口为 233
sb id tcp -> 更改一个 tcp 配置的 UUID
sb id tcp auto -> 更改一个 tcp 配置的 UUID，并且 UUID 自动创建
sb host tls 233boy.com -> 更改一个 tls 配置的域名为 233boy.com
sb web tls example.com -> 更改一个 tls 配置的伪装网站为 example.com
sb sni reality 1.1.1.1 -> 更改一个 reality 配置的 SNI 为 1.1.1.1

更改配置的选项较多，就不一个一个举例了，绝大多数情况下使用 sb change 即可

info

info 是一个用来查看配置的参数

用法: sb info [name]

举例:

sb info -> 查看配置
sb info tcp -> 查看一个 tcp 配置
sb info tuic -> 查看一个 tuic 配置
sb info tls -> 查看一个 tls 配置

import

import 是一个用来导入 xray/v2ray 脚本配置的参数，方便统一管理

使用: sb import

仅限使用本人(233boy)的 xray/v2ray脚本创建的配置可自动导入

仅部分配置可实现自动导入，并且已导入的配置，将在原脚本上无法查看或管理

url

url 是一个生成配置的 URL 链接的参数

用法: sb url [name]

举例:

sb url -> 查看配置的 URL 链接
sb url tcp -> 查看一个 tcp 配置的 URL 链接
sb url hy -> 查看一个 Hysteria2 配置的 URL 链接
sb url tls -> 查看一个 tls 配置的 URL 链接

qr

qr 是一个用来生成配置的二维码的参数

用法: sb qr [name]

举例:

sb qr -> 查看配置的二维码
sb qr tcp -> 查看一个 tcp 配置的二维码
sb qr hy -> 查看一个 Hysteria2 配置的二维码
sb qr tls -> 查看一个 tls 配置的二维码

del

del 是一个用来删除配置的参数

用法: sb del [name]

举例:

sb del -> 删除配置
sb del tcp -> 删除一个 tcp 配置
sb del tuic -> 删除一个 tuic 配置
sb del tls -> 删除一个 tls 配置

谨慎使用此选项

ddel

ddel 是一个用来删除多个配置的参数

用法: sb ddel [name...]

举例:

sb ddel -> 删除配置
sb ddel tcp tuic -> 同时删除一个 tcp，一个 tuic 配置

提醒，此处的 [name] 只有匹配到相关配置是唯一时，才会执行删除

例如，假设你当前有两个 tcp 配置，使用 sb ddel tcp 是不会删除任何文件的

谨慎使用此选项

gen

gen 参数跟 add 参数用法一样，但是 gen 参数只返回 JSON 内容，不会创建配置，仅供测试使用

用法：sb gen [protocol] [args... | auto]

举例：

sb gen ss
sb gen tcp
sb gen hy2
sb gen tuic
sb gen reality 2333
sb gen vws 233boy.com

bbr

bbr 参数是启用 BBR 优化的

使用: sb bbr

bin

bin 参数是直接调用 sing-box 核心运行相关命令，此参数可完全兼容所有 sing-box 命令

用法：sb bin [...]

举例：sb bin help

举例：sb generate uuid

fix-config.json

fix-config.json 参数是用来修复 config.json 文件的

使用: sb fix-config.json

update

update 参数是用来更新的

用法：sb update [core | sh | caddy] [ver]

举例:

sb update -> 更新核心
sb update core -> 更新核心
sb update core v1.8.13 -> 更新核心，使用 v1.8.13 版本
sb update sh -> 更新脚本
sb update caddy -> 更新 Caddy

log

log 参数是用来查看 sing-box 运行的实时日志

举例：

sb log -> 查看日志
sb log [level] -> 设定 log 级别

由于每个人日常使用需求不同，为了避免 log 生成太大的文件占用硬盘空间，请考虑使用 sb log del 来删除日志文件；

或者直接使用 sb log none 直接禁止生成 log 文件。

status

status 是查看运行状态的参数

使用：sb status

start, stop, restart

start, stop, restart 是管理 sing-box 启动，停止，重启的参数

用法：sb [start | stop | restart] [caddy]

举例：

sb restart -> 重启 sing-box
sb restart caddy -> 重启 Caddy

reinstall

reinstall 是重装脚本的参数

使用: sb reinstall

uninstall

uninstall 是卸载脚本的参数

使用：sb uninstall

设置DNS

请看：sing-box 脚本 DNS 设置

中转

如果你需要使用 A 机器转发流量到 B 机器

那么请看：sing-box 脚本中转教程

帮助

哎呀，不想写了，其他的一些参数用法，请查看帮助

使用：sb help

友情提醒

如果你添加了 *TLS 协议的配置，请务必设置伪装网站，使用 sb web tls 快速设置伪装网站

伪装网站

伪装网站是一个反代，指的是打开自己域名的时候显示来自伪装网站的内容

自动 TLS 说明

sing-box 脚本自动 TLS 帮助说明

备份脚本

考虑到可能会有不可描述的事情发生，你可以将 sing-box 脚本备份一下以防止万一。