官方手册 / iPhone 与 iPad
Shadowrocket 订阅导入
与连接检查教程
先导入已有资料,再选择 Global Routing;连接后用实际访问验证结果。首次操作按下列五步完成,遇到失败时从对应环节继续检查。
- 已有资料 → 导入
- Global Routing → 连接
- 实际访问 → 验证
尚未安装时,先阅读App Store 下载说明 →。系统要求与购买适用范围以 App Store 页面标注为准。以下操作以 iPhone、iPad 为对象;界面布局可能随设备和应用调整而变化,请按英文入口名称识别。
步骤 01 / 建立可选的服务器记录
添加服务器或导入已有订阅
打开 Shadowrocket,先在 Home 查看是否已经有服务器记录。空列表只表示尚未添加资料,不表示应用安装失败。添加前先辨认手中内容:一组地址、端口和认证字段用于手动填写;单个服务器分享链接通常导入一条记录;Subscribe 订阅地址用于获取和更新一组记录;配置文件则可能包含规则及其他设置。这几类资料不能仅凭“都是链接”就互换入口。
已有订阅:使用 Subscribe 对应的导入项
从自己的服务商处复制完整订阅地址,确认复制的是订阅内容入口,而不是账户登录页、账单页或说明文章。回到 Home,打开添加入口;如果 Add Server 的类型列表提供 Subscribe,选择该项并填写订阅地址,保存后等待获取完成。若应用从剪贴板识别出可导入内容,先核对导入类型和来源,再确认,不要因出现提示就直接接受。
保存后返回 Home,检查订阅分组及其服务器记录是否出现。只有订阅名称、没有服务器条目时,应先检查更新结果,而不是立即打开连接。订阅刷新可能改变记录名称或可选项目;首次成功后先选一条记录验证,不必反复导入同一地址。重复导入容易产生相似分组,之后难以判断连接使用的是哪一份资料。
如果已有资料明确指向 Config 页的远程配置或 Subscribe 管理入口,应按其资料类型操作:在 Config 中添加或获取对应配置,检查内容后再选择使用。Config 主要管理配置文件,导入一份配置不等于已经选中可用服务器;同样,Home 中出现订阅记录,也不代表规则配置已经切换。入口名称相近时,先区分“更新服务器列表”与“选择规则配置”两个目的。
已有服务器信息:在 Add Server 中逐项填写
在 Home 点添加入口进入 Add Server,先选服务商给出的协议类型,再填写服务器地址、端口以及对应的认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等类型需要的字段并不相同。只填写资料中明确给出的值;密码、标识、密钥、传输设置不能根据相邻字段猜测,也不要把服务器显示名称当作连接地址。
填写时注意前后空格、全角标点及复制时多带的换行。地址栏通常只需要指定的主机名或地址,不应自行拼上网页路径;端口则按原资料填写。需要 TLS 或其他传输参数时,逐项对照来源说明,不能用“先全部打开”的方式试错。保存后返回 Home,点选刚添加的记录,并再次核对名称,防止误选旧记录。
已有二维码可从 Scan QR Code 进入识别;已有分享链接可使用应用提供的剪贴板导入提示。无论采用哪种方式,完成标准都是“记录已经保存并能明确选中”,而不是“扫描动作已完成”。协议字段含义可查阅术语表,四种导入入口的进一步说明见订阅导入方法。确认记录无误后,再进行路由选择。
步骤 02 / 确定连接如何处理
选择 Global Routing 姿态
在 Home 找到 Global Routing 并打开选择项。这里决定流量的整体处理方式,不负责补齐服务器资料,也不会修复失效的认证信息。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)。选择前先明确本次目标:按规则日常使用、对照测试服务器,还是检查原有网络。
| 姿态 | 处理方式 | 本教程中的用途 |
|---|---|---|
| 配置(Config) | 按当前配置中的规则选择处理策略。 | 用于日常规则分流,并验证规则是否符合预期。 |
| 代理(Proxy) | 以代理处理为主要路径。 | 用于对照检查服务器链路,不替代规则核对。 |
| 直连(Direct) | 以直接连接为主要路径。 | 用于检查原有网络,不适合验证代理服务器。 |
日常分流:选择 Config 并核对当前配置
需要按目标分流时选择配置(Config),随后进入 Config 页,确认当前选中的配置确实是准备使用的那一份。配置列表中存在文件,并不等于该文件正在生效。若刚导入远程配置,先检查获取是否完成、文件是否可读取,再按界面选择它。已有配置能正常工作时,不必为了完成本教程额外替换一份来源不明的规则。
规则中的 DIRECT 表示直接连接,PROXY 表示交给相应代理策略,REJECT 表示拒绝。规则通常按顺序匹配,因此目标被前面的规则命中后,后面的规则可能不会再参与处理。这里先理解“配置决定路径”即可,不需要马上改写规则。若当前配置引用了不存在的策略或尚未准备好的服务器组,应先修正引用,而不是只切换 Home 中的记录。
对照测试:临时选择 Proxy 或 Direct
尚不确定问题来自服务器还是规则时,可临时选择代理(Proxy),用同一个目标做一次对照;如果 Proxy 下可以访问,而 Config 下不行,后续重点应转向配置和命中策略。直连(Direct)则用于观察原有网络能否访问该目标。它并不保证每个网站都能打开,也不能证明代理服务器可用。
每次切换后回到 Home 核对显示的 Global Routing 值,并记录这次测试采用的姿态。对照结束后恢复计划使用的配置(Config),避免把临时测试状态当作日常设置。有关规则关键字与策略含义,可继续查阅术语表;此时先保留一个明确的姿态,进入连接步骤。
步骤 03 / 建立系统连接
打开开关并完成 VPN 授权
回到 Home,再次确认选中的服务器和 Global Routing。尤其是刚刷新订阅后,原先选中的记录可能已经变化;不能只看列表里有熟悉名称就认定当前正在使用它。确认后打开 Home 的连接开关,等待应用报告状态,不要在等待过程中连续开关或同时修改配置。
首次建立连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置。这个提示用于授予应用建立系统网络隧道的权限,不是再次购买应用,也不是订阅导入确认。阅读提示中的应用名称,确认是本次主动操作发起的请求,再按系统流程允许,并完成设备密码或生物识别验证。若选择取消,服务器记录仍可能保留,但连接不能按预期建立。
授权后返回 Shadowrocket 观察开关和连接状态。系统中的 VPN 标识可以作为辅助信息,但不同设备的状态栏展示并不完全一致,不必只为寻找某个图标反复重连。更重要的是应用是否维持连接,以及下一步实际访问是否成功。连接状态成立只说明隧道已经建立,不能直接推导出认证、DNS、目标服务和分流规则都没有问题。
如果开关立即回落,先检查系统授权有没有完成,再查看是否存在其他正在管理网络隧道的系统配置。单位或学校管理的设备可能限制相关操作,应遵循设备管理要求,不要随意删除不清楚用途的配置。完成授权仍反复失败时,保留报错文字,稍后按排查顺序处理。
首次验证期间先保持操作简单:在应用前台手动连接,不同时新增 On Demand 条件。On Demand 用于按条件触发连接,与本次手动验证是两个层次。已经设置过该功能的用户应留意自动重连是否影响测试,防止刚手动断开又被条件重新触发。连接稳定后,再进入实际访问验证。
步骤 04 / 分开检查三个结果
验证连接、访问与分流是否生效
验证时分别回答三个问题:连接有没有保持、目标能不能访问、路径是不是符合配置。它们不是同一个结果。不要只凭开关已打开就结束,也不要只凭一次测试超时就删除全部设置。固定同一条服务器记录和同一个测试目标,才能比较前后操作的影响。
先执行 Connectivity Test
在 Home 找到 Connectivity Test,对准备使用的服务器进行测试,等待结果后再继续。测试采用的方式和目标会影响读数;有结果表示这次探测获得了响应,不等于所有网站或所有应用都能正常通信。反过来,测试失败也可能与探测目标或网络环境有关,需要结合实际访问判断。不要为了追求更小的数字持续切换服务器。
再进行一次可重复的实际访问
打开浏览器,访问一个熟悉、允许访问且能够明确判断是否加载完成的目标。尽量重新加载页面,避免把已经缓存的页面误判为刚刚连接成功。确认页面正文或实际请求能够完成,而不是只看到旧标题或封面。第一次测试不宜同时打开多个应用,否则难以确定哪次请求与哪条记录对应。
随后回到 Shadowrocket,查看 Data 中与本次操作相关的流量变化;如应用提供当前连接记录,也可结合目标地址与处理策略核对。Data 出现流量只能说明发生了传输,后台请求也会贡献读数,因此不能仅凭数字增加就认定目标走了 PROXY。需要结合访问时间、目标及策略一起判断。
最后检查 Config 的分流结果
使用配置(Config)时,选择一个按配置应走 DIRECT 的目标,再选择一个按配置应走 PROXY 的目标,分别访问并核对记录。不要预设某个固定域名在所有配置中都应该采用同一路径;实际结果取决于当前文件。若目标命中了 REJECT,阻断可能正是规则预期,并不是连接开关失效。
如果代理(Proxy)下访问正常,恢复配置(Config)后同一目标失败,记录当前配置名称及命中的策略,重点检查规则和策略引用。如果两种姿态都失败,则继续检查服务器信息和网络条件。验证完成后保留预期的 Global Routing 设置;Data 的读数也不能直接当作服务商的用量账单,二者统计口径可能不同。
步骤 05 / 每次只修改一项
按失败位置继续排查
排查从最早失败的一步开始,而不是把所有设置重新填写。先记下所用网络、选中的服务器、Global Routing 值、当前配置名称和可见错误。一次只改变一个条件,再重复相同访问。这样才能判断改善来自哪项修改,也便于恢复到原先状态。
订阅导入后没有记录
先检查地址是否完整,以及返回的是订阅内容还是需要登录的网页。地址中的查询参数可能参与认证,遗漏一段就可能导致获取失败;不要自行删减。确认已有服务的有效状态和格式适用性后,再执行更新。若服务商调整了地址,应先更新原有订阅条目,验证成功后再清理旧内容,避免唯一可用资料被提前删除。
记录存在,但开关无法维持
检查系统 VPN 授权是否完成、所选配置是否可读取,以及当前是否有其他网络隧道设置影响连接。回到 Add Server 核对协议类型与必填字段,不要只重填密码。若配置导入后立即失败,可先回到此前确认可用的配置做对照,区分是新配置的问题还是连接本身的问题。
已经连接,但目标打不开
先断开 Shadowrocket,确认原有 Wi-Fi 或蜂窝网络本身能够完成基本联网,并处理可能存在的网络登录页面。重新连接后核对实际选中的记录,再执行 Connectivity Test。如果自己已有多条可用记录,可在其他条件不变时换一条做对照;不需要为排查不断增加未知来源的资料。
服务器认证失败时,逐项核对地址、端口、认证与传输字段是否来自同一份信息。订阅中的记录可能已经更新,手工保存的旧副本却不会因此自动改动。若出现与证书或域名解析相关的错误,应核对服务器域名、设备时间及当前配置的 DNS 设置,不要通过随意关闭安全检查来掩盖原因。复杂字段先查术语表,再向自己的服务商核实资料。
只有 Config 失败,或只有部分目标失败
保留同一个目标,在代理(Proxy)与配置(Config)之间做一次对照。只有 Config 失败时,检查当前文件、规则顺序、策略引用和 DNS;只有个别目标失败时,还要考虑目标自身是否可用、是否要求登录,以及它是否被配置有意拒绝。不要直接认定整个订阅失效,也不要为了让一个目标通过而删除整份规则。
Wi-Fi 与蜂窝网络结果不同时,可在自己允许使用的网络之间做对照,并留意网络访问权限和 On Demand 条件。相同服务器在不同网络下可能遇到不同的解析或连接条件;记录这种差异比反复重装应用更有助于定位。每次切换网络后重新检查连接状态,再进行同一组访问测试。
完成以上检查后,能够稳定连接、实际访问符合预期、Config 的处理路径也能对应规则,即可结束首次设置。后续只在资料或需求变化时调整对应环节。购买、商店地区及换机恢复问题请阅读正版指南;这类问题与服务器连接排查分开处理,不必通过修改规则解决。