Sing-box 节点超时(Timeout)全链路排查指南:从 IP 阻断、端口封锁到配置调优

按网络链路层、服务端日志与客户端配置三层拆解 sing-box (VLESS-REALITY) 超时问题,涵盖 IP/端口检测、DoH 避坑、冷门高位端口更换及 iptables 放行实操。

自建 sing-box( VLESS-REALITY)节点时,最让人头疼的莫过于客户端测速清一色返回 timeout,但反复核对服务端和本地配置似乎又挑不出毛病。实际上,Mihomo/Clash 等客户端会把底层各种错误(路由丢包、防火墙拦截、DNS 失败、TLS 握手异常)统一折叠显示为 timeout。

盲目改配置或重装只会浪费时间。高效的排查思路是分段掐断、两端联合:严格按照 网络链路层(IP/端口) → 服务端应用层 → 本地客户端层 的顺序逐跳定位,通常 5 分钟内就能锁定真正卡点。


一、网络层定性:区分 IP 被封、单端口封锁与防火墙拦截

不要急着翻日志,先绕开所有代理协议,确认最基础的 TCP 链路是否通畅。

1. 避开普通 Ping 的误判,直接测 TCP 端口

很多云服务器(尤其是甲骨文云 OCI)的默认安全列表直接丢弃 ICMP 入站包,哪怕服务器完全健康,普通 ping 也会国内外全红。

正确的检测方式是打开 tcp.ping.pe(或 port.ping.pe),分别测试服务器的 SSH 端口(如 22)、标准 HTTPS 端口(443) 以及 sing-box 实际监听的端口(如 8443),对照下表直接定性:

海外节点结果 国内多地节点结果 真实原因与处理方向
22 与 443 全绿 22 与 443 全部全红(或卡在 Connecting) 实锤 IP 级阻断。改配置、换端口均无效,需更换公网 IP 或改走 WS + TLS 套 CDN
22 与 443 全绿 443 全绿,唯独 8443 全红 IP 干净,仅单端口被封(8443、2053 等常见代理端口易被针对)。更换冷门高位端口
22 与 443 全绿 大部分绿,仅本地宽带不通 IP 正常。属于本地运营商线路波动或服务器 fail2ban 误封本地 IP(切手机 4G/5G 热点直连可秒验证)
国内外全红 国内外全红 非封锁问题。检查云控制台安全组、本机防火墙,或程序本身根本未监听该端口

注意一个常见误报: 测 22 端口时若出现国内大部分绿、偶发 1~2 个节点红,而 443 全绿,说明 IP 是干净的。tcp.ping.pe 瞬间发起几十个并发探针,容易触发 OpenSSH 默认的并发连接限流(MaxStartups),无需因此反复换 IP。

2. 两端同步抓包,排除本地代理“套娃”假象

如果本地电脑开着全局代理或 TUN 模式去测 nc,很容易测出“中转通、直连不通”的假象。验证前务必彻底关闭本地代理和 TUN 模式,两端同步操作:

服务端开启实时抓包(将 <PORT> 替换为实际监听端口):

sudo tcpdump -ni any tcp port <PORT>

本地终端发起纯 TCP 探测:

# macOS / Linux
nc -zv -w 3 <SERVER_IP> <PORT>

# Windows PowerShell
Test-NetConnection <SERVER_IP> -Port <PORT>
  • 本地返回 succeeded 且服务端看到 Flags [S] 与 Flags [S.]:TCP 链路完全畅通,直接进入第二步。
  • 服务端无任何输出:数据包在到达服务器前被丢弃(查云控制台安全列表或线路阻断)。
  • 服务端看到 [S] 但无 [S.] 回复:被本机防火墙拦截,或服务未正确监听在该端口。

二、应用层联合排查:撕掉 timeout 伪装

确认 TCP 畅通后,同步打开服务端实时日志和本地命令行请求,抓出真实报错。

1. 核对实际加载的配置与监听端口

先确保改的配置文件确实是 systemd 正在运行的那个,且端口没有被其他服务冲突占用:

