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 为system或mixed时无法修改系统网络防火墙设置
开机时启动：程序跟随系统启动
内核选项卡下可管理下载和更新 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 进行节点管理

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

配置设置(必须)

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

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

工作模式：可选全局、规则、直连三种模式，默认建议使用规则模式
允许局域网访问：如果还想使用 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 模式堆栈：可选System、gVisor、Mixed三种，当使用Mixed时，TCP 使用System栈，UDP 使用gVisor栈
自动设置全局路由：建议打开
TUN 网卡名称：可自定义
最大传输单元：Sing-Box 的mtu字段，默认 9000
严格路由：使用 Sing-Box 的 DNS 务必打开
独立于端点的 NAT：建议打开

代理组设置(必须)：

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

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

路由规则设置(必须)

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

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

规则集

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

本地规则集

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

使用远程链接下载 srs 格式的 binary 规则集或 json 格式的 source 规则集
使用本地创建 json 格式的 source 规则集，格式参考源文件格式 - sing-box和无头规则 - sing-box

远程规则集

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

规则集获取方式

注意事项

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

GUI.for.SingBox 用户指南 ​

软件设置项 ​

订阅设置(必须) ​

配置设置(必须) ​

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

TUN 设置(非必须)： ​

代理组设置(必须)： ​

路由规则设置(必须) ​

DNS 设置(必须) ​

DNS 规则设置(必须) ​

规则集 ​

本地规则集 ​

远程规则集 ​

规则集获取方式 ​

注意事项 ​