官方手册 · 操作教程

Shadowrocket 导入订阅与连接教程

以 iPhone / iPad 界面为例,依次完成添加、模式选择、连接与验证。先让一条已有连接正常工作,再检查规则和自动连接条件。

Add Server Global Routing Connectivity Test

导入内容 → 确认去向 → 验证结果

步骤 01

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

先区分手上的内容是单个服务器参数、二维码,还是可以更新的订阅地址,选择其中一种方式操作即可。

已有订阅链接:选择 Subscribe

打开 Shadowrocket 的 Home,在 SERVER 区域找到 Add Server,进入添加页。点开 Type 后选择 Subscribe,再把自己的完整订阅地址粘贴到相应地址栏。保存前从开头到结尾核对一次,特别留意复制时是否带入空格、换行或说明文字。订阅地址可能包含身份凭据,不要改动其中看似随机的字符,也不要把普通网页地址当成订阅链接。

完成后点右上角保存按钮,回到 Home,按订阅项目提供的更新操作读取内容。更新成功后,SERVER 列表应出现从订阅解析出的服务器条目。订阅名称本身只是分组或更新入口,不等于已经选中可用服务器;接下来要在展开后的列表里选中一个具体条目。如果保存后列表为空,先检查地址是否完整、当前网络能否获取订阅,以及订阅本身是否仍然有效,不要立即反复添加同一地址。

已有单个服务器信息:按 Type 填字段

如果手上是服务器地址、端口和认证信息,在 Add Server 中选择相符的 Type。不同协议显示的字段不同,不能因为都有 Host、Port 就互相套用。以 Shadowsocks 类型为例,Host 填服务器地址,Port 填服务端指定端口,Password 和 Method 必须与服务端一致。不要在 Host 里额外加网页路径,也不要把服务器显示名称填进地址栏。其他类型出现的认证与传输字段,同样逐项依据用户已有的信息填写。

保存后回到 Home,检查新条目名称与地址是否符合预期。显示名称可以用于辨认用途,但修改名称不会改变连接参数。遇到服务商同时给出多种协议信息时,应选择一套完整信息填写,不要混用其中一套的端口与另一套的认证字段。若无法确定 Type,先核对原始配置说明,再继续连接,避免用多次试填掩盖真正的字段错误。

已有二维码:使用 Scan QR Code

在 Add Server 页面可使用 Scan QR Code。首次调用相机时按系统提示授予相机权限,扫描后仍需查看解析出的 Type 和服务器字段,再保存。二维码应来自自己的配置资料;它与明文链接一样可能包含凭据。Import from Cloud JSON 是另一种结构化导入入口,不是任意订阅网址都适用的粘贴位置。完成一种导入方式后即可进入下一步,不需要为了同一个服务器再重复扫码和手动录入。

进入下一步前:Home 的 SERVER 中已有具体服务器条目,并且可以辨认准备使用的那一项。

Shadowrocket 添加服务器页面,显示 Type、Host、Port、Password、Method 以及扫码导入入口
Add Server 官方截图。字段随 Type 改变,按自己的服务器信息填写。
步骤 02

Global Routing:选择流量处理姿态

服务器决定可用的代理连接,Global Routing 决定流量怎样处理,两者需要分别确认。

导入完成后回到 Home,点开 Global Routing。初次使用先认清三种常用姿态:配置(Config)/代理(Proxy)/直连(Direct)。不要仅凭某个选项的名称判断连接是否成功;选择模式只是设置处理方式,仍需选中服务器并打开连接开关。排查期间记住原来的模式,临时更改测试后再恢复,避免把测试用的设置当成长期配置。

配置(Config):按所选配置文件执行

Config 会根据当前配置文件中的规则判断请求去向。进入底部 Config 页面,确认所需配置文件已经导入并选中;仅仅把文件保存在列表中,不代表它已经成为当前配置。打开配置文件可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。初次上手只需确认所用文件与规则来源符合自己的用途,不要为了连接成功一次性开启所有高级功能。

Rule 中的规则通常按顺序匹配,更具体的条件与兜底条件的位置会影响结果。PROXY、DIRECT、REJECT 是处理去向,不是三个服务器名称。例如 DOMAIN-SUFFIX,example.com,PROXY 表示匹配对应域名后缀时使用代理策略,而 FINAL,DIRECT 会把前面未匹配的请求交给 DIRECT。这里的域名仅用于说明语法,不需要把它添加到自己的配置中。若使用已有配置,先保持其规则不变,再通过请求记录检查实际命中。

