OFFICIAL MANUAL / 问题诊断

Shadowrocket 故障排查连接、订阅与配置诊断

先区分故障发生在哪一层,再修改对应设置。一次只改变一个条件,保留测试前后的结果,避免把权限、服务器、规则和 DNS 问题混在一起处理。

  • 权限与开关
  • 网络与服务器
  • 订阅与配置
  • 系统与设备

本页是按症状查阅的官方手册,不替代首次设置流程。尚未完成导入和首次连接时,先阅读快速上手教程;已经可以操作 Home、Config 与 Global Routing,但某一步出现异常时,再按下面的章节定位。教程负责建立可用连接,本页负责解释失败条件、对照方法与恢复边界。

排查以用户已有自己的订阅或服务器信息为前提。本站不提供、不销售、不推荐节点或订阅。客户端买断 ≠ 线路套餐;客户端一次性买断也不等于线路服务持续可用。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。获取渠道与安装放行步骤见全平台下载页。

01 / 权限层

连接开关打不开,或打开后立即关闭

开关不能保持开启,首先检查系统是否成功建立网络扩展或 VPN 配置,而不是直接修改服务器密码。Home 中的连接开关表示客户端请求接管相应网络流量;系统接受请求、扩展启动、服务器建立连接,是几个不同阶段。开关刚打开便回到 Not Connected,通常需要先判断停在权限阶段还是连接阶段。记录是否出现系统授权提示、身份验证提示或错误文字,原文比“打不开”更有诊断价值。

先确认系统授权与配置状态

在 iPhone 或 iPad 首次连接时,允许系统添加 VPN 配置,并按系统要求完成身份验证。若当时取消,返回 Shadowrocket 再发起一次连接;不要连续快速点击开关。随后到系统 Settings 的 VPN 管理位置查看对应配置是否存在。系统版本不同,入口名称可能略有变化,可在 Settings 搜索 VPN。配置存在不代表服务器可用,但配置没有建立时,服务器延迟测试不能替代权限检查。

若设备属于学校或单位管理,检查是否有管理策略限制新增 VPN、修改网络配置或运行网络扩展。受管理设备上,按钮不可操作与个人设备上的临时错误不是同一个问题。保留限制提示并联系设备管理员,不要反复删除管理项目。若系统要求设备解锁后才能修改,先完成解锁,再回到前台操作,避免把锁定状态下的失败误认为配置损坏。

排除连接竞争,再区分启动与握手

先关闭正在连接的其他 VPN 会话,以及可能接管同一系统网络通道的功能,再测试 Shadowrocket。这里的目标是减少同时改变路由的因素,不是卸载所有网络工具。若停用其他会话后开关能够保持,逐项恢复原设置,确认冲突来自哪一项。系统状态栏的 VPN 标记只说明存在系统连接,不能证明当前显示的是期望的那一个会话,应同时核对系统 VPN 列表中的名称与连接状态。

如果开关保持几秒后断开,观察错误是否指向服务器连接、认证、证书或配置解析。服务器地址错误与系统拒绝授权的处理方向不同:前者转到节点与协议参数检查,后者继续处理系统权限。不要因为开关关闭就清空所有服务器。对于可以正常打开但目标网页不通的情况,直接进入下一章,避免在已经成功的权限层重复操作。

  1. 关闭连接,保留当前配置与订阅记录。
  2. 将 Shadowrocket 留在前台,等待系统提示完成后再观察开关。
  3. 记录错误原文;若开关稳定开启,测试一项明确的网络请求。
  4. 只在确认系统配置异常后,考虑移除对应 VPN 配置并重新授权。

重新授权的边界与恢复方法

移除系统 VPN 配置前,先确认应用内服务器信息和 Config 副本已经保留。系统配置与应用内规则文件不是同一对象,删除前应看清所在页面,避免把订阅列表当成系统配置清理。重新打开 Shadowrocket 后发起连接,按系统提示添加配置;如果仍失败,重启设备后在相同网络复测一次。重启用于排除暂时挂起的系统扩展,不是证明原配置正确。

