内核配置 · 字段手册
V2Ray 配置文件参考
按 JSON 层级查阅入站、出站、路由、DNS 和连接策略,再用一份最小配置核对它们如何配合。
第一次导入订阅或设置系统代理,先走一遍快速上手教程。教程讲操作顺序,这里讲内核实际读取的字段。遇到端口、出站标签或解析结果对不上的问题,可以从目录直达对应章节。
01 配置层级
V2Ray 配置文件的 JSON 结构
客户端保存的设置不等于内核配置
桌面端优先用 v2rayN,Android 可按所需内核选择 v2rayNG 或 v2flyNG,入口见客户端下载页。使用图形界面时,订阅地址、当前条目、系统代理和界面偏好通常由客户端管理;客户端再根据选中的条目和全局设置生成或加载内核配置。界面里看到的条目名称不一定是 JSON 里的标签,客户端保存的数据文件也未必能直接交给内核读取。对照字段时,要先确认当前运行的内核,以及实际交给它的是哪一份配置。
日常连接通常不必手写整份 JSON。只有在确认界面设置无法表达所需行为,或需要缩小故障范围时,才建议复制出一份独立配置。直接编辑客户端生成的文件,修改可能在重新连接、切换条目或更新订阅时被覆盖。反过来,修改一份没有被加载的副本也不会改变连接。验证修改是否生效,不要仅看文件的保存时间,应检查启动结果以及监听、出站等可以观察到的行为。
根对象、对象数组和协议参数
根节点是一个对象。入站和出站各用一个数组表示,因为同一个进程可以有多个入口和出口;数组里的每一项才是具体的入站或出站对象。路由、解析、策略和日志各有自己的根级对象。写在错误层级的字段即使能通过 JSON 语法检查,也未必会被内核采用。例如,监听端口是入站对象的属性,而认证方式在 SOCKS 入站的 settings 对象里。不要因为两项都能在同一个设置窗口找到,就把它们写到同一层。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
}
这份完整的最小配置只接收本机 SOCKS 请求,并直接连接目标,不依赖远端服务。它没有路由规则,未分流的请求自然交给数组首项出站。JSON 的书写顺序要分两种:同一对象内先写 log 还是先写 inbounds,不改变这里的行为;数组却往往有顺序意义,尤其是默认出站的位置和规则的先后。复制片段时应保留外层结构,把需要的项插入对应数组,而不是把两份完整根对象前后拼接。
| 字段 | 形状 | 作用 |
|---|---|---|
inbounds | 对象数组 | 接收连接,并为入口命名 |
outbounds | 对象数组 | 定义目标连接或丢弃行为 |
routing | 对象 | 选定出站,内部含有规则数组 |
dns | 对象 | 配置由内核发起的域名解析 |
policy | 对象 | 定义连接时限与统计开关 |
log | 对象 | 控制日志级别及相关输出 |
先检查语法,再检查字段关系
以标准 JSON 保存时,用半角双引号包住键名和字符串,不加注释或末尾逗号。端口写数字,认证方式写字符串,开关写不带引号的 true 或 false。同一对象不要重复使用同一个键:有的读取器会取最后一个值,看起来只是加了一组设置,原来的规则却整体被覆盖。遇到报错指向下一行时,也要回看上一项是否漏了逗号,或某个数组是否提前闭合。
通过语法检查只说明文件能被读成结构化数据。接着还要核对三类关系:协议与 settings 是否相配,规则指向的标签是否存在,配置里引用的文件是否在运行环境中可读。最后才是端口能否绑定、对端能否连通这类运行问题。不同内核对未知字段的处理可能不同,有时不会明确报错。本文用两类内核常见的基础结构说明配置关系;涉及特定内核的扩展时,以实际加载该文件的内核所支持的字段为准。
02 接收连接
inbounds:监听地址、端口与入站协议
监听地址决定谁能连到入口
本机使用时,把 listen 明确写成 127.0.0.1,避免把入口暴露给同一网络里的其他设备。应用要连的是运行内核的那台机器;如果在手机上填这个地址,指向的是手机自身,不是桌面电脑。只监听这个 IPv4 回环地址时,用 IPv6 回环地址访问也不会落到同一个监听器。排查客户端界面里的代理地址时,建议先使用明确的地址,不要让 localhost 解析结果成为另一个变量。
port 指内核实际等待连接的本地端口,不是订阅里的服务端口。监听地址与端口的组合受操作系统绑定规则约束:已有进程占用时,新入站可能启动失败;绑定所有 IPv4 接口的监听也可能与指定地址的监听重叠。切换端口要同时修改应用或系统代理所填写的端口。只改一侧时,典型现象是客户端似乎运行正常,应用却仍连接旧入口,甚至误连到占用旧端口的别的程序。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
]
}
协议匹配先于路由匹配
示例使用 SOCKS 入站,应用应主动选择 SOCKS5 代理;浏览器请求的是网页,并不代表代理握手要使用 HTTP。对于只提供 HTTP 代理设置的应用,应使用独立的 HTTP 入站或客户端生成的相应入口,端口按实际配置填写。向 SOCKS 端口发 HTTP 代理请求时,端口可能是通的,但内核无法按入站协议读出请求目标,自然也轮不到后面的路由规则处理。判断是否进入路由阶段,不能只看端口探测结果。
auth 为 noauth 时不要求账户,适合这里限制在回环地址的测试。udp 为 false 时,本入口不提供 SOCKS 的 UDP 转发。即使打开,应用也要能使用 SOCKS5 的 UDP 关联,后续出站也必须支持这类流量。网页能打开只能验证这次网页请求走通,不能证明实时通信或其他依赖 UDP 的应用也能通过同一个入口。应分别记录出现问题的应用、代理协议和实际使用的传输方式。
入口标签、目标地址和嗅探是三回事
tag 为入口命名,路由可以通过 inboundTag 区分来自不同监听器的请求。比如给两个本机入口分别取名后,可以让测试应用的规则只在测试入口生效,不影响日常使用的入口。入站标签不随应用的代理协议自动变化;改名时要同步改路由引用。若两个入口表现不一致,应先检查应用连的是哪一个端口,再比对相关规则是否把另一个入口名写进了条件。
域名不一定会随入站请求一起到达。应用可能把域名交给内核,也可能在本机先解析,再仅传一个 IP。启用 sniffing 后,内核可尝试从受支持的流量里识别域名,例如 HTTP 请求中的主机名或部分 TLS 握手中的服务器名,但不能保证每条连接都能识别,也不会因此解密应用流量。某些配置还区分仅将识别结果用于路由与改写实际目标。为便于验证,先用能明确提交域名的应用测试,确认基础分流后再考虑启用嗅探。
03 发起连接
outbounds:出站协议、标签与默认出口
标签用来引用,协议才决定行为
outbounds 定义请求交给哪个处理器。把某项命名为 direct 只是便于人读;真正执行直连的是 freedom。同理,阻断项通常取名 block,实际由 blackhole 处理。取名本身不会改变出站行为。如果复制配置时只复制了路由规则,没有复制同名出站,就缺了被引用的对象。反过来,定义了一个阻断项而从未让规则选中它,也不会主动阻断任何指定请求。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
]
}
在这种不另设默认出口的常见配置里,没有规则命中的请求会落到首项。把阻断项移到第一个位置,即使不改一条规则,也会改变所有未命中流量的结果。默认项和显式兜底规则不是一回事:前者在没有规则命中时生效,后者一旦写成广泛条件,就可能把后面更具体的规则挡住。审阅配置时,应先确定想用哪个出口处理未知目标,再决定依靠首项还是明确写一条放在末尾的通用规则。
远端服务参数分为协议与传输两层
远端出站一般同时涉及协议参数和连接参数。protocol 选定内核使用的协议,settings 按该协议描述远端地址、服务端口及身份信息;streamSettings 则描述这条连接使用的传输和安全层。两部分都要与远端提供的配置相符。把一个条目的传输段直接移植到另一个条目,可能导致协议身份仍正确,但路径或握手条件不匹配。排查时按字段所属层级比对,不要把所有握手失败都归到订阅更新上。
看到多个名称像“地址”的字段时,先确认各自服务于什么阶段。建立远端连接需要拨号地址;安全握手可能还要使用服务器名;某些传输还有独立的路径或主机名要求。它们在某些服务上相同,却不能当成可随意替换的同义字段。把拨号域名改成 IP 也不等于其余名字都应跟着改。单节点参数如何由分享链接传递,可参照分享链接与订阅地址的区别,而不要把整条链接粘进一个 JSON 地址字段。
区分“规则选中”与“出站连通”
路由命中只是选择了处理器,不保证它能建立连接。直连失败时,要看本机是否能解析目标、是否有到目标的网络路径,以及目标端口是否可用。远端出站失败时,先区分能否拨通远端地址和能否完成该出站的协议握手,再区分是所有目标都失败,还是只有一个目标失败。阻断是有意不转发请求,示例中的 none 不提供有文字说明的阻断页面,应用只看到连接失败并不奇怪。
出现“选了另一条节点却仍像走直连”的情况,也不要只凭网页是否打开判断。直连和远端转发都可能让同一网页加载成功;旧的长连接也可能在切换后继续短时间存在。更可靠的做法是先确认新请求确实进入指定入站,再检查日志或对照实验所反映的出站选择。若两个出站看起来都失败,可以先用最小配置保留单一的直连出站。这样能把应用到本地入口这一段,与依赖远端服务的链路拆开验证。
04 匹配规则
routing:规则顺序、目标类型与出站引用
从前往后找,命中一条就停止
routing.rules 是顺序表,不是给每个候选规则打分的列表。较宽的规则写在前面时,后面更具体的条件也可能永远用不上。例如先把测试入口的所有请求交给直连,再写同一个入口下某个域名的阻断规则,域名规则会被第一条提前截住。检查这种问题时,可从最上方开始逐条问“这一条是否已经满足”,而不是只盯着预期命中的那一项。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
}
第一条同时要求请求来自 local-socks,并且目标完整域名为 example.org。不同条件字段需要同时成立,而同一个列表里的候选通常取其一,例如域名列表中的任一模式匹配即可。想实现“满足域名条件或满足目标网段条件”时,通常应拆成两条规则,不能指望把 domain 和 ip 放在同一对象里就会产生“或”的关系。这也是把多条规则合并后命中率反而下降的常见原因。
域名规则不匹配网页路径
用 full: 限定完整域名;用 domain: 匹配该域及其子域。前者不会把子域一起收入,后者也不是对整条网址查找任意子串。配置里填的是主机名,不写网址前缀、路径、查询参数或页内锚点。一次网页访问可能先重定向到另一个域名,再从第三个域名加载静态内容;看见页面的一部分成功不代表所有请求都命中同一条规则。测试时先用一个明确的主机名,并核实失败的是主文档还是后续资源。
IP 规则对目标地址匹配,可使用单个地址或 CIDR 网段。端口条件针对连接的目标端口,不是本机 SOCKS 监听端口。如果应用提交的是 IP,域名条目通常不能直接匹配,除非内核从流量中识别出了可用域名。反过来,应用提交域名时,是否在路由阶段解析成地址供 IP 规则使用,取决于路由自己的 domainStrategy。不要把路由找不到可匹配的地址误判为出站已经完成了解析并连接失败。
域名转换策略与规则库
路由的 AsIs 不为匹配 IP 规则而额外解析域名。IPIfNonMatch 会在首次查找没有命中时尝试解析后再查找,因此一条能在首轮命中的宽泛兜底可能让解析机会消失。IPOnDemand 则允许路由在匹配需要 IP 条件时触发解析。配置时先确定确实需要用域名结果匹配地址范围,再选择对应方式。若只是按主机名分流,不必为此引入一次额外查询及其失败分支。
geosite: 和 geoip: 依赖实际加载的资源文件及其分类名称。同名分类并非固定不变,同一个域名或网段是否归入分类,应以正在使用的资源为准。内核报资源找不到、分类不存在,和资源加载正常但某条地址未被收录,是不同层面的故障。可以先用明确的域名或一小段已知网段证明匹配链路,再换成分类。这样相同测试失败时,问题范围才落在规则库或其更新结果上。
05 解析域名
dns:内置解析器、静态映射与查询来源
先找出是谁在解析
应用可能自己解析域名再把 IP 交给入站,也可能把域名作为代理请求的一部分交给内核。后一种情况下,内核仍可能把域名交给远端处理,或在路由匹配和直连拨号阶段自行解析。顶层 dns 配置控制的是使用内核解析器的查询,不会自动接管所有应用或操作系统发出的查询。浏览器开启独立的解析方式时,操作系统查询工具和浏览器给出的结果也可能不同,两者都不足以单独证明内核使用了哪套设置。
先按具体连接列出链路:应用提交的目标是域名还是 IP,路由是否为了匹配地址触发查询,最终出站是自己解析还是把目标交给远端。几个阶段可能查询同一个域名,也可能一个都没有触发。例如应用把 IP 传给内核,直连出站只需拨该地址,那么加一条针对原始域名的静态映射通常不会改变结果。想验证映射时,测试请求必须保留域名,并且让所选出站实际调用内核的解析器。
{
"dns": {
"hosts": {
"sample.test": "127.0.0.1"
},
"servers": ["localhost"]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": { "domainStrategy": "UseIP" }
}
]
}
看懂 hosts、servers 和出站的 domainStrategy
例中的 hosts 把测试域名指到回环地址,只影响使用这份 DNS 配置的内核。servers 中的 localhost 表示使用本地系统的解析能力,不是叫你在回环地址另起一个 DNS 服务。直接把字面地址 127.0.0.1 当成 DNS 服务器填进去,与使用这个特殊值不是同一件事:前者要求相应地址和端口上真的有可响应的服务。静态映射也只返回地址,不代替应用协议握手,不替目标域名提供证书。
freedom.settings.domainStrategy 控制直连出站如何处理域名目标,和 routing.domainStrategy 分工不同。这里用 UseIP 让直连出站解析后再尝试拨号;只调整路由的策略,不能据此断言最终拨号用了哪一个地址。测试时可让已知可用的本机 HTTP 服务监听回环地址,并从支持提交域名的 SOCKS 应用访问测试域名及服务的实际端口。如果服务按请求主机名区分站点,还要检查它是否接受该测试主机名。
上游可以使用简单的服务器项,某些内核也支持用对象给特定服务器划定域名范围。按域分配上游时,命中优先使用哪一项与失败后是否还有回退,是两个问题;还要区分返回空答案、查询超时和返回了不合预期的地址。如果多个查询方案一次全部启用,症状往往只能说明某个结果异常,无法说明错误来自哪个上游。先保留一个已知可用的解析路径,再加入域名范围和回退限制,逐项验证更易定位。
地址族、缓存与 FakeDNS
同一域名可能同时有 IPv4 和 IPv6 地址,而当前网络未必能连通两种地址族。应先对照解析结果与实际拨号地址,再判断是否需要限制查询或出站使用的地址类型;只压掉一种查询结果,不能修复那个地址族的底层连通性。改静态记录后也可能仍看到旧地址,因为应用、操作系统、内核或上游各自可能保有缓存。验证时应发起新连接,并明确刷新的是哪一层,而不是只重复刷新网页。
FakeDNS 返回的是供代理流程识别的虚拟地址,要由同一路径上的内核还原关联的域名,不是对真实地址缓存的通用替代。如果应用拿到虚拟地址后绕开了内核,或地址映射已经丢失,后续连接就难以按原来的域名处理。普通 SOCKS 示例不需要启用它;要分析透明代理中地址如何交接,可以再看FakeDNS 原理与适用场景。先把普通解析走通,后面才有对照判断虚拟地址所在的环节。
06 管理连接
policy:连接时限、用户级别与统计开关
级别是策略索引,不是权限排序
policy.levels 把一组参数关联到用户级别。在 JSON 对象里,级别键用字符串,例如 "0";协议设置里可指定用户级别的字段通常写数字。级别不是套餐名称,也不是数字越大权限越高。哪个连接使用哪一级,取决于相关入站协议及其用户级别字段。初次排查可从默认级别入手,而不是在 policy 里创建一个事实上没人引用的新级别,随后误以为改过的策略没有生效。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 3,
"downlinkOnly": 10
}
},
"system": {
"statsInboundUplink": true,
"statsInboundDownlink": true
}
},
"stats": {}
}
这是要并入根对象的片段,不是单独启动用的配置。数值用于说明字段含义,并非推荐给所有网络的统一参数。策略既不替路由选出站,也不替入站改监听范围。遇到入口访问被拒、某个条目无法拨通等问题,首先检查出错阶段;在握手根本没有开始时,增加某个会话时限通常不会提供线索。反之,如果每次都能完成握手,只在连接空闲一段时间后断开,才值得用策略参数做对照。
四种时限分别约束哪个阶段
handshake 以秒为单位,指入站协议等待握手完成的时限,不是供所有网络操作共用的总计时器。它不等同于浏览器等待首字节的时间,也不等同于与远端服务建立连接的上限。检查这项时要区分客户端连到端口却迟迟没有送完握手,与握手完成后对端迟迟不返回数据。仅凭应用界面上显示“连接超时”,无法判断该调的是入站握手还是更下游的连接参数。
connIdle 衡量的是连接的无数据活动时间,而不是从连接建立开始算的固定寿命。一个持续收发数据的连接,不应因为到达这个秒数就被当成空闲连接。uplinkOnly 与 downlinkOnly 处理一侧结束后另一侧仍可传输的阶段:只剩上行或只剩下行时分别适用。先确认应用是否会提前关闭发送方向,或是否需要继续接收较长响应,再判断对应时限是否合适。
较短的空闲时限可能更早回收长期不用的连接,但也可能让偶尔才传数据的会话不得不重连;拉长时限则会让暂时无用的连接保留更久。如果断开周期与配置值相近,只能作为线索,因为应用、远端或中间网络设备也会管理自己的超时。对照时把观察拆成持续传输、完全闲置和单向结束三种场景。只修改与现象对应的一项,保留其余参数,才有机会分辨是内核策略还是链路上其他组件先结束连接。
统计开关本身不会生成界面报表
示例的顶层 stats 启用统计模块,policy.system 的两个开关要求按入站记录上行和下行。给需要区分的入站设置稳定标签;改名之后,读取方也要查新名称。另一些开关用于用户级统计,能否关联到用户需要看协议提供的用户标识,不能把系统级入站计数等同于每个应用或每个订阅条目的用量。两台设备恰好走同一个监听器时,入口计数可能包含两台设备的请求。
统计开关只是让内核记录相关指标。是否能看到数值,要看客户端是否接入统计读取,以及它读取的是哪一个运行实例。没有读取通道时,开关置为真也不会在配置文件里写下一份报表;重启后,旧进程的计数也不会自然接进新进程的累计值。验证时用单个入口发一小段可识别的流量,再检查同一实例的计数变化。不建议为查看计数把管理接口开放给其他设备。
07 组合验证
完整配置示例:本机 SOCKS、直连与单域名阻断
在单独的测试配置里动手
以下配置没有远端出站,不需要订阅或账户。它用一个仅本机可访问的 SOCKS 入站,配一条完整域名阻断规则,其他请求交给首项直连。直连出站请求内置解析器处理域名,解析器再通过本地系统获得结果。这个组合有意不使用规则库、嗅探或远端连接:只要为应用选对代理类型,就可以把第一个实验集中在入站、目标形状和出站引用。需要正常导入订阅时,仍按订阅导入教程操作。
开始前,保留现有可用的客户端配置,在支持加载自定义配置的测试环境里选择单独的文件。确认当前运行的内核能读取这种完整 JSON,并检查示例端口是否已被客户端正在使用。若要换端口,只需同时替换示例中的入站端口与测试应用里的代理端口;不要把它写进域名匹配项。测试只改一个应用的代理设置,不必让整台设备的流量参与。这样实验结束后只需还原那个应用,也更容易判断观察到的请求来自哪里。
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {
"domainStrategy": "UseIP"
}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
},
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": { "connIdle": 300 }
}
}
}
按可观察结果验证,不只看网页能否打开
先看启动是否成功:如果解析失败或监听失败,不必打开浏览器反复试。启动后,在测试应用中明确设置 SOCKS5,地址与端口填本机监听值,并选择通过代理提交域名的方式。访问一个已经确认在本机可直接连接的测试主机,再使用不同连接访问 example.org。预期前一个请求使用直连,后一个命中阻断。前者是否成功取决于本机和目标本身可达,不能用一个原本就连不上的目标作为成功组。
阻断验证也需要基线。可以先临时去掉唯一的规则,把 rules 保留为空数组,重新加载后确认测试域原本可达;再恢复规则并发起一个新请求。如果规则存在时失败、移除后成功,才说明差异与这条规则有关。两个状态都失败时,不能据此确认阻断成功;两个状态都成功时,则优先怀疑请求没有经过这个入口、应用先把域名转成了 IP,或使用了配置修改前的连接。
再做一项反向核对:用同一入口访问与阻断目标不同的已知主机,确认移除和恢复规则对它没有相同影响。这样能把“所有请求因为本地代理设置出错而失败”与“只有一项被规则阻断”区分开来。支持同时记录目标和入站信息的日志也很有用,但不同内核和客户端的记录格式并不一样。重点是核对当前时刻的新请求、目标形状和选中的出口,不必追求日志文本与某篇教程的截图一字不差。
扩展配置时保留一个可回退的基线
要增加远端出站时,可以先保留当前直连首项和阻断规则,单独把新出站加到后面,再写一条只用于已知目标的规则指向它。加载成功后分别验证旧目标与新目标;旧目标保持原行为,才能说明这次增量没有不小心改变默认路径。若把示例复制回客户端的日常配置,不要整段覆盖原有出站数组或 DNS 对象。应逐个合并并检查引用,尤其要确认生成的标签不与已有对象重名。
08 排查与维护
V2Ray 配置故障:从加载到目标连接逐层定位
无法启动:先区分读取、校验与绑定
完全无法启动时,把第一个错误保留下来。报解析位置,先看括号、逗号或复制进来的全角符号;报字段类型或协议名称,检查字段层级与所选内核;报地址无法绑定,则回到本机接口和端口占用。三种错误的处理方向不同。客户端也可能只显示概括性的启动失败,可从它提供的内核日志中找第一次失败的位置。后续连续出现的连接错误,可能只是入口从未启动,不必与第一条错误并列处理。
若同一文件在另一个环境中能加载,先确认比较的是同一种配置格式,而不是一个客户端导入了条目、另一个直接读取整份 JSON。规则库路径、日志目录和端口是否可用也取决于运行环境。相对路径的起点未必是配置文件所在目录,不要以文件管理器里“两个文件放在一起”为存在证明。先用不引用外部资源的配置验证能启动,再逐项恢复文件引用,比把所有路径同时复制到新的目录更容易找到差异。
可以启动但行为不符:找第一处偏离预期的环节
| 现象 | 先核对 | 下一步 |
|---|---|---|
| 应用连不到本地代理 | 监听地址与端口 | 确认进程启动、地址族一致 |
| 握手失败 | 应用的代理协议 | 核对入站协议、认证方式 |
| 命中错误出站 | 目标形状与规则顺序 | 核对入站限制、标签和默认项 |
| 出站正确但连不通 | 解析和出站拨号 | 区分地址不可达与远端握手失败 |
| 仅空闲后断开 | 连接阶段和持续时间 | 对照应用、策略与远端时限 |
“全部应用都不通”和“只有一个应用不通”是有用的区分。如果所有请求都没到入站,优先检查系统代理或测试应用的独立设置;有些应用并不读取系统代理。如果只剩某个应用失败,检查它是否让代理处理域名,是否改走其他传输方式,以及是否沿用了已有连接。不要为了证明一条域名规则,把设备的代理模式、应用解析方式和内核的路由策略一起切换;否则即使恢复正常,也无法指出是哪一项起作用。
如果入口有请求、规则也指向预期出站,下一步就不是重排路由。拿直连和远端两种路径分别判断错误发生在何处:本地地址解析失败、远端地址不可达、出站握手被中断,或目标服务连接本身失败。某个目标的成功也不能推出其他目标都可达。比较时保持测试应用和目标一致,变更一项后发起新请求。遇到间歇性的故障,记录现象出现前后的时间和是否经历切换网络或休眠,便于分离配置问题与偶发链路变化。
用临时日志和小范围改动保留证据
{
"log": {
"loglevel": "info"
}
}
需要更多线索时,可把片段里的 loglevel 合并到已有的 log 对象,短时提高日志详细程度。客户端可能还单独控制日志的显示位置和过滤方式;没有在窗口看到记录,不一定说明内核没有收到请求。只复现一个动作并记下时间,检查它是否出现在预期实例的日志里。排查结束后恢复日常级别;分享诊断信息前,移除订阅地址、身份信息和可关联个人的目标记录,不要直接转发完整配置。
日常维护可以保留两份不同用途的副本:一份是确认能启动的最小样例,另一份是最近一次验证可用的实际设置。更新客户端或切换内核后,先用日常设置跑一次固定的入站与分流测试,再启用新增功能。若出现回归,用最小样例判断通用结构是否仍能运行,然后逐块加入原配置的 DNS、路由与远端出站。最后记下哪些项由客户端生成、哪些项来自外部资源、哪些项是手工维护的。下次覆盖或迁移时,就能知道该保留哪一层。