代理(Proxy)与直连(Direct):用于对照检查

Proxy 可用于检查选中服务器的代理连接是否正常,便于把服务器问题与 Config 中的分流问题分开。Direct 则让请求直接连接,适合对照当前网络本身是否可用;选择 Direct 不等于已经验证了代理服务器。三种姿态的结果不应混为一谈:在 Proxy 下能够访问,并不能证明 Config 中的规则顺序正确;在 Direct 下能够打开网页,也不能说明订阅中的服务器可用。

建议先用所需模式完成一次连接验证。如果只有 Config 下出现异常,再核对当前文件、相关规则和实际命中策略,而不是直接删除整个配置。协议字段的含义与选择依据见协议参考;与规则有关的具体疑问可继续查看FAQ,本页保留首次连接需要的操作顺序。

进入下一步前:已知道当前 Global Routing 的选择;使用 Config 时,已确认当前配置文件。

Shadowrocket 配置文件编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config 官方截图。此处查看配置内容;Global Routing 的模式入口位于 Home。
步骤 03

Home:选中服务器并开启连接

先选条目,再开顶部开关,最后检查系统授权与连接状态。

回到 Home,在 SERVER 列表中点选准备使用的服务器,确认选中状态落在具体服务器上,而不是只展开订阅分组。首次测试尽量固定同一服务器,避免一边切换模式一边更换条目,否则后续无法判断是哪一次修改产生了影响。若列表较长,先依据自己保存的名称辨认条目;不要把名称相近视为参数相同。

确认 Global Routing 后,打开 Home 顶部原先显示 Not Connected 附近的连接开关。首次连接时,系统可能提示允许添加 VPN 配置,这是客户端接管设备网络流量所需的系统授权。核对提示确实由当前操作触发后再允许,并按系统要求完成设备验证。若拒绝了授权,服务器条目虽然仍在列表中,连接过程也可能无法继续;应重新操作并检查系统中的 VPN 配置状态。

返回 Shadowrocket 后观察顶部状态是否离开 Not Connected,并确认开关能保持开启。系统 VPN 标识可以作为配置已启用的辅助信息,但不能单独证明目标网站可访问。不要因为刚出现标识就反复关闭再打开,也不要在状态尚未稳定时连续切换服务器。如果开关立即回落、一直无法连接,先保留当前参数,跳到本页失败点排查,区分授权问题与服务器连接问题。

测试时还应检查设备是否已有其他 VPN 连接占用系统通道,必要时先断开其他连接,再返回 Home 重试。若此前启用过 On Demand,手动断开后可能被触发条件重新连接,容易误以为开关没有响应;排查阶段可以先记录原设置并暂时关闭相应自动触发,待手动连接验证完成后恢复。

连接成功后暂时不要调整配置文件。接下来直接进行 Connectivity Test 和实际访问检查,用同一服务器、同一模式形成一组可比较的结果。仅保存条目、选中条目和打开连接是三个不同动作,缺少任何一步,都可能出现“列表里有服务器但没有实际使用”的情况。

进入下一步前:选中服务器、模式选择与连接状态三项均已确认,且没有其他连接干扰本次测试。

Shadowrocket Home 页面,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 与 Add Server
Home 官方截图展示操作入口,图中的 Not Connected 是截图状态,不是连接成功示例。
步骤 04

Connectivity Test:验证连接与规则结果

将“测试有响应”“网页能访问”“策略符合预期”分开检查,避免只看一个结果。

先执行测试,再检查实际请求

在 Home 点 Connectivity Test,等待本次测试完成。测试结果用于观察所选测试方法对应的连通情况,不代表所有应用、所有域名和所有传输方式都正常。若需要比较两次结果,应保持相同的 Test Method 和网络环境;不同测试方法返回的结果含义不同,不宜直接把数值放在一起比较,更不能只依靠一个测试结果判断服务器长期表现。

随后打开浏览器,访问自己需要验证的页面,必要时重新加载。只看到之前打开的页面不能作为可靠证据,因为页面内容可能来自缓存。可分别检查一个预期 DIRECT 的普通请求和一个预期 PROXY 的请求,观察是否符合配置目的。选择的目标应是自己确实需要访问的内容;某个目标暂时不可用时,换另一个目标对照,先排除目标站点自身异常。

