官方手册 · iPhone / iPad 操作示例

Shadowrocket 使用教程
订阅导入、连接与验证

按五个步骤完成首次设置:先把已有资料放入 Home,再选择请求路径,最后用测试与实际访问确认结果。首次操作可按约十分钟预留时间;若遇到失败,直接跳到对应检查项。

STEP 01 / IMPORT

Add Server:添加服务器或导入订阅

打开 Shadowrocket 后进入 Home,先辨认下方的 SERVER 区域。这里显示可供选择的服务器条目;列表里出现名称,只代表资料已经保存,不代表服务器当前可用。准备好自己的服务资料后,再进入 Add Server。首次导入建议只选择一种方式,完成并确认结果后再添加其他资料,以免同名条目混在一起,难以判断正在测试哪一个。

有订阅链接:选择 Subscribe

  1. 在 Home 点击添加入口打开 Add Server,进入 Type 选择 Subscribe。订阅应使用服务商提供的完整链接,而不是其网站首页、登录页或账户管理页面。
  2. 把链接粘贴到对应的 URL 输入项,检查首尾是否混入空格、换行或聊天文字。链接中的参数属于地址的一部分,不要为了缩短显示而删除。
  3. 填写便于辨认的备注并保存,等待订阅读取完成,再回到 Home 检查 SERVER 列表。若未生成条目,先检查读取失败的提示,不要立刻连续导入多次。

订阅是批量读取服务器资料的入口。后续更新可能调整名称、地址或条目数量,手动改动订阅生成的内容也可能在更新时被覆盖。因此,第一次应先确认订阅能够正常读取,再考虑整理分组。订阅链接往往包含访问凭据,不要把完整链接放到公开截图、留言或共享文档中;向他人说明错误时,应遮盖认证部分。

有单个服务器信息:按 Type 逐项填写

再次进入 Add Server,Type 必须与已有服务资料一致。以截图中的表单为例,Host 填服务器主机名或 IP 地址,Port 填服务端口,Password 与 Method 按原资料填写;Host 不应混入完整网页路径。选择其他协议后,字段会随 Type 变化,不能把某一协议的填写方式直接套用到另一协议。涉及 TLS、传输方式或额外认证字段时,应逐项对照服务端资料,不凭名称推测取值。

如果已有资料是二维码,可使用 Scan QR Code;Import from Cloud JSON 则用于相应的 JSON 资料,并非任意订阅地址的替代入口。不要为了让某个链接通过导入而反复更换不匹配的 Type。保存后回到 Home,选择本次添加的条目,记录其备注,下一步将为这个选中条目确定请求路径。

还不清楚订阅、服务器与配置文件的区别,可先查阅术语手册。本步的完成标准是:Home 中能找到预期条目,而且其协议与连接参数有明确来源。

Shadowrocket Add Server 页面,包含 Type、Host、Port、Password、Method 与底部导入入口
Add Server:先核对 Type,再填写对应字段。截图中的字段集合不代表所有协议。

STEP 02 / ROUTING

Global Routing:选择配置、代理或直连

已有服务器条目后,回到 Home 打开 Global Routing。这里决定请求按什么策略处理,不负责补全服务器资料,也不会自动把无法连接的服务器变为可用。三种姿态应区分为配置(Config) / 代理(Proxy) / 直连(Direct)。选择前先明确目的:是验证已有服务器能否工作,还是按自己的规则进行日常分流。

  • 配置(Config):按当前配置中的规则决定请求去向。同一次连接中,不同域名可能分别使用 PROXY、DIRECT 或 REJECT 等策略,结果取决于具体规则及其顺序。
  • 代理(Proxy):主要请求路径使用代理策略,适合在排查时减少规则分流带来的变量,但仍需结合实际配置与系统流量范围理解结果。
  • 直连(Direct):主要请求路径直接连接目标,不适合用来证明选中的代理服务器已经生效。开关开启与请求使用代理是两个不同判断。

使用配置(Config)前,先确认当前文件

