JSON 结构与配置归属
顶层对象与数组
独立内核读取的配置通常是一个顶层对象。入站和出站分别为数组,因为一个进程可以有多个监听和多个出口。路由是对象,其中的规则再用数组表示。解析、策略和日志也是各自独立的对象。不要把客户端导出的订阅资料、单节点分享文本或应用自身设置当成这份配置:它们可能也含有端口或协议字段,但文件的读取者和字段层级不同。
{
"log": { "loglevel": "warning" },
"inbounds": [],
"outbounds": [{ "protocol": "freedom", "tag": "direct" }],
"routing": { "rules": [] }
}
这段完整 JSON 用来辨认层级,不提供应用可用的监听。最外层键的排列不改变含义,但数组不是无序集合。出站数组的第一项通常承担未匹配规则时的默认出口,规则数组则从前向后匹配。编辑器的格式化功能可以调整缩进,不应顺手重排这两个数组。即使两份文件的键和值完全相同,交换规则或出站的位置也可能改变实际行为。
| 顶层字段 | 容器类型 | 优先检查 |
|---|---|---|
inbounds | 数组 | 监听地址、端口、应用使用的协议。 |
outbounds | 数组 | 默认出口、标签及出口自身的设置。 |
routing | 对象 | 规则顺序、匹配字段和目标标签。 |
dns | 对象 | 内置解析器使用的服务器和调用时机。 |
policy | 对象 | 等级映射、连接时限及统计开关。 |
写严格的 JSON 时,键名和字符串使用双引号,数字和布尔值不要额外加引号,最后一个元素后不加逗号。同一对象内不写同名键。有些编辑工具会接受注释或重复键,有些加载器会报错或只保留后一个值,结果不便复现。看到端口没有生效,除了核对数字,还要确认修改的是当前对象中的唯一字段,而不是同名键或另一个入站里的字段。
客户端界面与内核文件
桌面端优先从 下载页选择 v2rayN,在「参数设置」查看本地监听相关选项,在「路由设置」查看规则。客户端可能在切换节点、应用设置或重启时重新生成内核文件。对图形界面托管的连接,先通过界面修改并观察日志;对自行维护的配置,另存文件并明确加载方式。不要把编辑运行时临时文件当作持久设置。
安卓端的 v2rayNG 与 v2flyNG 各自维护应用设置,内核也不同。桌面文件中的本机监听、系统代理行为或数据文件路径不能直接类推到移动端。迁移前先写下真正要带走的内容:是节点连接资料、路由规则,还是某个应用的接入方式。节点能导入不代表桌面监听和解析也随之迁移,日志出现同一协议名称也不代表所有选项均被采用。
从症状回到对应层
把错误分成读文件、建监听和处理请求三类。读文件阶段的报错先处理语法或字段位置;启动后仍看不到本机监听,再看端口冲突与地址绑定;应用已经接入但访问结果不对,才看路由、出站和解析。从最早失败的一步开始,能避免把所有问题都归到节点。若重启后结果不变,确认旧进程是否仍在占用端口,别把旧进程的响应记成新配置成功。
以下各章的短片段都以顶层对象的成员为示范。同一顶层键已有内容时,应在相应对象或数组内合并,不要再追加一个同名的顶层键。只想确认字段行为时,可在独立文件中采用后面的完整示例。记录原值、修改值和一个可复现的请求;对照前后的日志,比把整份配置替换后再追问哪一行生效更容易定位。没有整套配置的基线,也就很难判断问题是新改动引入的,还是原有设置早已如此。
inbounds 入站监听
地址、端口与协议一起核对
入站决定哪些应用能够把请求交给内核。排查时把监听地址、端口号和代理协议作为一组处理。应用里填的是代理入口,不是订阅地址,也不是节点的远端端口。将本机浏览器指向本机 SOCKS 入口,只验证这一条应用接入路径;系统代理是否开启、其他应用是否读取系统设置,要分别确认。代理端口已开启并不表示所有流量都会经过它。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false },
"sniffing": { "enabled": false }
}
]
}
这个监听只绑定本机 IPv4 环回地址;应用中也填写同一地址。把它换成名称时,应用可能先尝试 IPv6 环回,导致地址看起来等价、连接却建立不了。出现拒绝连接时,检查当前进程是否实际绑定了对应地址以及端口,也检查是否有另一个客户端占着同一个监听。不要先改远端服务器地址,因为请求此时还没有进入路由。
代理类型必须与监听协议对应。即便都使用同一个数字端口,HTTP 代理请求与 SOCKS 握手也不是一回事。填写错误时,应用可能连接到端口,却在交涉阶段断开。分别开两个入口时,给它们不同的标签和端口,按应用的代理选项分别验证。若只有读取系统代理的应用能用,优先查系统设置所指的端口与协议,而不是把所有入口改成同一种协议。
示例关闭 UDP,目的是先确认基本的 TCP 请求。打开 udp 只表示这个 SOCKS 入口可以处理相应的 UDP 转发请求,应用必须支持相关交涉,选中的出口也要能传递,且中间环节不能阻断。浏览网页成功不证明语音、游戏或其他数据报业务可用。不要用应用的一个连接结果推断所有网络类型都已走同一路径。
入站标签与嗅探边界
入站标签是规则引用的名称,不是对外显示的节点备注。为每个入口取不同的标签,便于用 inboundTag 区分来自浏览器、工具或代理转接的连接。重命名时,除了入口本身,还要修改路由中的引用。若两个应用都交给同一入口,单靠这个条件无法区分它们;先明确应用是否有能力连接到不同入口,再决定是否拆分,而不是靠增加重叠的域名规则代替。
应用若先在本机把域名解析成地址,入站可能只收到 IP。嗅探可以在部分协议和请求形态中识别主机信息,但不保证取得所有连接的原始域名。支持相应字段的内核中,routeOnly 可以让识别结果只用于路由,而不替换原目标。检查域名规则时,先比较应用传入域名与传入地址的结果;不要假定启用嗅探就能修复所有不能匹配的请求。
在共享场景中,先在宿主设备验证入口,再从另一台设备验证宿主的局域网地址,最后才改防火墙规则。对方填自己的环回地址,访问的是对方自身。若只有同一设备能连,要分别核对绑定地址、设备所在网络和访问规则。离开可信网络后关闭共享,再检查环回入口是否仍按原方式工作,避免把临时调整留为日常默认值。
交接配置时,把入口的地址、协议和用途写成一组说明。一台设备上的应用可能有系统代理、应用内代理和扩展代理等多个设置点;先用一个明确指定代理的请求建立基线,再核对其他入口。若界面显示已启用但看不到流量,可回到系统代理步骤检查应用是否采纳系统设置。若需验证某个坏掉的入口,可让同一个应用暂时切到已确认可用的入口,对比握手结果;这样可以把应用行为与本地监听问题分开。
outbounds 出站与标签
出口行为由协议决定,路由通过标签选择
出站是内核实际交付请求的方式。直连出口由运行内核的设备拨向目标;阻断出口终止匹配到的请求;远端代理出口按对应协议与服务器交涉。标签只是名称,写成直连并不会改变协议行为。若日志显示路由选择了某个标签,定位时下一步是找到同名出站对象,再核对它自身的协议与设置,而不是按标签名字猜测连接走向。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{
"tag": "blocked",
"protocol": "blackhole",
"settings": { "response": { "type": "none" } }
}
]
}
这里直连放第一项。没有命中任何规则时,通常走第一个出口,不是按标签名称自动寻找备用线路。把阻断项移到第一位后,未匹配请求也会失败。相反,若设计要求某些请求只能经指定出口,把直连误放为默认可能让漏写的规则回落到直连。准备调整数组顺序时,先用一个明确不会命中规则的目标测试原默认行为,再用同一目标复测。
路由命中一个出口后,出站连接失败通常不会让匹配器回头尝试下一条规则。把两条条件相同、出口不同的规则连写,不等于建立故障转移。排查这类问题时,应该先验证指定出口是否能完成自己的拨号和协议交涉。若默认出口可用而选定出口报错,只能证明接入和某条链路正常,不能用来说明后一个出口的参数有效。
远端参数与传输参数的边界
远端代理出口需要该协议认可的服务器地址、服务器端口和用户参数。它们与目标网站的域名、目标端口以及应用连入的本地端口分别属于不同阶段。图形客户端中编辑节点时,先对照服务方提供的参数,再对照协议相关栏目。更换通信方式时,不要用从其他协议复制来的用户结构填补缺失值;同名设置在不同协议下的允许值也可能不同。
在提供相应能力的出口上,streamSettings 描述与远端连接时采用的传输和安全设置,不是为最终打开的网站切换加密。目标网站的安全连接与客户端到远端服务器的安全连接需要分开看。若日志显示错误发生在连接代理服务器阶段,核对地址、端口、传输类型和与服务端约定的名称。不要为绕过安全交涉报错而关闭证书检查;先确定具体失败的是哪一层。
协议字段通过语法检查,不意味着当前内核实现了要求的传输和安全组合。桌面客户端可以管理不同内核,移动客户端也不保证与正在运行的桌面版本具有相同能力。向另一设备复制节点时,应首先检查目标客户端实际使用哪种内核,再确认它支持这些组选项。如果界面没有对应字段,不能假定导入文本会让该功能生效。协议术语见入门指南的协议说明。
调试中应区分服务器域名与请求目标域名。即使应用提交的是目标地址,代理服务器本身可能仍需先解析和拨号;即使服务器能建立连接,具体目标也可能因远端规则或网络条件而失败。记录失败是在入口交涉、代理连接还是目标响应阶段,再选该阶段的配置进行对照。比较时尽量只换出口,保持请求目标、应用和入口一致。
建立自己的出口清单时,可以给每一项写下用途、所属内核、是否依赖服务器域名解析,以及哪些规则会选中它。把本机直连、远端代理和测试阻断分开描述,不在日志或截图里复制节点的认证资料。某出口准备停用时,先修改引用并测试默认出口,确认没有规则继续选择旧标签,再移除旧对象。小范围逐步调整比删除后统一修复更容易发现遗漏,也让配置审阅时能追到每条规则的实际目的地。
routing 规则顺序与匹配
先命中先使用
规则数组从上向下检查。单条规则里同时写目标域名、网络类型和入站标签时,需要满足配置中的各类条件;同一个匹配列表可以列出多个候选值。要表达“域名命中或地址命中”,一般拆成两条规则,而不是把域名与地址塞进同一条。把窄规则放在能覆盖它们的广规则之前,否则只会看到广规则的出口,后面的例外没有机会参与。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:blocked.example"],
"outboundTag": "blocked"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["domain:example"],
"outboundTag": "direct"
}
]
}
}
此片段引用前两章的标签。第一条只匹配给定入口上完整域名为 blocked.example 的请求。第二条用域名后缀覆盖该后缀自身及其子域名。两条换位后,较宽的后缀规则会抢先命中,阻断规则就不起作用。这里使用保留域名来解释匹配,不把它当作实际可访问的服务。测试阻断最适合选一个直连本来能成功的目标,详见完整示例。
full: 适合精确的主机名,domain: 适合域名本身及它的子域名。域名匹配项不要写入网页路径、查询参数或网址前缀;这些不是目标主机名。用部分文字匹配时容易无意覆盖不相关的域名,特别是名称很短的服务。排查一个具体站点时,先以完整主机名验证,再按需求扩大范围。访问页面还会连向其他主机,不要把主页面成功当成所有请求都已命中。
匹配端口时,port 指请求的目标端口,而不是入站的监听端口。要按入口区分,应使用 inboundTag。网络类型条件约束的是连接类型,不代表应用的名称。若规则的测试只用一个浏览器页面,很难判断失败是端口、协议还是域名不符合条件。可先只留一个条件验证,再逐个加回其他条件,以定位到底哪一个约束没有满足。
域名解析策略与数据文件
AsIs 不为路由去解析收到的域名,因此不能期待地址规则直接匹配该域名解析后的地址。IPIfNonMatch 在域名目标未匹配时尝试解析,让地址条件参与后续匹配。若之前已有广泛规则命中,后续解析阶段就不一定发生。IPOnDemand 允许在匹配需要地址的规则时解析域名。三者控制的是路由阶段,不是浏览器如何查询域名。
地址条件可用单个地址或网段,也可引用内核数据文件支持的类别,例如 geoip:private。域名类别如 geosite:cn 则取决于对应文件是否存在、类别是否收录以及内核实际读取的路径。选择类别前先用单条明确的域名或网段验证规则结构,再换成类别;否则文件加载和规则匹配两类问题会混在一起。参见GeoIP 与 GeoSite 规则文件更新。
使用类别时,如果内核提示类别不存在,不要先改规则优先级。核对进程实际读取的数据文件及类别名,再检查是否因工作路径改变而载入了另一套数据。若能启动却结果不符,取一个你知道应命中的目标和一个应不命中的目标分别测试。类别更新可能调整成员;把变更前的命中结果与数据文件一起留存,比单看文件更新时间更能说明问题。
最后测试默认路径:准备一个不符合所有例外条件的目标,按同样方式提交请求,确认它确实进入预期的默认出口。若测试结果取决于应用是否传入域名,在记录中标明这一点,避免其他设备重复测试时得到相反结论。应用已经解析成地址时,规则看到的可能只有地址;内核能为域名补查地址,却不能保证从任意地址恢复应用最初输入的域名。
dns 解析与路由联动
先确认发起查询的是谁
内置 DNS 模块向内核功能提供解析结果,不会因为存在 dns 对象就自动接管整台设备。应用可能调用系统解析器,也可能自行做加密解析,或交给代理端处理目标名称。应用在连接前已查询并提交地址时,改变内核的解析服务器不一定改变这次请求。看到目标域名能打开,也不能直接判断是哪一个解析器返回了地址。
{
"dns": {
"servers": [
{ "address": "1.1.1.1", "port": 53 }
]
}
}
例子给内置解析器列出一个以 IP 表示的服务器,端口是普通 DNS 使用的端口。它不新增一个可供系统填写的本机 DNS 监听,也不承诺查询加密。把它用于个人测试前,确认当前网络允许访问该解析器;受管理网络宜使用管理员指定的服务器。最简单的组合只留一个解析端,方便判断超时是否由服务器选择、网络路径或回退造成。
把服务器地址写成域名时,还要考虑该服务器名最先由谁解析。如果引导解析又依赖尚未建立的同一个入口,可能出现反复等待。远端代理自身的服务器域名也有同样的依赖问题。排查时,把“目标域名解析”和“用于建立解析或代理连接的服务器名解析”分开记录;前者失败不见得是目标不可访问,后者失败可能让所有依赖它的目标同时超时。
确定解析发生在匹配还是拨号阶段
路由遇到域名目标时,可以按前一章的策略为地址规则取得结果。这个结果首先服务于匹配判断,不等于最终拨号一定使用同一个地址。直连协议如何处理域名还可能受其自身设置和内核实现影响;远端代理也可能接收目标域名后自行解析。只修改路由策略而不看出口行为,就容易把“命中的条件变了”误认为“目标连接地址也变了”。
配置不同域名使用不同解析端时,可在支持的内核中用服务器条目的 domains 指明优先匹配范围。它不是系统级的防泄漏开关。是否在失败后查询其他服务器,还要看相应回退设置和内核行为。先让一个明确的测试域名可复现地走一条路径,再加入其他分组。若用地理类别描述范围,应同时确认该类别在本机数据文件中能加载。
比较解析结果时,避免同时改查询类型和服务器。某些网络环境的 IPv4 和 IPv6 可达性不同,查询返回地址也不等于设备具备建立连接的条件。浏览器、操作系统与内核还可能各自缓存结果。做两次对照时,使用同一主机名、同一代理入口和相同网络条件;核对预期地址族,并说明是否让应用先在本地解析。否则两种测试得到不同地址,也不足以定位问题。
FakeDNS 由支持的内核和接入方案配合使用,返回的是供后续还原关联的合成地址,不是站点的实际服务地址。后续连接若没进入能识别关联的路径,就可能出现解析成功而连接失败。调试基础解析时先排除这一层:用普通解析验证查询和拨号,再单独引入合成地址方案,确认解析、接管和目标恢复处于同一条配置链路。
排查记录至少包含请求是域名还是地址、实际命中哪个出口、解析发生在哪一端、等待超时还是收到了失败响应。是单应用异常,就先查该应用的解析选项;是所有依赖某一解析端的请求异常,就先验证该解析端从使用它的位置是否可达。不要把内置 DNS 清单越加越长当作修复,除非能说明每个条目的用途、查询优先级和失败之后的预期结果。
还有一种常见误判:网页内容来自应用缓存,即使已有解析路径被改坏,原页面也可能继续显示。应以重新发出的网络请求判断,并在结果中标明测试时间和设备所接入的网络。只有能说明查询如何进入预期的解析端,再对照路由和拨号,才能把解析故障与其他阶段的故障区分开来。
policy 连接策略与统计
连接等级不是分流优先级
策略对象将一组连接参数绑定到用户等级。levels 中的键是 JSON 字符串,引用等级的字段值则通常是数字。未单独指定等级的连接一般使用等级零。某个协议能否给用户或入口指定等级,要查所用内核与协议的字段定义,不能把同一个字段放在所有协议的相同层级。等级不会重排路由规则,也不能用于选择代理出口。
{
"stats": {},
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
},
"system": {
"statsOutboundUplink": true,
"statsOutboundDownlink": true
}
}
}
这些时限以秒为单位,示例用于讲解,不是所有设备的推荐值。handshake 限定相关连接完成握手的等待时间;connIdle 用于连接空闲的判定。连接持续有数据传输时,空闲限制并不等于一次请求的总时限。若页面迟迟没有建立连接,应先查失败在入口交涉、解析还是出口拨号,不能简单把所有异常都当作空闲时间过短。
uplinkOnly 与 downlinkOnly 用于连接只剩单向可传输时的等待控制,分别对应仅剩上行和仅剩下行的阶段。它们不限制带宽,也不是每次上传或下载的最长时限。调低这些值可能让先关闭一侧而仍在传数据的连接提前结束。诊断此类异常要看半关闭后的进展,不宜只看短网页或一次能快速结束的请求。
| 策略字段 | 观察角度 | 不能据此判断 |
|---|---|---|
handshake | 是否卡在连接的握手阶段 | 目标站点的总响应时间 |
connIdle | 最后一次传输后多久断开 | 一条持续活跃连接的寿命 |
uplinkOnly / downlinkOnly | 单向关闭后的剩余传输 | 上下行速度限制 |
观察到固定间隔的断开时,先记录从哪个事件开始计时:启动连接、最后一段数据,还是某一方向结束。相同的墙钟时间可能来自应用自身、远端服务器或中间网络,不一定来自本机策略。若调大某一字段后断开时间没有变化,恢复该字段并找另一层的限制。多处同时放宽会让真正触发者更难识别,也会让空闲连接长时间占用本机资源。
开启计数与读取计数是两回事
在支持示例字段的内核中,顶层 stats 启用统计模块,policy.system 中的开关选择要记录的出站方向。它们不会自动创建可访问的统计网页。需要读数时,仍要由支持的客户端或内核管理接口获取。示例特意没配置远程接口;用于验证一般连接时,也不需要把管理能力开放给其他设备。
计数用于确认某段流量是否经过某个出口,不等于访问目标收到的数据量,也不等于测速结果。零计数要结合开关、读取方式、出口标签和测试期间实际产生的流量判断。客户端重载或切换实例后读到的值也可能来自新进程。每次比较应确认同一统计来源,先完成一个明确请求,再看该标签的数据是否发生变化,避免把别的应用流量误归到当前请求。
如果要用等级统计区分用户,要核对协议是否提供用于统计的用户标识,不能把界面里的节点备注当作同一种字段。标签、用户标识和计数名称属于不同层。只关心出口是否被用到时,先测出站方向计数;只有确实需要分用户观察,且当前配置能提供合适标识时,再增加等级对应的统计设置。
日常维护可以把策略保留为最小配置。频繁修改的场景只写清实际用到的等级和时限,并注明对应的客户端或自主维护的文件。接手旧配置时,先检查某个等级有没有任何连接在用,不要把一批没有引用的参数机械迁移。随后在相同条件下测短请求与空闲后恢复两种场景,再决定保留显式值还是回到内核默认。
本机完整配置与验证
用实际可达的目标对照两个出口
这份独立配置只在本机接收 SOCKS 请求。它不需要远端账户,也不修改操作系统代理设置。规则按目标域名选择阻断,其他请求走默认直连。目标是证明三个环节:应用把连接交给了正确的监听,内核能按域名命中一条规则,未命中时能选到第一个出站。测试现有客户端时应保留原配置,另选空闲端口或先退出占用示例端口的进程。
{
"log": { "loglevel": "info" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{
"tag": "blocked",
"protocol": "blackhole",
"settings": { "response": { "type": "none" } }
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "blocked"
}
]
},
"policy": {
"levels": { "0": { "connIdle": 300 } }
}
}
将文件另存到便于辨认的位置,不覆盖图形客户端生成的文件。已有独立 Xray 内核、且当前终端能调用它时,可以分别执行下面两条命令。第一条只做配置加载测试,不能证明端口可绑定;第二条才会运行内核。在图形客户端使用自定义配置时,采用客户端提供的加载方式,并查看它实际启动的内核和日志,不需要另起一份独立进程。
xray run -test -c config.json
xray run -c config.json
命令中的文件名要对应当前目录下的文件。若检查返回无法打开文件,先核对工作目录及文件名,而不是改配置字段。检查通过但启动报地址占用,应该释放该端口或换成确认未用的端口,并同步更新后面的请求。若内核提示入口已建立但系统代理设置仍显示关闭,这是正常的:这个配置只提供入口,没有要求操作系统把应用流量导向它。
启动后在另一个终端发送两个显式经过本机代理的请求。使用 socks5h 让请求把域名交给代理端处理,以免应用先解析成地址导致域名条件无法匹配。--noproxy "" 防止环境中的代理例外设置让测试目标绕开指定入口。系统已有同名命令别名时,选择实际的 curl 程序执行,例如在相应系统中运行 curl.exe。
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.org/
若当前网络能访问这些示例站点,第一个请求应走直连;第二个应被规则选到阻断出站,可能在服务建立前或安全交涉时就失败。不要用某一句固定错误文本作为唯一判断依据。网络本身不可达时,直连请求也会失败,先改用自己能确认可访问的非敏感目标,并保持规则中的完整主机名与命令中的主机名相同。
若两个请求都失败,先确认第一个请求能否离开入站。终端显示无法连到代理时,查本机地址、端口和进程;已经连到代理但无法打开目标时,结合日志检查出口拨号。若两个都成功,核对实际正在加载的文件、请求传入的是域名还是地址,再查入站标签与规则对应关系。不要为了让结果符合预期而把阻断出口移到第一位,那会破坏对照的意义。
把实验结果与客户端行为分开
还可暂时移除那条阻断规则,重启并只重试第二个请求。如果它恢复,说明原来的失败与规则有关,而不是目标始终不可达。此时不要同时换端口或应用,否则结果不能只归因于规则。记录命令、匹配到的出站与结果后,停止独立进程,清理测试端口,再恢复之前使用的客户端配置。
这个示例不验证 UDP、系统代理覆盖范围、远端协议参数或移动端接管。验证图形客户端时,以入门指南的连接测试为主;对某个字段有疑问,再用这里的最小样本还原。若已有一份能正常工作的文件,先在副本中逐步加入规则和策略。每加一段就重新跑两条对照请求,出现变化时便能判断是哪一步引入的。
验证成功后,把测试结果写成可重复的条件,而不是只记“能打开”。例如明确说明请求从哪个入口进入、哪个主机应正常请求、哪个主机应被阻断,以及未命中时预期走的出站。以后客户端更新或调整字段后,可以按原条件复测。如果重测前发现示例端口已有其他用途,另选端口并重新记录,不要借用实际业务的入口来做阻断实验。
分层排错与配置回退
先区分订阅、启动与单次请求
订阅更新属于客户端下载节点资料,不等于内核已经使用资料建立连接。更新按钮报超时或证书错误时,先区分订阅请求失败与已有节点不可用,检查客户端用于更新的访问方式及本机时间。若已有节点仍可用,不必立刻删掉现有配置重导。订阅相关故障见订阅更新失败排查;本章从配置已经选定后的失败开始分层。
内核不能启动时,从最新一次启动报错的首个明确原因查起。语法或字段类型不对,核对括号、逗号和字段所在层级;规则载入异常,先核对引用的数据文件与类别;绑定地址失败,确认监听是否冲突或地址是否属于本机。后续报错可能只是前一环节失败的结果,逐条消除源头比同时调整网络与配置更有效。
启动成功但应用无法连接时,先用显式指定代理的请求测试入口。它可用而普通浏览器不可用,检查该浏览器是否采纳系统代理、有没有自己的代理覆盖或例外。它也不可用,就把入口与日志放在同一时间范围内看。看不到请求不一定等于没接入:日志级别可能没有记录对应事件。应结合启动信息、请求报错与目标行为判断。
{
"log": {
"loglevel": "info"
}
}
遇到需要观察具体连接的情况,可临时提高日志详细程度。把这段合并到原有日志对象,不要覆盖原文件中的其他日志设置;由客户端托管时优先在其日志设置中调整。复现一次后恢复原级别。日志可能包含目标域名、地址、设备路径或服务端信息,准备分享时先删去与问题无关的记录,保留字段名、失败阶段和必要的前后两行。
匹配异常、出口失败与恢复方法
能接入但疑似分流错误时,从一条可以复现的请求开始。记录它从哪个入口进来,提交的是域名还是地址,有没有先命中广规则,以及实际选中的出站。入口标签没对上,或者域名早已被应用解析,都会让规则条件不成立。如果日志已能确认选中正确出口,就不要继续改匹配条件,转去检查该出口的服务器连接、协议参数和目标响应。
只有个别域名失败时,可在同一入口比较按域名请求与按地址请求,但不能用把网页地址简单换成 IP 的办法推断网站服务正常,因为主机名和证书语义也会改变。应分别看解析是否返回预期地址、规则是否按当前输入命中,以及保留正确主机名时能否建立目标连接。遇到一整类域名异常,再核对域名类别数据和解析分组,而不是为每个站点单独加一条规则。
回退应恢复最后一份实际运行成功的文件或界面设置,不只是撤销编辑器里最后一行。规则依赖外部数据时,确认回退后的文件仍与当前数据兼容。客户端换过内核,则核对回退后的字段在当前内核仍可读。先重启并验证本地监听,再重试原有对照请求,最后恢复日常使用方式。若无法回到原结果,重新核对运行的是不是原来那一个配置来源。
电脑配置正常、安卓配置异常时,不要把同一个节点成功导入当作两端行为相同。对照所用内核、客户端中的路由模式、接入方式和各自的解析设置,逐项找出差异。同步时优先迁移连接资料,在目标设备上重新设置本地行为。操作入口可参见多设备配置同步,把这类迁移问题与单次访问失败分开记录。
完成排查后,只保留能够解释结果的改动。检查临时测试规则、提高的日志级别和局域网监听是否恢复;确认默认出站仍符合预期,并用原来失败的请求复测。若问题已经解决但原因仍未清楚,应标明这是一次恢复而非已定位故障。下一次复发时,从已记录的原始条件重现,不要因为曾经重启后恢复,就把反复重启当成长期设置方案。