Skip to content

GUI.for.SingBox 用户指南

欢迎使用 GUI.for.SingBox,该文档将介绍本项目基本使用指南,以降低用户使用 Sing-Box 的门槛,不再需要维护大量的 json 配置,本项目通过便捷的 GUI 操作即可生成的 Sing-Box 的完整客户端配置并运行;同时,它几乎支持 Sing-Box 作为客户端的全部特性!

软件设置项

  • Settings-Language选择语言,目前支持中英语;该 wiki 之后的介绍将基于中文语言进行说明

  • 内核缓存:生成在data/sing-box目录下,用于存储持久化 Fake-IP 数据以及远程规则集数据

  • 关闭窗口时退出程序:当点击右上角的关闭按钮时将退出主程序,将不会出现托盘图标

  • 退出程序时同时关闭内核:当关闭程序时结束 sing-box.exe 内核进程,Sing-Box 终止

  • 自动启动内核程序:当启动软件时自动启动内核

  • 以管理员身份运行:非 Windows 的Administrators用户组的系统用户建议打开该选项,否则会出现 Tun 模式无法启动核心或 Tun.stack 为systemmixed时无法修改系统网络防火墙设置

  • 开机时启动:程序跟随系统启动

  • 内核选项卡下可管理下载和更新 Sing-Box 核心程序

  • 关于选项卡可查看本项目版本信息以及在线更新

订阅设置(必须)

GUI.for.SingBox 的订阅部分只需要包含出站(outbounds)部分,格式如下

json
[
    {
        "type": "vless",
        "tag": "Proxy1",
        "server": "xxx.xxx.xxx.xxx",
        "server_port": 443,
        "uuid": "..."
        ...
    },
    {
        "type": "shadowsocks",
        "tag": "Proxy2",
        ...
    }
]

这里以手动管理方式的订阅为例,之后可以使用 GUI 进行节点管理

添加订阅.png

保存路径填写 json 文件的完整路径,建议使用相对路径,命名之后保存点一下更新,确保订阅正常显示节点数量

订阅信息.png

配置设置(必须)

新建一个配置,任意命名即可,在创建的配置上使用右键菜单可以分别设置,也可以使用向导模式一步一步进行设置!

通用设置(包含高级设置-必须):

  • 工作模式:可选全局、规则、直连三种模式,默认建议使用规则模式

  • 允许局域网访问:如果还想使用 Yacd 或 XD 面板或其它局域网使用场景,建议打开该项

  • 出站接口名称:建议选择自动

  • 混合代理端口:设置该项时会创建一个mixed类型的入站用于作为本地监听的代理服务器

  • HTTP(s)代理端口:设置了混合代理端口之后可以不用单独设置

  • SOCKS5 代理端口:设置了混合代理端口之后可以不用单独设置

  • RESTful WEB API 监听地址:用于clash_api方式的监听地址,用途是使用第三方面板,格式为server:port

  • RESTful API 密钥:API 访问 secret

  • 自定义外部用户界面下载地址:自定义下载 yacd 或 xd 面板的资源链接

  • 持久化缓存:用于记录选择的节点以及分流规则,下次重启核心无需重新设置

  • 持久化 Fake-IP:存储 Fake-IP 记录

  • TCP 快速打开:Sing-Box 的tcp_fast_open字段,用于 mixed 入站

  • 多路径 TCP:Sing-Box 的tcp_multi_path字段,用于 mixed 入站

  • UDP 分段:Sing-Box 的udp_fragment字段,用于 mixed 入站

  • 协议探测:Sing-Box 的sniff字段,用于 mixed 和 tun 入站

  • 探测域名覆盖目标地址:Sing-Box 的sniff_override_destination字段,用于 mixed 和 tun 入站

TUN 设置(非必须):

  • TUN 模式堆栈:可选SystemgVisorMixed三种,当使用Mixed时,TCP 使用System栈,UDP 使用gVisor

  • 自动设置全局路由:建议打开

  • TUN 网卡名称:可自定义

  • 最大传输单元:Sing-Box 的mtu字段,默认 9000

  • 严格路由:使用 Sing-Box 的 DNS 务必打开

  • 独立于端点的 NAT:建议打开

代理组设置(必须):

代理组列表.png

编辑相应代理组可以将自己添加的订阅节点加入该组

代理组添加节点.png

可以根据需求添加/编辑/删除代理组

路由规则设置(必须)

这里着重介绍以下最常用最实用几种,分别是Clash模式Fallback协议内联规则以及(远程)规则集

默认路由规则列表.png
  • Clash 模式global/direct、应分别设置为使用代理和直连

  • Fallback:属于 Sing-Box 的 route.final 字段,当没有命中任何规则时默认使用的 outbound

  • 协议:dns 协议使用dns-out出站为必须的,否则无法正常使用 Sing-Box 的 DNS 功能

  • 内联规则:使用多条件的复杂规则或逻辑规则时使用,可直接填写 json 内容

  • (远程)规则集:对应 Sing-Box 的 rule_set 功能,用途是将 geoip 或 geosite 需要用到的部分单独取出来,理论效率比直接使用 geoip/geosite 更高且在处理路由规则时更低的核心占用

DNS 设置(必须)

  • 本地 DNS:用于本地使用直连出站的 DNS 服务器,通常使用国内 DNS,支持 UDP53/QUIC/DoH/DoT

  • 远程 DNS:用于使用代理作为出站的目标域名的 DNS 解析,通常使用国外 DNS,支持 UDP53/QUIC/DoH/DoT

  • 本地解析 DNS:当本地 DNS使用 DoT 或 DoH 时,用于解析的 hostname,当其使用 IP 则可以不配置。仅支持 UDP53 或 hostname 为 IP 的 DoT/DoH

  • 远程解析 DNS:当远程 DNS使用 DoT 或 DoH 时,用于解析的 hostname,当其使用 IP 则可以不配置。仅支持 UDP53 或 hostname 为 IP 的 DoT/DoH

  • 回退 DNS:该选项属于 DNS 规则中的配置项,当没有命中任何 DNS 规则时使用该 outbound 作为 DNS 服务器

  • 策略:DNS 解析策略,可选优先 IPV4/优先 IPV6/只使用 IPV4/只使用 IPV6

  • Fake-IP:Fake-IP 使用开关

  • Fake-IP 排除:列表中的域名不会使用 Fake-IP (需配合 DNS 规则)

DNS 规则设置(必须)

DNS规则设置.png

DNS 规则设置和路由规则设置方法一样,需要注意 any 出站选中一个 DNS Server,以及前面提及的 DNS 设置中如果设置了 Fake-IP 排除的话,需要在 DNS 规则中启用 Fake-IP 规则。

规则集

规则集有两种方式,本地规则集和远程规则集

本地规则集

本地规则集.png

本地规则集有如下几种方式设置

远程规则集

远程规则集通常是在设置路由规则设置DNS规则设置中使用,即直接使用链接形式添加规则集

远程规则集.png

规则集获取方式

注意事项

  • 非 Administrators 用户组的用户建议打开设置-通用中的以管理员身份运行,否则无法使用 TUN 启动内核
  • 若代理节点标签(tag)使用了国旗等图标无法正常显示,请安装插件【Twemoji.Mozilla】。