systemctl cat sing-box | grep ExecStart
sudo ss -tlnp | grep sing-box

2. 开启 debug 级实时日志(屏蔽历史干扰)

将服务端 config.json 中的 log.level 临时改为 "debug". 然后使用下面的命令查询一下错误信息,加上 --since 参数只看重启后的新日志,避免把重启前的公网扫描噪声(如旧的 processed invalid connection)当成当前报错:

sudo sing-box check -c /etc/sing-box/config.json \
  && sudo systemctl restart sing-box \
  && sudo journalctl -u sing-box --output cat --since "10 seconds ago" -f

3. 本地用 curl 制造探测流量,抓取底层真实报错

图形客户端自带的“测速小飞机”遇到任何异常都会一刀切折叠显示为 timeout,彻底抹去了底层错误细节。

此时在本地客户端关闭 TUN 模式、选中待测节点,通过本地混合/HTTP 代理端口(如 7890)主动发一次探测请求作为“靶子流量”。这一步的目的不是指望它能正常连通,而是为了从命令行抓取具体的底层报错(如 502、EOF、Reset),同时让服务端日志现场捕获到你的入站握手:

curl -v --max-time 8 -x http://127.0.0.1:7890 https://cp.cloudflare.com/generate_204

4. 两端现象联合对照表

服务端 debug 日志 本地 curl / 客户端日志 根因定位与处理
sing-box started 后毫无新日志 timeout 或 connection refused 流量未打到该端口。检查客户端 IP/端口是否填错、配置是否重载、请求是否被本地分流规则导流
报 REALITY: processed invalid connection EOF 或 TLS handshake timeout REALITY 外层握手未通过。优先核对公私钥配对、short-id、两端 SNI 与服务端时钟(YAML 中建议用单引号包裹字符串;注:uuid/flow 属于内层 VLESS 参数,填错通常在握手成功后报错)
报 REALITY: failed to dial dest timeout 或 EOF 服务端无法连上或解析伪装目标站(常见于服务端 DoH DNS 故障或目标站异常)
收到入站,但 outbound/direct 报错 timeout 或 502 服务器自身出站网络或 DNS 故障,在服务器本机执行 curl -Iv https://cp.cloudflare.com/generate_204 排查

三、排查中最高频的四个配置坑点

1. 海外服务器用 DoH(type: "https")引发 connection reset by peer

日志中如果出现类似报错:

dns: lookup failed for www.samsung.com: read tcp 10.0.0.x->8.8.8.8:443: read: connection reset by peer
TLS handshake: REALITY: failed to dial dest

问题往往出在服务端配置了基于 TCP/HTTPS 的 DoH。DoH 长连接在空闲后容易被对端或云厂商 NAT 网关重置,导致 REALITY 解析伪装域名失败。另外,在 sing-box 的 dns.servers 里放多个服务器并不会自动主备切换,未被 final 或 rules 引用的项只会在日志里报 is unreferenced。

海外服务器本身无 DNS 污染,直接改为无状态的系统解析(local)或纯 udp 最稳:

"dns": {
  "servers": [
    {
      "tag": "local",
      "type": "local"
    }
  ],
  "strategy": "ipv4_only",
  "final": "local"
}

(若改为 "tag": "local",同步检查 route.default_domain_resolver 是否仍指向旧 tag。)

2. REALITY 伪装域名不达标或关闭了 HTTP/2

VLESS-REALITY 强依赖目标站同时支持 TLS 1.3 + X25519 + HTTP/2(h2)。避开证书链过长容易触发 8192 字节限制的站点(如部分地区的 www.microsoft.com),以及因应急缓解 NGINX 漏洞而临时停用 HTTP/2 的中小型站点。

在服务端用一条命令即可验明正身:

curl -Iv --tlsv1.3 --http2 --connect-timeout 5 https://www.apple.com 2>&1 | grep -iE "SSL connection|ALPN|server:"

输出同时包含 TLSv1.3、X25519 和 ALPN: server accepted h2 才算合格(如 www.apple.com、www.icloud.com、www.samsung.com)。

3. max_time_difference 可选校验

