SETTINGS REFERENCE

Shadowrocket Settings 设置项参考

先确认设置作用于哪里,再修改取值。本页是按问题查阅的官方手册;首次导入已有订阅、选择节点和建立连接,请先读使用说明,完成主线后再返回对应章节。

Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓和 Linux。本页以 iPhone / iPad 的 Settings 界面词为查阅基准,其他平台仅在相应入口实际存在时参照,不把系统专属功能推定为各平台共有功能。

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。获取入口与系统放行步骤见全平台下载页;iPhone / iPad 系统要求以 App Store 页面标注为准。客户端一次性买断 ≠ 线路套餐:订阅或服务器信息从你的服务商处获取,本站不提供、不销售、不推荐此类服务。

默认值不是推荐值的同义词

已有安装可能恢复过备份、导入过配置或保留过旧设置。本页不为未核实的开关编造统一默认值;“保留默认”指保留当前安装中未经修改的初始状态,并先记录界面显示。每次只改一个变量,验证后再决定是否保留。

01 / SCOPE

作用范围、默认状态与修改顺序

先区分 Settings、Config 和系统权限

排查设置之前,先把问题分成三层。Settings 管理客户端行为,例如测试方式、日志和应用偏好;Config 里的当前配置决定规则及部分网络处理方式;系统权限决定客户端能否建立系统网络连接、访问局域网或使用云端能力。相同现象可能来自不同层:连接开关无法保持,不等于 DNS 一定错误;网页打不开,也不能直接认定是规则失效。先记录当前页面、所选配置与实际提示,再进入对应设置,能够减少反复修改却不知道哪项生效的情况。

本页说的“默认状态核对”是一项操作,而不是要求把全部开关恢复到某个固定组合。首次查看时,记下字段当前内容、是否为空、是否由配置提供,以及是否存在系统权限提示。经历过迁移的设备,其界面值不能代表全新安装默认值;从云端恢复的内容也不一定适用于当前网络。不要为了取得一组所谓标准值而删除正在使用的配置或重装应用,这会同时改变多个条件,使问题更难复现。

Global Routing 决定规则是否参与判断

Global Routing 的配置、代理、直连分别对应 Config、Proxy、Direct。Config 按当前配置的规则处理请求;Proxy 用于让相关流量按代理姿态处理;Direct 用于直连姿态。三者不负责修复服务器参数,也不表示连接目标一定可达。排查规则时应使用 Config;短暂切换到其他姿态,只是为了比较同一个目标在不同路径下的表现。测试完成后恢复原来的姿态,否则后续修改规则可能看起来没有效果。

姿态查阅重点适合的验证问题
Config当前配置、规则顺序与策略该请求命中了哪条规则?
Proxy所选节点及其连接参数代理路径本身是否可用?
Direct本地网络与目标可达性脱离代理路径后现象是否变化?

用一份可回退记录替代连续试开关

建议记录四项基础信息:所处网络是 Wi-Fi 还是蜂窝网络,当前使用哪个配置与节点,Global Routing 处于哪种姿态,以及故障发生在连接前还是连接后。然后写下准备修改的一个字段和预期变化。例如准备调整 DNS,就先规定验证目标是“同一域名能否解析并打开”,而不是笼统地观察网络有没有变快。测试对象保持一致,才能把结果与这次设置变更建立联系。

修改后先重新发起请求;如果设置作用于隧道建立阶段,可断开后重新连接再测。长连接应用可能继续复用已有会话,因此旧页面仍然报错不一定代表新值未生效。关闭受影响页面并重新访问,比连续刷新更有解释力。若结果没有改善,先恢复刚才记录的值,再进入下一项。不要在一次测试中同时换节点、换配置、改 DNS 和打开 On Demand,那样即使恢复正常也无法确定原因。

推荐的初始取值原则

