从剪贴板导入分享链接

在非输入框区域按 Ctrl+V,或使用剪贴板导入菜单。客户端会尝试 Base64 和明文解析。HTTPS 地址优先作为订阅处理,随后识别标准协议链接、SIP008、WireGuard、内部分享格式、多条或单条 Xray / sing-box 配置,再尝试 Clash / Hysteria 自定义配置。

无法解析时检查完整内容、前缀和格式,避免把包含订阅链接的网页正文一起复制。若光标位于输入框,Ctrl+V 只会把文本粘到该输入框。

自定义配置与 Socks 端口

完整配置可能使用不同核心,客户端不能可靠地推断其 Socks 监听端口。填写“自定义配置的 Socks 端口”后,会额外启动 Xray 或 sing-box 前置服务,先分流,再把流量转发到这个端口。

若完整配置已负责入站和路由(如通常的 mihomo 配置),可不填此前置端口。此时客户端更接近服务启动器,系统代理与其他应用的代理端口必须和自定义文件一致,不能默认使用界面显示的混合端口。

订阅分组字段

分组可以单独保存来源,也可以合并相同格式的内容。保存后需要执行更新,过滤和请求设置才会应用到新获取的内容。

字段行为
可选地址 / 更多地址主 URL 放可选地址;其他 URL 用逗号分隔。合并时类型应一致,更多地址非空会停用订阅转换
别名正则过滤更新后只保留匹配的别名;空结果先检查表达式
订阅转换目标类型经转换服务获取内容;多地址合并时不生效
User Agent默认 v2rayN/版本号,可能影响提供方返回格式
自定义 HTTP 标头7.25.6 新增;只填写提供方要求的请求头,认证值属于敏感信息
前置 / 落地代理别名引用唯一的现有配置名称
自定义配置的 Socks 端口订阅被解析成自定义配置时,将此端口写入配置项

更新订阅时发生什么

客户端先检查分组是否启用更新,再获取地址内容,必要时转换或合并,然后解析配置。活动项属于本组时会重新处理活动项,并整理已有流量统计;延迟和速度结果会清空。

更新失败先看下载失败还是解析失败。前者检查访问路径、代理节点和认证;后者检查内容格式、过滤条件和 User Agent。保留一个独立可用配置,避免订阅暂时失败后没有可用代理。

混合监听与关联端口

本地混合端口同时接受 HTTP 与 SOCKS5。若修改基准端口,应同时确认偏移端口未被其他程序占用,并同步修改手工配置代理的应用。

用途相对基准端口
第二本地监听+1
局域网监听+2
PAC 服务+3
Xray API+4
mihomo API+5
临时测试配置+21

基础连接设置

routeOnly 让嗅探结果用于路由判断,避免不适当地替换连接目标;sing-box 中强制启用。REALITY、ECH 等可能使用不同于实际目标的 SNI,调整此项需结合当前配置。

Mux 仅对客户端支持的 VLESS、VMess、Shadowsocks、Trojan 配置生效;sing-box 还需选择复用协议。7.25.6 已在核心设置界面提供 Mux 设置。

“日志存到文件”把核心输出保存到 guiLogs;未启用时主要查看信息栏。分片在代理链下可能达不到预期。多网卡可绑定网口和本地出站地址,但双核心 TUN 的自动路由可能影响地址绑定。

启动、更新与证书来源

开机启动需要 TUN 时,应按客户端要求设置相应权限。仅普通代理使用不必为此改变权限。托盘配置列表超过数量限制时会隐藏切换列表,并非节点丢失。

设置说明
Geo 自动更新间隔单位小时,0 表示关闭自动更新
测速分批数量每批最多 1000;较小批次可降低资源压力
根证书提供者 system使用系统信任的根证书
根证书提供者 mozilla / chrome使用相应根证书列表验证客户端下载及获取证书的请求
日志 / 临时文件清理7.25.6 默认保留 7 天,排查时及时保存相关片段

UDP 测试地址

UDP 测试仅说明节点到指定测试服务的连通情况,不等同于所有游戏或视频服务可用。测试目标不可达也会造成失败,应换一个已知可达目标交叉验证。

协议客户端验证范围
ntp响应头
dns响应帧与结构
stun响应头
mcbeMinecraft Bedrock 响应帧、结构和负载

系统代理例外与协议

例外 / 忽略列表中的地址不会使用系统代理,多个条目用逗号分隔。留空会恢复客户端默认值,不能用空字符串表示“没有例外”。

Windows 高级代理协议选项用于特定应用的特殊需求;普通使用保持默认即可。应用有独立代理设置时,应同时核对该应用自己的配置。

TUN:协议栈、MTU 与排除路由

TUN 通过虚拟网络接口接收流量,需要系统权限与可工作的核心。先确认普通代理可用,再开启 TUN;避免同时运行多个修改默认路由的工具。