Mac、Windows、安卓与 Linux 上,先确认应用已经能够正常启动,再检查相应网络权限。若故障实际上发生在首次打开应用之前,应按下载页的安装放行表处理:Windows 在核对来源后使用 SmartScreen 的“更多信息 → 仍要运行”;Mac 在“隐私与安全性”检查“仍要打开”;安卓检查“允许安装未知应用”;Linux 检查安装格式与执行权限。不要把安装拦截当成连接失败,也不要对来源不明的文件放行。

02 / 路由层

显示已连接,但网页与应用无法上网

连接开关保持开启,只能说明系统连接已经建立,不能直接证明每个目标请求都经过正确的出口。先把“全部无法访问”“只有部分域名失败”“浏览器可用但某个应用失败”分开记录。三种现象分别可能涉及基础网络、服务器路径、规则匹配、DNS 或应用自身行为。选择一个平时稳定且当前有明确用途的目标作为测试对象,重复同一项操作,不要每次更换不同网站后笼统比较。

先检查未连接时的基础网络

关闭 Shadowrocket,用当前 Wi-Fi 或蜂窝网络访问一个原本可以直接访问的页面。如果此时也失败,优先处理 Wi-Fi 登录认证、蜂窝数据权限、路由器或系统网络状态。公共 Wi-Fi 可能要求先完成网页认证,连接图标存在并不表示认证已经完成。先在断开 VPN 的状态完成认证,再启动 Shadowrocket;认证页面本身访问失败时,不要继续通过改规则寻找原因。

基础网络正常后,恢复原服务器与原配置,确认 Home 中实际选中的是期望的 SERVER。列表中有多个相似名称时,应核对地址或所属订阅,而不是只看显示名称。某条服务器刚刚测试通过,也不会自动保证后续连接选择了它。若使用选择策略,还应确认策略最终指向哪条可用记录;把策略名误当成固定服务器,会使前后两次测试缺少可比性。

用 Global Routing 三姿态建立对照

先记下原来的 Global Routing,再短时间切换姿态进行诊断。Config 按当前配置处理流量;Proxy 将适用流量交给所选代理路径;Direct 用于直连对照。这里的切换不是永久建议,而是为了区分规则问题与服务器问题。完成测试后恢复原姿态,尤其不要把为诊断临时启用的 Proxy 忘记保留在日常环境中。

姿态主要对照目的观察结果后的方向
配置 / Config观察当前规则的实际行为只有此姿态失败时检查规则顺序与策略
代理 / Proxy减少规则分流差异同样失败时检查服务器、认证与 DNS
直连 / Direct观察目标的直接网络路径同样失败时继续检查基础网络与目标服务

如果 Proxy 可以访问、Config 不行,查看目标命中了哪条规则,以及该规则指向的策略是否存在。规则通常按顺序匹配,前面的宽泛条目可能遮住后面的精确条目。下面的片段仅用于解释顺序,不是完整可导入配置;实际使用时,必须确认当前配置中 PROXY 对应的策略已经定义,不能仅凭复制规则就认为出口可用。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

从单个请求继续缩小范围

若只有某个应用失败,先在浏览器访问同一服务的公开页面,再比较应用登录、内容加载与上传等不同操作。页面能打开而登录失败,可能是认证、时间或服务端风控;图片加载失败也可能来自另一个域名,不能只给首页域名加规则。查看请求记录时关注真正失败的域名与处理策略,避免把成功请求当作故障证据。

若切换网络后恢复,保存两种网络下相同配置的结果,再检查局域网限制与 DNS 差异;若所有网络都失败,才继续集中检查服务器或配置。每次修改后重新发起请求,必要时结束旧连接再测试,已有长连接未必立即采用新规则。完整的导入与连接顺序见Config 设置教程,协议字段疑问可查协议相关问答。

03 / 服务器与传输层

节点超时、连接间歇失败与速度慢

Timeout 表示某一步没有在等待时间内得到期望响应,不等于密码一定错误,也不等于服务器一定停止运行。延迟测试、协议握手和实际网页访问可能使用不同的测试方式,三者结果需要分别记录。首先说明是单条服务器超时、同一订阅全部超时,还是只有某种网络超时。范围越明确,越容易判断应检查本地网络、订阅参数还是远端服务。