可正常工作的字段保持不变;服务商明确要求的协议参数按原始资料填写;自动重连和对外监听等附加行为,在基础连接通过验证后再启用。未知字段先保留当前初始状态,不根据名称猜测含义。

对需要精确定位的问题,可以给每次试验写一句结论:改了什么、请求如何发起、结果是什么、是否已回退。记录不需要包含订阅地址或密码。跨设备比较时也应分别记录,因为系统权限、网络和配置副本都可能不同。更多界面词可在术语表查阅;本页其余章节则沿着这套记录方法逐项展开。

02 / DNS

DNS:解析路径与网页打不开的定位

DNS 解决名称,不代替连接与规则

DNS 把域名解析成地址,是访问网站前常见的一步。一次访问还可能经历规则匹配、连接服务器、TLS 协商和内容传输,因此“延迟正常但网页打不开”不能仅凭一个测试数字归结为 DNS。先看日志能否得到目标地址,再看连接阶段是否失败。如果已经解析出地址但连接超时,继续替换解析服务器通常无法修复线路不可达或协议参数错误;如果连所选节点的服务器域名都无法解析,则应先处理建立代理连接之前的基础解析。

DNS 设置可能受到当前 Config 中相关内容影响。修改前要同时检查当前配置,避免在 Settings 改了一处,却仍由另一处设置决定行为。对于空白字段,不应直接解释为“没有 DNS”;它也可能表示沿用系统或配置提供的处理方式。默认状态以当前安装界面及所选配置为准。网络已经正常时,推荐保持原有解析方案;只有出现可复现的解析错误,才有必要建立对照并调整。

填写地址时先确认字段接受什么格式

先确认界面需要的是解析服务器地址、带协议的端点,还是配置文本中的一行参数。不同字段不能仅因名字都带 DNS 就互相复制。填写前检查前后空格、全角标点及换行;若使用加密解析端点,还要确认当前入口接受这种写法,并且端点本身能够访问。不要只看地址文字正确就认为链路已经可用,连接解析服务也依赖当前网络、证书校验和设备时间。

推荐优先采用已有配置明确要求且在当前网络可达的解析方案。需要更换时,先保留一条可工作的基础路径,不把多个来源不明的地址一次性填满。更多解析器不等于更稳定:如果其中一项响应异常,最终表现可能随请求变化。测试期间固定网络与节点,选一个此前出错的域名和一个平时正常的域名分别访问,记录是否都能返回地址,而不是只看单个页面偶然打开。

观察结果优先核对下一步
节点域名无法解析连接前的系统网络与基础解析先恢复基础网络,再建立连接
目标域名解析失败当前 DNS 设置及配置中的相关项只调整解析方案后重新请求
已有地址但连接超时所选策略、节点与目标可达性转查连接日志,不继续盲换 DNS
仅部分网络失败网络限制、地址族与解析端点可达性分别记录 Wi-Fi 与蜂窝网络结果

缓存、地址族与规则的交叉影响

系统和应用都可能保留解析结果,修改后立即刷新旧页面,可能仍然使用旧地址。先重新建立连接并重新发起访问;若当前界面提供清理 DNS 缓存的操作,可在记录后使用,但不要把清缓存当作长期解决方案。偶尔恢复而随后再现,说明仍需检查上游响应或网络变化。对于只在某个应用出现的问题,还要考虑该应用是否采用自己的解析路径,不能仅凭浏览器正常就断言所有应用都使用了同一组设置。

域名可能返回 IPv4 与 IPv6 地址,两种地址在当前网络中的可达性不一定相同。不要见到 IPv6 就直接关闭,也不要把某个地址族的故障误判成整个 DNS 失效。先通过日志确认实际连接的地址,再比较切换网络后的结果。涉及 IP-CIDR 或 IP-CIDR6 的规则时,还应核对解析得到的地址是否改变了规则命中;解析成功与分流符合预期,是两个需要分别验证的结论。

不要用固定地址替代所有域名验证

