官方手册 · 首次配置

Shadowrocket 使用教程

从已有订阅开始,依次完成添加、分流、连接与验证。首次设置先跑通一条连接,再调整规则与自动连接条件。

已有服务器条目可从第 02 步开始;开关已打开但访问异常,可直接查看第 04、05 步。

STEP 01 / IMPORT

添加服务器与订阅导入

打开 Shadowrocket 后先停留在 Home。下方的 SERVER 分组用于列出服务器;刚开始没有条目时,先点 Add Server。进入添加页后,第一项 Type 决定后续需要填写的字段。订阅链接和单台服务器参数属于两种不同的输入,不要把订阅网址直接填进 Host,也不要把某个服务器地址当成订阅链接提交。

已有订阅链接:选择 Subscribe

如果拿到的是订阅网址,进入 Type 选择 Subscribe,再把完整链接填入 URL。链接应从你的服务商处获取,复制时保留问号之后的全部内容;开头或结尾多出的空格、换行也应清理。填写便于辨认的名称后保存,等待客户端请求订阅内容,再返回 Home 检查是否出现对应分组及服务器条目。

订阅是一份可更新的服务器列表,不等于 Config 中的规则文件。列表出现只能说明本次导入得到了条目,不能说明每个条目都能连接。如果保存后分组为空,先确认链接是否完整、是否仍然有效,以及当前网络能否取得内容;不要连续添加多个重复分组来代替排查。订阅链接通常包含访问凭据,向他人说明问题时不要直接展示整条链接。

已有服务器参数:按 Type 逐项填写

手动添加时,先把 Type 改为服务商提供的协议,再填写 Host 和 Port。截图展示的是包含 Password、Method 的添加表单;切换协议后,实际字段会变化。Shadowsocks 需要核对 Method 与 Password;VMess、VLESS 需要核对 UUID 以及传输相关参数;启用 TLS 时还应核对对应的服务器名称等设置。不要只凭端口猜测协议,也不要把没有提供的参数自行补成常见值。

如果拿到的是二维码,可以使用 Scan QR Code;Import from Cloud JSON 则用于对应格式的配置输入,不是任意订阅网址的通用导入按钮。保存之后返回 Home,确认名称、协议和分组符合预期。此时先不急着打开开关,下一步先确认 Global Routing,让后续验证有明确的判断标准。

Shadowrocket Add Server 官方截图,包含 Type、Host、Port、Password、Method 及底部导入入口
Add Server:先选 Type,再按已有信息填写字段。不同协议的字段会有所变化。

STEP 02 / ROUTING

选择 Global Routing

回到 Home,点 Global Routing 查看当前姿态。这里控制的是连接如何选择策略,不负责补全服务器参数。三种姿态写作配置(Config)/代理(Proxy)/直连(Direct)。先弄清当前选择,再进行连接测试,可以避免把规则导致的直连误认为服务器没有工作。

配置(Config):按规则决定去向

日常需要规则分流时选择 Config。随后打开底部 Config,确认要使用的配置文件已选中,而不只是出现在列表里。进入文件后可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次连接只需要关注现有 Rule 与策略是否对应,不必为了完成基础连接同时调整每一个分段,也不需要开启 HTTPS Decryption。

Rule 中的规则通常按从上到下的顺序匹配,先命中的规则决定本次连接的策略。DOMAIN-SUFFIX 可以按域名后缀匹配,IP-CIDR 可以匹配地址范围,FINAL 用于前面规则都没有命中的情况。PROXY 与 DIRECT 分别表达代理和直连去向。使用 Add Rule 前先查看已有规则的位置与策略名称,避免把宽泛规则放到前面,遮住后面的具体规则。

代理(Proxy)与直连(Direct):用于区分路径

Proxy 将由客户端处理的连接交给所选代理路径,适合在排查时减少规则差异带来的干扰;它不会自动修复失效的服务器。Direct 使用直连路径,不应拿它来证明代理服务器可用。如果当前网络本来可以访问某个网站,即使选择 Direct,该网站也可能正常打开。

本次先用已有配置选择 Config,并记住当前姿态。若之后需要临时切换 Proxy 做对照,请在测试完成后恢复原设置。规则的有效性最终要结合实际连接记录判断,不能仅凭 Config 文件存在就认定分流正确。接下来返回 Home,选择默认服务器并建立连接。

Shadowrocket Config 官方截图,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:检查已选文件的 Rule;配置编辑页与 Home 的 Global Routing 选择是两个操作位置。

STEP 03 / CONNECT

选择默认服务器并打开连接

返回 Home,在 SERVER 分组中点选准备使用的服务器。所选条目会有圆点标记,用它确认默认服务器,而不是只看列表中哪个条目排在最上方。点进条目详情与选中条目不是同一件事;检查参数后回到列表,再确认圆点仍对应本次要测试的服务器。

默认服务器确定后,打开 Home 顶部开关。首次启用时,系统会请求允许添加 VPN 配置。核对请求来自 Shadowrocket 后允许,并按系统要求完成设备认证。这个授权用于让客户端接管相应网络流量,不会替你创建服务器,也不会让已经到期的订阅恢复服务。

完成授权后回到 Shadowrocket,查看顶部是否仍停留在 Not Connected。若开关立即回落,先处理系统授权或配置建立失败的问题,不要马上改 DNS。若连接状态已建立,再继续下一步测试。系统中的 VPN 标识仅说明相关连接已启用,不能单独证明远端服务器、DNS 与目标网站都正常。

