[Quickstart]官方手册

Shadowrocket 快速上手

从已有订阅或服务器信息开始,依次完成导入、Global Routing 选择、连接与验证。先确认一条连接能够使用,再调整规则与其他设置。

[Subscribe]

01 添加服务器或导入订阅

打开 Shadowrocket 后,先回到 Home。这里用于查看和选择服务器条目;Config 则用于管理配置文件,两者用途不同。首次使用时,先把已有的连接信息放进 Home,不必为了出现服务器列表而寻找规则文件。订阅链接也不是普通网站地址,它通常包含访问服务配置所需的凭据,不应发送到公开讨论区。

已有订阅链接:选择 Subscribe

在 Home 点击右上角的加号,进入 Add Server。点击 Type,选择 Subscribe,然后在 URL 一栏粘贴从自己的服务商处获取的完整订阅链接。粘贴前后各检查一次:链接开头与结尾是否完整,是否混入空格、换行或聊天消息中的说明文字。可在备注中写一个便于辨认的名称,随后点击右上角完成按钮保存。

返回 Home 后,等待订阅内容下载。正常获取后,应能在对应分组中看到服务器条目。分组名称只是管理标记,并不表示已经连接;还需要点选其中一个条目。若只有分组名称而没有服务器,先检查订阅更新是否报错,不要通过反复添加同一链接解决。订阅可能需要有效账户或具备访问条件的网络,具体状态应以用户已有服务的账户信息为准。

有些用户拿到的是单个服务器分享信息,而不是订阅链接。两者不能仅凭地址长短判断;应先确认提供方标明的用途。把单条服务器信息填入 Subscribe,或者把订阅地址当成服务器主机名,都会造成导入错误。暂时无法分辨时,先查看术语表中的订阅与配置说明,不要尝试把未知链接逐项填入所有输入框。

已有服务器参数:在 Add Server 手动填写

如果拿到的是一组服务器参数,在 Add Server 的 Type 中选取与原始资料一致的协议,再填写服务器地址、端口和认证信息。Shadowsocks、VMess、VLESS、Trojan 等协议所需字段不同,不能把某种协议的密码或身份字段直接套到另一种协议。TLS、SNI、传输方式与路径也应逐项照原始资料核对,不根据服务器名称推测。

保存后回到 Home,确认条目出现在列表中,并点选准备使用的服务器。此时先不急着打开连接:下一步需要明确 Global Routing,让后续测试的结果能够对应到一个确定的流量处理模式。若订阅中有多个条目,首次只选一个进行验证,避免同时改变服务器与分流方式,导致失败原因难以区分。

[Rule]

02 选择 Global Routing

在 Home 点击 Global Routing,查看当前选中的模式。这里的三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。它们决定请求如何交给策略处理,不负责补齐服务器参数,也不能修复已失效的认证信息。切换前先记住原来的选项,便于测试结束后恢复。

配置(Config)按当前启用的配置文件匹配规则。打开 Config 后,应核对实际选中的文件,而不只是看文件是否存在。文件中的规则通常按先后顺序匹配,请求命中哪一条,就按该条指定的策略处理。某个域名能够直连,并不能据此认定代理服务器已经可用,因为该请求可能根本没有走代理。

代理(Proxy)可用于初步隔离规则因素,让适用流量按代理模式处理。首次验证时,可以先选择 Proxy,再回到 Home 确认已选中服务器。这里的用途是建立一个易于观察的测试条件,不是要求长期固定使用此模式;系统流量范围、应用自身行为与网络条件仍会影响结果。

直连(Direct)用于直接访问,不适合拿来验证代理服务器是否正常。如果打开连接后访问表现与未连接时一致,应先检查是否停在 Direct,而不是马上重填密码。Direct 也可作为对照条件,帮助判断一个原本能够直接访问的网站,在其他模式下是否出现了额外问题。

当 Proxy 下的实际访问已确认正常,再进入 Config 选择用户已有且理解其来源的配置文件,返回 Global Routing 切换至 Config。不要把网上未知规则整份覆盖到当前配置,也不要仅为“让所有测试通过”而随意调整 DNS。规则顺序、DNS 与 On Demand 的详细关系放在Settings 设置项参考中;本页只完成基本连接闭环。

[Connect]

03 打开连接并完成授权

回到 Home,再看一次选中标记是否位于准备测试的服务器上,并确认 Global Routing 与上一步一致。随后打开顶部连接开关。首次建立连接时,iPhone / iPad 可能显示添加 VPN 配置的系统提示;确认这是刚刚从 Shadowrocket 发起的操作,再按系统提示允许,并完成设备要求的身份验证。

系统授权的作用是允许客户端建立相应网络连接,不是购买服务,也不会自动生成服务器账户。如果选择取消,先返回 Home 查看开关状态;需要连接时再重新发起。若设备由组织管理,相关配置可能受管理策略限制,此时应由设备管理方核对权限,而不是反复删除系统设置。