部分服务依赖域名、TLS 主机名和动态地址。直接访问某个 IP 失败,不足以证明 DNS 出错;直接访问成功,也不能证明基于域名的完整访问过程正常。

完成调整后,把正常域名和故障域名各重新访问一次,再观察日志中的解析及连接阶段。若只有特定网站异常,保留具体时间与失败阶段,避免继续扩大修改范围。关于这种“测试有响应、页面仍失败”的分层判断,可继续阅读DNS 问题排查说明。

03 / ON DEMAND

On Demand:自动连接条件与手动开关

先验证手动连接,再启用自动条件

On Demand 用于按条件触发连接行为,不是对服务器可用性的修复开关。只有手动选择节点、打开连接并访问目标都已通过验证,才建议设置自动条件。否则自动重试会与原始故障交织,出现“刚断开又连上”“切换网络后不停尝试”等现象。初次排错时先记录原有条件,再暂时停用 On Demand,让每次连接都由手动操作发起,这样才能准确判断失败发生在什么时刻。

默认状态应在当前安装的 On Demand 页面核对,包括总开关和下方每条条件。恢复过配置或设备备份之后,不能只看总开关就推断所有条件都已回到初始状态。推荐从最小范围启用:只为明确需要的网络情形设置行为,先完成一次进入和离开条件的测试,再逐步增加其他条件。不要照抄他人网络名称,也不要假设相同名称的 Wi-Fi 就一定具有相同访问能力。

网络条件与系统权限需要一起检查

如果当前界面提供按网络类型或 Wi-Fi 名称区分的条件,逐项确认它表达的是需要连接还是需要断开,以及是否存在覆盖范围更广的条件。网络名称按设备实际识别结果核对,空格、大小写和相似字符都可能影响判断。系统对网络信息的访问也可能受到权限限制;若应用无法取得用于匹配的信息,应先查看系统权限与页面提示,而不是反复新增同名条件。

测试顺序可以从当前 Wi-Fi 开始:记录手动连接状态,启用一条条件,离开该网络,再重新加入,观察是否出现预期行为。然后对蜂窝网络单独测试。切换时存在系统重新建立网络的过程,不宜在短时间内连续切换多次后只看最终开关位置。每一步等待网络稳定,再发起一次新请求,并把触发时间与连接日志对应起来,才能区分条件未匹配和连接建立失败。

手动断开后又连接,应查触发来源

当 On Demand 仍处于生效状态时,手动断开未必等于永久停止自动触发。系统在后续网络事件或请求发生时,可能重新按已有条件处理。因此需要持续断开时,应检查 On Demand 的总开关及相关条件,而不是反复点击连接开关。修改后再次观察系统 VPN 状态,确认没有其他仍在生效的自动条件。是否触发应以实际条件和系统行为为准,不用“开关坏了”概括所有重复连接。

同时要区分系统保存的 VPN 配置与当前连接状态。允许添加配置,表示系统具有相应连接配置,并不表示每时每刻都在传输流量。若曾拒绝权限或删除系统配置,On Demand 也不能绕过这个前提。先手动连接,按系统提示完成授权,再回到条件设置。有关授权与系统配置的关系,见添加 VPN 配置提示说明。

网络切换故障的回退顺序

记录条件 → 暂停 On Demand → 手动重连 → 在稳定网络验证 → 逐条恢复条件。不要同时删除系统配置和修改节点参数,否则无法判断是哪一项改变了结果。

自动连接不等于自动选择可用线路

触发连接、选择节点和确认目标可达是不同任务。On Demand 成功触发后,所选节点仍可能过期或参数不匹配;能够连接,也不代表所有目标都按预期分流。推荐保留一组可重复的验证对象:一个用于检查本地网络,一个用于检查代理路径,再查看当前规则命中。出现异常时先按这三层定位,不要为了让开关保持开启而不断放宽自动条件。

