自建 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:
- 进入 Compute(计算) → Instances(实例),点进对应实例,打开 Networking(网络) → Attached VNICs(附加的 VNIC) 中的主网卡。
- 进入 IP administration(IP 管理),点击主私有 IP 右侧菜单 Edit(编辑),选择 No public IP 并更新释放旧 IP。
- 再次点击 Edit(编辑),选择 Ephemeral public IP(临时公网 IP) 重新分配。
- 拿到新 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)。 - 配置变更流程:
- 修改服务端
config.json的inbounds[].listen_port(如改为38443)。 - 按照下文「场景 C」在云控制台安全列表及 VPS 本机防火墙放行该端口。
- 重启
sing-box服务,并同步更新本地客户端配置中的节点端口。
- 修改服务端
场景 C:Ubuntu iptables 放行新端口的正确姿势
换用新高位端口(以 38443 为例)时,必须同时对齐三个位置:云控制台安全列表 + 本机 iptables + sing-box 监听端口,缺一不可。
- 必须用插入(
-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。)
- 避免
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。)
- 三位一体最终验收
修改
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"
}
}
关键特性解析与生成命令:
- 双协议分工:
- VLESS-REALITY (TCP 38443):主力稳定穿透,无需申请自签或 CA 证书,直借三星官网 SNI,关闭了易漂移的
max_time_difference。 - Hysteria2 (UDP 48443):弱网对抗与高峰期加速利器(需自备域名和证书路径)。
- VLESS-REALITY (TCP 38443):主力稳定穿透,无需申请自签或 CA 证书,直借三星官网 SNI,关闭了易漂移的
- DNS 无状态兜底:使用
type: "local"与strategy: "ipv4_only",避开基于 TCP/HTTPS 的 DoH 被云厂商或对端 NAT reset 的致命陷阱。 - VPS 滥用风控规避:出站路由默认拒绝对外发送 25 端口邮件(防垃圾邮件封机)、阻断 BT 种子下载(防版权投诉封号)及局域网私有 IP 探测。
- 服务端快速生成相关参数:
# 生成 UUID sing-box generate uuid # 生成 REALITY 密钥对(获取 PrivateKey 与 PublicKey) sing-box generate reality-keypair # 生成 8 位 Short ID sing-box generate rand 8 --hex