sing-box 搭建:Reality/Hysteria2/TUIC/AnyTLS
用 sing-box 自己搭节点:先分清官方安装和第三方全家桶脚本,再照 Reality、Hysteria2、TUIC、AnyTLS 各自眼下的前提条件,一个个配置、检查、排错。
- 发布
- 更新
- 核对
- 门槛
- 进阶
- 类别
- 教程
最后更新于:2026-11-16
眼下的首选路线;仍要按复核周期去看官方维护和兼容情况。
原名 / 别名:Reality
眼下的首选路线;仍要按复核周期去看官方维护和兼容情况。
原名 / 别名:Hysteria2、HY2
官方文档和版本都还在更新,适合 UDP 能用、网络弱、丢包多的环境,但别只靠它一个协议。
sing-box 依旧带官方入站实现,可以当 TCP 备选;支持它的客户端比 Reality 少,先不当新手首选。
原名 / 别名:TUIC
sing-box 依旧带 TUIC v5 入站实现,留作 QUIC 备选;好飞机场指南暂未单独写它的教程,也没有长期使用记录,所以不列为首选。
sing-box 一个进程就能管好几种入站,可「全家桶」并不意味着要全部打开。先挑一个网络、TLS、客户端条件都满足的入站,检查通过后再加第二个。
- 官方部署通过 sing-box 官方仓库或安装脚本完成部署,自己负责维护 JSON 与 systemd。
- 第三方路线Fscarmen 脚本能生成多协议配置和订阅,但它不属于 SagerNet 官方组件。
- 一个个验每次只加一个入站,配置、监听、证书、防火墙和客户端分别核对。
先挑协议,别先求数量
| 入站 | 网络条件 | 身份与 TLS 材料 | 版本和安全提醒 |
|---|---|---|---|
| VLESS + Reality | 选定的 TCP 端口能连通 | UUID、Reality 公私钥、Short ID、握手目标 | 两端字段要一一对上;常规部署用不着自己的证书 |
| Hysteria2 | 选定的 UDP 端口能连通 | 密码、TLS 配置 | TLS 不能省;从 1.14 开始还多了 Gecko、bbr_profile 和 realm,默认都没开 |
| TUIC v5 | 选定的 UDP 端口能连通 | UUID、密码、TLS 配置 | 拥塞控制默认是 cubic;官方文档建议关掉 0-RTT |
| AnyTLS | 选定的 TCP 端口能连通 | 密码、TLS 配置 | sing-box 1.12.0 起才有这个入站;padding_scheme 先用默认的 |
没有哪个协议名能对应固定的「抗封」或「速度」分数。挑选时先把条件不满足的剔掉,再在同一台 VPS、同一条线路、同一个目标任务下,一次只改一样去复查。
路线一:用官方方式安装
官方的 Package Manager 文档 里给了软件源、手动脚本和 systemd 管理三种方式。下面照仓库原有的「先下载、再检查、后执行」来:
curl -fsSL https://sing-box.app/install.sh -o /tmp/install-sing-box.sh
less /tmp/install-sing-box.sh
bash /tmp/install-sing-box.sh
sing-box versionsing-box v1.14.0 在 2026-08-31 转为 stable。官方的 Linux 软件源和 Docker 另外还有 beta、testing、oldstable 几条轨道;正式使用时要明确挑 stable 或自己验证过的版本。
从 1.13 升上来之前,先读 v1.14.0 Release Notes 和 Migration,把配置备份好,重启之前拿新的二进制再检查一遍:
sing-box version
cp -a /etc/sing-box "/etc/sing-box.backup-$(date +%Y%m%d-%H%M%S)"
sing-box check -c /etc/sing-box/config.json
# 按已选择的软件源 / 固定版本完成升级后
sing-box version
sing-box check -c /etc/sing-box/config.json
systemctl restart sing-box
systemctl status sing-box --no-pager默认的配置文件多放在 /etc/sing-box/config.json,systemd 里的服务名叫 sing-box。装完先看一眼,别马上覆盖已有配置:
systemctl status sing-box --no-pager
journalctl -u sing-box -n 50 --no-pager路线二:用 Fscarmen 的第三方脚本
Fscarmen sing-box 全家桶 能一次生成多协议订阅,只是它并非官方安装器。脚本要用高权限运行,跑之前先读一遍当前的 commit 和安装脚本。
curl -fsSL https://raw.githubusercontent.com/fscarmen/sing-box/main/sing-box.sh -o /tmp/fscarmen-sing-box.sh
less /tmp/fscarmen-sing-box.sh
bash /tmp/fscarmen-sing-box.sh只打开用得到的入站,不用的 Web 服务和端口都关掉,升级之前先备份。v2rayN 里 Hysteria2 端口跳跃字段不见了的话,先更新脚本再重新生成,别一边手改脚本状态一边更新。
生成密钥和凭证
# VLESS / TUIC UUID
sing-box generate uuid
# Reality 公私钥
sing-box generate reality-keypair
# Reality Short ID
sing-box generate rand --hex 8
# Hysteria2 / TUIC / AnyTLS 密码示例
openssl rand -base64 24Reality Private Key 只留在服务端,Public Key 交给客户端。每个入站、每个用户各用一套凭证,要撤销时可以单独处理。
TLS 证书要注意什么
Hysteria2、TUIC、AnyTLS 这三个入站都离不开 TLS 配置。可以用外部证书文件,也可以用官方眼下支持的 certificate provider;怎么申请、怎么续期,要看用的证书工具和 challenge 类型,未必非得对外开放 80 端口。
sing-box 1.14.0 起,TLS 配置里内联写的 acme 字段已被弃用,打算在 1.16.0 删掉。新写的配置请改用 certificate provider 或外部的证书管理流程,并保证证书续期后 sing-box 能重新读到。
Reality 服务端常见的写法靠握手目标加密钥,不需要自己的证书。这也不是在描述「借用或盗用别人证书」的做法。
手动写 Reality 入站
下面的例子只展示 sing-box 现在的 VLESS 和 Reality 字段,没有把四种协议一起塞进去。占位值要全部换掉,字段含义以 VLESS 入站 和 TLS / Reality 字段 的最新文档为准:
{
"log": {
"level": "info",
"timestamp": true
},
"inbounds": [
{
"type": "vless",
"tag": "vless-reality",
"listen": "::",
"listen_port": 443,
"users": [
{
"uuid": "你的UUID",
"flow": "xtls-rprx-vision"
}
],
"tls": {
"enabled": true,
"server_name": "你的握手目标域名",
"reality": {
"enabled": true,
"handshake": {
"server": "你的握手目标域名",
"server_port": 443
},
"private_key": "你的PrivateKey",
"short_id": ["你的ShortID"]
}
}
}
],
"outbounds": [
{
"type": "direct",
"tag": "direct"
}
]
}客户端要是不支持 xtls-rprx-vision,别只在一头删掉 flow;要照两边现行文档挑一套两端一致的组合。
再加别的入站
Reality 能用以后,再去官方页面单独复制一个入站的结构,换上新的端口和凭证:
- Hysteria2 入站:要有 UDP、用户密码和 TLS。官方的
userpass得写成用户名:密码。Gecko、bbr_profile和realm默认都不开。 - TUIC 入站:要有 UUID、密码和 TLS;先用默认的
cubic,0-RTT 保持关闭。 - AnyTLS 入站:要有用户密码、TLS,客户端版本也要够新;先用默认的
padding_scheme。
别把老文章里整份多协议 JSON 搬过来。升级版本时,先看 sing-box changelog,以及每个字段上的 Deprecated 标注。
检查、启动、放行端口
每改一次只加一个入站,接着运行:
sing-box check -c /etc/sing-box/config.json
systemctl restart sing-box
systemctl status sing-box --no-pager
journalctl -u sing-box -n 100 --no-pager
ss -lntup然后照实际监听的情况分别放行 TCP 或 UDP。下面只是占位示例,没用到的端口别照着开:
ufw allow 你的Reality端口/tcp
ufw allow 你的Hysteria2端口/udp
ufw reload本机 UFW、云安全组、客户端里的端口三者要对得上。ss 没在监听就先改服务配置;在监听但外面连不上,再去查防火墙和网络路径。
客户端怎么填
客户端要和服务端一项项对上:
- VLESS Reality:地址、端口、UUID、flow、Public Key / password、Short ID、server name
- Hysteria2:地址、UDP 端口、密码、TLS server name 和证书信任;使用官方的
userpass时,需完整填写为用户名:密码 - TUIC:需核对地址、UDP 端口、UUID、密码及 TLS,并确认拥塞控制的兼容性
- AnyTLS:地址、TCP 端口、密码、TLS server name,以及版本是否支持
iOS / macOS 与 Android 客户端现在从哪里下载,看 iOS 客户端对比 和 Android 客户端对比。名字相近的镜像站、第三方下载站里的安装包都别用。
常见问题怎么查
服务起不来
先跑一下 sing-box check,再翻 systemd 日志。语法检查过了却监听不上时,用 ss -lntup 看端口是否冲突、协议类型对不对。
Reality 连不上
外面能连到 TCP 端口、日志里也有请求,就逐个核对 UUID、flow、Public Key、Short ID、server name 和握手目标。服务端日志一条都没有,先查地址、端口、防火墙和接入网络。
Hysteria2 / TUIC 连不上
别一上来就怪「运营商限了 UDP」。先确认服务在监听 UDP、主机和云防火墙都放行了、证书有效、客户端端口一致,再换一种接入网络重试。升到 1.14 以后只有 Hysteria2 的 TLS 握手失败的话,还要查客户端默认的 Chrome QUIC fingerprint 和 Ed25519 证书之间的兼容限制。
网速慢
别急着套 BBR 或 sysctl 模板。把服务器、时间段和目标任务固定住,TCP / UDP 两类候选各自记下成功率、延迟、吞吐和日志;只有一次改一样能反复看到同样的差别,才去动拥塞控制。
怀疑 IP 连不上
偶尔一次 timeout、ICMP 丢包,或者某个 UDP 端口不通,都不足以断定 IP 被封。照着 VPS IP 被墙排障 去查服务本身、主机防火墙、云安全组、服务商状态,以及换几种接入网络的结果。
安全上要注意
- 配置文件、订阅 URL、UUID、密码、私钥,一样都别放进公开仓库。
- 升级前先备份
/etc/sing-box/,配置检查过再重启。 - 只开真正用到的端口;订阅入口和管理入口都要加访问限制。
- 留着 VPS 控制台或另一条管理通道,免得改一次防火墙就连不上机器。