需要在公共网络先完成登录或确认页面时,应先保证基础网络可以使用,再验证自动连接。某个网络无法通过基础访问,属于前置条件未满足,不宜用更积极的重连条件掩盖。完成测试后,把条件的使用目的和适用网络写入自己的记录;日后网络名称、设备权限或使用习惯变化时,按记录逐项复查,比重新导入整套条件更容易维护。

04 / PING

Ping 与 Connectivity Test:测试结果的边界

先读测试方式,再解释延迟

Ping 是诊断入口,不应把所有测试都理解为同一种探测。实际结果取决于所选测试方式、测试目标以及当前网络;TCP 建连、普通探测和经过代理的应用层请求,覆盖的链路并不相同。进入设置后先记录当前方式,再运行测试。默认测试方式以当前界面显示为准,不在未核对的情况下把某种方式当作统一初始值。比较两次结果时,测试方式和目标必须一致,否则数字本身没有直接可比性。

节点显示有响应,通常只能说明本次探测覆盖的阶段获得了回应。它不能单独证明认证参数正确、目标网站可访问或持续传输稳定。反过来,超时也不总表示服务器完全离线:测试目标不可达、该类探测被限制,或超时时间不足,都可能产生类似结果。推荐把测试结果视为缩小范围的证据,再用真实请求验证,不把节点列表中的一个数字作为最终结论。

测试目标、超时和重复次数如何选择

如果当前界面允许指定测试地址,应选取自己有权使用、能够稳定访问且响应过程简单的目标。测试目标本身需要登录、发生重定向或限制访问时,会引入额外变量。不要频繁更换地址寻找一个看起来更小的数值。先保留原有目标做基线,确认失败可以重复,再只替换目标进行对照;若换目标后恢复,应继续确认是目标差异还是链路真的恢复。

若有超时时间设置,推荐先保留初始值。过短可能把正常但较慢的请求归为超时;过长则会使每轮测试等待增加,并不能提高服务器本身的可达性。只有确认当前网络建立连接确实需要更长时间时,再小幅调整并重新测试。对于重复次数,少量间隔测试通常比连续高频测试更容易阅读,也能避免把瞬间网络波动误当作长期表现。

测试层次能够提供的线索不能单独证明
服务器端口连接地址和端口是否可建立连接协议认证及目标访问正常
经过代理的请求本次代理请求是否完成所有网站与所有应用都正常
Connectivity Test当前测试条件下的连接表现未来网络切换后的持续可用性

超时后的检查顺序

先确认设备基础网络可用,再核对服务器地址与端口,随后检查协议类型和认证字段。Shadowsocks 的加密方式与密码、VMess 或 VLESS 的身份字段、Trojan 的认证和 TLS 相关设置,都应与原始服务器资料逐项对应。WireGuard 与 Hysteria2 也有各自参数,不能仅因为某些字段看起来相似就互相套用。服务商资料不明确时,从你的服务商处获取准确参数,不用随机修改取值试碰结果。

设备时间同样值得检查。时间偏差可能影响证书验证或具有时间要求的连接过程,但校准时间也不是所有超时的通用修复。先让系统时间与时区设置正确,再重复原测试。如果只有某个节点异常,保持网络不变并检查该节点;如果所有节点同时异常,则优先检查共同条件,例如网络、解析和测试目标,避免逐个改动本来正确的节点参数。

测试正常后仍要做一次真实访问

选中准备使用的节点,确认 Global Routing 的姿态,建立连接后发起一个新请求,并在 Log 中核对它走了预期策略。不要拿后台已经建立的长连接作为唯一验证对象;新打开的页面更容易对应到具体日志。对上传、流媒体或长时间会话有要求时,还应使用自己的实际业务作进一步验证,短暂探测无法替代这些应用场景。

排查记录中保留测试方式、网络类型、失败阶段和发生顺序即可,通常不需要公开完整节点信息。若希望按固定步骤处理节点超时,可阅读节点超时与连接失败排查顺序。测试通过后恢复日常测试频率,避免为了观察数值而持续触发大量探测;稳定完成所需请求才是保留某项设置的依据。