完成授权后回到 Home,观察开关是否保持开启,以及客户端是否显示已连接状态。系统状态栏或控制中心也可能提供 VPN 状态提示,但不同设备的显示位置并不完全相同。不要只依赖某一处小图标:连接保持、实际访问与请求记录应结合判断。已建立 VPN 通道,只说明系统连接环节完成,并不等同于远端服务一定可用。

若开关刚打开就关闭,或者系统立即弹出错误,先保留错误文本,再检查是否已有其他 VPN 连接正在使用、系统权限是否完成,以及当前配置是否存在明显错误。首次排查期间暂不启用 On Demand 等自动连接条件,以免手动关闭后又自动重连,影响对当前状态的判断。修改完一个项目后再重新连接,不要连续快速开关。

日后更换服务器、网络或关键参数时,可先关闭连接,完成修改后再打开,并重新做一次下一步的验证。退出到桌面不等于断开连接;不再需要时应回到 Home 主动关闭,并确认状态已经变化。这样也能避免把上一次连接的结果误当成当前参数的测试结果。

[Test]

04 验证连接是否生效

在 Home 使用 Connectivity Test 获取初步反馈。它适合帮助发现当前服务器是否存在明显连通问题,但测试采用的目标与方式不一定等同于日常使用的应用。出现测试结果,不代表所有网站都能访问;测试失败,也应结合具体错误与实际访问继续判断,不能只凭一次反馈就删除整份配置。

接着打开浏览器,访问一个自己有权访问、且能够明确判断是否加载完成的网站。测试时主动刷新页面,避免仅看到上一次保留的内容。若需要登录、提交表单或使用实时功能,应分别验证这些操作,因为页面主体加载成功,并不说明它引用的全部域名都使用了正确策略。

使用 Config 时,还要核对预期的分流结果。以某个本应走 PROXY 的测试域名为例,先在配置中找到对应规则,再结合可用的连接或日志信息查看实际处理情况。若命中了 DIRECT,应检查是否有更靠前的规则先匹配,而不是把问题归到服务器。规则关键字的含义可到术语表查看,具体设置再参考设置参考。

如果 Proxy 下能访问,Config 下却失败,说明应优先检查当前配置的规则、策略引用和 DNS 设置;如果两种模式都失败,应先回到服务器参数、服务状态与当前网络。只有某一个应用失败时,还需区分该应用自身的登录状态、缓存或服务故障。一次只更改一个条件,才能让前后两次测试具有比较意义。

最后分别在实际需要使用的 Wi-Fi 与蜂窝网络下复测。切换网络后等系统稳定,再确认连接状态与选中服务器,不要把切网瞬间的短暂失败当作持续故障。完成这一步后,保留已验证可用的服务器和模式,基础上手流程就结束了;后续增加自动连接、修改规则或替换配置,都以这组可用条件作为回退依据。

[Troubleshoot]

05 按失败位置逐项排查

排查从“最后一个成功的步骤”开始,而不是从重新安装开始。先记下当前网络、导入方式、协议、选中服务器、Global Routing 和错误文本,再确定失败发生在下载订阅、建立连接还是实际访问阶段。这样既能减少重复操作,也能在需要向自己的服务提供方询问时给出明确现象。

订阅未出现服务器,或更新失败

先检查 URL 是否完整、订阅是否仍有效,以及当前网络能否访问订阅所在地址。服务器条目已经存在,不代表下一次订阅更新必然成功;订阅下载与服务器连接是不同环节。保留原有分组,确认链接及服务状态后再更新,不要反复删除重建。若只能获取到一段网页说明而不是可识别的配置内容,应向原提供方确认链接用途。

Connectivity Test 失败

确认选中的是准备测试的服务器,而不是只展开了某个分组。手动填写时重点核对协议、地址、端口与认证参数;启用 TLS 的连接还应核对 SNI 等原始要求。不要通过随意开启 Allow Insecure 来掩盖参数问题,也不要为了让测试显示成功而更换未知测试目标。若已有订阅中的其他条目可用,可在相同网络与模式下换一个已有条目复测。

开关不能保持,或已连接但访问失败

开关不能保持时,优先看系统授权、其他 VPN 状态与明确报错。开关保持但访问失败时,则先确认不是 Direct,并使用 Proxy 做一次对照。若 Proxy 仍失败,核对服务器状态与参数;若 Proxy 成功而 Config 失败,回到当前启用的 Config 文件排查。不要同时更改 DNS、协议、规则和测试站点,否则无法确定是哪一项造成变化。

只有部分网站或切换网络后失败

部分网站异常通常需要检查具体域名的规则命中、DNS 结果及目标服务状态;先确认其他网站是否正常,再缩小范围。切换 Wi-Fi 与蜂窝网络后异常,则先等待网络稳定并重新连接,然后使用相同目标复测。需要更完整的现象分类时,继续阅读常见问题,不在基础上手阶段批量替换高级设置。

完成排查后,重新按“选中服务器 → 确认 Global Routing → 打开连接 → 实际访问”的顺序复测。确认恢复后再逐项加回原有设置。需要备份或长期维护配置时,转到设置参考继续阅读,不必在第一次连接过程中完成所有功能的配置。