官方手册 · 首次连接

Shadowrocket 使用教程

本教程以 iPhone / iPad 界面为例。先导入已有的连接信息,再选择流量如何转发,最后用实际访问结果确认设置是否生效。

开始前:确认已安装 Shadowrocket。iPhone / iPad 从 App Store 获取,美区为 $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费,从本站下载页选择安装包。

准备你自己的订阅链接或服务器信息,从你的服务商处获取。本站不提供、销售或推荐节点与订阅。客户端一次性买断 ≠ 线路套餐。

01 Add Server

添加服务器或导入订阅

打开 Shadowrocket,从 Home 找到 SERVER 区域,点 Add Server。先确认手里是哪一种信息:单台服务器通常有协议、主机地址、端口和认证字段;订阅是一条用来获取服务器列表的链接。按实际拿到的材料选一种方式即可,不必先手动建一条服务器再导入订阅。

已有单台服务器信息

在 Add Server 中先选 Type,再按你的服务商给出的信息填写。以 Shadowsocks 为例,Host 对应主机地址,Port 对应端口,Password 和 Method 分别对应密码和加密方式。切换 Type 后字段可能变化,应以所选协议显示的字段为准,不要把另一种协议的参数照搬过来。粘贴地址或认证信息时,检查有没有多带空格、换行或引号;如果缺少必填项,先核对原始资料,不要用猜测值补齐。

已有订阅链接

在 Add Server 把 Type 选为 Subscribe,将完整的订阅链接粘贴到链接字段后保存。链接中的问号及其后的参数也是链接的一部分,不要只复制到域名或路径。回到 Home,看 SERVER 下是否出现订阅导入的记录。若只有分组而没有可选服务器,可在分组中查看更新或错误提示,确认导入结果后再继续。排查截图不要带上完整的订阅链接或认证字段。

无论用哪种方式,下一步都一样:在 SERVER 中点选一条你要使用的服务器,确认选中标记落在该条目上。列表里看得见不等于已经选中,选中也不等于已经连接。选定后先保留当前网络,不急着打开开关,继续核对 Global Routing。

Shadowrocket Add Server 界面,显示 Type、Host、Port、Password 和 Method 字段
Add Server:先选 Type,再根据显示的字段录入。

02 Global Routing

选择流量分流姿态

回到 Home,点 Global Routing。这里控制连接建立之后,进入 Shadowrocket 的请求按什么方式处理;它不负责选择服务器,也不会因为切换姿态就自动修正服务器信息。第一次按已有规则使用时,可先选择配置(Config);如果目的是排查某个请求走哪条路径,再用另外两种姿态短暂对照。

  • 配置(Config):使用当前配置文件的规则决定如何处理请求。某些请求走代理,某些直接访问,也可能按配置被拒绝。连上之后仍有一部分流量直连,并不表示规则没有生效。
  • 代理(Proxy):将进入该模式处理的流量交给所选代理服务器。适合在服务器不变时,与配置姿态对照,判断某个目标是否能通过代理路径访问。
  • 直连(Direct):不通过所选代理服务器转发。这与关闭 Home 顶部开关不同:连接可以保持开启,改变的是请求如何转发。

如果选了 Config,却不确定正在用哪份配置,先去 Config 页面确认当前启用的文件,再打开文件查看 Rule。截图里的 General、Rule、Hosts 等是文件编辑页中的分段,不是 Home 上 Global Routing 的选项。已有明确可用的配置时,第一次连接不必马上改规则;没有把握时,先记下现用文件和姿态,避免配置和服务器同时变化。

例如,规则中的 DOMAIN-SUFFIX,example.com,PROXY 表示把匹配该域名后缀的请求交给 PROXY;这行示例用来读规则,不是要添加的服务器。想了解规则顺序和 FINAL,可查名词解释。选好姿态后,返回 Home 看 Global Routing 显示值是否符合预期,再进入连接步骤。

Shadowrocket Config 配置编辑界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:查看配置文件的 Rule 分段。切换姿态请回到 Home。

03 Home

打开 Home 顶部开关

打开开关之前,在 Home 核对两处:SERVER 下选中的条目是不是刚才准备使用的服务器,Global Routing 是不是刚选的姿态。截图中的 Not Connected 表示连接尚未建立。确认后点顶部开关,等连接状态稳定,不要在状态切换期间反复开关或改选服务器。

