在配置 Sing-box 客户端时,开启 TUN 模式(虚拟网卡模式) 是实现全系统流量接管的“终极方案”。
但对于开发者而言,TUN 模式接管系统全局路由表后,极易导致 WSL2 无法连网、Docker 镜像拉取超时、Localhost API 阻断以及 Git SSL 证书报错。
今天,我们将彻底厘清这些开发环境冲突,并给出 2026 最强 Sing-box TUN 优化配置!
[!NOTE] 📌 核心速览(TL;DR / 快问快答):
- WSL2 终极解法:在
~/.wslconfig配置networkingMode=mirrored(镜像网卡模式),让 WSL2 与宿主机共享网络,彻底杜绝 TUN 网卡冲突。- Docker & 局域网豁免:在 Sing-box 的
route.rules中必须为127.0.0.0/8、172.16.0.0/12(Docker 网段)及192.168.0.0/16强制指定"outbound": "direct"。- Git SSL 报错:针对 GitHub 单独配置全局代理
git config --global http.https://github.com.proxy socks5://127.0.0.1:7890,避免全局证书链冲突。
🛠️ Sing-box TUN 模式开发环境豁免配置模板
在 Sing-box 客户端 config.json 的 inbounds 与 route 模块进行加固:
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"interface_name": "singbox-tun",
"auto_route": true,
"strict_route": true,
"address": ["172.19.0.1/30"]
}
],
"route": {
"rules": [
{
"ip_cidr": [
"127.0.0.0/8",
"10.0.0.0/8",
"172.16.0.0/12",
"192.168.0.0/16",
"169.254.0.0/16"
],
"outbound": "direct"
},
{
"domain": ["localhost"],
"domain_suffix": [".local"],
"outbound": "direct"
}
],
"final": "proxy"
}
}
🧠 先理解冲突的根源:TUN 到底干了什么
TUN 模式会创建一个虚拟网卡并接管系统路由表,所有流量先经过 Sing-box 再决定走代理还是直连。问题就出在”所有”二字上:
- WSL2 自己有一套虚拟网卡和 NAT,TUN 抢了默认路由 → WSL2 内网络不通。
- Docker Desktop 的网段(
172.16.0.0/12)被 TUN 吃掉 → pull 镜像超时。 - 本地开发的
localhost:3000被送进代理 → 本地服务”失联”。
解法思路统一:把不该代理的流量,在 route 最前面豁免掉。
🖥️ stack 参数:1.15 已废弃,直接删掉
旧教程里常见的 "stack": "system"(或 gvisor/mixed)在 1.15 已被废弃,1.17 将彻底移除。官方说法:新版 sing-tun 自带 TCP/IP 栈,性能、能效、内存占用全面优于旧实现。
现在的做法:stack 字段整个删掉,不用选。如果你的配置里还有它,删掉即完成迁移。
Windows 上 UWP 应用(微软商店)连不上,优先检查 TUN 的 auto_route/strict_route 和回环豁免,而不是折腾 stack。
🐧 WSL2 详解:mirrored 模式有版本门槛
networkingMode=mirrored 需要 Windows 11 22H2 及以上。如果你的系统版本不够,老方案是:
- WSL2 里手动设置代理:
export https_proxy=http://$(宿主机IP):7890 - 宿主机 IP 从
/etc/resolv.conf的 nameserver 取(NAT 模式下)
mirrored 模式开启后,WSL2 和宿主机共享同一套网络,Sing-box 的 TUN 规则直接生效,curl 不用任何额外配置。
🐳 Docker Desktop 冲突的完整处理
除了 route 里豁免 172.16.0.0/12,还有两个坑:
- Docker Desktop for Windows 自带 WSL2 后端:先确认 WSL2 网络已解决(见上节),否则 Docker 里的容器同样断网。
- 改完 route 规则要重启 Docker 服务:Docker 启动时会缓存 DNS 和路由,规则生效后重启一次 Docker Desktop 最稳。
🔍 排查方法论:流量到底走了哪条规则
怀疑某条流量被误代理?开 debug 日志看命中:
{ "log": { "level": "debug", "timestamp": true } }
日志里会打印每条连接命中的 rule。配合二分法:先把可疑规则逐条注释,定位到具体哪条再修,比瞎改快得多。
Q1: 开启 TUN 模式后,本地运行的 MySQL/Redis 数据库连不上怎么排查?
答:请确保在 route.rules 中已经将 127.0.0.0/8 与 localhost 显式划归给 direct 直连。严禁将 localhost 写入 dns.fakeip 范围。
Q2: 在 Windows 11 下,WSL2 如何开启镜像网卡模式?
答:在 Windows 用户根目录编辑 .wslconfig,写入 [wsl2] networkingMode=mirrored,随后在 cmd 执行 wsl --shutdown 重启即可无缝共享宿主机 Sing-box 代理。
Q3: 手机投屏 / NAS 内网传输变慢,是 TUN 的锅吗?
答:大概率是。把 192.168.0.0/16 和 224.0.0.0/4(组播,投屏发现用)加到 direct 豁免。智能家居的 mDNS(224.0.0.251)被代理会导致设备”失踪”,这条最容易被忽略。
Q4: TUN 和系统代理模式该用哪个?
答:日常办公用系统代理就够了,省电、兼容性好;需要接管所有流量(终端、游戏、UWP)再开 TUN。两者可以共存:TUN 处理全局,浏览器单独配系统代理做补充。
(总纲阅读:《Sing-box 高效配置与出站路由全解析》,五大模块逐个拆解。) (相关资源导航:如果您需要拉取 npm、pip 或 Docker 镜像的高速专线网络,推荐阅读 《“饿饭CC云”深度评测》;自建 VPS 选购指南见 《2026 国外 VPS 选购指南》!)