05 / LOG

Log 与 Data:按请求顺序读取故障线索

把日志当作过程记录,而不是结论列表

Log 的价值在于还原一次请求经历了哪些阶段:接收到目标信息、进行解析、匹配策略、建立连接,最后完成或失败。不同协议与日志级别显示的细节可能不同,不必要求每次都出现完全相同的行。阅读时先寻找与刚才操作时间相近的记录,再沿同一目标或会话查看后续事件。单独截取一行错误容易丢失上下文,例如前面已经有解析失败,后面出现连接失败就可能只是连带结果。

日志默认是否记录、保留多少内容以及可选级别,以当前 Log 页面为准。推荐日常保留能够满足基本排查的状态,不长期维持最详细记录。需要诊断时临时提高细节,复现一次后及时恢复。日志越详细,越可能包含访问目标、网络信息和配置线索,也会增加阅读负担。先明确要定位的阶段,比把全部记录打开再逐行搜索更有效。

用一次干净的复现建立时间对应

开始前记录当前网络、配置、节点和 Global Routing 姿态。如果准备清理旧日志,先保存仍有价值的排查结论;清理只影响记录,不会修复网络。然后减少其他应用的网络活动,只打开一个故障目标,记下操作时间,再回到 Log 查找。系统后台仍可能产生请求,因此不能保证日志只包含这一项;需要结合目标域名、时间和请求顺序判断,而不是把最新一行直接当成故障请求。

找到目标后,先确认它有没有进入客户端处理范围,再检查策略。若规则预期走 PROXY,记录却指向 DIRECT,优先检查规则与 Global Routing;若已经走预期策略但认证失败,则查看节点参数;若连接成功后应用仍报错,还需考虑目标响应、应用会话或其他关联请求。一个网页通常会访问多个域名,主页面成功并不意味着图片、登录或接口请求也成功,必要时按访问过程继续追踪。

日志阶段优先检查应避免的误判
解析阶段失败DNS 与基础网络直接重填全部认证参数
策略不符合预期Global Routing、当前配置、规则顺序把分流问题当成服务器离线
认证或 TLS 阶段失败协议字段、主机名、系统时间只因端口可连就排除参数错误
连接建立后中断网络切换、目标响应及会话持续性把一次中断概括成所有请求失败

Data 统计与具体请求日志不能互相替代

Data 中的统计用于观察某个范围内的流量情况,不等于逐请求成功率。存在流量,只能说明有数据活动;它可能来自后台服务,也可能是失败前已经交换的数据。累计值还受统计周期和重置操作影响,不宜直接用来比较两套设置的效率。需要判断某个网页是否按规则处理,仍应回到对应请求的 Log,而不是仅看总流量有没有增加。

同样,系统状态栏显示连接,也不意味着每个应用请求都成功。隧道状态、规则命中和目标响应分别属于不同层。推荐先用状态判断连接是否建立,再用 Log 判断请求路径,最后用实际应用判断功能是否恢复。三者一致时,结论才较完整。若只有统计变化而找不到目标日志,应重新确认复现方式、日志记录状态,以及观察的是否是当前连接产生的数据。

分享排查材料前先移除敏感信息

不要公开订阅链接、认证字段、完整二维码或云端配置地址。保留错误阶段、策略类型和必要上下文即可;域名与地址可替换为明显的示例文字,但应说明哪些字段已经替换。

排查结束后,恢复临时调整的日志级别,并保留精简结论:问题如何复现、哪个字段改变了结果、最终采用什么取值。若一次改动没有改善,也记录已回退,避免下次重复同一试验。清晰的过程记录比大量未经整理的日志更便于维护;涉及规则顺序时,可接着阅读自定义规则与 FINAL 说明。

06 / WIDGET

