官方手册 / 初次设置

Shadowrocket 快速上手

从添加服务器到验证分流。按顺序操作,每一步确认结果后再继续。

步骤 01 / 准备服务器

添加服务器或导入订阅

打开 Shadowrocket,进入底部的 Home。先看清手头的资料是哪一类:一条订阅链接通常用来获取一组服务器;单台服务器的资料则会分别给出协议、地址、端口和认证参数。两种方式任选一种,不用先手动添加,再用订阅重复导入同一组条目。

手动添加:先选 Type,再填字段

在 Home 点右上角的加号,进入 Add Server。先在 Type 选择资料中明确标注的协议,因为协议不同,接下来显示的字段也不同。以 Shadowsocks 为例,在 Host 填服务器域名或 IP 地址,在 Port 填端口;再填 Password,在 Method 选择服务商指定的方法。地址和端口分开填,不把网址前缀、路径或端口一并粘进 Host。复制参数后,检查首尾是否多了空格或换行。

确认各字段与原始资料一致后保存,返回 Home 查看 SERVER 下是否出现该条目。如果只拿到了地址和端口,却不清楚 Type 或认证参数,先向你的服务商核对;不要用其他协议的示例值补齐缺项。右侧截图中的 Scan QR Code 和 Import from Cloud JSON 是其他导入入口,手动填写时不必经过它们。

用订阅导入:保存后检查 SERVER

如果拿到的是订阅链接,从 Home 点加号,在 Add Server 的 Type 中选择 Subscribe,把完整链接粘贴到 URL 字段后保存。保留链接原有的路径和查询参数,不要改用服务商的登录页地址。返回 Home,等订阅加载,再在 SERVER 下找到对应分组并查看其中是否有条目。订阅链接可能包含访问凭据,不要连同截图或日志公开发送。

看到可以选中的服务器,就可以继续设置 Global Routing。只看到分组名、里面却没有服务器时,先处理导入问题;反复切换连接开关不会让空分组自动补齐。

Shadowrocket 的 Add Server 页面,显示 Type、Host、Port、Password、Method 字段及底部两个导入入口
Add Server:先确认 Type,再按协议核对字段。

步骤 02 / 指定流量处理方式

选择 Global Routing 模式

在 Home 点 Global Routing。这里决定客户端接管连接后怎样处理流量,不负责添加服务器,也不会替换 SERVER 中选中的条目。若希望访问不同目标时分别走代理或直连,日常使用应选配置(Config),并确认所用配置文件符合预期。

  • 配置(Config):按当前配置文件中的规则选择策略。两个目标可以分别走代理和直连,不要求所有请求走同一路径。
  • 代理(Proxy):让客户端处理的流量走代理。初次排查时可短暂切到此模式,确认所选服务器能否处理测试目标,再切回原模式。
  • 直连(Direct):让客户端处理的流量直接连接,不经所选代理服务器。适合做对照,但不等于关闭 Home 的连接开关。

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

Global Routing 中的 Config 是一种模式,底部的 Config 则是管理配置文件的页面。选了配置模式以后,再去底部 Config 核对当前启用的文件。编辑页可看到 General、Rule 和 Hosts 等分段;初次连接只需确认自己查看的是当前文件,进入 Rule 了解要测试的目标应走哪种策略,不必点 Add Rule 临时改规则。

尽量不要在初次验证时一边改规则、一边换服务器。两处同时变动,即使目标恢复访问,也难以判断是哪项调整起了作用。模式选定后回到 Home,确认 Global Routing 显示刚选择的值,再打开连接。

Shadowrocket 的 Config 配置文件编辑页,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段及 Add Rule
Config:截图是配置文件编辑页;模式仍在 Home 的 Global Routing 中选择。

步骤 03 / 建立连接

打开 Home 的连接开关

回到 Home,在 SERVER 下点选刚添加的服务器。如果导入的是订阅,先进入对应分组,再选其中一个具体条目。列表里有服务器不代表已经选中打算测试的那一条;操作前记一下条目名称,后面测出异常时,才能回到同一个条目复测。

点 Home 顶部 Not Connected 旁的开关。首次连接时,系统可能请求允许 Shadowrocket 添加 VPN 配置。确认请求是在刚才点开关后、由 Shadowrocket 发起,再允许;如果系统要求验证设备身份,按系统提示在设备上完成。这一步是让系统允许客户端建立连接,不需要在系统弹窗里填写订阅链接或服务器密码。