首次验证期间建议暂不配置复杂的 On Demand 条件,也不要同时启用多个接管网络的 VPN 配置。先让手动连接的结果稳定,再逐项加入自动化条件。如果需要切换到另一台服务器,先记下当前条目和测试结果,切换后重复相同测试,避免在目标网站、网络与服务器都改变的情况下比较结果。

如果系统授权时选择了取消,可返回 Home 再次操作开关,并留意系统提示。若设备受管理策略限制,应该检查设备自身允许的 VPN 设置。基础连接建立后保持当前网络不变,接下来使用 Connectivity Test 和实际访问共同确认结果。

Shadowrocket Home 官方截图,展示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 分组与 Add Server
Home:先确认服务器的圆点标记,再打开顶部开关,最后进行 Connectivity Test。

STEP 04 / VERIFY

用实际请求验证生效

在 Home 点 Connectivity Test,观察客户端是否返回测试结果。测试使用的方式会影响结果含义,因此不同 Test Method 下的数值不能直接比较。测试成功表示相应探测条件下得到了响应,不等于所有网站都可以访问;显示的耗时也不是下载速度,不能把它当作带宽数值。

随后打开浏览器,访问一个已经知道正常、并且能明确判断加载结果的目标。不要同时打开很多页面,也不要只看已经缓存的页面是否还能显示。可以刷新一次目标,确认有新的请求发生,再回到 Shadowrocket 检查状态。若测试成功而单个网站失败,需要继续区分域名解析、规则去向与网站自身响应,而不是直接删除全部配置。

使用 Config 时,还应在 Data 中查看刚才的连接记录。按访问时间找到对应目标,核对域名或地址、命中规则及最终策略;具体信息以当前界面显示为准。如果结果为 DIRECT,先看是否本来就有规则要求直连。如果预期走 PROXY,却被前面的宽泛规则命中,调整规则顺序才是相应的处理方向。

为了验证分流,可以分别访问一个预期直连的目标和一个预期代理的目标,再分别检查记录。只看网页打开与否无法区分两条路径,因为同一目标可能在不同路径下都能访问。记录中存在请求也不代表请求最终成功,还应结合实际页面表现与错误信息判断。

完成一轮后,记住四项信息:本地使用 Wi-Fi 还是蜂窝网络、当前默认服务器、Global Routing 姿态、实际失败的目标。后续每次只改变其中一个条件。需要进一步理解首次测试的观察顺序,可阅读首次连接与 Connectivity Test 说明;如果本轮全部正常,基础上手流程已经完成。

STEP 05 / DIAGNOSE

按层检查常见失败点

出现问题时先保留当前配置,记录错误发生在哪一步。导入失败、开关无法保持开启、测试超时与个别网站异常是不同问题,处理入口也不同。按下面顺序检查,每完成一项就重复同一目标测试,通常比同时改动服务器、DNS 和规则更容易定位原因。

先检查本地网络与输入内容

先断开 Shadowrocket,确认当前网络本身可以完成正常访问;公共 Wi-Fi 如需登录,应先完成登录。如果只有某个网络失败,可以换到自己的另一种网络做一次对照。更换网络后结果恢复,说明还需要检查原网络条件,不宜立刻重写整个 Config。

若订阅无法更新,核对完整链接、有效期和当前网络可达性。订阅更新失败不一定会删除之前已有的条目,也不等于这些条目全部失效。若导入后某台服务器无法使用,回到它的参数页,依次比对 Type、Host、Port、认证信息与 TLS、传输层设置。向服务商确认时说明具体错误,不公开链接或认证信息。

再区分服务器问题与规则问题

如果所有目标都失败,先核对默认服务器是否选对,并换用自己已有的另一条服务器做对照。如果 Proxy 下能访问,恢复 Config 后失败,再检查 Rule 的匹配顺序、所指策略以及 DNS 相关设置。若只有个别域名异常,优先检查该域名的记录,不要因为一个目标失败就推断整个连接中断。

进入 Settings 后,可以核对 Test Method,使前后测试采用相同方式;需要补充错误信息时使用 Diagnostics。诊断记录可能包含域名、地址和配置细节,分享前应移除个人信息。On Demand 会按条件影响连接行为,如果手动断开后又重新连接,或者换网络后状态变化,也要检查是否启用了相关条件。

最后回到最小可验证设置

修改 DNS 前先记录原值,每次只改一个设置,并重新发起请求。测试结束后恢复用于对照的临时改动,避免留下不清楚用途的配置。完整记录应能说明“哪个网络、哪个服务器、哪种姿态、哪个目标、什么现象”。这样才能区分本地网络、服务端参数和规则匹配问题。

商店地区、购买恢复等获取问题可查看App Store 获取全指南;访问慢但能连接时,可继续阅读速度慢的分层检查。需要重新核对整个操作顺序时,从本教程第 01 步重新执行,而不是反复导入相同订阅。

Shadowrocket Settings 官方截图,展示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:排查时关注 Test Method、On Demand 与 Diagnostics,每次只调整一项。

其他设备的获取入口

本页的操作位置以 iPhone / iPad 为例。iPhone / iPad 版在 App Store $2.99 一次性付费;Mac(Apple 芯片与 Intel)/ Windows / 安卓 / Linux 版免费。电脑与安卓安装包通过本站下载页获取,安装包地址由本站 /dl/ 提供。

首次打开遇到系统拦截时,先核对下载来源,再按安装放行说明操作:macOS 查看“隐私与安全性”,Windows 查看 SmartScreen 的“更多信息”,安卓核对“允许安装未知应用”,Linux 按包格式处理安装权限。不要忽略提示后反复下载。

客户端一次性买断 ≠ 线路套餐。订阅链接与服务器信息请从你的服务商处获取。