区分测试失败与真实业务失败

运行 Connectivity Test 时,先确认测试对象与方式,再用浏览器发起一次实际请求。有些服务器不响应某类探测,但能够完成正常代理连接;反过来,探测成功也不能保证访问目标的后续路径正常。不要把某个延迟数值直接当作下载速度,也不要用一次测试给服务器作长期判断。相同条件下连续几次结果是否稳定,比孤立的一次读数更有意义。

在保持配置不变的前提下,切换 Wi-Fi 与蜂窝网络测试同一条服务器。如果只有 Wi-Fi 失败,检查路由器、公共网络限制与 DNS;如果只有蜂窝失败,检查应用蜂窝权限与当前数据网络状态。测试会消耗流量,尤其大文件传输前应确认数据额度。若已有另一条确认可用的服务器,可作为对照,但不要为了排查去导入来源不明的记录。

按协议逐项核对参数

服务器地址、端口和认证信息是第一组检查项;TLS、SNI、传输类型与路径是第二组。导入成功只表示客户端能识别内容,不代表其中每个字段都与服务器一致。不要把服务器地址直接填入所有名称字段,也不要因为使用相同端口便假定传输方式相同。优先与自己的服务商提供的原始信息逐项核对,修改前保留原记录。

协议或功能重点核对常见误判
Shadowsocks地址、端口、加密方法、密码只修正密码而忽略加密方法
VMess / VLESS身份字段、传输方式、TLS 与相关参数协议名称相同就认为其余字段通用
Trojan认证信息、TLS、SNI混淆连接地址与证书名称
Hysteria2 / WireGuardUDP 可达性与各自认证、密钥参数以普通网页可访问推断 UDP 同样可用

出现证书相关错误时,先检查设备日期、时间与时区是否正确,再核对服务器证书名称和 SNI。不要把关闭证书验证当作通用修复方式,它会掩盖名称错误、证书异常或连接目标不符。若服务商已经更换连接参数,先更新自己的订阅,再比较新旧条目的差异,而不是凭经验补填字段。

速度问题需要拆分测量环节

连接建立慢、首屏出现慢和持续下载慢,是不同的瓶颈。建立慢可能发生在 DNS 或握手阶段;首屏慢可能涉及目标站点和多个附属域名;持续下载慢则还受本地带宽、服务器负载与远端线路影响。用同一目标、相近时段与同一文件比较,每轮只改变服务器或网络中的一个因素。后台系统更新与云同步也应纳入观察。

若小页面正常而大文件频繁停顿,记录是否只在某个网络或某种传输下出现,再请自己的服务商确认服务器侧状态。不要在没有证据时随意调整 MTU 或并发参数,错误设置可能扩大故障范围。恢复原值后能否稳定复现,是判断参数影响的必要条件。提交问题时提供失败时间、网络类型、错误原文及脱敏参数,不要发送完整密码或私钥。

04 / 订阅数据层

订阅导入失败、更新失败或列表没有变化

订阅更新是“取得内容”和“解析内容”两个过程。前者涉及订阅地址可达性、认证与服务器响应,后者涉及格式、协议字段及客户端能否识别。先看错误发生在下载阶段还是导入阶段:连接超时、认证失败、返回空内容与格式错误,应分别处理。用户已有的订阅地址通常包含访问凭据,不要把完整地址放入公开截图、聊天记录或浏览器同步笔记。

确认拿到的是订阅内容而不是网页

从自己的服务商账户页面重新复制订阅地址,注意不要复制到说明页、管理后台页面或分享页面。复制时检查首尾是否混入空格、换行与中文标点,尤其留意消息软件自动断行后的内容是否完整。地址中的参数有时承担认证作用,不能为了缩短显示自行删减。二维码识别成功只说明内容被读取,并不证明内容一定是客户端所需的订阅格式。

若反馈认证失败或链接失效,先在服务商账户中确认该订阅是否已重置、到期或受访问条件限制。此前保存的旧地址可能在重置后立即失效,客户端重复更新无法恢复失效凭据。若返回的是登录页面或验证页面,说明下载到的并非服务器列表,应取得正确的订阅入口。不要把网页内容手工改成几行地址后当作完整订阅使用。