验证完成后回到 Home,等状态更新。看到顶部从 Not Connected 变为 Connected,再检查 Global Routing 是否仍是第二步选定的模式。若已经有其他 VPN 在工作,先在对应应用中断开它,再回到 Shadowrocket 试一次,避免把另一个连接的状态误认为本次结果。不要为了测试随意删除设备上已有的 VPN 配置。

如果先前点了不允许,回到 Home 重新打开开关,看看系统是否再次提示。如果开关点开后立即回落,不必连续点击:记下有没有弹窗、是否已允许,以及回落发生在选中服务器前还是之后,按第五步查找原因。即使看到 Connected,也只能确认客户端已建立连接;服务器是否可用、特定目标是否按预期分流,要到下一步分别验证。

Shadowrocket 的 Home 页面,顶部为 Not Connected 开关,中部有 Global Routing 和 Connectivity Test,下方有 SERVER 分组与 Add Server
Home:先在 SERVER 选中条目,再操作顶部连接开关。

步骤 04 / 检查实际访问

用 Connectivity Test 与实际请求交叉验证

保持和第三步相同的网络、服务器及 Global Routing 模式。在 Home 点 Connectivity Test,等本次结果返回,再看它对应的条目是不是刚才选中的服务器。出现结果说明该条目在当前测试方法下有响应,不代表每个网站都能正常访问;反过来,单次超时也不一定说明连接已断开,测试目标本身也可能没有响应。

按当前模式选择测试目标

如果选择的是配置(Config),用浏览器分别打开两个你熟悉的目标:一个按当前规则应走代理,另一个应直连。对照时以规则实际匹配的域名为准;一个页面可能还向其他域名请求内容,因此页面能打开,不等于它的所有请求都走同一策略。可以重新载入页面,避免把已缓存的内容当成新连接的结果。若只想确认代理能不能访问某个目标,可保持同一服务器,短暂切到代理(Proxy)重试,再恢复配置(Config)。

如果选择的是直连(Direct),当前结果只用于确认目标在直连条件下是否可达,不作为代理成功的依据。测试结束后回到 Home,核对开关和模式是否符合日常使用需求。若 Connectivity Test 有响应、实际目标也能访问,但还不能确定规则匹配到了哪一项,请查看使用手册中的规则与连接验证章节,不必为此重建订阅。

步骤 05 / 定位失败环节

按现象排查常见连接问题

SERVER 没有条目:先查导入

订阅分组为空时,先核对粘贴的链接是否完整、Type 是否选了 Subscribe,再确认设备当前能够联网。如果链接能确认是最新的,但刷新后仍无条目,向你的服务商确认链接是否有效以及返回的内容是否适用于客户端。手动添加后找不到条目,则回到 Add Server 检查必填字段是否完整、是否完成保存。只有看到具体服务器后,才需要检查连接模式。

开关回落或自动重连:区分权限与按需行为

如果没能完成系统的 VPN 配置确认,先从 Home 重新发起一次连接。若 VPN 权限已允许,但手动断开后又自动连接,进入 Settings 检查 On Demand 是否启用。需要做一次纯手动对照时,可先记下原设置,再临时停用 On Demand,回到 Home 重试;排查结束后按需要恢复原设置。

已连接但测试失败:先分清失败范围

先确认普通网络访问是否正常,再核对 Home 选中的服务器与当前模式。若只有 Connectivity Test 超时,而实际访问正常,在 Settings 查看 Test Method,避免把不同测试方法得到的结果直接比较。若测试和实际访问都失败,可在条件允许时选另一个你已有的服务器,以同一模式和目标复测。每次只改一项,观察是某个条目失败,还是换条目后仍出现同一现象。

若仅一个目标不通,且同一服务器在代理(Proxy)下可以访问、切回配置(Config)后却不行,优先核对当前配置文件和 Rule 的匹配顺序。问题持续时,可到 Settings 中查看 Diagnostics,对照刚记录的复现时间和现象。更细的权限、导入和路由排查见疑难解答。

Shadowrocket 的 Settings 页面,列出 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:根据现象查看 Test Method、On Demand 或 Diagnostics。