在 Data 中对照实际策略

返回客户端,在 Data 中查看可用的请求记录。找到刚才访问的域名,结合记录中显示的规则或策略信息,判断请求去了 PROXY、DIRECT 还是 REJECT。若没有看到预期记录,先确认应用仍在连接、页面确实发起了新请求,以及查看的记录范围是否正确。不同版本展示细节可能不同,应以当前界面可见字段为准,不要把找不到某个字段直接当成网络故障。

如果请求实际走了 DIRECT,而预期是 PROXY,应优先检查 Global Routing 是否仍是 Config,以及当前规则为何命中 DIRECT。反过来,如果请求已经走了 PROXY 却仍无法访问,就应检查所选服务器、相关传输参数或目标可达性,而不是不断追加相同域名规则。能够把问题定位到“未命中预期策略”或“命中后连接失败”,下一步的排查范围就会明显缩小。

记录本次使用的网络、服务器名称、Global Routing 和具体现象即可,不需要公开完整订阅或密码。测试完成后,把临时切换的 Proxy 或 Direct 恢复为日常需要的模式,再做一次实际访问验证。这样既确认了连接,也确认了最终保留的设置,避免测试结束后仍停在与日常用途不符的姿态。

完成标准:连接开关保持开启,实际请求可完成,需要分流的请求命中了预期策略。

步骤 05

Settings:按失败位置逐项排查

每次只改一个变量,复测后再继续。先检查能直接核对的信息,再考虑高级设置。

订阅为空或更新失败

先检查订阅是否粘贴完整、是否填在 Subscribe 对应的地址位置,以及当前网络能否获取这条订阅。服务器已经存在但更新失败,与第一次导入就没有条目是两种情况:前者先保留现有条目和配置,后者重点核对地址与订阅格式。不要为了触发更新反复新增相同订阅,也不要在没有备份时先删除全部内容。必要时向自己的服务商核对订阅状态,但不要把完整地址发到公开讨论中。

连接开关无法保持开启

核对首次 VPN 授权是否完成,再检查设备系统中的 VPN 配置及其他正在运行的连接。若弹出系统提示,应先读清具体内容,而不是连续重复操作。服务器参数错误也可能造成连接失败,此时回到 Add Server 对应条目的编辑页,逐项比对 Type、Host、Port 和认证字段。相似的服务器名称、相同的域名或成功保存的表单,都不能替代参数核对。

已连接,但网页仍无法打开

先测试当前 Wi-Fi 或蜂窝网络本身是否正常,再对照 Proxy 与 Config 的表现。如果 Proxy 正常、Config 异常,检查当前配置文件和规则命中;如果两者都失败,先检查服务器信息及服务器可用性。若只有个别域名失败,可结合 Data 记录检查 DNS 与目标请求,而不是立即修改全部 DNS 设置。需要深入理解协议字段时,转到协议参考按所用 Type 阅读,避免在不相关字段上反复试错。

测试失败,或断开后又自动连接

进入 Settings 查看 Test Method,确认所用测试方法后,再回 Home 重做 Connectivity Test。测试有响应但网页失败时以实际请求继续排查;测试失败但网页可访问时,则应先区分测试目标与方法,而不是直接认定整个连接不可用。若连接在切换网络后自动变化,检查 On Demand 的触发条件与顺序,暂时停用相关条件完成手动对照,再恢复需要的自动连接设置。

Settings 中的 Diagnostics 可用于进一步定位问题,但诊断输出可能包含域名、地址或配置线索,分享前应检查并移除敏感内容。不要同时改动 Proxy、TCP、UDP 等多组设置;先保留原值,确定具体现象后再作对应调整。也不需要为了普通连接验证去启用 HTTPS Decryption 或安装证书,避免把额外变量引入首次上手流程。

当问题仍然存在时,整理“在哪一步失败、使用哪种模式、当前网络类型、测试与实际访问分别怎样”四项信息,再查看FAQ 中的导入、规则与故障排查说明。比起只描述“不能用”,这些信息更有助于区分配置、系统授权、网络与服务器问题,也能避免不必要的重装与重复导入。

Shadowrocket Settings 页面,显示 Language、Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP 设置入口
Settings 官方截图。先核对 Test Method 与 On Demand,再按具体问题查看诊断入口。
Shadowrocket 全平台下载