设置基线与 Config 作用范围
调整设置前,应先建立一份能够恢复的基线。Shadowrocket 的行为可能同时受到 Settings、本次选中的服务器、正在使用的 Config,以及系统网络状态影响;看到某个开关已开启,并不能单独证明它决定了当前请求的去向。先在 Home 记录服务器名称和连接状态,再检查 Global Routing,最后进入 Config 确认正在使用的配置文件。记录时只保留便于辨认的名称,不把订阅地址、密码或密钥贴到公开笔记。后续每次试验都从同一组条件开始,才能判断变化来自哪一项。
默认值:以当前安装状态为基准
本手册不把所有设备的初始值写成同一组常数。首次安装、恢复备份、导入配置以及系统升级,都可能使你看到的状态不同;某些选项还只在满足条件时显示。这里的“默认状态核对”是指:在尚未修改该项之前,记录当前界面显示的值及其来源,而不是先恢复全部设置。推荐取值也按用途说明:没有明确问题时保留原值;需要验证假设时做单项调整;确认没有收益时恢复。不要为了与文章中的界面一致而更改本来正常的连接。
Global Routing:先确认三种姿态
Global Routing 决定整体路由姿态,但不能代替对每条连接的观察。配置姿态 Config 按当前配置中的规则处理请求;代理姿态 Proxy 可用于对照服务器路径;直连姿态 Direct 可用于观察当前网络直接访问的表现。三者是排查条件,不是速度等级。使用 Proxy 时仍要考虑本地网络、服务器地址和 DNS 的可达性;使用 Direct 也不能据此认为所有应用都一定成功。实际测试应使用同一个目标、相近时间和相同网络,避免把目标自身的变化误认为模式差异。
| 姿态 | 主要用途 | 核对重点 |
|---|---|---|
| 配置 Config | 按配置规则分流 | 活动配置、命中规则、策略去向 |
| 代理 Proxy | 对照服务器路径 | 选中服务器、协议参数、连接结果 |
| 直连 Direct | 对照当前网络 | 网络认证、直接访问、解析结果 |
规则片段与配置文件的边界
规则通常按顺序匹配,因此排在前面的宽泛规则可能先于后面的精确规则生效。下方只是一段用于理解语法的片段,不是可覆盖现有文件的完整配置;其中 PROXY 必须对应实际可用的策略或配置定义。DOMAIN-SUFFIX 用于域名后缀匹配,GEOIP 根据地址归属条件处理,FINAL 接住此前未匹配的请求。修改前先另存配置副本,再在副本上调整规则顺序。若某个域名已有连接保持,修改后应重新建立测试请求,避免继续观察旧会话。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
记录结果,而不是累计改动
建议每次记录“原状态、修改项、测试目标、观察结果、是否恢复”五项。比如只切换 Global Routing,保持服务器和网络不变;若结果没有区别,就先恢复原姿态,再测试 DNS。订阅更新与手工编辑也应分开执行,否则文件被刷新后,很难确定手工改动是否仍然存在。配置中出现不认识的关键字时,先到术语手册核对,不要批量删除。完成一个测试后,再用原本正常的应用做一次回归检查,防止只修复了单个目标,却改变了日常使用路径。
DNS:解析来源与连接路径
DNS 的作用是把域名转换为可供连接使用的地址,解析成功和连接成功是两个独立环节。页面打不开时,既可能是没有得到地址,也可能是得到了地址却无法连接,还可能是在后续加密协商中失败。因此不要把所有连接错误都归到 DNS。先确认问题是否只影响某个域名,再检查同一目标在当前网络下的表现,最后结合 Log 判断失败阶段。对于已经正常工作的配置,推荐保留现有 DNS 方案,而不是仅因某个解析服务被描述为“更快”就替换全部设置。
默认状态:同时检查 Settings 与 Config
开始前应分别查看 Settings 中与 DNS 有关的选项,以及活动 Config 中的 DNS 内容。界面中的某个地址不一定就是所有查询最终使用的地址,因为配置文件、系统网络和特定规则可能共同影响结果。记录原有地址、顺序及相关开关;如果某项没有明确显示,不要自行补入猜测值。导入的配置带有 DNS 内容时,先阅读其说明,再决定是否修改。排查时只更改一个明确可识别的来源,并确认配置已被选中;仅编辑了未启用的文件,不会改变当前连接行为。
先分清普通解析与加密解析
普通 DNS 与加密 DNS 的传输方式不同,不能只看它们都返回地址就认为配置条件相同。使用带域名的加密解析端点时,还需要先解决该端点自身如何被定位,以及当前网络能否访问它的问题;系统时间明显不正确也可能影响证书验证。推荐使用你能够确认来源、理解传输方式且在当前网络可达的解析配置。不应把多个来历不明的地址叠在一起作为排错方法,因为返回结果与失败等待可能变得更难解释。更换网络后,也应重新验证同一解析方案是否仍然成立。
IPv4、IPv6 与规则匹配
同一域名可能同时返回 IPv4 与 IPv6 地址。某条路径的 IPv6 可达性不足时,表现可能是等待较长后才成功,或部分应用正常而另一部分失败;但仅凭这个现象,不能直接断定应该关闭所有 IPv6 功能。先在当前网络与另一条可用网络分别复现,再查看连接记录中的地址类型。若配置按 IP-CIDR 或 IP-CIDR6 匹配,还要核对实际地址是否落在预期范围内。基于域名的规则与基于地址的规则观察角度不同,排查时应保留完整域名和地址类型的对应关系。
| 观察现象 | 优先核对 | 不宜直接得出的结论 |
|---|---|---|
| 只有一个域名失败 | 该域名解析结果与目标服务 | 所有 DNS 都不可用 |
| 切换网络后恢复 | 网络认证、解析端点可达性 | 服务器参数一定错误 |
| 解析后连接超时 | 目标地址、路由与传输路径 | 继续增加解析地址即可修复 |
按顺序验证一次修改
先结束正在测试的请求,记录当前活动配置,然后只修改 DNS 相关的一项。保存后按界面要求重新建立连接,再使用同一域名发起一次新请求,同时查看日志中的解析与连接记录。应用、系统和浏览器都可能保留缓存,因此重复刷新不一定会生成新的解析查询;没有看到新查询时,不要立刻认定修改无效。可以退出测试应用后重试,并比较新的时间点。若出现更多域名失败,应恢复记录的原值,再检查是否输错地址、协议形式或端点路径,而不是继续叠加其他修改。
保留能解释的结果
DNS 调整完成后,应同时验证一个原本正常的目标和一个原本异常的目标,确认改动没有扩大影响。若只在某个 Wi-Fi 下失败,先完成该网络的登录认证;若仅一个服务异常,则继续检查规则命中与目标服务状态。不要把服务器 IP 直接当成网页地址来替代测试,因为 HTTPS 还涉及主机名和证书,得到的结果并不等价。仍无法定位时,可按问答页的故障分类继续检查,并保留经过脱敏的错误阶段与网络条件,而不是公开整份配置。
On Demand:触发条件与自动连接
On Demand 用于按条件决定连接行为,不负责判断服务器是否适合当前业务,也不能替代 Global Routing。前者回答“何时建立或改变连接”,后者回答“连接建立后怎样处理请求”。如果手动连接尚未稳定,推荐先保持手动方式,完成服务器与配置验证后再设置 On Demand。否则自动触发、手动切换和服务端失败会交织在一起,使“为什么又连接了”与“为什么访问失败”变成同一个难以解释的问题。测试自动行为时,应先保证基础连接已经可用。
默认状态:读取现有开关与条件
进入 On Demand 后,先记录总开关、已有条件和它们的排列顺序,不假设新设备一定处于关闭状态。系统恢复或配置迁移后,当前状态可能与最初安装时不同。若已经存在规则,先理解每条规则覆盖的网络范围,再增加新条件;不要只看到某个 Wi-Fi 名称就认定它是唯一触发来源。推荐从最少条件开始,先验证一个明确网络下的行为,再扩展到其他场景。需要暂时排查连接时,可先停用自动触发并记录原状态,测试结束后再恢复。
Wi-Fi 名称与蜂窝网络条件
按 Wi-Fi 名称设置时,应核对实际连接的网络名称,包括大小写、空格和相似字符。相同名称可能出现在不同地点,因此名称匹配不等于对网络可信程度的认证,也不应被当成安全边界。蜂窝网络条件则应在真正离开 Wi-Fi 后验证,不能只根据状态栏短暂变化下结论。双卡切换、热点和网络认证页面都可能改变测试前提。推荐先写清预期:“连接这个网络时应保持什么状态,离开后应怎样变化”,再对照实际结果,避免只观察开关是否亮起。
域名条件不是网站完整访问规则
域名触发通常与解析或系统网络请求有关,不能理解为对浏览器每个地址栏动作逐字检查。一个网页可能调用多个域名,应用也可能复用已有连接或缓存结果,因此打开同一页面不一定每次都产生相同触发过程。测试域名条件时,应使用能够辨认的新请求,并查看事件发生的时间,而不是快速反复刷新。也不要把 On Demand 的域名条件当成 Config 中的 DOMAIN-SUFFIX 规则;两者承担的任务不同,分别需要验证触发结果与请求最终去向。
匹配顺序与兜底条件
存在多条条件时,应按界面展示的顺序逐条检查,并确认当前规则动作的含义。范围较宽的条件可能覆盖后面的精细条件,导致某个例外始终没有机会生效。推荐把具体条件与兜底条件分别写清,再在实际网络中逐个验证,而不是仅凭列表看起来完整就结束设置。若某个平台或系统版本没有显示预期条件,不要从其他设备照搬不存在的入口。更细的网络切换示例可参阅On Demand 按需连接设置,本页侧重验证顺序与排错边界。
自动重连与网络认证的排查
手动断开后又出现连接时,先检查 On Demand 是否仍满足触发条件,而不是反复点击总开关。为了区分触发行为与连接失败,可以暂时关闭 On Demand,在 Home 手动连接一次;若手动方式也失败,应先回到服务器、DNS 和规则排查。进入需要网页认证的 Wi-Fi 时,先确认认证流程已经完成,再验证自动连接,否则可能把认证未完成造成的不可达误认为规则错误。不要通过不断增加条件来补偿一个尚未解决的基础网络问题。
最终验收至少包括停留在目标网络、离开目标网络以及再次返回三种情况,并在每次切换后等待系统完成网络变化。观察记录应包含网络名称、触发条件、预期动作和实际动作。锁屏后是否即时发生变化可能受到系统调度影响,不宜以秒级响应作为固定承诺。完成测试后清理临时条件,只保留能够说明用途的规则;更换网络名称或迁移设备后,再重新检查。自动连接的价值在于条件清楚、行为可预测,而不是把所有可见选项都开启。
Connectivity Test 与 Ping 判断
Connectivity Test 用于观察特定测试条件下的可达性,不是服务器综合质量排名。列表中的一个时间值只能说明该次测试测到了什么,不能代表下载吞吐量、视频稳定性或所有网站的响应速度。Ping 也应结合实际测试方式理解,不能把所有延迟显示都当成 ICMP 往返时间。推荐先辨认所选测试项目、目标和网络,再阅读结果。只要条件不同,两次数字就未必可直接比较;尤其不要用 Wi-Fi 下的一次结果与蜂窝网络下的一次结果判断服务器优劣。
默认状态:确认测试方式和目标
开始测试前,查看 Connectivity Test 当前选用的方式,以及界面是否提供测试地址、超时等选项。未显示的参数不应自行假设,更不应照抄其他版本的数值。若测试目标可以调整,应选择你有权访问、当前可达且响应行为稳定的地址,并记录原值。推荐先保留现有测试配置,只有当目标本身不可达或返回方式不适合测试时才修改。某个目标访问失败,只能说明该目标与当前路径的组合有问题,不能据此宣布服务器整体不可用。
区分连接耗时与完整请求耗时
建立传输连接、完成加密协商、发送 HTTP 请求和接收响应属于不同阶段。不同测试可能覆盖其中一部分,也可能覆盖多个阶段,因此相同单位不代表相同测量对象。服务器端口能够建立连接,不等于认证参数正确;能够收到测试响应,也不等于某个业务网站一定可用。推荐把 Connectivity Test 作为筛查工具,再用真实但轻量的访问验证业务路径。需要确认协议参数时,应核对服务端提供的协议、地址、端口和认证信息,而不是只反复执行延迟测试。
timeout 与异常结果的含义
超时表示在本次等待范围内没有得到预期结果,原因可能位于本地网络、解析、服务器、测试目标或返回路径。过短的等待会把较慢但可用的路径记成失败;过长的等待则会延后判断,并不能修复问题。没有明确测试需求时,不建议只为得到成功标记而持续增加超时。先测试一条已知正常的路径作为对照,再测试异常路径;如果所有项目同时失败,优先检查网络是否已完成认证,以及当前设备是否真正能够访问外部服务,而不是立即删除全部服务器。
| 结果组合 | 下一步 | 保留的变量 |
|---|---|---|
| 测试成功,业务失败 | 核对业务域名的规则与连接日志 | 服务器、网络、测试时间 |
| 测试失败,业务可用 | 核对测试目标与测试方式 | 业务目标、路由姿态 |
| 同一网络全部失败 | 检查网络认证和直接访问 | 服务器参数与配置副本 |
怎样做可比较的重复测试
先固定网络、服务器和测试方式,暂停占用较大的传输任务,再在相近条件下重复几次。关注是否持续超时、结果是否大幅波动,以及真实访问能否完成,而不是挑选最小数字作为结论。大量并发测试会让设备和网络同时承担额外负载,可能改变原本想观察的情况,因此不宜一边持续批量测试一边判断日常体验。若需要比较两个服务器,应分别保留同样的测试条件;若切换了网络,就把它记为另一组实验,不与前一组混合排序。
测试结果与规则的交叉验证
Config 姿态下,业务请求的路径取决于规则,不能因为某个服务器测试成功,就认定当前网站一定经过它。先查看该域名的连接记录与策略,再用 Proxy 姿态作短时对照,完成后恢复 Config。如果测试成功而特定应用失败,可继续检查应用是否缓存旧连接、是否使用不同域名,以及服务器是否支持该业务所需的传输方式。排错记录应写“何种测试成功、何种请求失败”,而不是笼统写“网络正常”。这种表述能让后续检查落到具体环节。
验证结束后,应把临时测试地址、超时和模式恢复到有记录的原值,或者明确记录保留修改的理由。测试记录不必长期积累全部数字,保留具有代表性的失败阶段和复现条件即可。若延迟表现正常但持续出现断流,应转到 Log 与网络切换检查,而不是继续在 Ping 数字上寻找答案。对持续不可用的服务器,向现有服务提供方核对状态与参数,比更改所有本地测试项目更直接。
Log 与 Data:定位失败阶段
Log 用于还原事件顺序,Data 用于观察流量或连接统计;二者都需要结合复现时间理解。看到流量增加,只能说明有数据经过统计范围,不能证明目标网页完整打开;没有看到预期日志,也可能是记录范围、筛选条件或旧连接复用造成的。推荐先写下一个能够稳定复现的问题,再短时开启所需记录,完成一次操作后立即检查。持续记录大量正常访问既增加阅读负担,也可能保留敏感信息,不适合作为日常排错的起点。
默认状态:先看记录范围,再改详细程度
进入相关页面后,先核对记录是否启用、当前筛选条件、可见时间范围,以及是否有清理或导出入口。不同界面提供的细节可能不同,本手册不设一个适用于所有安装状态的日志级别。推荐日常保留原有记录策略;排查时,只提高足以观察问题的详细程度,完成后恢复。若需要清空旧记录,应先保存真正有用的脱敏片段,再执行清理。清空日志不会修复连接,也不会替代重新发起请求,它只是帮助缩小下一次观察的时间窗口。
从时间线识别失败发生在哪里
一次请求可按解析、匹配规则、建立连接、认证或加密协商、数据传输等阶段阅读。错误文字需要放回这个顺序理解:地址解析失败时,应先检查 DNS;能够建立连接但认证失败时,应核对服务器信息;已经传输后被关闭,则还要考虑目标服务和网络切换。具体错误文字以实际显示为准,不应把不同错误统一解释为同一个原因。推荐先定位最后一个明确成功的阶段,再检查紧接着失败的步骤,这比从头修改所有设置更容易得到可验证的结论。
规则命中与实际去向
请求被分到什么策略,是判断 Config 行为的关键。记录中若能看到域名、地址、规则和策略,应把它们放在一起阅读:域名可能匹配后缀规则,地址可能匹配范围规则,未匹配的请求则可能落到 FINAL。修改规则后,重新发起请求并核对新记录,不要只看文件里已经写入了目标规则。若同一网页出现多条连接,这通常反映它访问了多个资源域名,应分别判断,而不是只找到其中一条就认为整个网页都走了相同路径。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
这段片段用于说明顺序:精确域名 example.com 可以先命中 DOMAIN,其他符合后缀的请求才继续考虑 DOMAIN-SUFFIX。实际使用前,必须确认 PROXY 在你的配置中有有效含义,并把片段合并到正确位置,不能直接覆盖完整配置。若调换顺序,应预期精确域名也可能先被后缀规则处理,再用新请求验证。规则示例不是对任何真实站点的访问建议,只用于解释配置行为。
Data 不等于业务完成状态
Data 中的上传、下载或连接统计,可能包含应用后台请求、重试以及其他正在运行的任务。需要核对某次操作时,先记录起始状态,执行单一测试,再观察增量;如果界面允许重置统计,应先确认重置范围,避免丢失你还需要的历史记录。统计口径与系统运营商账单也未必相同,因此不能用两个数字不一致直接推断异常。推荐把 Data 用作“是否发生传输、是否持续重试”的线索,再由日志与目标应用结果判断请求是否真正完成。
导出、脱敏与停止记录
分享日志前,应移除订阅地址、认证内容、私人域名、内网地址及可识别个人的请求路径。仅隐藏服务器显示名称通常不够,因为查询参数、错误上下文或相邻记录仍可能包含敏感内容。向现有服务提供方描述问题时,优先提供网络类型、失败时间范围、协议名称和经过脱敏的错误阶段,不要发送整份备份。完成排查后,恢复记录选项并按需要清理临时文件;如果准备清除应用数据,应先阅读iCloud 同步与备份章节,确认有效配置已经另存。
Widget:状态展示与快捷操作
Widget 是系统提供的快捷展示或操作入口,不是另一套独立连接配置。它能否显示某种内容、多久刷新以及允许执行什么动作,取决于当前系统和应用提供的组件类型。推荐先在 Home 确认连接正常,再添加 Widget;出现组件状态与应用内状态不一致时,以重新打开应用后的实际状态作为核对起点。不要仅凭组件上的一个旧标记判断服务器故障,也不要把组件无法即时更新理解为整个设备已经断开网络。展示与连接需要分别验证。
默认状态:以已添加的组件为准
默认桌面是否存在 Widget,由设备布局和此前恢复状态决定,不能假设安装应用后一定自动出现。先查看系统组件选择界面是否列出 Shadowrocket,再查看可用尺寸与说明;如果系统没有提供某种组件,就不要按照另一台设备的截图寻找同名按钮。推荐选择能够清楚显示所需信息的尺寸,而不是尽量放入更多字段。添加后先保持组件原有设置,确认它对应的应用与配置,再逐项调整可见选项。若支持编辑组件,应记录当前选择的项目,避免误以为它总跟随 Home 中的选择。
状态刷新与系统调度
系统可能限制后台刷新频率,因此组件显示有延迟并不罕见。锁屏、低电量状态、应用近期是否运行以及系统资源调度,都可能影响展示更新的时机。推荐先打开 Shadowrocket 核对状态,再返回桌面观察组件是否更新;如果应用内连接稳定而组件暂时滞后,应优先排查展示链路,而不是改动 DNS 或服务器。不要通过连续快速点击迫使刷新,因为这些点击可能实际执行连接切换,反而造成状态来回变化,使原本只是显示问题变成新的连接问题。
快捷切换与 On Demand 的关系
通过 Widget 发起的操作,与 On Demand 自动触发可能先后发生。若点击断开后很快又显示连接,应进入 On Demand 检查条件,而不是先删除组件。为了验证快捷入口,可临时停用自动触发,在 Home 确认初始状态,再通过 Widget 执行一次动作,最后返回应用检查结果。测试完成后恢复原有 On Demand 状态。此处关注的是动作是否送达,不是要求组件每个文字立即变化;应把操作结果与视觉刷新分别记录,才能判断问题位于哪一层。
配置切换后检查引用对象
新增服务器、删除旧项目或恢复配置后,快捷入口可能需要重新核对其引用对象。如果组件提供服务器或动作选择,应打开编辑界面确认仍指向有效项目;若没有这类选择,则以实际组件说明为准。不要仅凭两个同名服务器判断它们完全相同,订阅更新可能改变条目内容。推荐给常用项目使用便于自己辨认、又不暴露敏感信息的名称,并在修改后从应用内测试一次,再检查快捷入口。这样能把数据引用问题与网络连接问题分开处理。
桌面与锁屏的隐私边界
Widget 可能在他人能够看到屏幕时展示连接状态、流量或项目名称,具体内容取决于组件类型和系统设置。推荐在添加前检查实际预览,不把私人服务地址或账号信息写进显示名称;需要展示设备截图时,也应检查组件是否泄露使用习惯。锁屏上的可见性与操作权限还受系统设置影响,不能假设桌面上能执行的动作在锁屏上也相同。若设备用于工作或受管理,应同时遵守设备管理要求,不要为了快捷操作修改不理解的系统限制。
组件持续空白时,可按顺序检查应用能否正常打开、组件类型是否仍可用、引用项目是否存在,再尝试移除并重新添加组件。重新添加属于展示层排查,不应先删除应用或清空配置。若重新添加后仍异常,但 Home 中连接与访问均正常,可以暂时从应用内操作,保留复现条件等待进一步核对。没有必要为了一个快捷入口重建全部网络设置;排查目标应始终限制在发生问题的那一层。
iCloud 同步、备份与恢复
同步用于在设备之间传递状态,备份用于保留可恢复的历史副本,两者不能等同。同步可能传播修改或删除,因此开启 iCloud 并不意味着任何时候都能找回误删内容。推荐在变更主要配置前,先按应用提供的方式导出一份可辨认的配置副本,再检查同步状态。导出的 Config 也不应被自动理解为包含全部服务器、订阅与应用设置;每种导出内容的范围都应实际核对。换机前应同时考虑恢复应用、恢复配置和重新验证服务信息这几个不同环节。
默认状态:核对系统与应用两层条件
先在系统设置中确认设备已登录预期账户,iCloud 相关能力可用,再进入 Shadowrocket 查看同步选项。具体入口以系统和应用当前界面为准,不把其他设备的菜单位置当作固定路径。记录哪些类别明确标为可同步,哪些只保存在本机;界面没有说明的项目,不应假定会自动迁移。推荐在旧设备仍可使用时做一次小范围验证,例如比较一个配置名称与内容是否在另一台设备出现。仅看到开关开启,不能证明最近修改已经成功传递。
导出文件前确认内容与敏感性
导出 Config 时,先确认选中的是正在使用的文件,而不是同名旧副本。保存后核对文件能否重新打开、规则是否完整,并使用能够区分用途的文件名。配置中可能包含服务器地址、认证信息或远程资源地址,所以备份应存放在你控制且有适当访问限制的位置。不要把完整文件放到公开共享目录,也不要为了求助直接发送全部内容。推荐同时保存一份简短说明,记录该文件的用途、活动姿态和需要另外恢复的项目,而不是把敏感凭据写进说明标题。
多设备冲突先保全,再同步
两台设备离线修改同一内容后再次同步,可能出现版本冲突或结果与预期不一致。此时应先停止在两边继续编辑,分别导出仍能访问的副本,再比较实际内容。不要仅凭文件名相同认定内容一致,也不要假定修改时间较新的文件必然正确;设备时间、同步延迟和局部编辑都可能影响判断。推荐先选出一份已经验证可用的基线,再按应用当前提供的同步或导入方式恢复。没有明确冲突处理提示时,不应通过反复开关同步赌出期望结果。
换机恢复按层验收
新设备恢复后,先确认 Shadowrocket 可以打开,再检查服务器列表、订阅条目、Config 文件和 Global Routing,最后才测试 On Demand、Widget 等附加行为。用户已有的订阅可能需要重新更新,某些授权也可能与设备或服务状态有关,应向现有服务提供方核对。推荐先在 Home 手动建立一次连接,确认基础访问正常后,再启用自动连接,避免旧设备的环境条件直接影响新设备。恢复完成不等于验收完成,应逐项检查实际请求,而不是只看列表已经出现。
| 层次 | 验收内容 | 保留旧设备的理由 |
|---|---|---|
| 服务信息 | 订阅、服务器与认证是否可用 | 便于核对遗漏项目 |
| 配置文件 | 规则、策略与活动文件是否一致 | 便于比较实际内容 |
| 自动行为 | On Demand 与 Widget 是否符合新环境 | 避免照搬旧网络条件 |
同步异常时的检查顺序
没有看到更新时,先检查两台设备是否使用预期账户、网络是否可用、云端存储是否存在空间问题,以及应用是否有明确错误提示。随后分别打开应用并等待同步,再比较一个具体项目,避免一次性修改大量内容。不要立刻退出账户或删除应用,因为这些动作可能让尚未同步的本地内容失去恢复机会。更完整的分步流程见iCloud 同步、导出配置与换机恢复步骤。确认新设备配置和连接都通过验收前,继续保留旧设备与独立备份。
Proxy 端口与设置恢复顺序
本地 Proxy 端口是供其他程序连接的入口,不是远端服务器端口。远端端口属于用户已有服务的连接参数;本地监听端口则用于当前设备或获准访问该设备的程序。二者数值即使相同,含义也不同。没有明确的本地代理使用需求时,推荐保留相关选项原状,不为“提高速度”随意修改。是否支持监听、允许哪些协议,以及是否能被其他设备访问,都应以当前平台实际提供的选项为准,不能把桌面端或另一台设备的配置直接套到当前环境。
默认值:读取端口、协议与监听地址
检查时应一起记录端口、代理协议、监听地址,以及是否允许局域网访问。不要假定 HTTP 与 SOCKS5 共用入口,也不要把示例数字当成产品固定默认值。客户端程序填写的协议必须与监听入口匹配,否则可能出现端口能够连接但请求格式不被接受的情况。端口还需要避免与其他本地服务冲突;若启用后立即提示占用,应先找出冲突来源,而不是连续换多个数字。推荐保留原有配置记录,明确哪个程序需要使用该入口,再进行最小范围的调整。
本机访问与局域网访问的边界
监听在本机回环地址时,通常只供当前设备访问;允许其他设备连接则涉及监听范围、网络隔离、防火墙与设备是否保持在线。不能因为本机使用成功,就断定同一 Wi-Fi 下的另一台设备也一定可用。推荐优先采用满足需求的最小暴露范围,仅供本机使用就不扩大到局域网。确需跨设备访问时,先确认网络可信、访问控制与认证选项符合要求,并在使用结束后恢复。公共网络中的其他设备不应被默认视为有权访问本地代理的客户端。
避免代理回环与重复转发
让程序使用本地代理时,应确认其连接不会再次被送回同一个入口,形成循环。常见线索包括请求持续重试、连接数量异常增加以及代理开启后所有相关请求都停滞。推荐先只让一个测试程序使用该入口,并核对其目标地址和端口,不要同时改系统代理、应用代理与 Config。若需要还原,先撤销测试程序中的代理设置,再恢复 Shadowrocket 的监听选项。这样即使本地入口停止工作,程序也不会继续指向一个已经不存在的地址。
按失败层次恢复设置
如果多项改动后无法判断原因,应先恢复最近一次记录的单项原值,再按从外到内的顺序检查:当前网络能够直接使用、Home 能手动连接、Global Routing 明确、活动 Config 正确、DNS 结果可解释、目标请求命中预期策略。随后才恢复 On Demand 与 Widget 等自动或展示能力。不要把删除全部数据作为第一步,因为它会同时移除证据与可用配置。确需重新导入时,先导出仍有价值的内容,并核对用户已有订阅与服务器信息可以重新取得。
获取渠道与安装问题分开处理
需要重新获取应用时,前往全平台下载页核对渠道。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片版与 Intel 版)、Windows、安卓、Linux 版免费,桌面与安卓安装包通过本站 /dl/ 提供。iPhone / iPad 系统要求以 App Store 页面标注为准;核验开发者 Shadow Launch Technology Limited 和应用 ID 932747118。重新安装不会替代服务端参数核对,也不会自动解决订阅失效,操作前仍应保全配置。
桌面与安卓首次打开遇到系统拦截时,应先确认文件来自本站下载页,再按该页说明处理:macOS 在“隐私与安全性”核对并选择“仍要打开”;Windows 在 SmartScreen 核对后进入“更多信息”;安卓只为实际下载文件的浏览器开启“允许安装未知应用”,完成后可关闭该权限。Mac 应按“关于本机”的芯片信息选择安装包,不猜测设备架构。完整安装分支见安装放行说明,不要通过改变 DNS、Ping 或 Proxy 端口处理系统安装提示。
留下能够再次复现的结论
结束排查时,用一句话描述有效修改及其条件,例如“仅在指定网络下恢复原 DNS 后,目标请求重新完成”,而不是写“打开全部开关后正常”。再验证一个原本正常的应用、一次网络切换和一次手动重连,并清理测试规则、临时日志与不再使用的本地入口。若问题仍存在,带着脱敏后的失败阶段到问答页继续定位;需要重新走完整操作链时,返回快速上手教程。设置手册的用途是让每项变化可解释、可验证并可恢复。