最后更新于:2026-11-16

sing-box推荐

眼下的首选路线;仍要按复核周期去看官方维护和兼容情况。

整理于 2026-11-16官方来源
VLESS + Reality推荐

原名 / 别名:Reality

眼下的首选路线;仍要按复核周期去看官方维护和兼容情况。

整理于 2026-11-16官方来源
Hysteria 2推荐

原名 / 别名:Hysteria2、HY2

官方文档和版本都还在更新,适合 UDP 能用、网络弱、丢包多的环境,但别只靠它一个协议。

整理于 2026-11-16备选:VLESS + Reality(UDP 被限制时)官方来源
AnyTLS维护

sing-box 依旧带官方入站实现,可以当 TCP 备选;支持它的客户端比 Reality 少,先不当新手首选。

整理于 2026-11-16备选:VLESS + Reality(主力)官方来源
TUIC v5维护

原名 / 别名:TUIC

sing-box 依旧带 TUIC v5 入站实现,留作 QUIC 备选;好飞机场指南暂未单独写它的教程,也没有长期使用记录,所以不列为首选。

整理于 2026-11-16备选:Hysteria 2(教程更全)或 VLESS + Reality(主力)官方来源
SING-BOX STACK

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 管理三种方式。下面照仓库原有的「先下载、再检查、后执行」来:

bash
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 version

sing-box v1.14.0 在 2026-08-31 转为 stable。官方的 Linux 软件源和 Docker 另外还有 beta、testing、oldstable 几条轨道;正式使用时要明确挑 stable 或自己验证过的版本。

从 1.13 升上来之前,先读 v1.14.0 Release Notes 和 Migration,把配置备份好,重启之前拿新的二进制再检查一遍:

bash
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。装完先看一眼,别马上覆盖已有配置:

bash
systemctl status sing-box --no-pager
journalctl -u sing-box -n 50 --no-pager

路线二:用 Fscarmen 的第三方脚本 ​

Fscarmen sing-box 全家桶 能一次生成多协议订阅,只是它并非官方安装器。脚本要用高权限运行,跑之前先读一遍当前的 commit 和安装脚本。

bash
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 端口跳跃字段不见了的话,先更新脚本再重新生成,别一边手改脚本状态一边更新。

生成密钥和凭证 ​

bash
# 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 24

Reality 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 字段 的最新文档为准:

json
{
  "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 标注。

检查、启动、放行端口 ​

每改一次只加一个入站,接着运行:

bash
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。下面只是占位示例,没用到的端口别照着开:

bash
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 控制台或另一条管理通道,免得改一次防火墙就连不上机器。

延伸阅读 ​