Widget:快捷入口、状态显示与系统刷新

Widget 是操作入口,不是独立连接引擎

Widget 用于在系统允许的位置提供快捷操作或状态信息,实际能力以当前设备提供的组件为准。它不能替代首次授权、有效配置和可用节点。首次使用应先在 Shadowrocket 内完成手动连接,再从系统组件入口添加可用的 Widget,观察它能否正确打开应用或执行界面提供的动作。若系统没有显示某种组件,不应推断是配置文件缺了一行,也不要通过网络规则寻找与系统组件无关的修复。

Widget 的默认状态需要分两处核对:应用内相关设置,以及系统桌面或组件页面中的实际添加情况。应用具备 Widget 入口,不代表系统已经放置组件;已经放置组件,也不代表其中显示的内容会持续实时刷新。推荐先保留应用初始选项,只添加日常确实需要的入口。组件数量和尺寸应服务于操作可辨认性,不需要为了排查连接而同时添加所有形式。

状态文字可能晚于实际连接变化

系统会安排组件刷新时机,因此 Widget 中的文字与应用内当前状态可能短暂不同。点击连接后,应回到应用与系统 VPN 状态确认结果,再发起一次真实请求。不能仅凭组件仍显示旧状态就连续点击,多次操作可能让连接状态来回变化,反而难以判断哪一次动作生效。先完成一个动作并验证,再进行下一步,是处理组件交互问题的基本方法。

如果状态长时间没有更新,先打开应用确认当前连接,再返回系统组件页面观察;仍不一致时,可在保留应用配置的前提下移除并重新添加 Widget。重新放置组件只是重建显示入口,并不修复节点或 DNS。若应用内部连接也失败,应离开组件排查分支,回到基础网络、权限和节点参数。不要在组件故障尚未定位时删除全部 Config,那会把显示问题扩展成配置恢复问题。

锁屏、系统权限与可见信息

锁屏或其他系统位置是否可放置某种组件,取决于设备系统与当前可用组件形式。只使用系统实际提供的添加入口,不把其他系统版本的布局当作本机必备项。若组件需要打开应用完成操作,应按系统交互继续;这不表示连接功能失效。对于需要解锁后才能完成的动作,先解锁再验证,避免把系统访问限制误判为应用不响应。

还应考虑组件展示的信息是否适合出现在他人可见的位置。节点备注可能包含个人设备、地区或用途线索,配置名称也可能暴露使用习惯。推荐采用自己能够辨认但不过度具体的名称,并在锁屏上只保留必要内容。更改名称后检查组件是否更新;名称只是识别标签,不要为了让显示整齐而改动服务器地址、认证字段或订阅地址,这些字段承担完全不同的用途。

区分快捷操作失败和连接失败

应用内可以正常连接而 Widget 操作异常,先查系统组件与刷新;应用内同样无法连接,先查权限、网络与节点。两条分支不要同时修改设置。

与 On Demand 联动时看最终触发条件

Widget 手动断开后又恢复连接,可能与仍生效的 On Demand 条件有关,而不一定是组件重复执行动作。先在应用里核对自动条件,暂时停用后再通过 Widget 测一次。如果此时操作符合预期,应调整自动连接条件,而不是反复移除组件。测试中固定网络,避免恰好在切换 Wi-Fi 时观察,从而混淆手动操作和系统网络事件的影响。

维护时建议把 Widget 放在整个连接流程的最后验证:基础网络正常,应用内可连接,规则符合预期,自动条件已检查,然后再测试快捷入口。这样即使组件暂时不可用,也仍有应用内操作路径。有关首次连接与系统授权的完整主线,返回使用说明即可;本章只处理入口、状态和刷新,不把 Widget 当作提高网络性能的设置。

07 / ICLOUD

iCloud 同步:同步范围、冲突与恢复

先确认同步对象,不把同步当作连接前提

