P 机场推荐与网络诊断
iOS Android macOS Windows Linux

Sing-box 配置与排障手册

性能极致、低内存开销、原生支持 Shadowsocks 2022、VLESS Reality 与 Hysteria 2

官方发布入口与版本要求

内核:原生 Go 现代化通用网络内核 · 推荐版本:1.9.0 以上通用稳定版
前往官方发布源下载 →

安全提醒:iOS 请在非国区 App Store 搜索 sing-box 下载;Android 可通过 GitHub Releases 或 Google Play 获取。

图文配置与订阅导入流程

1 1. 获取与安装客户端

在对应平台安装 Sing-box 官方图形客户端。移动端授权 VPN 配置文件添加权限。

2 2. 添加 Profiles 订阅

点击 Profiles -> New Profile,选择 Type 为 Remote,将服务商提供的 Sing-box 原生订阅 URL 填入并保存。

3 3. 更新并切换策略

点击 Fetch / Update 拉取最新节点配置。在 Dashboard 中启动主开关,并在 Groups 中挑选目标节点。

4 4. 验证分流与出口

使用本站 [/lab/public-ip/](/lab/public-ip/) 验证当前访问的公网出口 IP 是否与所选节点地区一致。

常见报错排障与修复建议

⚠️ 配置报错 parse config: rule_set decode error

解决办法:这是规则集版本与内核版本不匹配导致。更新客户端到最新稳定版(>=1.9.0),并在配置中更新 remote rule_set。

✓ 配置完成后的连通性验证

导入订阅并开启代理后,请立即运行本站的 HTTP 请求耗时测试与公网出口 IP 检查,确认请求正常返回且出口地区与节点一致。

Sing-box 进阶网络机制:系统代理 vs TUN 虚拟网卡深度剖析

搞懂为什么终端命令(curl/git)不走代理,以及如何利用 TUN 模式实现全流量接管。

1. 普通系统代理(System Proxy)的局限

普通模式下,客户端仅在操作系统设置中配置了一个本地 HTTP/Socks5 监听端口(如 127.0.0.1:7890)。这种模式仅对主动遵循系统代理设置的应用程序生效(如 Chrome、Edge、Firefox)。

而像终端命令行(Terminal / CMD)、Git 拉取、Docker 镜像下载、Steam/Epic 外服联机游戏以及部分后台守护进程,默认完全忽略系统代理,数据包仍然直接向公网发起直连,导致频繁报 Connection Timeout 错误。

2. TUN 虚拟网卡模式(TUN Mode)的解决机制

开启 TUN 模式后,Sing-box 会在操作系统内创建一个虚拟三层网卡接口,并修改系统默认路由表,将主机上所有应用程序的 TCP/UDP IP 报文强制接管。

  • 真正全局生效:无需在终端敲 export http_proxy,命令行与开发工具自动享受代理加速;
  • UDP FullCone 支持:解决 Discord 语音断断续续、外服游戏联机 NAT 类型受限(Strict NAT)的问题;
  • DNS 防污染:配合 Fake-IP 机制,操作系统在本地即可瞬间响应一个虚构 IP(如 198.18.0.x),将真实 DNS 解析交给远端节点处理,彻底杜绝 DNS 劫持。

3. 常见报错代码与速查自愈表

错误代码/日志提示 根本原因 一分钟修复方案
EOF / Connection Reset 节点入口断开或遭遇运营商 TCP RST 干扰 在节点列表中切换至同组备用专线节点,手动更新订阅
TLS Handshake Timeout 晚高峰骨干网丢包过高导致 TLS 握手无法完成 将直连/普通中继切换为 IEPL 内网专线节点
Proxy Loopback Detected 代理客户端把自身的外部流量又路由进了自身 关闭多开的二次代理软件,重置系统默认路由规则