连接开关打不开:先检查系统 VPN 配置
点击 Home 的连接开关后立即回到关闭状态,与开关保持开启但网页打不开,是两种不同故障。前者首先检查系统是否接受并启动了 VPN 配置,后者才进入服务器和分流排查。先记下开关回落是否伴随提示、是否出现系统授权窗口,以及离开应用后连接是否仍然存在。不要在尚未确认系统连接状态时反复更换节点;服务器地址错误通常应从连接日志判断,不能单凭开关颜色下结论。
首次授权与其他 VPN 配置
首次启用时,系统可能要求添加 VPN 配置,按系统提示确认,并完成设备密码或身份验证。若之前取消了授权,返回 Shadowrocket 再发起一次连接,观察提示是否重新出现。随后打开系统 Settings,进入 General 下的 VPN & Device Management,查看是否已经存在 Shadowrocket 对应的 VPN 配置。系统版本不同,入口位置和提示文字可能有所调整,应以设备当前页面为准,不要把网络配置与设备管理描述文件混为一项。
如果设备同时保存了其他 VPN 配置,先断开其他活动连接,再测试 Shadowrocket。某些企业管理、内容过滤或安全设置可能限制个人 VPN 的启用;受管理设备应由管理员确认策略,不应自行移除组织配置。个人设备也不宜直接执行“还原网络设置”:这会影响已保存的无线网络等信息,而不能替代对授权提示的检查。先确认当前连接归属,通常比一次性删除所有网络配置更容易保留线索。
开关回落、自动重连与配置重建
开关刚关闭又自行开启时,检查 On Demand 是否仍然满足连接条件。按需连接可能在产生网络请求时再次启动隧道,这不等于按钮失效。诊断期间先记下原条件,临时关闭 On Demand,再手动控制连接。如果系统显示正在连接而应用尚未刷新,等待状态稳定后再观察;连续快速点击会让启动和停止请求交错,难以区分原始问题与操作造成的状态变化。
授权已完成但仍立即断开时,先正常退出并重新打开应用,再重启设备进行一次复测。只有在已备份配置、确认订阅能够重新获取之后,才考虑移除系统里属于 Shadowrocket 的失效 VPN 配置并重新授权。移除系统 VPN 配置与删除客户端内的订阅、服务器或 Config 文件不是同一个动作,操作前核对对象。不要为了重建隧道顺手清空应用数据,否则会把一个系统启动问题变成配置恢复问题。
把启动失败与服务端错误分开
查看出错时段的日志,区分配置读取失败、系统隧道启动失败和后续连接远端失败。只记录错误原文与发生顺序,不要因日志里出现服务器域名就认定服务器一定有问题。若同一设备在不同网络上都无法建立系统 VPN,而相同订阅在其他自有设备上可用,排查重点应留在本机授权、管理策略和配置状态。若隧道能启动,随后才出现 timeout 或 TLS 错误,则转到节点超时章节,避免在错误层级反复操作。
每次复测都固定一个已知条件:同一无线网络、同一 Config、同一服务器,先手动连接一次,再打开一个测试页面。保留修改前后的结果,才能判断重启、重新授权或关闭 On Demand 哪一步真正产生影响。若需要继续求助,可整理为“首次授权是否完成、系统是否显示连接、断开前最后一条错误、是否受设备管理”四项,不必发送完整配置文件。
已连接却无法上网:按姿态和规则逐层定位
系统显示 VPN 已连接,只代表隧道已经建立,不代表所选服务器可用,也不代表每条请求都走代理。先关闭 Shadowrocket,访问一个原本能够直接打开的页面,确认当前 Wi-Fi 或蜂窝数据本身可用。公共无线网络若需要网页登录,应先完成认证;认证页打不开时,保持隧道关闭重试。基础网络未恢复之前,修改规则、DNS 或协议参数通常只会增加变量。
使用 Global Routing 做对照测试
基础网络正常后,固定同一个服务器和测试地址,分别检查 Global Routing 的配置、代理、直连三种姿态,对应界面词 Config、Proxy、Direct。Direct 用于观察当前直连路径,Proxy 用于检查代理路径,Config 则按当前启用的配置规则决定策略。这里的对照测试是临时诊断,不是要求长期使用某一种姿态;完成后应恢复原本需要的分流方式。
| 测试结果 | 优先检查 | 下一步 |
|---|---|---|
| Direct 正常,Proxy 失败 | 服务器、协议与代理侧解析 | 固定服务器检查握手错误 |
| Proxy 正常,Config 失败 | 命中规则、策略名称与兜底 | 查看请求实际命中项 |
| 关闭隧道后仍失败 | 基础网络或目标服务 | 先恢复普通网络访问 |
| 只有一个应用失败 | 应用请求、缓存与连接复用 | 重新建立该应用连接 |
三次测试应使用同一目标,且每次切换后重新发起请求。已经建立的长连接可能继续沿用之前的路径,浏览器缓存也可能让页面看起来“仍然正常”。可以关闭对应页面后重新打开,必要时完全退出测试应用,再观察连接记录。不要一边切换姿态一边切换服务器,否则即便恢复,也无法知道问题来自哪一项。
检查启用文件、命中顺序与 FINAL
在 Config 中确认当前启用的文件,而不只是列表里存在某个文件。规则通常按从上到下的顺序匹配,较宽的规则放在前面可能遮住后面的精确规则。下面只是规则语法示例:example.com 是教学域名,不是用于验证代理效果的服务;PROXY 应关联到实际可用的代理策略。不要将片段直接覆盖到唯一的日常配置,应先制作副本。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,DIRECT
这个片段表示域名后缀命中后走 PROXY,地理位置匹配规则随后处理,其余交给 FINAL,DIRECT。若预期是所有未命中的连接也走代理,兜底策略就需要与该目标一致,例如 FINAL,PROXY;两种写法服务于不同需求,不能同时当作最后一条生效规则。GEOIP 依赖目标地址及相关数据,并不等价于按网页语言或网站名称判断归属。对指定网站分流的完整示例可读DOMAIN-SUFFIX 与 FINAL 说明。
局部失败时查看实际请求
网页的主域名能打开而图片、登录或视频失败,往往需要检查资源域名,而不是只看地址栏。一个页面可能请求多个不同域名,命中不同策略后,部分资源会通过不同路径。根据连接记录找到失败请求,再检查它对应的规则与目标策略;不要看到一个资源失败就把整个站点相关域名全部加入 REJECT 或 PROXY。先验证具体请求,规则才能保持可解释。
如果 Proxy 与 Direct 的结果都不稳定,暂时使用最小测试配置,停用本次诊断不需要的额外处理,并保留原文件。目标是依次确认“基础网络可用、代理路径可用、规则命中正确”,而不是以增加复杂设置换取偶然恢复。确定最小配置可用后,再逐项恢复原规则;每恢复一项就复测同一请求,出现问题的那一步才是下一轮排查的起点。
节点超时与握手失败:先确认连接停在哪一层
timeout 只说明某个操作在等待期限内没有完成,不直接说明密码错误,也不一定表示服务器整体离线。需要先分清失败发生在域名解析、建立传输连接、TLS 握手,还是代理协议认证阶段。先选择一个已有服务器,记录完整错误与发生时间,再做 Connectivity Test 和实际页面访问。不同测试使用的目标和方式可能不同,因此测试成功只能证明相应检查通过,不能保证全部业务请求都成功。
从地址、端口到协议类型逐项核对
在服务器编辑页核对 Address 与 Port,确认地址没有夹入空格、中文标点、网页标题或完整订阅 URL。地址字段应按所选类型填写主机名或 IP,不要随意加上协议前缀。端口必须与服务端监听的入口一致;同一服务器上的不同端口可能对应完全不同的服务。Type 也应来自你的服务商或自有服务端配置,不能根据端口数字推测协议。
| 错误阶段 | 常见核对项 | 验证方向 |
|---|---|---|
| 域名解析 | Address 拼写、DNS 可达性 | 确认服务器域名能够解析 |
| 传输连接 | Port、服务监听、防火墙 | 比较不同基础网络 |
| TLS 握手 | SNI、证书、系统时间 | 核对服务端 TLS 参数 |
| 协议认证 | 密码、用户标识、加密方式 | 与当前有效资料逐项比较 |
Shadowsocks 的加密方式与密码必须配套;Trojan 需要核对密码及 TLS 相关参数;VMess、VLESS 等类型需要按服务端资料检查用户标识与传输设置。若启用了 WebSocket 等传输方式,Path、Host 及服务端路由也要一致。界面允许填写的字段不代表全部都需要填写,没有提供的值不要凭其他服务器的配置补齐。相同协议名称下仍可能使用不同的传输组合。
TLS、SNI 与系统时间
TLS 错误应先检查设备时间是否自动设置,再核对服务端要求的 SNI 与证书对应关系。连接地址与 SNI 可以不同,但必须由实际部署决定,不能任选一个常见域名填入。证书到期、证书链异常或名称不匹配都应从服务端配置核实。不要把开启 Allow Insecure 当作通用修复;它会改变证书验证条件,可能掩盖真正的名称或证书问题。
若旧连接仍可用而新连接失败,可能是旧连接尚未重新握手,不能据此排除证书变化。断开并重建一次连接后比较日志,避免缓存状态干扰。Trojan 字段的详细解释见地址、端口、密码与 SNI 参数说明。涉及自己的服务器时,应同时查看相同时间段的服务端日志,判断请求是否到达、在哪一步被拒绝。
换网络验证,不把超时当作唯一结论
保持服务器和参数不变,分别在 Wi-Fi 与蜂窝数据下测试。仅一条网络失败,重点检查该网络的可达性、认证、传输限制与 IPv6 条件;两条网络都失败,再核对服务端监听、账户状态或资料是否已变更。若同一订阅里的其他已有服务器可用,也只能说明客户端具备建立连接的能力,不能证明失败服务器的每项参数都正确。
基于 UDP 的协议与基于 TCP 的协议,可能在同一网络中呈现不同结果。不要把一种协议的成功直接推导为另一种协议也应成功,更不要无依据地反复调整 MTU。提交问题时提供协议类型、错误阶段、两条网络的对照结果以及已核对的字段名称即可,密码和完整用户标识无需公开。确认连接可以稳定完成后,再返回 Config 检查业务流量,避免把握手修复与分流修复混在同一轮测试。
订阅添加或更新失败:检查获取路径与解析结果
订阅更新包含下载内容和解析内容两个过程。请求无法完成、服务器返回错误页面,以及下载成功但内容格式不被识别,需要分别处理。先确认自己操作的是 Subscribe 更新,而不是把订阅链接作为单个服务器地址填进 Add Server。订阅链接从你的服务商处获取;链接通常包含访问凭据,应按密码处理,不应粘贴到公开讨论区、图片注释或无关在线检测页面。
先保留原条目,再检查链接完整性
旧条目仍可连接时,不要先删除整组订阅。记录订阅备注、更新时间提示和错误原文,备份当前配置,然后对原订阅发起一次更新。复制链接时注意聊天软件是否截断参数、是否混入前后的引号或说明文字,以及换行是否成为链接的一部分。含有问号和连接符的查询参数通常属于完整地址,不能为缩短链接而手动删去。若凭据已被重置,旧链接即使外观相似也可能失效。
如果资料里同时给出多种导入格式,应选择适用于 Shadowrocket 的内容,并确认获取的是订阅地址而不是账户网页。成功打开一个网页登录页面,不代表该页面就是订阅内容。返回登录表单、验证页或普通 HTML 时,客户端可能表现为解析失败或没有新增服务器;此时应核对入口及权限,而不是将网页内容重新编码后导入。
区分网络错误、权限错误与格式错误
提示解析域名失败时,转到 DNS 章节;提示 timeout 时,先判断订阅地址通过哪条路径访问。若订阅域名当前被规则交给一个已经失效的代理,就可能出现“代理失效导致无法更新,无法更新又无法替换代理”的循环。可以在确认基础网络允许访问的前提下,临时用 Direct 更新,或者选择另一条已有且可用的连接;不应通过关闭证书检查来绕过 HTTPS 错误。
HTTP 状态能提供方向,但不能代替服务端说明。401 或 403 常与认证、权限或访问策略有关,404 可能是路径变化,429 通常应停止连续重试并等待允许的间隔。服务器也可能将错误信息包装成正常响应,所以仍要结合错误正文类型判断。重复点击更新不会修复无效凭据,反而可能触发更多请求限制;先保存一次明确结果,再核对账户中的有效链接。
更新成功却没有预期服务器
显示更新完成后,检查订阅分组内的实际条目,而不是只看服务器总数。服务端可能移除了旧条目、修改了名称或返回了相同列表;过滤条件也可能让部分条目不显示。已有手动服务器与订阅生成的服务器不一定属于同一组,操作前核对来源,避免把手动条目误认为更新残留。若有重复名称,应通过协议、地址与订阅归属区分,而不是仅凭备注删除。
订阅更新与 Config 文件更新不是同一件事。服务器列表更新成功,不代表当前分流文件、规则引用或策略选择自动符合预期;更新后还应确认当前选中的服务器仍然有效。多订阅场景可参照分组、排序与重复节点清理,先整理来源再批量操作。每次只更新一组,能够更快确认哪条来源返回异常内容。
问题交付给你的服务商时,提供失败时间、错误类型、是否能解析域名、采用的访问路径以及最后一次正常更新的大致场景即可。若必须提供完整链接,应使用双方认可的私密渠道;公开日志里删除链接查询参数和用户标识。确认更新后先测试一条服务器,再清理已经失效的旧数据,这样即使新列表存在问题,也仍保留可回退的配置。
连接速度慢:分开测延迟、吞吐与页面加载
“速度慢”至少包含三类现象:开始响应前等待很久、持续传输速率低,以及页面只有部分资源迟迟不完成。Connectivity Test 的结果与文件下载吞吐不是同一指标;一个连接测试较快的服务器,也可能因为出口负载、目标站限制或网络丢包而下载缓慢。先描述慢发生在开始阶段还是持续阶段,再决定检查 DNS、服务器路径还是应用本身,不应只按一个测试数字排序后反复切换。
建立可比较的测试条件
固定设备、网络、服务器与目标内容,暂停正在运行的大文件同步或系统下载。先在关闭隧道时观察普通网络,再在 Proxy 下观察相同目标;如果目标本来不能直连,就换一个可以做基础网络对照的合法测试对象,不要把直连失败当作测速结论。每轮只改变服务器或网络其中之一,连续观察几次趋势,而不是根据一次瞬时峰值判断优劣。
Wi-Fi 信号格数不能完整反映实际链路质量。设备靠近接入点后恢复、同一时段其他设备也慢,或路由器重连后改善,都提示先检查本地网络。蜂窝数据则需留意当前位置、信号变化、流量状态和低数据模式。测速本身会消耗流量,也可能与视频播放争抢带宽;诊断时不要同时运行多个速度测试,否则得到的是竞争后的结果,而不是单条连接的能力。
区分首次等待与持续传输
首次打开等待明显,随后刷新很快,可能与 DNS、TLS 建连或连接复用有关;持续下载一直缓慢,则需要观察丢包、服务端负载与目标端限制。下载开始很快,设备发热后逐渐下降,还应检查温度和后台任务。保持同一服务器,对比两个不同目标:只有一个目标慢,优先考虑目标路径与服务端限速;所有目标都慢,才更有理由检查公共传输链路。
网站页面包含脚本、图片、接口和媒体等多个请求,主文档先到达并不代表页面加载已经结束。打开连接记录寻找等待最久的请求,核对它使用的策略;如果某个资源域名走到了失效路径,页面会呈现“能开但很慢”。这类问题更接近规则或 DNS 故障,换一个吞吐更高的服务器也可能没有效果。先修复失败资源路径,再评价整体加载速度。
协议、UDP 与 MTU 的边界
不同协议、传输层与加密方式对网络条件的适应性不同,但不能据此给某个协议固定贴上“必然更快”的结论。基于 UDP 的连接在某些网络下可能受限,基于 TCP 的连接也可能受丢包与重传影响。应使用你的服务端实际支持的参数进行对照,不要只更改客户端 Type 而不改变服务端配置;协议不匹配带来的失败不是性能差异。
小页面正常、大响应或部分连接卡住时,才有必要进一步考虑 MTU、路径分片与中间网络设备。先排除目标服务异常、规则不一致和普通丢包,再根据服务端或网络诊断证据调整。没有通用的 MTU 数值适合所有链路;盲目调小可能增加开销,调大也可能造成新的卡顿。修改前记录原值,验证时使用同一个大响应目标,确认稳定改善后再保留。
日常选择应兼顾稳定性与实际业务,不必频繁执行全列表测试。批量检测会产生额外连接,在移动网络上尤其容易干扰当前业务。完成定位后保留一条适合当前网络的已有连接,恢复日常 Config,再检查资源请求是否按预期分流。如果只有后台应用慢而前台浏览正常,还应结合耗电章节检查后台调度和网络切换,避免把系统的后台限制误认为服务器性能问题。
DNS 解析异常:区分服务器域名与目标域名
DNS 问题可能出现在两个不同位置:客户端需要先解析服务器的域名,业务请求随后也可能需要解析目标网站的域名。前者失败时代理连接本身就建不起来,后者失败时则可能表现为 VPN 已连接但特定网站无法访问。先看日志里失败的是哪个名称,不要把所有域名错误都归为同一个 DNS 设置。解析成功也只表示得到了地址,并不保证该地址对应的服务可达。
确认解析请求经过哪条路径
检查当前 Config 中与 DNS 有关的设置,区分系统提供的解析器、手动指定的解析器以及通过特定路径访问的解析服务。配置了一个 DNS 地址,不代表当前网络一定允许访问它;采用加密传输的解析服务同样需要建立连接,还可能涉及其自身域名的初始解析。若解析服务必须依赖尚未建立的代理,就需要检查是否存在启动依赖循环,而不是再叠加更多解析器。
日志出现“名称不存在”与“请求超时”时,检查方向不同。前者可能是域名拼写、记录确实缺失或服务端返回结果的问题,后者则可能是解析服务不可达或请求路径异常。记录查询对象及返回类型,再用不同基础网络做对照。不要因为某个解析器在家中可用,就认为它在公共无线网络或蜂窝网络上也具有相同可达性。
缓存、IPv4 与 IPv6 的影响
修改 DNS 后,应用、系统或已有连接可能仍使用之前的缓存结果。先断开并重建测试连接,再关闭测试页面重新请求;必要时重新打开目标应用。不要仅凭地址栏刷新一次就判定设置无效。若同一名称同时具有 IPv4 与 IPv6 地址,不同网络可能选择不同路径,导致一台设备正常、另一台设备失败,或者切换 Wi-Fi 后结果变化。
IPv6 相关设置应根据实际网络验证,不能遇到任何异常都直接关闭。只有在日志或对照测试显示 IPv6 路径失败、IPv4 路径正常时,才有依据继续检查相关配置。更改后同时测试原来失败的网站和原来正常的网站,确认没有让另一组业务受影响。以 IP 地址访问网站也不是万能对照,因为 HTTPS 证书名称、虚拟主机与应用接口可能要求正确域名。
域名规则与 IP 规则为什么可能得到不同结果
DOMAIN 与 DOMAIN-SUFFIX 依赖请求中的域名信息,IP-CIDR 则针对目标地址段,GEOIP 依赖地址及相关数据。一个网站可以对应多个地址,也可能在不同网络返回不同结果,因此不能把一次解析得到的地址永久等同于该网站。规则中写入某个共享地址段,还可能影响其他完全不同的服务;对网站分流时,先检查能否使用准确的域名条件。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
示例中的 192.0.2.0/24 是文档示例地址段,不是可用服务器。no-resolve 用于避免为了该 IP 规则匹配而额外触发域名解析,并不等于关闭所有 DNS。理解它的作用后再放入实际文件,不要把网上片段整段覆盖到日常配置。若请求本身已经具有目标 IP,匹配行为又与只有域名时不同,应结合连接记录判断,而不是仅查看规则文本。
局域网设备名称失败时,还要区分普通 DNS、局域网名称发现与具体服务发现机制。打印机、存储设备和家庭设备不一定通过同一种方式发现;能访问某个 IP,不代表名称发现也一定可用。恢复诊断时,先使用当前配置原本正常的 DNS 路径,再逐项恢复自定义设置。最终记录应包含失败名称、网络类型、实际使用的解析路径及错误结果,便于在后续更新或换网后复现。
完成修复后,用一个此前失败的域名和一个此前正常的域名分别验证,并重新检查服务器自身域名。这样可以避免只修好了业务解析,却让下一次建立代理连接时仍然失败。若错误已经转为连接超时而不是解析失败,应转到节点章节继续,不必持续调整已经恢复工作的 DNS。
耗电与发热异常:观察业务流量和重连频率
系统电池页面中的应用占比是相对统计,不直接等于它增加了多少实际耗电。设备整体使用时间、屏幕亮度、蜂窝信号、视频播放和后台同步变化,都会改变这个比例。先比较相近使用条件下的掉电、温度与网络活动,再判断是否与 Shadowrocket 相关。仅看到占比上升就删除配置,可能既丢失现场,也不能解决真正持续传输数据的应用任务。
建立相同业务负载的对照
选择设备温度接近、网络信号相近的时段,分别观察空闲连接和相同日常业务。不要一组测试播放视频,另一组测试只锁屏待机;也不要在系统刚完成更新、照片同步或大量应用下载时比较。记录屏幕开启情况、充电状态与大致流量活动,能够帮助区分是加密转发负载、基础网络条件,还是业务本身消耗增加。
系统可能将部分网络扩展相关活动归到客户端名下,但不意味着所有请求都由客户端主动产生。某个后台应用反复同步、重试失败接口或传输媒体时,代理会参与这些连接。查看同时段的连接记录,找出持续出现的目标与失败模式,再回到对应业务应用检查。不要仅按应用显示名称推断请求来源,也不要为降低统计占比而随意屏蔽不认识的系统域名。
排除反复重连与批量检测
弱信号、Wi-Fi 与蜂窝数据频繁切换,以及不可达服务器,都可能让连接重复建立。TLS 握手、解析与认证反复发生时,耗电和发热可能比稳定保持连接更明显。检查日志中是否短时间连续出现连接、断开、重试,再固定一条稳定网络复测。如果只在通勤切换网络时明显,应先看重连规律,而不是直接改动全部协议参数。
On Demand 的条件也需要检查。条件过于频繁变化,可能使连接跟随网络环境反复启动与停止;但持续关闭按需连接也不一定适合日常需求。诊断期间先暂时关闭自动条件、保持手动控制,确认异常是否消失,再逐项恢复条件。与此同时,停止不必要的全列表 Connectivity Test,避免批量检测在后台制造额外请求,干扰对实际业务流量的判断。
日志与额外处理要按需使用
详细日志适合短时间复现问题,长期保持大量记录可能增加写入和处理负担。先记下故障发生时间,采集足够定位的片段后恢复日常记录级别,不要为了等待一个偶发问题而无限保留所有细节。含有额外重写或脚本处理的配置,也应在副本中逐项停用对照;判断依据是相同请求与相同条件下的差异,而不是处理项数量本身。
如果启用了需要解密检查的配置功能,应先确认自己理解其范围、证书条件和来源,再决定是否保留。普通连接、订阅更新与基础分流排查不需要为此增加新的证书。遇到发热时,先减少非必要处理并停止高负载业务,待设备温度恢复后再比较性能。温度较高时系统可能调整运行状态,此时连续测速会进一步增加负载,结果也缺乏可比性。
验证修复应观察足够覆盖日常场景的使用过程,而不是只看几分钟的电池百分比。系统统计具有时间窗口,修改后的结果未必立即反映到旧记录中。若基础网络关闭代理后仍持续发热,应进一步检查系统后台任务、信号和设备自身状态;若只有某个 Config 引发异常,则保留最小可用副本,并通过逐项恢复定位处理项。更多简短问题可转到问答页,避免在同一轮测试中同时改变电源、网络和规则。
更新后出现异常:区分应用、系统与配置变化
“更新后不能用”需要先说明更新对象:是 Shadowrocket、设备系统、订阅列表,还是远程 Config 文件。它们可能发生在相近时间,却作用于不同层级。先回忆最后一次正常连接使用的网络、服务器与文件,再核对当前实际状态。不要只因应用刚更新就断定全部错误来自应用;服务端参数变化、订阅条目移除或网络切换,也可能同时发生。
先保存现场,再做最小回归测试
在覆盖文件或删除数据之前,备份当前 Config,并保存能够说明问题的日志片段。订阅与配置文件不一定包含完全相同的信息,恢复前要确认服务器资料、规则文件和额外引用是否都已保存。备份里可能包含密码、订阅凭据或用户标识,应放在自己控制的位置;导出只是保存资料,不代表导出文件可以公开分享。
用原有服务器进行最小回归测试:关闭自动条件,手动连接,在 Proxy 下访问固定目标。如果这里正常,再切回 Config 检查规则;如果系统开关不能保持,就回到首章。这个顺序能先判断是系统隧道、代理连接还是分流文件受影响。每一步只恢复一个处理项,避免把多个变化叠加后得到无法解释的结果。
配置语法与引用变化
新导入或更新的 Config 若报错,查看错误涉及的节名、行内容和引用策略。常见问题包括逗号被替换为中文标点、规则被换行拆断、策略名称已经改动,以及复制时带入说明文字。先修复明确的语法错误,不要把所有未知选项逐一删除。来自不同来源的片段即使都使用规则关键字,也不保证可以直接拼接成完整且符合当前目标的配置。
订阅更新后,原先选中的服务器可能已改名或被移除,策略引用却仍指向旧名称。应核对当前实际选择和规则命中的策略是否仍可用,再决定重新选择或调整引用。若旧 Config 副本正常、新文件异常,就逐段比较规则、DNS 与额外处理项;不要为了恢复可用而立即覆盖唯一副本,否则后续无法确认究竟哪一段发生了变化。
系统更新后的权限与连接状态
系统更新后若出现授权提示,按当前设备页面重新确认,并检查 VPN 状态与 On Demand 条件。先重启一次设备,再进行固定网络测试;不要连续重置网络、重装应用和删除配置。更新刚完成时可能存在系统后台整理与同步任务,若主要表现为耗电或速度变化,应待相关活动稳定后按对应章节复测,不要与明确的握手错误混为一谈。
确需重新获取客户端时,使用全平台下载页。iPhone / iPad 从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,安装包由下载页通过本站下载路径提供。iPhone / iPad 的系统要求以 App Store 页面标注为准,核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118,避免仅凭相同名称判断。
桌面或安卓重新安装后,如系统提示阻止打开,应先确认文件来自本站,再按安装放行表处理:Windows 可在确认来源后通过 SmartScreen 的“更多信息”查看“仍要运行”;macOS 在隐私与安全性中检查“仍要打开”;安卓按系统提示允许当前来源安装未知应用;Linux 按包格式安装,AppImage 需具有执行权限。不要全局关闭系统防护来处理单个安装文件。
恢复数据与提交可复现问题
重装应放在备份与最小测试之后,而不是第一步。iPhone / iPad 使用原购买账户核对已购项目,恢复应用后仍需检查订阅和 Config 是否已经回来;商店购买记录不等同于应用配置备份。迁移前可阅读iCloud 同步、导出配置与恢复步骤。报告问题时给出系统环境、更新对象、错误原文和最小复现顺序,不编写推测性的版本结论,也不发送带凭据的完整文件。
iPad 专项检查:网络切换、局域网与配置迁移
iPad 与 iPhone 使用相近的连接逻辑,但网络来源、后台行为和使用场景可能不同。平板经常连接家庭 Wi-Fi、学校或办公网络,也可能通过手机热点上网;相同订阅在手机上正常,不代表平板当前网络具有相同路径。先确认 iPad 的网络来源、系统 VPN 状态、所选服务器与 Config,再比较两台设备,避免只看订阅备注相同就认为设置已经完全一致。
Wi-Fi、热点与网页认证
iPad 连接手机热点时,手机自身的代理状态不应被当作平板已经建立代理连接的证据。平板应单独检查 Shadowrocket 开关与实际请求路径。保持 iPad 的服务器和 Config 不变,分别在普通 Wi-Fi 与热点下测试;若仅某一来源失败,重点检查该网络的认证、DNS 和协议可达性。热点切换期间的短暂断线,也不应直接归因于订阅失效。
学校、酒店或办公场所的无线网络可能需要网页登录、同意使用条款或重新验证设备。先断开隧道完成该网络要求的认证,再尝试连接。认证状态可能因离开网络、休眠或有效期结束而变化,所以“昨天可用”不能证明今天已经完成认证。受管理的 iPad 还可能限制个人 VPN 或网络设置,应让设备管理员核对策略,不要移除不属于自己的管理配置。
锁屏、分屏与恢复后的旧连接
锁屏后再次打开页面失败时,先区分系统 VPN 已断开,还是业务应用保留了一条失效连接。查看系统状态,再关闭失败页面重新请求;如果新请求正常,问题可能在旧连接恢复,而不是全部服务器失效。On Demand 可以按条件重新建立连接,但不代表每个后台应用都能一直执行任务。系统后台调度与客户端连接状态需要分别观察,不能只看应用切到后台后的界面刷新。
分屏或多窗口使用时,多个应用可能同时发起下载、视频和文档同步。排查速度慢时先暂停其他窗口的传输,并固定一个前台目标。外接显示器、持续充电与高亮度也会改变发热条件;比较耗电时保持这些条件接近。若只有某个应用在恢复后失败,先重新建立该应用连接,再对照其他应用,不必立即重建系统 VPN。
局域网设备、投屏与发现服务
打印机、家庭存储和投屏设备通常依赖局域网可达性,有的还依赖广播或服务发现。先在关闭隧道时确认设备可以被找到,再在连接后观察变化。确认两台设备处于可以互访的同一网络,并检查无线网络是否启用了访客隔离;同一个 Wi-Fi 名称也不一定意味着设备之间允许通信。必要时核对系统中的本地网络访问权限,具体权限取决于发起访问的应用。
局域网地址分流可使用与你实际网络相符的 IP-CIDR 规则,但应先查明地址范围,不要随意添加覆盖过大的网段。域名访问与直接 IP 访问结果不同,说明还要检查名称解析或发现机制。投屏发现正常但播放失败,也可能涉及后续媒体连接,而不是发现步骤本身。先定位失败阶段,再修改相关规则;一条 DIRECT 规则不能替代所有发现协议和网络权限检查。
从 iPhone 迁移后逐项核对
迁移 Config 后,核对当前启用文件、服务器选择、订阅是否有效,以及文件引用是否齐全。iCloud 同步是否已经完成,应从实际文件与条目判断,不能只凭同一账户推测。设备上的系统 VPN 授权仍需单独确认,订阅链接也可能已经变化。先在 iPad 上手动连接并验证,再恢复 On Demand;不要把手机上所有自动条件未经检查直接套用到平板使用场景。
如果按上述顺序仍不能定位,整理一份简短记录:设备系统、网络来源、是否受管理、Global Routing、错误原文、另一条网络的结果,以及最小配置是否正常。继续操作前回看快速上手主线确认基础步骤,或在问答页查找对应问题。保留可以复现的条件,比重复导入、反复重装或同时修改多组参数更有助于缩小范围。