可选协议栈为 system、gvisor、mixed;Wiki 记录默认 gvisor,正常使用时可尝试 mixed。Xray 仅支持 gvisor。MTU 默认 9000,属于虚拟接口参数;尝试更大值后出现连接异常,应降低并复测,不要与物理网卡 MTU 混淆。

启用自动路由后,可在排除地址中填写不进入 TUN 的 CIDR 网段,多个值用逗号分隔,例如 192.168.1.0/24。范围应只包含需要保留直连的网络。

TUN 的 ICMP 策略

sing-box 支持以下策略;Xray 对 ICMP 采用 reply,因此极低的 ping 延迟可能只是本地回复,不能当成远程代理延迟。当前说明中只有 WireGuard 支持 ICMP 转发,其他代理协议会回退到 reply。

值行为
rule按规则匹配;未匹配直连,代理能力不足时回退回复
direct全部 ICMP 直连
unreachable返回不可达
drop丢弃
reply返回 echo 响应

固定证书与获取证书链

固定证书将验证限定到指定证书,配置前应从可信来源确认指纹或证书链。Xray 的 SHA-256 指纹字段可用 ~ 分隔多个值;该界面字段在 sing-box 中会被忽略。完整证书链使用 PEM 内容,可包含多个证书。

“获取证书 / 获取证书链”会连接目标并验证返回链。地址不可达、自签证书、未知 CA 或本地信任问题都可能导致获取失败。不要把获取失败直接视为需要关闭验证;应先核对地址、SNI、系统时间及预期证书。证书更新后,固定值也需按可信来源更新。

策略组与子配置项

Xray 支持最稳定、最低延迟、负载均衡和随机;sing-box 支持最低延迟,并可在当前代理页的 Selector 组手动选择出口。“故障转移”使用 5000ms 高容差的最低延迟策略,不是按列表逐个顺序切换。

子配置项一按订阅分组和别名正则选择,更新订阅时会自动刷新成员。子配置项二手工选择配置,可嵌套其他组;订阅节点更新时可能被移除,因此更适合自建、稳定的非订阅配置。两类成员会合并,所有成员必须被组使用的核心支持。

链式顺序与 Core 类型

链式代理按实际流量方向排列:第一个节点是前置,最后一个是落地。设置 Core 类型时,当前配置项的选择优先于全局 Core 类型;改变全局值后,已显式指定核心的节点不会跟随改变。

出现“不支持协议”时检查整条链和策略组成员,不要只检查当前显示的主节点。

代理链操作步骤

路由设置与导入

首次启动已生成默认规则集。“一键导入规则集”会新增默认规则,不会替换已有内容;适用于发布说明要求更新默认规则的情况。规则也可从文件、剪贴板或可选订阅 URL 导入。

规则按顺序匹配;Domain、IP、进程名三类建议一条只填一类,再与 Port、Protocol、InboundTag、network 组合。域名解析策略与规则集配合,修改后用日志确认结果。Windows 可给规则集指定 PNG 托盘图标,该图标会覆盖系统代理状态图标。

完整路由用法

自定义 sing-box rule-set

rule-set 设置使用 JSON,可同时引用本地与远程规则。tag 必须与路由引用一致;本地文件需要存在,远程 URL 需要可访问。优先使用当前规则集的自定义来源,其次寻找本地规则资源,再使用用户设置的来源,最后使用默认来源。

下面是本地 SRS 文件示例,path 需要换成你实际保存的位置。JSON 中 Windows 路径的反斜杠需要转义。

JSON · local rule-set example复制
[
  {
    "tag": "example-rules",
    "type": "local",
    "format": "binary",
    "path": "/path/to/example-rules.srs"
  }
]

DNS 基础设置

先区分“路由匹配需要的解析”和“实际出站目标的解析”。Xray 默认直连 / 远程 DNS 主要服务于路由中的 IP 匹配;sing-box 还用它们解析节点或目标。填写多个 DNS 地址时用逗号分隔。

设置作用
直连 DNSsing-box 用于路由、节点和直连目标;Xray 默认主要用于路由解析
远程 DNSsing-box 用于路由与代理目标;Xray 默认主要用于路由解析
Bootstrap DNS必须使用 IP 形式,用来解析 DNS 服务器本身的域名,避免循环依赖
直连目标策略 AsIs通常交给系统 DNS;其他策略使用配置的直连 DNS
代理目标策略 AsIs通常交给代理节点解析;其他策略使用远程 DNS
UseIPv4 / UseIPv4v6在 sing-box 中映射为 prefer_ipv4,IPv6 对应 prefer_ipv6
并行查询Xray 专用;预先并发查询,再按分组 / 回退逻辑选择
乐观缓存Xray 专用;暂用过期缓存,同时等待新结果

Hosts、FakeIP 与 DNS 校验

“使用系统 hosts”可合并 Windows 的 hosts 和 hosts.ics;“添加常用 DNS Hosts”提供常见 DNS 域名映射,作为 Bootstrap 的补充。手工 DNS Hosts 每行写域名及一个或多个 IP,优先于普通查询。