iCloud 相关功能用于在系统和应用允许的范围内保存或同步数据,不是建立代理连接的必需步骤。先在本机确认已有配置可用,再考虑同步到其他设备。同步入口实际包含哪些数据,应以当前页面列出的项目和操作为准;不要假设节点、配置、偏好、日志和系统权限都会整套复制。尤其系统 VPN 授权仍需在相应设备上确认,云端出现配置文件并不等于另一台设备已经能够连接。

默认状态同样应在本机核对。应用内开关、系统 iCloud 设置以及所用账号都会影响结果,不能仅凭一个开关已开启就断言同步完成。推荐先保留本地可用副本,并选择一份可辨认的配置做小范围验证。若界面提供导入、导出或从云端选择文件等不同操作,应先分清它们是复制一份内容,还是维持后续同步关系;操作名称相近,不代表后续更新行为相同。

首次启用前建立可恢复的本地基线

在操作前记录当前正在使用的配置名称、来源和最后一次人工修改内容。需要备份时,使用当前应用提供的导出方式,并把文件保存在自己可管理的位置。备份文件可能含有订阅地址与认证信息,应按敏感资料处理,不放入公开目录或共享截图。只有能够确认备份内容和恢复路径,才继续处理云端副本;同步不能替代独立备份,因为错误修改也可能被传播到其他设备。

第一次测试可先在一台设备完成改名或其他容易识别、不会影响连接的改动,等待另一台设备出现预期变化,再进行反向验证。若实际入口只负责文件导入,就应把它理解为一次性复制,而不是等待自动变化。不要为催促同步而反复切换账号、连续导入同一文件或删除本地配置;这些操作可能制造更多副本,让哪一份是有效配置变得不清楚。

两台设备同时修改时如何处理

发生冲突时,先暂停在另一台设备继续编辑,把两端内容分别保存。不要单看文件名称判断新旧,因为名称相同也可能内容不同;也不要把系统显示的时间直接等同于每一条设置的修改时间。比较重点是服务器字段、规则顺序、策略名称和自己最近改过的部分。确认哪一份是准备保留的基线后,再通过明确的导入或保存动作统一,避免在不清楚方向时选择覆盖。

订阅更新与云端同步是两条不同链路。Subscribe 更新通常从已有服务商地址取得内容;云端操作则处理设备之间或文件位置之间的数据。节点未更新时,先检查订阅更新结果,而不是先关闭 iCloud;本地规则被恢复成旧内容时,才检查导入来源和同步副本。还要留意订阅更新是否会替换自己修改的部分,重要自定义内容应单独记录,不依赖记忆重新填写。

现象先核对推荐动作
另一台设备看不到内容账号、系统云端权限、实际同步对象用单份配置验证,不反复批量导入
出现多个相似副本是否多次执行了一次性导入确认可用基线后再整理名称
节点内容没有刷新Subscribe 的更新结果先排查订阅链路
配置存在但无法连接本机授权、网络与服务器参数按新设备首次连接步骤验证

恢复后仍要逐项验证运行环境

恢复成功的判断不是文件已经出现,而是能选择预期配置、确认节点信息、建立连接并命中正确规则。不同设备所处网络不同,DNS 和 On Demand 条件也可能需要分别检查。不要因为一台设备可以使用,就把另一台设备的权限提示视为多余步骤;先按系统提示完成本机授权,再按照本页的分层方法验证。

如果担心同步继续覆盖刚修复的内容,先保留两份副本并暂停继续编辑,确认当前入口的同步方向后再恢复日常操作。涉及订阅地址时,从你的服务商处获取准确资料,不公开链接求助。关于 Subscribe、手动填写和扫码的入口区别,可阅读订阅导入方法;导入方式不同,也会影响后续应该在哪里更新。

08 / PROXY AND CONFIG

Proxy 端口、规则联动与最终回退

本地监听端口不是远端服务器端口