检查获取路径,再保护已有列表

有些订阅地址在当前直接网络下不可达,但在已有可用连接下能够获取;也可能相反。先记下原连接状态,分别测试断开连接与使用已确认可用连接时的更新结果。不要使用正等待该次订阅更新才能恢复的失效服务器作为获取路径,这会形成排查循环。若全部服务器都失效,应先向自己的服务商确认订阅入口和服务器状态。

更新失败时保留原有列表,避免先删除整组订阅。原条目若仍可连接,可以帮助判断问题仅限订阅接口,还是服务器本身也不可用。更新完成后核对服务器数量与条目字段,但不要只凭数量相同判断没有更新;名称可能不变,而地址、认证或传输参数已经改变。反过来,列表数量增加也不代表新增条目一定能够连接。

识别解析问题与覆盖边界

如果能够获取内容但提示解析失败,确认服务商提供的格式与所选导入方式匹配。Add Server、Subscribe、Scan QR Code 与 Import from Cloud JSON 面向的内容类型并不完全相同,不能把完整配置文件、单条连接信息与订阅地址视为同一种输入。先使用匹配的入口导入一份副本,确认结果后再替换旧记录;详细操作见订阅导入教程。

订阅中的单条记录如果在本地被手工修改,后续更新可能重新写入服务商提供的参数。需要保留临时修正时,应另存独立记录并明确命名,同时向服务商核对原始信息;不要长期依赖每次更新后再手工补改。若某些条目消失,检查过滤条件和分组显示,再确认订阅返回内容是否实际包含这些条目,避免把显示筛选误认为数据丢失。

重试应留有间隔,连续点击不能修复认证或格式问题,还可能触发接口访问限制。整理问题时记录失败阶段、错误原文、当时网络与是否开启连接,仅提供脱敏后的地址结构。若对方要求日志,先检查其中是否包含订阅凭据、服务器密码与私人域名。订阅内容的可用性由对应服务端决定,客户端付费状态不能替代订阅账户状态。

05 / 名称解析层

DNS 失败、域名打不开与规则命中异常

DNS 将域名转换为连接所需的地址。服务器能连接但某些域名打不开,可能是解析失败,也可能是解析成功后目标连接失败,二者不能仅凭浏览器的一句错误提示区分。先记录失败域名、发生时间与 Global Routing 姿态,再查看请求或诊断记录中是否存在解析错误。只看到页面空白时,不应立即添加更多 DNS 地址;过多同时变化的设置会让后续结果难以解释。

把解析失败与目标拒绝连接分开

若记录显示没有取得地址,重点检查 DNS 服务器是否可达、所用传输是否依赖当前网络以及相关设置是否生效。若已经得到地址,却在后续连接超时,应继续检查路由、出口和目标服务。不要简单用目标 IP 替换 HTTPS 地址作为唯一判断,因为 HTTPS 还依赖域名、证书与服务端名称,直接访问 IP 失败不能反证 DNS 一定正常或异常。

同一域名在 Wi-Fi 与蜂窝网络下结果不同,先保持服务器与配置相同,再比较两种网络。若只有局域网内部名称失败,检查该名称是否需要由当前路由器或单位内部 DNS 解析。公共解析服务通常不知道私人局域网里的设备名称,把所有请求交给同一个远端解析入口,可能修复外部访问却破坏内部服务。对内部域名的处理应根据所在网络配置,而不是套用通用地址。

检查 DNS 设置与规则顺序的交点

在 Config 中确认正在使用的文件,再查看 DNS 相关设置,避免编辑了未启用的副本。记录系统 DNS、配置内 DNS 与可能存在的加密解析设置,逐项确认谁在处理当前请求。不要假定设置栏里出现的每个地址都会同时生效,也不要把系统层的名称解析结果与代理服务器侧解析结果混为一谈。不同处理路径可能得到不同地址,应结合实际请求记录判断。