REALITY 配置里的 "max_time_difference": "1m" 是完全可选的。排查阶段建议直接删掉该字段(默认关闭时间差校验),避免因手机、电脑或服务器时钟漂移触发握手拒绝。


四、IP 与端口的实操修复方案

场景 A:IP 被封后的快速恢复(以甲骨文云 OCI 为例)

无需重装系统,直接在控制台免费更换公网 IP:

  1. 进入 Compute(计算) → Instances(实例),点进对应实例,打开 Networking(网络) → Attached VNICs(附加的 VNIC) 中的主网卡。
  2. 进入 IP administration(IP 管理),点击主私有 IP 右侧菜单 Edit(编辑),选择 No public IP 并更新释放旧 IP。
  3. 再次点击 Edit(编辑),选择 Ephemeral public IP(临时公网 IP) 重新分配。
  4. 拿到新 IP 后,先用 port.ping.pe 验证新 IP 的 22 和 443 均通畅,再更新本地客户端和域名 DNS 解析。

(若暂时不想换 IP,且海外全绿,可将自有域名接入 Cloudflare 开启小黄云,采用 VLESS + WS + TLS 回源保底。)

场景 B:单端口被封后的恢复(更换高位冷门端口)

如果检测发现 IP 干净(SSH 端口国内全绿),唯独当前代理端口被精准阻断,最快、最直接的恢复方案就是更换为冷门高位端口:

  • 避开特征端口:切勿换到 8443、2053、2083、2087、2096 等常见的 Cloudflare 备用端口或代理常用端口,这些端口往往是公网扫描和主动探测的重点关照对象。
  • 优选高位端口区间:建议在 20000–50000 之间挑选一个冷门端口(例如 38443)。
  • 配置变更流程:
    1. 修改服务端 config.json 的 inbounds[].listen_port(如改为 38443)。
    2. 按照下文「场景 C」在云控制台安全列表及 VPS 本机防火墙放行该端口。
    3. 重启 sing-box 服务,并同步更新本地客户端配置中的节点端口。

场景 C:Ubuntu iptables 放行新端口的正确姿势

换用新高位端口(以 38443 为例)时,必须同时对齐三个位置:云控制台安全列表 + 本机 iptables + sing-box 监听端口,缺一不可。

  1. 必须用插入(-I),切忌用追加(-A) 甲骨文云 Ubuntu 默认 INPUT 链末尾带有一条兜底 REJECT 规则,用 -A 追加的放行规则排在 REJECT 后面根本不会生效。先查看行号:
sudo iptables -L INPUT -n --line-numbers

在安全防护规则之后、末尾 REJECT 之前插入新端口(假设插在第 4 行):

# 放行 TCP 代理端口(如 VLESS-REALITY)
sudo iptables -I INPUT 4 -p tcp --dport 38443 -j ACCEPT

# 若同时部署了 Hysteria2,需同步放行 UDP 端口
sudo iptables -I INPUT 4 -p udp --dport 48443 -j ACCEPT

(若输错端口号,可直接用原地替换修正,不打乱行号:sudo iptables -R INPUT 4 -p tcp --dport 38443 -j ACCEPT。)

  1. 避免 netfilter-persistent save 产生重复的 Fail2ban 规则 直接执行 netfilter-persistent save 会把运行中的 f2b-sshd 动态规则也写死到磁盘,重启后 Fail2ban 再次插入就会出现重复项。更干净的持久化方式是直接编辑 /etc/iptables/rules.v4,在末尾 REJECT 行之前手动加入:
-A INPUT -p tcp -m tcp --dport 38443 -j ACCEPT
-A INPUT -p udp -m udp --dport 48443 -j ACCEPT

(如果服务器上已存在重复的 f2b-* 规则,需先 sudo systemctl stop fail2ban,倒序按行号删除残留项,保存后再重新启动 Fail2ban。)

  1. 三位一体最终验收 修改 sing-box 的 listen_port 并重启后,按顺序核验三件事:
  • sudo ss -tlnp | grep 38443 确认 sing-box 处于 LISTEN 状态(未监听的端口外部探测必红)。
  • 外部使用 tcp.ping.pe 或本地直连 nc -zv -w 3 <SERVER_IP> 38443 返回全绿 / succeeded。
  • 执行 sudo iptables -L INPUT -n -v --line-numbers | grep 38443,看到左侧 pkts 命中计数大于 0。