FakeIP 仅在 sing-box 的 TUN 模式有效,用特定地址映射保留域名信息。“阻止 SVCB 和 HTTPS 查询”也仅在该模式生效,会影响 ECH 和 HTTP/3 的服务发现。地区 IP 校验用于判断某类域名的结果是否位于期望 GEO 范围;数据或规则不一致时可能导致解析失败。

Hosts · documentation addresses复制
example.com 192.0.2.10 192.0.2.11
example.org 198.51.100.20
# A matching keyword can return NOERROR
keyword:blocked.example #0

自定义 DNS 配置

Xray 与 sing-box 使用各自独立的 DNS 配置,不应把一种核心的 JSON 原样放进另一种。没有特殊需求时可导入对应核心的默认 DNS,再逐项修改。

“使用系统 hosts”控制是否合并系统映射;Outbound 域名解析地址用于本机解析节点域名,Outbound 解析策略控制 IPv4 / IPv6 等选择。若使用域名形式的 DNS 服务器,应保证 Bootstrap 不依赖尚未建立的代理连接。

修改后分别验证节点域名、直连网站和代理网站,出现问题回退到备份的默认配置。

完整配置模板

客户端先正常生成配置,再依据模板重写配置,尽量保留模板自身设计。启用模板后,部分界面里的路由、入站、DNS 等设置可能不再决定最终配置,应检查实际生成结果。

“不添加非代理协议出站”开启后,需要在模板中自行提供 direct、block 等出站。设置“上游代理 tag”时,客户端会给没有前置的节点引用该 tag;对应上游出站也必须由你定义。不存在的 tag 会导致配置失败或行为不符。

Windows UWP 回环访问

部分 UWP 应用处于沙盒中,默认不能访问本机回环地址,因此无法直接连接 127.0.0.1 的代理。“解除回环代理限制”用于对需要的应用开放这一访问。

运行该功能需要相应系统权限。若工具报错,先确认 Windows 版本、应用是否安装完整和权限提示;排查时记录原始错误,不要通过关闭整个系统防火墙代替应用级配置。

清除服务统计

该操作清除配置项记录的上传与下载流量,不清除延迟或速度测试结果,也不代表重置服务提供方的用量计费。

希望对比一段时间的本地流量时,可先记录旧值,再清除并观察新连接;订阅更新后的节点变化也可能影响统计的呈现。

区域预置与资源来源

默认 GEO、rule-set 和路由资源面向中国区域的常见使用方式。其他区域可先调整区域预置或自定义来源,再执行资源更新。

更换来源后确认分类名称仍与现有规则一致;新数据缺少旧分类时,应同步修改规则,而不是只重复下载文件。

备份和还原

备份对象是整个 guiConfigs 文件夹,包含客户端设置、配置数据库与自定义配置。使用“备份和还原”保存 ZIP;非 Windows 系统要明确填写 zip 扩展名,还原对话框只接受 ZIP。

还原会替换相应配置并重启客户端,操作前先备份当前状态。自动重启失败时手动启动。备份包含订阅 URL 和凭据,保存在自己控制的位置;迁移后检查本地文件路径和核心可执行文件是否在新设备存在。

打开存储位置

便携版数据通常随解压目录保存;安装版运行目录与数据目录可能不同。“打开存储所在的位置”能直接定位实际数据,便于备份、检查 guiLogs 和查找配置。

手工编辑 guiNConfig.json 之前必须退出客户端,避免退出保存覆盖你的改动。guiNDB.db 是数据库,不要用文本编辑器修改。

配置文件与参数

检查更新与更新失败

检查更新可更新客户端、核心和规则资源。7.25.6 提供通过代理检查更新的选项;失败时先确认当前节点能访问下载源,再尝试其他可用访问方式。GitHub API 有频率限制,短时间反复检查可能暂时受限。

更新窗口关闭后任务可能继续在后台运行。客户端自更新需要另一个进程完成替换,非 Windows 平台未显示进度时应留出完成时间,未重启再手动启动。Wiki 标注 6.10–7.23.2 自更新存在历史安全问题,仍使用这些版本时优先下载当前官方包并校验后迁移。

下载校验更新日志

关闭窗口与退出进程

Windows 的部分关闭操作只隐藏主窗口到托盘,代理核心仍在运行。非 Windows 平台的窗口关闭行为受设置控制,可隐藏或最小化;明确退出会结束应用与核心。

判断是否退出应查看托盘 / 进程和网络状态,不要仅根据窗口消失判断。停止使用时先清除系统代理,再通过退出命令结束。

列表排序与信息过滤

点击列表列名可切换正反排序;无效的延迟和速度数据始终排在后面。拖动列可调整顺序和宽度,正常退出时保存布局。配置列表的过滤是模糊查询,不支持正则表达式。

信息栏过滤支持正则,但只对设置过滤器之后产生的信息生效。复杂日志分析可先复制相关内容到文本工具;公开分享前隐藏订阅、密码与标识信息。