进入底部 Config,查看当前使用的配置文件;需要检查内容时再进入编辑页面。官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同配置分段,首次上手重点关注当前文件与 Rule,不必同时修改所有分段。先备份已有文件,再查看是否有与目标域名相关的规则。Add Rule 用于添加规则,不是添加服务器的入口。

下面的片段只用于说明规则顺序,不是完整配置,也不包含任何服务器资料。DOMAIN-SUFFIX 匹配指定域名及其子域名,FINAL 接住前面未命中的请求。若把最终规则放在前面,后续规则可能没有机会参与匹配。示例中只有匹配 example.com 的请求使用 PROXY,其余落入 DIRECT,不能据此推断所有访问都应经过代理。

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

完成检查后返回 Home,再确认 Global Routing 显示的是刚才选择的姿态。首次测试时不要一边切换姿态、一边更换服务器和整份配置,否则即使结果变化,也难以知道是哪一项起了作用。规则关键字含义见术语手册;DNS、规则引用与更多设置请继续阅读Settings 设置参考。

Shadowrocket Config 配置文件编辑页面,显示 General、Rule、Hosts 等分段和 Add Rule
Config:这里检查配置内容。Global Routing 的姿态选择仍在 Home 中操作。

STEP 03 / CONNECT

Home:打开顶部开关并完成系统授权

回到 Home,先看 SERVER 中当前选中的条目,再看 Global Routing。两项都与预期一致后,才打开顶部连接开关。截图中的 Not Connected 表示尚未连接,是操作前的状态参考;不要把截图文字当作操作完成后应该保持的结果。如果之前已经连接,修改关键参数后应按需要先断开,再重新建立连接,以便观察新的设置。

  1. 点击 Home 顶部开关。首次使用时,系统可能请求添加 VPN 配置,核对提示属于 Shadowrocket 后继续,并按设备要求完成密码或生物识别确认。
  2. 授权结束后返回 Shadowrocket,观察开关是否保持开启、连接状态是否发生变化。如果授权被取消,应重新发起连接,不要跳过系统授权直接修改服务器密码。
  3. 若开关立刻回到关闭状态,先记下提示文字,再检查系统授权、当前配置与参数。若开关保持开启但网页无法访问,继续下一步验证,不把两类失败混为一谈。

系统 VPN 标识说明设备建立了相应的网络配置状态,并不单独证明远端服务器、域名解析和目标服务全部正常。类似地,Home 的连接状态与 SERVER 条目是否可用也不是同一件事。需要把“配置已启用”“服务器能响应”“实际请求走对路径”分开确认,才能避免只看到开关开启就结束检查。

测试期间暂时不要启用复杂的 On Demand 条件,也不要让其他 VPN 配置同时接管网络。如果关闭后又自动连接,应先到 Settings 检查 On Demand 的条件,而不是反复与顶部开关互相切换。初次设置的目标是完成一次可重复的手动连接;确认基本路径可用后,再添加自动连接行为。

到这里,先保留同一个服务器、同一种姿态与同一份 Config,进入下一步进行验证。这样一旦出现问题,后续测试结果才具有可比较性。

Shadowrocket Home 页面,顶部显示 Not Connected 开关,下方为 Global Routing、Connectivity Test 与 SERVER 区域
Home:依次核对选中条目、Global Routing 和顶部开关,再运行 Connectivity Test。

STEP 04 / VERIFY

Connectivity Test:测试后再验证实际访问

保持连接,点击 Home 中的 Connectivity Test,等待测试完成。测试结果可以帮助判断当前测试方法下的连接情况,但它测试的目标与实际要访问的服务未必相同。不要仅按列表里的某个数值判断全部业务是否正常,也不要把一次超时直接等同于订阅失效。首先确认本次测试的是刚才选中的条目,并注意网络是否在测试期间从 Wi-Fi 切换到了蜂窝网络。

接着打开浏览器或目标应用,发起一次新的请求。优先选用自己知道正常、且确实需要检查的服务页面;若只打开一个之前已经加载的页面,缓存可能使结果失去参考价值。可以重新载入页面,或进入该服务中尚未访问的内容。实际访问成功后,还应确认当前 Global Routing:直连(Direct)下可以打开的页面,不能用来证明代理路径已经生效。