规则检查应从最早可能匹配的条目开始。DOMAIN 关注精确域名,DOMAIN-SUFFIX 关注域名后缀,IP-CIDR 与 GEOIP 面向地址条件,FINAL 负责前面未匹配的请求。地址条件可能涉及解析结果,因此同一目标的 DNS 变化也可能改变后续分流结果。下面仅展示规则类型,不包含完整策略定义,不能直接替换正在使用的配置。

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

如果某个域名本应走 PROXY,却提前命中宽泛的 DIRECT 条目,应调整规则位置或条件,而不是在文件末尾不断追加相同域名。还要检查应用请求的实际域名是否与预想相同:登录、图片、接口和推送可能分属不同域名。仅观察网页地址栏,无法覆盖后台的所有请求;应从失败记录中找出需要检查的对象。

缓存、IPv6 与恢复测试

修改 DNS 后,旧连接与缓存可能继续影响结果。先保存配置,断开并重新连接,再重新发起目标请求;必要时关闭目标应用后再打开。不要在未等待新请求的情况下,仅刷新诊断页面就判断设置无效。设备重启可以排除部分缓存和会话因素,但应放在记录原始结果之后,以免丢失可复现条件。

若仅部分网络出现 IPv6 相关连接失败,比较记录中的 IPv4 与 IPv6 地址,以及当前配置对两类地址的处理。不要一见超时就永久关闭 IPv6,也不要默认开启便一定更快。先确认失败是否稳定关联某类地址,再做短时间对照,完成后恢复原值。涉及路由器或单位网络的解析策略时,应与网络管理员核对,而不是覆盖受管理的设置。

06 / 后台与连接策略

后台耗电、发热与 On Demand 反复连接

排查耗电应先看系统电池统计,再判断 Shadowrocket 是否是主要因素。电池页面中的占比是统计时段内各应用的相对消耗,不等于电池总容量按相同比例减少;设备使用时间较少时,某项后台活动的占比可能显得很高。先选择有代表性的观察时段,记录屏幕使用、网络类型、信号强弱与后台下载情况,不要只用刚打开应用后的短时间读数作结论。

建立能比较的观察条件

在系统 Settings 的电池页面查看 Shadowrocket 的前台与后台活动,再与相同时间内的浏览器、视频、云同步和系统任务对照。经过系统 VPN 通道的流量不一定由客户端主动产生,其他应用在后台持续传输,也会让网络扩展维持工作。Data 页的流量记录可帮助发现活跃对象,但流量大小与耗电不是固定比例,还需要结合连接次数、无线信号与设备温度判断。

先暂停能明确识别的大量后台传输,再观察问题是否仍然存在。若只在弱蜂窝信号下发热,移动网络重连和无线发射可能是重要因素;若稳定 Wi-Fi 下仍持续出现,再检查客户端连接策略。测试时尽量保持相同屏幕亮度、相近使用方式和同一网络,不要一边充电、一边下载大文件,再与待机状态直接比较。

On Demand 不是固定的省电开关

On Demand 根据配置条件触发连接,并不意味着开启后一定省电,也不意味着关闭后一定更稳定。若条件与日常网络切换不匹配,设备可能在 Wi-Fi、蜂窝或唤醒时反复尝试连接。先记录连接发生的场景:锁屏后、离开 Wi-Fi 时、加入某个网络后,还是打开某个应用后。把触发时刻与设置条件对应,才能判断是否存在重复触发。

需要关闭连接进行观察时,先检查 On Demand 是否会立即重新建立连接。只点击 Home 的开关而没有处理自动连接条件,可能让用户误以为开关失效。短时间停用 On Demand 后,以相同网络和相近使用方式观察,再恢复原设置比较。这个测试用于隔离触发因素,不代表建议所有用户长期关闭;有自动连接需求时,应根据实际网络条件重新整理规则。

  1. 记录原有 On Demand 条件与当前连接状态。
  2. 暂停自动触发,手动建立一次稳定连接。
  3. 观察是否仍有持续重连、网络中断或异常后台活动。
  4. 逐项恢复条件,确定哪项条件与异常同时出现。

从持续重连追查服务器与网络

