图形界面负责管理配置,真正处理连接的是sing-box 核心。
客户端名称与内核名称并不总是同一回事。安装了界面后,仍要确认核心是否就绪、配置能否读取,以及当前采用的网络接管方式。
从配置关系入手,可以把 Windows 端的准备工作分成软件获取、核心初始化、文件导入和请求路径检查,逐项确认后再继续。
从核心与界面的分工开始
💡 配置前先确认:先核对现有订阅是否有效,客户端能否读取相应配置,再决定是否继续操作。服务内容可查看 服务说明入口。
在添加订阅前,先确认程序各部分承担的工作。
sing-box 用于处理代理连接与规则。图形界面提供操作入口,而核心程序需要能够正常启动并读取配置。
下面分别查看协议适配、运行条件与规则引用,不据此作不同软件的性能比较。
协议名称与配置参数对应
配置可能涉及不同协议,但能否使用取决于当前核心和字段格式。导入失败时应看具体错误,不把支持某个协议等同于能够读取所有来源的文件。
运行资源按当前设备观察
电脑上的资源占用与配置和负载有关。缺少相同环境的依据时,不给出内存比例、并发能力或耗电方面的结论。
查看规则引用的对象
请求可以根据目标或进程等条件分配。配置完成后应查看命中情况,而不是仅凭规则文件存在就认定流量已经按预期处理。
按管理需求理解界面差异
普通用户可以通过图形界面管理配置,但界面提供哪些选项、如何调用核心,需要分别确认。
管理界面可以侧重简化操作,也可以集中展示配置选项。选择时先看现有文件和管理需求,再核对界面能够读取的内容。
偏重简化操作的界面
- 管理方式:将常用动作集中展示,使用前仍需要确认配置格式和运行状态。
- 检查重点:查看导入、激活与连接开关分别处于什么状态,不把步骤少当作连接成功的保证。
偏重配置管理的界面
- 管理方式:可提供订阅、策略与规则的管理入口。操作前先区分当前编辑的内容与实际运行配置。
- 检查重点:了解规则的引用关系和接管权限,再逐项处理需要的设置,不使用性能释放比例作承诺。
下文按 GUI.for.SingBox 的界面入口整理操作,菜单名称以当前程序为准。
获取程序后先检查运行条件
⚠️ 查看文件来源:从项目发布信息核对文件,避免仅凭名称相近就运行其他来源的修改程序。
对照项目发布条目
- 从已有项目说明确认发布入口,查看
项目发布记录 - 中与 Windows 环境相符的文件。
- 名称可能包含
Windows 架构标识,应与设备信息相互核对,不按使用比例选包。
解压后核对应用文件
- 将已确认来源的
.zip解压到便于管理的位置。路径问题应结合项目要求处理,例如先明确程序所在目录,再排查访问或写入错误。 - 找到解压目录中的
GUI.for.SingBox.exe,核对文件来源后再打开。 - 系统若阻止运行,应先查看提示中关于来源和签名的信息,再阅读 详细信息 。确认文件可信之前,不直接使用 绕过拦截 的选项继续操作。
确认核心能够初始化
界面可以打开,并不代表代理核心已经安装。先查看核心管理状态,再尝试启动连接。
- 在程序中找到 设置。
- 进入 核心管理 页面。
- 若当前缺少核心,使用 下载或更新核心的入口,并查看获取结果。
- 确认核心文件存在且界面能够识别,再继续添加配置。
把订阅读取与配置激活分开
远程配置提供连接参数与规则。添加前先确认格式适配,添加后还要查看它是否成为当前运行配置。
在账户中确认配置类型
查看服务账户提供哪些格式,并对照当前界面的读取要求;不要假定所有订阅都可直接导入。
- 对应 sing-box 的格式:确认入口说明和实际文件内容是否一致。
- 需要转换的其他格式:先了解界面是否支持相应处理。格式转换可能产生不兼容字段,完成后仍需核对结果。
将地址加入配置列表
- 在界面中打开 订阅管理。
- 使用 新建 入口。
- 分别填写识别名称和资源地址。
- 名称:用能区分用途的备注,例如
日常配置。 - 地址:填入已经确认格式的完整远程地址。
- 自动更新:按需要安排,不使用统一的刷新周期保证节点始终有效。
- 名称:用能区分用途的备注,例如
- 确认后使用 保存。
下载结束后再激活
- 在新建条目中找到 更新 操作。
- 查看日志是否显示读取完成,区分下载失败与文件解析失败。
激活配置:确认内容成功读取后,再选择 启用当前配置,并查看运行状态是否随之改变。
让请求进入预期的接管路径
核心启动后,浏览器和其他应用是否使用代理,取决于接管设置。需要虚拟网卡时,可查看 TUN的运行条件。
区分系统代理与虚拟网卡
有些程序不会采用系统代理设置。需要扩大接管范围时,可以检查配置是否支持建立虚拟网卡,并核对它处理哪些请求。其他桌面配置方式也可参照 桌面接管设置说明 ,再与当前环境比较。
开启之前先核对权限
运行权限:TUN 可能需要修改系统网络。退出程序后,可根据项目要求确认 GUI.for.SingBox.exe是否需要 管理员权限才能启动相应功能。
- 在界面中进入 设置 ,找到 网络与 TUN区域。
- 确认配置条件后使用 启用 TUN 选项。
路由复查:查看规则是否安排了 局域网与本地目标直连,再分别检查本地应用和外部网页,不从模式名称推定所有请求都已正确分流。
- 回到 主页面,使用 启动 入口,并留意日志变化。
选择需要访问的 网页 与 应用分别检查,确认成功的是具体请求,而不是仅有核心运行状态。
从策略与连接列表理解当前状态
界面中的列表可以帮助定位请求去向,各项显示结果应结合配置理解。
节点列表:打开 代理管理,核对候选项与当前选择。连通检查可以作为线索,但不能替代所需应用的实际访问。
组内选择:在 Proxy 或其他 Select 类型的组内选择候选节点后,确认相关规则确实引用该组,再查看请求表现。
连接记录:在 主页面 或 连接列表 中查看进程与目标,帮助确认是否存在未按预期处理的请求。
常见疑问与格式补充
保留出错提示,再区分配置获取、核心启动与网络接管各环节。
问:获取配置时提示 Fetch error 或 Timeout,怎样继续检查?
- 先分清环节:配置下载失败不等于节点已失效,应先确认基础网络和资源地址能否读取。
- 再比较接入网络:在另一种接入方式下复查同一配置,记录错误是否变化,再决定继续查本地网络还是配置来源。
问:核心已启动,节点却显示 Error ,需要检查什么?
- 查看系统条件:先确认设备时钟和时区,再核对账户、配置与日志。不把所有协议的连接失败都归因于同一种时间误差。
- 查看自动校时:在系统中使用
日期与时间设置查看自动校时状态,需要时执行 立即同步,再观察报错是否改变。
问:出现端口或套接字权限错误,例如 bind 或 socket permission 错误,如何定位?
- 查看端口占用:先确认是否有其他代理或应用正在使用相同监听端口,同时查看当前程序的权限提示。
- 保留配置后调整:退出不需要的代理程序;确需更换监听端口时,应选择
当前环境未被占用的端口,并同步核对系统代理指向。
格式补充:文件无法被当前核心读取
- 查看具体字段:JSON 只是文件表达方式,来自其他内核的配置未必可直接使用,应根据错误确认不兼容位置。
- 核对适配来源:优先确认服务是否提供对应格式。若使用
订阅转换,先看其输入输出与隐私条件,再核对生成内容是否符合当前核心要求。
使用时保留清楚的配置层次
程序界面、核心文件和运行配置应分别管理。基础连接确认后,再启用需要的规则与网络接管功能;发生异常时按层次回查,避免反复覆盖配置。
服务条件另行核对:客户端能够启动,不代表服务账户和应用访问条件已经满足。
如需确认当前订阅是否提供 所需协议 及 对应配置 ,可以查看 服务说明入口,并将格式、配额和限制逐项对应。
配置保留提醒:修改前留存当前文件和接管设置,便于异常时恢复已经确认可用的状态。
继续定位连接故障:配置导入后仍不能连接,可接着阅读《从超时提示追查网络故障》。
项目文档和服务条款

界面中的菜单名称可能发生变化。操作时将软件内的选项与项目说明相互参照,遇到不同之处先确认当前界面的含义。
服务条款提醒: 服务的使用范围、付款条件与限制,以商家页面为准。