观察到的结果 下一项检查
测试失败,实际访问也失败 检查设备网络、服务器参数与服务状态,先排除基础连接问题。
测试成功,只有部分服务失败 核对目标域名的规则、DNS 与目标服务自身状态。
测试失败,实际访问正常 检查 Settings 中的 Test Method,区分测试条件与业务请求。
连接开启,但请求路径不符合预期 核对 Global Routing、当前 Config 与具体规则匹配结果。

如果使用配置(Config),应结合可用日志检查目标请求匹配的规则与策略。一个页面可能调用多个域名,主页面打开并不代表所有附属请求都走同一路径。排查时只跟踪一个具体失败请求,记录目标主机名、所用网络和当前姿态,再回看对应规则。需要调整规则时先备份,修改后重新发起请求,不依赖旧连接的结果。

本步完成标准不是某个固定测试数值,而是:连接能保持,自己需要的服务能正常请求,而且规则去向与预期一致。若测试与实际结果有矛盾,保留这些观察并进入最后一步,不要直接重装客户端。

STEP 05 / DIAGNOSE

Settings:按失败阶段逐项检查

先判断失败发生在导入、连接还是实际请求阶段,再进入 Settings 检查相关项。截图中的 Test Method、On Demand、Diagnostics、Proxy、TCP 与 UDP 属于不同设置范围,不应为了排错全部改动。每次只改变一项,重新连接并重复同一个测试;如果没有改善,就恢复原值。保留当前 Config 和原始服务资料,比盲目清空设置更有利于定位问题。

订阅读取失败,或导入后列表为空

回到 Add Server 检查 Type 是否为 Subscribe,链接是否完整,有没有误用网页地址。确认设备在当前网络下能访问订阅地址;订阅读取本身也需要网络,不能因为尚未建立代理连接就默认一定能更新。若提示认证或权限错误,应向自己已有的服务商确认资料状态。不要反复导入同一链接来代替检查,也不要公开完整订阅地址。此前已有可用条目时,先保留它们,避免删除后失去对照。

条目已保存,但连接或测试失败

逐项核对 Host、Port、认证字段与 Type,特别留意复制时产生的空格和协议不匹配。若资料包含 TLS、传输路径或其他扩展参数,需要与服务端一致。再确认设备本身能正常联网,并在条件允许时换一种网络重复相同测试。只有更换网络后结果才变化,说明应继续检查网络条件;如果所有网络都失败,则优先回到服务器资料与服务状态,而不是先改规则。

测试结果异常,或只有部分请求失败

在 Settings 查看 Test Method,先理解所用测试方法,再比较 Connectivity Test 与实际访问。某些测试条件下的超时不等于全部协议都不可用。只有特定域名异常时,检查 Config 中规则的先后顺序、是否命中 REJECT,以及 DNS 是否能获得有效结果。TCP 与 UDP 的差异也需要结合具体业务判断,不建议在尚未确定失败请求类型时随意切换相关设置。

关闭后自动连接,或需要收集诊断信息

检查 On Demand 是否存在满足当前网络条件的规则,先暂停自动触发因素,再手动验证顶部开关。需要进一步分析时,可进入 Diagnostics 查看可用诊断信息;分享前遮盖服务器地址中的私人信息、订阅认证参数与其他凭据。描述问题时写清失败发生在哪一步、所用网络、当前 Global Routing 及已做过的单项测试,比只提供一张开关截图更有帮助。

如果排查涉及 DNS、Proxy 端口或 On Demand 的具体选项,请转到Settings 设置参考继续阅读;协议字段或规则关键字可查术语手册。确认可用后保存当前配置备份,之后再整理订阅与自动连接条件,避免把首次连通和进阶调整混在同一轮操作中。

Shadowrocket Settings 页面,显示 Test Method、On Demand、Diagnostics、Proxy、TCP 与 UDP 等设置项
Settings:按失败现象选择相关设置。先记下原值,再做单项修改和复测。