第一次建立连接时,系统可能要求允许 Shadowrocket 添加 VPN 配置。确认提示对应的是刚才在 Shadowrocket 内发起的操作,再按系统指引授权;如果系统要求进一步验证,按设备提示完成后回到 Home。若先前取消了提示,连接不会因为已经填好了服务器信息而自动打开。可在 Home 再发起一次;若仍无法完成,先核对系统 VPN 设置和设备的管理限制。

如果连接刚打开就回到未连接状态,先保留当前服务器和姿态,记下当时是否出现提示。检查系统里是否已有其他 VPN 正在工作;在你有权限且不会影响必要网络访问的情况下,再处理冲突。若是工作或学校管理的设备,不要移除管理配置,向管理员确认是否允许添加 VPN。

顶部开关保持开启,只说明设备已经启用了这次连接,不能证明服务器可用,也不能证明某个请求命中了预期规则。此时保留同一 Wi‑Fi 或蜂窝网络,进入下一步测试,结果才容易和之后的对照区分开。

Shadowrocket Home 界面,显示 Not Connected 开关、Global Routing、Connectivity Test 和 SERVER 分组
Home:在同一页核对姿态、服务器选中标记和顶部连接状态。

04 Connectivity Test

验证服务器与实际访问

在 Home 点 Connectivity Test,查看刚选中的服务器对应结果,不要把同一分组内其他条目的结果当作这次连接的结果。记录测试是否返回结果、正在用的网络以及 Global Routing 的当前值。同一台服务器在不同网络下可能表现不同;要做前后对照,应先在同一网络、同一服务器上完成一次,再决定要不要换网络。

接着打开一个你平时能访问的页面,主动刷新或打开一个未加载过的页面。只看到旧标签页还显示内容,不能说明新请求已经成功。如果使用的是 Config,尽量分别检查一个按规则应当直连的目标和一个应当走代理的目标。若当前没有能辨认这两类路径的规则,只记录实际访问是否成功,不凭一次访问结果断定分流正确。

遇到特定目标打不开时,可以保留同一台服务器,临时切到 Proxy 重试同一目标。若 Proxy 下可访问、Config 下失败,优先核对启用的配置、域名匹配情况和未命中时的默认策略;不必立即改动服务器参数。若同一目标在不同姿态下都失败,也不能只凭这一点断定是服务器问题,还要检查本地网络和目标本身是否正常。完成对照后,把 Global Routing 恢复到日常要用的姿态。

Connectivity Test 的结果只对应本次测试,不能保证所有网站或应用都可访问。确认首次设置是否成功,应同时看 Home 连接状态、所选服务器的测试结果,以及目标能否发起并完成新的请求。

05 Settings

按症状排查连接失败

从最早没有通过的步骤查起。先留一条最小记录:网络类型、Home 开关是否能保持开启、是否有选中的条目,以及测试结果。再打开 Settings 查看 Test Method;如果要比较两次测试结果,先保持测试方式一致。需要进一步查看失败发生在哪一阶段时,再进入 Diagnostics,避免在找到原因前同时更改多项设置。

订阅已保存,但没有服务器

回到 Home 查看订阅分组是否已有可选条目。若列表为空,检查 Type 是否为 Subscribe、链接是否完整,以及更新时是否提示获取失败。若服务商提供了替换链接,先确认它与原链接不是同一条过期地址,再用新链接更新。若仍无结果,从你的服务商处确认链接状态和导入方式;在列表出现可选条目前,调整 Global Routing 不会解决导入问题。

开关无法保持开启,或离开 Home 后状态变化

先区分手动打开开关就失败,还是打开后切换网络才发生变化。前者优先检查系统 VPN 授权和冲突;后者可到 Settings 核对 On Demand 是否已启用,以及当前网络是否符合已有条件。若确定需要排除 On Demand 的影响,可记录原设置,再用手动连接做一次对照,测完恢复原有设定。

服务器测试失败,或只有特定目标打不开

测试失败时,先确认不连 Shadowrocket 时设备本身能正常上网,再核对所选服务器的 Type、Host、Port 和认证字段是否与服务商资料一致。若服务器测试有结果而只有特定目标失败,回到验证步骤,用同一目标对照 Config 与 Proxy,并按结果检查规则。每次只改一项,重试同一个测试;否则即使恢复,也无法知道是哪项改动起了作用。

需要请人协助时,提供错误原文、出现在哪一步以及你已经做过的对照即可,不要附完整服务器凭据或订阅链接。常见现象见常见问题;要进一步理解 Test Method、On Demand 或 Diagnostics,可查选项手册。

Shadowrocket Settings 界面,显示 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP 等设置
Settings:先核对 Test Method,再按症状查看 On Demand 或 Diagnostics。