所有测试跑通后,别忘了把服务端 config.json 里的 log.level 从 "debug" 改回 "warn" 并重启 sing-box,同时确认核心服务均已设为 enabled 开机自启,防止后续系统内核安全更新自动重启后掉线。


五、附:开箱即用的高稳服务端配置模板(VLESS-REALITY + Hysteria2)

综合全文排查与避坑要点(系统级无状态 DNS、规避时间差校验漂移、阻断高危滥用流量),以下提供一份兼顾稳健性与穿透力的生产环境完整配置模板(可直接存为 /etc/sing-box/config.json):

{
  "log": {
    "level": "warn",
    "timestamp": true
  },
  "dns": {
    "servers": [
      {
        "tag": "local",
        "type": "local"
      }
    ],
    "strategy": "ipv4_only",
    "final": "local"
  },
  "inbounds": [
    {
      "type": "vless",
      "tag": "vless-reality-in",
      "listen": "::",
      "listen_port": 38443,
      "users": [
        {
          "name": "main",
          "uuid": "<替换为生成的UUID>",
          "flow": "xtls-rprx-vision"
        }
      ],
      "tls": {
        "enabled": true,
        "server_name": "www.samsung.com",
        "reality": {
          "enabled": true,
          "handshake": {
            "server": "www.samsung.com",
            "server_port": 443
          },
          "private_key": "<替换为生成的PrivateKey>",
          "short_id": [
            "<替换为8-16位十六进制ShortID>"
          ]
        }
      }
    },
    {
      "type": "hysteria2",
      "tag": "hy2-in",
      "listen": "::",
      "listen_port": 48443,
      "ignore_client_bandwidth": true,
      "bbr_profile": "standard",
      "users": [
        {
          "name": "main",
          "password": "<替换为高强度随机密码>"
        }
      ],
      "masquerade": {
        "type": "proxy",
        "url": "https://www.samsung.com",
        "rewrite_host": true
      },
      "tls": {
        "enabled": true,
        "certificate_path": "/etc/sing-box/certs/fullchain.pem",
        "key_path": "/etc/sing-box/certs/privkey.pem"
      }
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "direct"
    }
  ],
  "route": {
    "rules": [
      {
        "action": "sniff"
      },
      {
        "action": "resolve"
      },
      {
        "protocol": "bittorrent",
        "action": "reject"
      },
      {
        "ip_is_private": true,
        "action": "reject"
      },
      {
        "port": 25,
        "action": "reject"
      }
    ],
    "final": "direct",
    "default_domain_resolver": "local"
  }
}

关键特性解析与生成命令:

  1. 双协议分工:
    • VLESS-REALITY (TCP 38443):主力稳定穿透,无需申请自签或 CA 证书,直借三星官网 SNI,关闭了易漂移的 max_time_difference。
    • Hysteria2 (UDP 48443):弱网对抗与高峰期加速利器(需自备域名和证书路径)。
  2. DNS 无状态兜底:使用 type: "local" 与 strategy: "ipv4_only",避开基于 TCP/HTTPS 的 DoH 被云厂商或对端 NAT reset 的致命陷阱。
  3. VPS 滥用风控规避:出站路由默认拒绝对外发送 25 端口邮件(防垃圾邮件封机)、阻断 BT 种子下载(防版权投诉封号)及局域网私有 IP 探测。
  4. 服务端快速生成相关参数:
    # 生成 UUID
    sing-box generate uuid
    
    # 生成 REALITY 密钥对(获取 PrivateKey 与 PublicKey)
    sing-box generate reality-keypair
    
    # 生成 8 位 Short ID
    sing-box generate rand 8 --hex
    
使用 Hugo 构建
主题 Stack 由 Jimmy 设计