来源: 233Boy | GitHub: https://github.com/233boy/sing-box

设计理念: 高效率,超快速,极易用 — 以多配置同时运行为核心设计


核心特点

  • 快速安装(通常15秒内完成,条件允许仅需1秒)
  • 自动化 TLS
  • 零学习成本,一条命令完成添加/更改/查看/删除
  • 兼容 sing-box 原生命令
  • 支持所有常用协议
  • 一键启用 BBR、更改伪装网站、更改端口/UUID/密码/域名等

支持协议列表

协议 快捷名称
VLESS-REALITY reality / r
VLESS-HTTP2-REALITY rh2
TUIC tuic
Trojan trojan
AnyTLS anytls
Hysteria2 hy / hy2
Shadowsocks 2022 ss
VMess-TCP tcp
VMess-HTTP http
VMess-QUIC quic
VMess-WS ws
VMess-WS-TLS wss
VMess-H2-TLS h2
VMess-HTTPUpgrade-TLS hu
VLESS-WS-TLS vws
VLESS-H2-TLS vh2
VLESS-HTTPUpgrade-TLS vhu
Trojan-WS-TLS tws
Trojan-H2-TLS th2
Trojan-HTTPUpgrade-TLS thu
Socks socks

安装

系统支持: Ubuntu, Debian, CentOS(推荐 Ubuntu 22,谨慎使用 CentOS)

bash <(wget -qO- -o- https://github.com/233boy/sing-box/raw/main/install.sh)
  • 指定版本:安装命令后加 -v ver
  • 查看帮助:安装命令后加 -h

安装完成后自动创建一个 VLESS-REALITY 配置,可直接复制 URL 到客户端测试。


管理面板

sing-box    # 或简写
sb          # 快捷命令

核心命令速查

添加配置 (add)

sb add                        # 交互式添加
sb add reality                # 添加 VLESS-REALITY
sb add reality 443 auto dl.google.com   # 自定义端口和 SNI
sb add r                      # 等同于 add reality
sb add rh2                    # 添加 VLESS-HTTP2-REALITY
sb add tuic                   # 添加 TUIC
sb add hy                     # 添加 Hysteria2
sb add ss                     # 添加 Shadowsocks
sb add tcp                    # 添加 VMess-TCP
sb add ws                     # 添加 VMess-WS
sb add wss 233boy.com         # 添加 VMess-WS-TLS(需域名)
sb add vws 233boy.com         # 添加 VLESS-WS-TLS
sb add socks                  # 添加 Socks

规则: 使用 auto 参数让脚本自动处理。仅 *TLS 协议必须提供域名。

更改配置 (change)

sb change                        # 更改配置
sb change tcp port 233          # 更改 TCP 配置的端口
sb change tcp port auto         # 端口自动创建
sb change tuic id auto          # UUID 自动创建
sb change reality sni 1.1.1.1   # 更改 SNI

快捷用法sb [option] [name] [...]):

sb port tcp 233                 # 更改端口
sb id tcp auto                  # 更改 UUID
sb host tls 233boy.com          # 更改域名
sb web tls example.com          # 更改伪装网站
sb sni reality 1.1.1.1          # 更改 SNI

可更改选项:

选项 用途 支持 auto
full 更改多个参数 其他
id 更改 UUID
host 更改域名
port 更改端口
path 更改路径
passwd 更改密码
key 更改密钥
method 更改加密方式
sni 更改 serverName
new 更改协议 其他
web 更改伪装网站

查看配置 (info)

sb info          # 查看所有配置
sb info tcp      # 查看 TCP 配置
sb info tuic     # 查看 TUIC 配置
sb info tls      # 查看 TLS 配置

删除配置 (del / ddel)

sb del              # 删除配置
sb del tcp          # 删除 TCP 配置
sb ddel tcp tuic    # 同时删除多个配置(仅匹配唯一时执行)

⚠️ 谨慎使用 del 参数


其他重要命令

URL & 二维码

sb url              # 生成配置 URL
sb url tcp          # 查看 TCP 配置的 URL
sb qr               # 生成二维码
sb qr hy            # 查看 Hysteria2 配置的二维码

no-auto-tls(禁止自动 TLS)

sb no-auto-tls wss          # 手动配置 TLS(如用 NGINX)
sb no-auto-tls vh2 233boy.com

导入配置

sb import           # 导入 xray/v2ray 脚本创建的配置(仅限 233boy 的脚本)

生成 JSON(测试用)

sb gen ss           # 只返回 JSON,不创建配置
sb gen reality 2333

BBR 优化

sb bbr              # 启用 BBR

调用 sing-box 核心

sb bin help         # 完全兼容 sing-box 原生命令
sb generate uuid    # 示例:生成 UUID

修复配置

sb fix-config.json  # 修复 config.json

更新

sb update                  # 更新核心
sb update core v1.8.13     # 更新到指定版本
sb update sh               # 更新脚本
sb update caddy            # 更新 Caddy

日志管理

sb log                     # 查看实时日志
sb log debug               # 设定日志级别
sb log none                # 禁止生成日志文件
sb log del                 # 删除日志文件

服务管理

sb status                  # 查看运行状态
sb start                   # 启动
sb stop                    # 停止
sb restart                 # 重启
sb restart caddy           # 重启 Caddy

重装 & 卸载

sb reinstall               # 重装脚本
sb uninstall               # 卸载脚本

故障排除

无法连接端口

  1. 检查外部防火墙是否开放端口
  2. 测试端口连通性: 打开 https://tcp.ping.pe/,输入 IP:端口,点击 Go
    • successful = 端口可达
    • failed = 端口不可达
  3. 关闭防火墙:
    systemctl stop firewalld; systemctl disable firewalld; ufw disable
    
  4. 使用 sb ip 查看 VPS IP

端口通但无法使用

sb add ss auto auto aes-256-gcm    # 添加 SS 测试
  • 如果 SS 能用 → 客户端内核太旧,请更新客户端 sing-box 内核
  • 尝试不同客户端(v2rayN、v2rayNG 等)
  • 确保客户端与服务端版本一致
  • 某些客户端需设置 VMessAEAD、额外ID(alterid) 填 0

目录结构

/etc/sing-box/
├── sh/          # 脚本
├── bin/         # 核心
└── conf/        # 配置

备份方法

sb backup           # 备份配置
sb backup list      # 查看备份列表
sb backup restore   # 恢复备份