如果停用自动触发后,手动连接仍频繁中断,应回到服务器、网络与 DNS 章节,不要继续只调整电池选项。服务端连接不稳定、认证失败或解析超时,都可能让客户端反复尝试建立连接。后台耗电有时是连接故障的结果,而不是独立的性能问题。先恢复可持续使用的连接,再评估待机影响,通常比单独限制后台更容易找到原因。

对于只在某个 Wi-Fi 出现的重连,检查该网络是否需要周期认证、是否在空闲后断开,以及设备是否频繁切换接入点。系统低电量模式、应用后台行为与网络策略也可能改变观察结果,应一并记录。不要为了降低读数而关闭与需求无关的系统保护;如果业务需要长连接,应说明测试中是否保留了相关后台任务。

临时开启的详细日志和大量诊断测试结束后应恢复日常状态,避免观察过程本身持续产生工作负载。若问题仍可复现,整理一个尽量简单的场景:固定网络、单条服务器、明确的 On Demand 状态与一项重复操作。关于流量面板可阅读Data 页统计说明,连接策略取舍见On Demand 与后台耗电排查。

07 / 更新与恢复

应用或系统更新后,原配置出现异常

“更新后发生”是时间关系,不一定已经证明更新是直接原因。应用更新、系统更新、订阅刷新、规则修改和服务端参数变更,可能在相近时间发生。先列出最近实际改变的项目,再用保留的配置副本复测。不要同时重装应用、重新导入订阅和更换 DNS,否则即使恢复,也无法知道是哪一项产生作用,下一次遇到相同问题仍然缺少依据。

先保存现场,再核对正在使用的对象

保留当前 Config、服务器信息与错误原文,确认更新后是否仍选中原服务器和原配置文件。列表顺序、分组或名称变化可能造成误选,看起来像“旧配置失效”,实际连接的却是另一条记录。若使用自动选择策略,确认最终选中的对象;若有本地修改,比较它是否在订阅更新后被远端内容覆盖。核对对象通常比立即恢复所有默认值更有效。

区分应用无法启动、连接开关无法保持、服务器握手失败与部分规则不生效。应用能打开但连接权限重新出现时,按系统提示完成授权,然后回到第一章;开关稳定而访问失败时,按路由与服务器章节检查。系统更新后如果网络扩展暂时异常,可以先重启设备再做同条件复测,但应在重启前记录已有提示,不要丢掉唯一的错误信息。

用最小配置判断兼容与引用问题

在副本中减少非必要规则和策略,保留一条已经核对参数的服务器,先测试基本连接。最小配置可以帮助判断故障是否来自复杂策略引用或某个配置项目,不意味着应永久删除所有分流规则。若基本连接可用,逐组恢复规则,每次确认保存并重新发起请求;恢复到某一组后再次失败,就继续检查该组里的条件与策略名称。

配置解析错误应根据具体行与字段处理。策略名称变更、引用了不存在的分组、段落位置错误或粘贴时混入不可见字符,都可能让文件无法按预期加载。先确认编辑的是当前启用的文件,再核对保存是否成功。不要把整份旧文件直接覆盖进新环境后立刻删除备份;保留前后两份,才能区分旧内容本身的问题与迁移过程中的变化。

需要重新获取应用时的渠道与放行

iPhone / iPad 使用 App Store 更新或重新获取,系统要求以 App Store 页面标注为准。核对开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。Mac、Windows、安卓与 Linux 的更新获取方式见全平台下载页,安装包仅由本站 /dl/shadowrocket/ 路径提供。不要用陌生来源的同名程序覆盖当前应用。

桌面与安卓首次运行或替换安装后,可能再次遇到系统拦截。Windows 核对来源后查看“更多信息 → 仍要运行”;Mac 查看“隐私与安全性 → 仍要打开”,若明确提示应用已损坏,按下载页说明核对路径后再处理扩展属性;安卓为实际打开安装文件的应用授予安装权限;Linux 按发行版选择安装格式,AppImage 需要执行权限。受管理设备的限制应交由管理员处理。

