来源: 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   # 恢复备份