sing-box Windows怎么设置系统代理?配置、验证与失效排查
简答:在 Windows 上,最直接的方法是在 sing-box 配置中使用 mixed 或 HTTP 入站,并将 set_system_proxy 设置为 true;启动 sing-box 后,它会自动设置系统代理,停止时清理。先确认本地监听地址和端口,再到 Windows“设置→网络和 Internet→代理”检查开关是否已打开。若命令行启动有效、Windows 服务启动无效,优先改用当前登录用户启动并暂不使用服务模式。
定义:sing-box Windows 系统代理,是让 sing-box 自动把本地 HTTP 或 mixed 入站地址写入 Windows 用户代理设置,使遵循系统代理的软件通过 sing-box 连接。
先试这一步:用 mixed 入站自动开启 Windows 系统代理
本文是第三方使用指南,页面事实按 2026-11-11 检索到的 sing-box 与 Microsoft 文档整理。若你已经有可用的 sing-box 出站和路由配置,不必先改动其他部分,只需要确认入站部分包含本地监听地址、端口和 set_system_proxy。
| 检查项 | 应填写或观察的内容 | 成功判据 |
|---|---|---|
| 入站类型 | mixed 或 http | 配置结构与 sing-box 文档中的入站类型一致 |
| 监听地址 | 优先使用 127.0.0.1 | 仅本机应用访问,不把代理端口直接暴露到局域网 |
| 监听端口 | 例如 2080,以你的配置为准 | 该端口没有被其他程序占用 |
| 系统代理字段 | set_system_proxy: true | 启动时 Windows 代理开关或代理地址发生变化 |
| 启动方式 | 优先从当前登录用户的命令行启动 | 停止 sing-box 后系统代理能够自动清理 |
官方配置文档说明,mixed 入站同时提供 SOCKS4、SOCKS4a、SOCKS5 和 HTTP 服务;其 set_system_proxy 字段支持 Windows,启动时自动设置系统代理,停止时自动清理。sing-box Mixed 入站文档(访问日期:2026-11-11)
可先把下面这几个字段加入你现有的 inbounds 数组。这里只展示最小入站片段,不代表完整的 sing-box 配置文件:
{"type":"mixed","tag":"mixed-in","listen":"127.0.0.1","listen_port":2080,"set_system_proxy":true}
如果你只需要 HTTP 入站,也可以使用 type: http,并保留相同的 listen、listen_port 和 set_system_proxy 字段。HTTP 入站文档同样明确标注该字段支持 Windows。sing-box HTTP 入站文档(访问日期:2026-11-11)
- 打开你的 sing-box 配置文件,找到
inbounds数组。 - 确认入站类型是
mixed或http,并把监听地址设为127.0.0.1。 - 记下
listen_port,例如2080;如果端口冲突,换成未被占用的端口。 - 将
set_system_proxy设置为true,保存配置。 - 从当前登录用户的命令行启动 sing-box,观察是否出现配置解析错误或端口占用错误。
- 打开 Windows“设置→网络和 Internet→代理”,检查“手动设置代理”区域的状态、地址和端口。
Windows 官方说明,手动代理设置位于“设置→网络和 Internet→代理”,需要填写代理服务器地址和端口;因此,若 sing-box 没有自动写入系统代理,也可以暂时在这里手动填写 127.0.0.1 和你的本地端口进行定位。Microsoft:在 Windows 中使用代理服务器(访问日期:2026-11-11)
图形客户端与命令行配置,应该选哪一种?
Windows 上需要先区分“sing-box 内核”和“图形客户端”。官方桌面客户端页面说明,sing-box for Desktop 可以管理并运行本地或远程配置文件,也提供平台相关功能,例如 TUN 透明代理;它支持 Windows 10 及更高版本。sing-box for Desktop 文档(访问日期:2026-11-11)
| 方式 | 适合谁 | 操作重点 | 注意事项 |
|---|---|---|---|
| 图形客户端 | 不想手动编辑 JSON 的用户 | 导入或打开配置,在当前客户端界面查找系统代理开关 | 不同客户端菜单名称和功能范围可能不同,未核实的菜单路径不要照抄 |
| 原生配置文件 | 需要明确控制端口、入站和启动行为的用户 | 在 mixed 或 http 入站中设置 set_system_proxy: true | JSON 语法、出站、路由和端口都必须有效 |
| Windows 服务 | 需要后台运行的用户 | 先确认当前用户模式已经成功,再考虑服务化 | 服务账户与当前登录用户不同,可能导致系统代理写入失败 |
如果你使用图形客户端,先打开当前客户端的配置管理页面,确认配置已经加载,再查找名称接近“系统代理”“System Proxy”或“代理开关”的选项。由于不同客户端的界面并非 sing-box 核心统一规定,本文不把某个未核实的按钮路径写成固定步骤。开启后仍应回到 Windows 代理设置页面和实际应用中复测。
如果图形客户端只开启了 TUN,而 Windows 系统代理开关没有变化,这不一定代表配置失败。系统代理和 TUN 是两条不同路径:系统代理依赖应用遵循 Windows 代理设置;TUN 则通过虚拟网卡或平台网络能力接管更多流量。需要解决的是“Windows 系统代理”,优先检查入站中的 set_system_proxy,不要把 TUN 开关当成同一个选项。
如何确认系统代理真的生效?
不要只看任务栏图标或客户端状态,建议按“地址—端口—应用—回滚”四步确认。
- 确认监听。检查配置中的地址是否为
127.0.0.1,端口是否与 Windows 代理设置中的端口一致。 - 确认 Windows 设置。进入“设置→网络和 Internet→代理”,查看手动代理是否启用,以及代理地址和端口是否对应 sing-box 入站。
- 确认应用行为。用一个明确遵循系统代理的浏览器页面进行测试;如果浏览器可用,但某个终端、游戏或专业软件不可用,先不要立即判断 sing-box 失败。
- 确认停止行为。停止 sing-box,再回到 Windows 代理页面检查代理是否被清理。官方文档对
set_system_proxy的定义就是启动时设置、停止时清理。
Windows 的系统代理不是“所有软件强制经过代理”的总开关。Microsoft 文档指出,具体应用是否使用代理取决于应用采用的代理配置方式;部分应用可能需要在自身设置中单独配置。Microsoft:配置 Windows 代理服务器设置(访问日期:2026-11-11)
因此,出现“浏览器能用、终端不能用”时,应分别检查该软件是否读取 WinINet 或 Windows 用户代理设置、是否单独配置了代理,以及是否使用了自己的网络栈。不要为了让单个软件生效,直接扩大监听地址或盲目切换到 TUN。
系统代理开启但无法联网:按现象排查
| 现象 | 先检查 | 处理与回滚 |
|---|---|---|
| 系统代理没有打开 | set_system_proxy 是否拼写正确,入站类型是否为 mixed 或 http | 修正字段后重启 sing-box;停止程序并手动关闭 Windows 代理作为回滚 |
| 端口被占用 | sing-box 日志和端口是否已被其他客户端使用 | 换一个本地端口,并同步更新 Windows 代理设置 |
| 代理打开但网页无法访问 | 出站、路由、节点或 DNS 是否正常 | 先测试直连或已有可用出站,再恢复原路由配置 |
| 浏览器正常,终端或游戏不通 | 目标软件是否遵循系统代理 | 在目标软件内单独配置代理;不要据此断定系统代理未生效 |
| 命令行正常,服务模式无效 | 服务运行账户是否是当前登录用户 | 先停止服务,改用当前用户启动;确认成功后再设计后台运行方案 |
Windows 服务模式要特别谨慎。sing-box 项目曾有 Windows 服务启动时 set_system_proxy 无法生效的公开 Issue;讨论中区分了当前用户的 WinINet 代理设置与服务账户环境,并指出直接从 CMD 启动和以服务方式启动的行为可能不同。该 Issue 不是所有系统都会复现的结论,但足以说明:服务模式不应作为第一次排障的起点。SagerNet/sing-box:Windows 服务模式下 set_system_proxy 问题(访问日期:2026-11-11)
- 先关闭现有 sing-box 服务或后台进程。
- 在当前登录用户的命令行中启动同一份配置。
- 检查 Windows 代理地址和端口是否发生变化。
- 用浏览器复测,再停止 sing-box,确认系统代理是否恢复。
- 只有当前用户模式稳定后,才继续排查服务账户、权限和用户配置环境。
如果你误把 WinHTTP 代理当成 Windows 用户系统代理,也可能得到不一致的结果。Microsoft 文档说明,netsh winhttp 用于配置和查看 WinHTTP 代理;它与常规用户代理设置并不是同一个配置范围。除非你明确要排查依赖 WinHTTP 的程序,否则不要把 netsh winhttp set proxy 当作 sing-box 系统代理的首选设置方法。Microsoft:Windows Update 客户端使用哪种代理(访问日期:2026-11-11)
停止 sing-box 后如何恢复 Windows 代理?
正常情况下,使用 set_system_proxy: true 的入站在 sing-box 停止时会自动清理系统代理。若 Windows 代理仍然保持开启,按以下顺序恢复:
- 确认 sing-box 进程已经退出,而不是只关闭了窗口。
- 打开“设置→网络和 Internet→代理”。
- 关闭“使用代理服务器”,或清空由 sing-box 写入的本地地址和端口。
- 如果你之前手动启用了 PAC 或“使用设置脚本”,检查“自动代理设置”区域,避免旧脚本继续接管请求。
- 重新打开浏览器或目标应用,再测试直连。
回滚时不要同时修改 DNS、MTU、TUN 和路由规则。一次只恢复系统代理,可以更快判断问题来自 Windows 代理状态还是 sing-box 的出站、规则和 DNS。
常见问题
sing-box Windows系统代理必须使用 mixed 入站吗?
不必须。官方文档显示,HTTP 入站和 mixed 入站都支持 set_system_proxy,并支持 Windows。mixed 同时提供 SOCKS 与 HTTP 服务,适合需要兼容多种本地代理协议的场景;只需要 HTTP 时可以选择 HTTP 入站。
为什么 set_system_proxy 写了 true,Windows 代理还是没有打开?
先检查配置是否成功加载、入站类型是否为 mixed 或 http、端口是否冲突,以及 sing-box 是否由当前登录用户启动。若使用 Windows 服务,服务账户与当前用户不同可能造成用户代理设置无法按预期写入,建议先改用当前用户命令行复测。
系统代理开启后,为什么游戏或终端仍然不能联网?
系统代理只对遵循 Windows 或应用自身代理设置的软件生效。游戏、终端和部分专业软件可能使用独立网络栈或单独代理配置。先确认浏览器能否通过代理,再查看目标软件是否提供独立的 HTTP、SOCKS 或代理设置。
停止 sing-box 后 Windows代理还在,怎么处理?
先确认 sing-box 进程已经完全退出,再打开“设置→网络和 Internet→代理”,关闭手动代理并检查自动代理设置或脚本。不要同时修改 DNS、TUN 和路由配置,以免增加回滚难度。
系统代理和 TUN 模式有什么区别?
系统代理是把 HTTP 或 mixed 入站地址写入 Windows 代理设置,应用是否使用取决于其代理支持;TUN 是另一种基于虚拟网络接口的接管方式。本文目标是 Windows 系统代理,优先排查 set_system_proxy 和入站端口。