Proxy 相关端口需要先区分方向。Add Server 中的端口属于远端服务器连接参数,应与服务商资料一致;本地代理监听端口则是其他程序连接本机入口时使用的端口,两者没有必须相同的关系。只使用系统连接功能时,不必为了“设置完整”额外开启本地监听。若当前平台和界面提供相关入口,再按实际需要配置;不能把某个平台的监听能力直接推定到所有设备。

默认端口、监听地址和是否允许局域网访问,应以当前界面为准,本页不指定一组跨平台通用初始数值。推荐没有明确需求时保留原状。确实需要其他程序使用本地代理时,先只在本机验证,确认代理类型与目标程序支持的类型一致。HTTP 与 SOCKS5 不是可以任意互换的标签,目标程序选择错误类型,即使端口能够连接,也可能无法完成请求。

监听地址与访问范围要分别确认

监听在回环地址表示只供本机使用;对其他地址监听可能扩大可访问范围。不要为了排查端口问题直接开放到整个局域网。先检查端口是否被其他进程占用,目标程序是否填写了正确的本机地址,以及代理功能是否确实已启动。若需要局域网设备访问,再检查系统权限、防火墙、当前网络隔离和应用提供的访问控制。仅在自己管理的网络内进行测试,不把监听端口暴露到不受控的网络。

端口冲突时,选择当前系统允许且未被占用的端口,并同步修改使用它的程序;只改一端会形成新的故障。修改后重新发起连接,必要时重启相关监听功能。验证完成后,关闭临时开放的访问范围。局域网地址会随网络变化,另一台设备保存的旧地址也可能失效,因此跨设备访问失败时应先核对当前地址,而不是立即修改远端节点。

规则只决定路径,不修复协议参数

在 Config 姿态下,规则通常按从上到下的顺序匹配,命中后按对应策略处理。DOMAIN-SUFFIX 适合按域名后缀匹配,IP-CIDR 与 IP-CIDR6 按地址段匹配,GEOIP 依赖相应地址归属判断,FINAL 作为兜底。PROXY、DIRECT、REJECT 分别表达代理、直连和拒绝策略。规则写对了,也不能弥补密码、证书主机名或服务器端口错误,必须把分流验证与连接验证分开。

下面只展示可用于理解顺序的规则段,不是完整配置。示例中的域名和网段用于说明匹配关系,不应不经检查就替换当前文件。实际使用前确认策略名称可用,并保留原文件副本;尤其 FINAL 的选择决定其他请求的去向,不能因为示例用了某个策略,就认定它适合所有网络。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

验证时选取明确能够触发目标规则的请求,再从 Log 查看实际命中。若规则似乎没有生效,依次检查 Global Routing 是否为 Config、是否选中了刚编辑的配置、前面是否已有更宽泛的规则,以及请求是否复用了旧连接。对于只修改域名规则的测试,应发起新的域名请求,而不是拿已经建立的会话作为唯一判断依据。规则顺序的完整解释见规则优先级与 FINAL。

用最小变更结束排查

最后把临时测试项目逐一恢复:不再需要的本地监听关闭,临时提高的日志级别调回,Global Routing 恢复日常姿态,On Demand 只保留已验证条件。随后在稳定网络重新连接,访问此前故障目标,再检查一次规则与日志。若恢复某项设置后故障立即重现,这项变更便成为下一轮检查的明确对象,不必重新调整所有选项。

完成标准

能重复建立连接,目标请求走预期策略,网络切换后的行为符合设置,并且保留可恢复的配置副本。一个开关显示开启或一次测试有响应,都不能单独替代这组验证。

仍未解决时,整理最小复现记录:平台、网络类型、当前姿态、失败阶段、已经尝试且回退的字段。不要附带完整订阅或认证信息。首次连接问题回到使用说明按顺序复核;需要重新获取客户端或查看系统放行步骤时,使用下载页安装说明。保留能解释结果的设置,撤销没有证据支持的修改,才是后续维护的稳定起点。