重新获取前确认备份是否真的可用:仅有服务器名称截图通常无法恢复认证字段,仅保存订阅名称也不能替代完整地址。备份应放在自己的受控位置,不要上传到公开空间。若同一配置在更新前后的行为仍有稳定差异,提交复现步骤、错误文字、系统环境和脱敏配置片段;避免附带全部访问历史,减少与问题无关的个人数据。

08 / iPad 场景

iPad 横屏、换机与网络切换专项检查

iPad 的排查主线与前文一致:系统权限、基础网络、服务器、规则和 DNS 依次检查。需要额外注意的是横屏与多窗口布局、Wi-Fi 和蜂窝型号差异、键盘输入,以及从另一台设备迁移后的配置完整性。不能因为相同订阅在 iPhone 上可用,就跳过 iPad 当前网络和所选服务器的核对;两台设备的连接条件可能并不相同。

横屏与多窗口下先确认操作对象

横屏布局可能同时显示列表与详情,点击某条记录进入编辑,不一定等于已经将它选为当前连接服务器。完成编辑后回到 Home,确认选中状态与实际连接对象,再启动测试。多窗口或分屏使用时,如果看不到完整按钮,先将 Shadowrocket 恢复为较宽窗口或全屏,再完成导入和保存,避免把布局空间不足误认为功能缺失。

外接键盘粘贴订阅时,注意输入框是否获得焦点,粘贴内容是否完整,以及是否误触回车提交。长地址在窄输入框中显示不全,不代表字符串被截断;应检查首尾和参数,而不是根据视觉长度判断。复制配置片段时保持英文标点与真实换行,不要让文本编辑工具自动替换逗号、引号或连字符。保存后重新打开相应项目,确认修改确实写入。

两台设备对照要控制网络与配置

进行 iPhone 与 iPad 对照时,先让两台设备加入同一个 Wi-Fi,使用同一条服务器与相同 Global Routing 姿态,测试同一个目标。若此时只有 iPad 失败,再比较系统 VPN 权限、当前 Config、DNS 与 On Demand。不要一台使用蜂窝、另一台使用公共 Wi-Fi,却把差异直接归因于设备型号。对照条件一致,结果才具有定位价值。

Wi-Fi 机型没有自身蜂窝网络,可通过自己可用的热点做第二网络对照。热点本身也有上游网络与数据额度,应说明测试实际经过哪条路径。支持蜂窝的 iPad 则需检查应用蜂窝权限、数据连接状态与 Wi-Fi 切换结果。离开 Wi-Fi 后连接中断时,先确认基础网络已经切换成功,再观察 Shadowrocket 是否重新建立连接;不要把网络尚未就绪时的瞬间失败当作持续故障。

锁屏后再打开应用出现短暂加载,可能与旧会话重建、网络切换或目标应用恢复有关。记录恢复后是否能自行重新请求,以及 Home 的连接状态是否真的发生变化。若只是某个应用需要刷新,先检查该应用的会话;若系统连接反复关闭,再回到开关与 On Demand 章节。对于公共 Wi-Fi,休眠后的重新认证也应纳入检查范围。

已购获取与配置迁移分别验证

iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费。iPad 使用购买时的同一 Apple ID,可在已购项目中查找 Shadowrocket;系统要求以 App Store 页面标注为准。若仍显示价格,先核对登录账户与购买记录,不要急于再次付款。获取应用和迁移连接配置是两个步骤,完成前者不会自动证明后者已经完成。

从另一台设备迁移后,分别检查订阅地址、服务器参数、Config、DNS 与自动连接条件。不要仅凭服务器名称相同判断内容完全一致,也不要假设所有本地设置都会随系统迁移完整恢复。先导入自己的订阅并验证一条连接,再恢复分流配置,最后启用 On Demand;这样的顺序便于在失败时确定是哪一步引入差异。

需要同步文件时,只使用自己受控的存储位置,并确认文件内容不是旧副本。含认证信息的配置不适合通过公开链接传递,向他人求助前应移除凭据。若问题最终只在 iPad 的特定布局、网络切换或锁屏场景出现,记录操作顺序与复现条件,相关获取说明见iPad 已购下载与横屏使用要点;基础操作仍可返回快速上手教程逐步核对。