官方手册 首次使用 / 5 个步骤

Shadowrocket 使用说明导入、连接与验证。

以 iPhone / iPad 界面为例,从已有资料开始操作。先确认服务器可以连接,再检查规则是否按预期处理请求;遇到问题时,按相同顺序回查。

§ 01ADD SERVER / SUBSCRIBE

添加服务器或导入订阅。先让资料出现在列表中。

打开 Shadowrocket,进入 Home。先判断手中的资料类型:一条用于获取服务器列表的完整链接,通常应按订阅导入;分别列出的服务器地址、端口、协议与认证参数,则适合手动填写。两种方式选择一种即可,不必把同一份资料重复添加。导入成功只代表应用读到了资料,还没有证明服务器可用。

已有订阅链接:在 Add Server 选择 Subscribe

在 Home 点击 Add Server,进入后打开 Type,选择 Subscribe。将自己的完整订阅链接粘贴到 URL 字段,确认开头与结尾没有空格、引号或换行,再填写一个便于辨认的名称并保存。链接可能带有较长的查询参数,不要为了缩短显示而删掉问号后面的内容,也不要把服务商的网页登录地址当作订阅地址。

保存后返回 Home,等待订阅内容载入,查看 SERVER 区域是否出现相应分组及服务器条目。若只看到分组名称、里面没有可选内容,先检查订阅地址和当前网络,不要立即反复新增同一链接。已有分组需要刷新时,应在该分组上执行更新操作;更新失败先保留原条目,以免把仍可对照的信息一并删除。

已有服务器参数:按 Type 对应字段填写

如果资料是单台服务器的参数,仍从 Add Server 进入,但 Type 应选择资料指定的协议。以 Shadowsocks 为例,对照填写 Host、Port、Password 与 Method。Host 是服务器地址,通常不需要添加网页地址的路径;Port 应与资料完全一致,Method 也应照原值选择,不能按名称相似程度猜测。

不同 Type 展示的认证字段并不相同。资料要求的标识、TLS、传输方式或其他选项,应逐项核对;不能把某个协议的密码直接填到另一种协议的字段中。已有二维码时可使用 Scan QR Code,导入后仍需复查 Type 与地址。Import from Cloud JSON 只用于匹配其格式的资料,不是普通订阅链接的通用粘贴入口。

保存后回到 Home,点选准备使用的服务器,确认选中标记已移动到该条目。至此只完成“资料已添加、目标已选中”,下一步还要确定请求采用哪一种处理姿态。订阅管理与重复条目的详细处理可查看常见问题,首次连接前不必同时整理全部分组。

Shadowrocket Add Server 页面,包含 Type、Host、Port、Password、Method 与二维码导入入口
Add Server:字段随 Type 变化,以自己的服务器资料为准。
§ 02GLOBAL ROUTING / CONFIG

选择 Global Routing 姿态。区分服务器与规则。

服务器决定“代理连接交给哪个目标”,Global Routing 决定“请求按什么方式处理”。两者不是同一项设置。在 Home 点击 Global Routing,查看当前选中的配置(Config)、代理(Proxy)、直连(Direct)。如果出现“开关已打开,但某些请求仍然直接连接”的情况,应先检查这里,而不是立即重新导入订阅。

配置(Config):按当前配置中的规则处理

日常希望按规则分流时,选择配置(Config)。再切换到底部的 Config 页面,确认已有并选中了准备使用的配置文件。这里的 Config 页面与 Global Routing 中名为 Config 的姿态有联系,但职责不同:前者用于管理配置,后者表示连接时采用规则处理。只切换姿态,并不会自动把某份远程规则导入应用。

进入配置编辑页后,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次使用先确认 Rule 的内容,不必为了建立连接同时修改每个分段。Add Rule 用于添加规则;改动前应保留原配置副本,并记下原来的规则顺序。对来源不明、用途不清楚的附加设置,先暂停修改,避免把连接问题和配置问题叠在一起。

规则按顺序匹配,前面的规则已经命中时,后面的规则通常不再决定同一请求的结果。下面两行只是说明规则结构:第一行让局域网地址采用 DIRECT,第二行是最终匹配项。这不是服务器配置,也不是建议直接覆盖现有文件的完整配置。其中 PROXY 应结合实际配置中的策略含义理解。

IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

代理(Proxy)与直连(Direct):用于明确路径和对照

代理(Proxy) 让通常可接管的请求采用代理路径,可临时用于判断问题是否与规则选择有关,但不应将其理解为所有应用、所有系统流量都必然经过服务器。直连(Direct) 则用于直接连接的对照;如果停留在 Direct,即使连接开关打开,也不能据此认定请求正在使用所选服务器。

首次排查时,可以先用 Proxy 对照服务器连接,再切回 Config 检查日常规则表现。每次切换都记住当前姿态,不要一边替换服务器、一边改规则、一边切网络。规则关键字与配置管理的延伸问题见常见问题;商店获取与账号问题另见App Store 指南。

Shadowrocket Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:先确认当前配置,再检查 Rule,修改前保留副本。
§ 03HOME / VPN

打开连接开关。完成系统授权后再观察状态。

回到 Home,先检查 SERVER 中选中的服务器,再看 Global Routing 是否为刚才确定的姿态。截图中的 Not Connected 表示当时尚未建立连接,是用于辨认开关位置的初始状态,不代表你的设备必须显示完全相同的列表内容。

打开 Home 顶部的连接开关。首次操作时,系统可能请求允许添加 VPN 配置;阅读提示,确认请求由 Shadowrocket 发起,再按照系统要求完成设备验证。这个步骤是在设备上授权建立网络连接配置,并不是要求把服务器密码填写到系统账号验证框中。完成授权后返回应用,等待连接状态变化,不要在提示尚未处理完时连续点击开关。

如果刚刚拒绝了授权,先回到应用再次尝试连接,并检查系统是否给出新的提示。仍不能建立时,查看设备是否受到组织管理策略限制,以及是否有其他正在运行的 VPN 连接。不要随意删除不认识的系统配置;受管理设备应先确认使用权限,再按管理要求处理。

开关保持开启、应用状态发生变化后,才进入下一步验证。状态变化说明本地连接流程有所进展,不能单独证明远端服务器认证成功、目标网站可以访问或规则完全符合预期。反过来,若开关立即弹回关闭,也不必重新购买或重新安装,应先记录系统提示并检查授权与配置。

第一次连接期间,建议保持当前 Wi-Fi 或蜂窝网络不变,也暂不启用新的 On Demand 条件。先完成一次手动连接和断开,确认基本流程正常,再考虑自动触发连接。这样出现异常时,能区分是手动连接本身失败,还是自动连接条件造成了重复切换。

Shadowrocket Home 页面,顶部为 Not Connected 开关,下方有 Global Routing、Connectivity Test、SERVER 与 Add Server
Home:依次确认服务器、Global Routing 与顶部连接状态。
§ 04CONNECTIVITY TEST / VERIFY

验证连接是否生效。把测试结果与实际访问分开看。

验证的第一步不是比较数字,而是确认基础网络。必要时先断开 Shadowrocket,打开一个平时能够直接访问的页面,确认 Wi-Fi 或蜂窝网络本身正常。如果网络还在等待网页登录、信号中断或系统限制了应用联网,服务器测试也可能一起失败,此时应先恢复基础连接。

回到 Home,使用 Connectivity Test 检查候选服务器。测试过程依据当前 Test Method 执行,因此结果反映的是特定测试条件下的可达情况。出现一个响应数值,不等于目标网页、视频或其他业务已经可用;出现超时,也不宜只凭一次测试就断定服务器资料永久失效。先确认测试方法,再用相同条件做一次复测。

随后保持连接开启,打开实际需要使用的页面,观察能否完成一次新的加载。仅看到浏览器里原来已经打开的内容不够,因为它可能来自缓存。可以重新载入页面,或打开同一服务中的另一个页面;如果只有某一个应用异常,应将问题范围收窄到该应用、目标地址或相关规则,而不是直接判定整个连接失效。

接着对照 Global Routing。处于 Config 时,目标可能命中 DIRECT、PROXY 或其他已定义策略;能够打开页面,不一定代表使用了代理。若需要比较路径,可保持服务器与网络不变,临时切换 Proxy 再测试相同目标,然后恢复 Config。若 Proxy 正常而 Config 异常,应优先查规则与配置;若两者都失败,再回查服务器参数、认证和基础网络。

验证通过后,保留这组已经确认可用的设置。后续再调整规则或 On Demand 时,若出现新问题,就可以回到这组基准条件对照。更细的订阅更新、连接超时与规则问题,可按现象进入常见问题继续查找,不必在首次连接时一次性修改所有设置。

§ 05SETTINGS / DIAGNOSTICS

常见失败点排查。从资料到网络逐项回查。

导入后列表为空,或服务器突然减少

先核对导入的是完整订阅链接,而不是介绍页或账户页面。再确认当前网络能取得订阅响应,以及自己的服务状态是否允许获取内容。订阅更新可能改变服务器数量和名称,这与客户端连接开关是两件事。保留已有分组,向自己的服务商核对链接有效性后再更新,不要通过反复创建分组来尝试修复同一个地址。

能够看到服务器,但连接持续失败

打开该条目的编辑页,逐项核对 Type、Host、Port 和认证字段,注意复制时带入的空格、大小写和被遗漏的附加参数。再回 Home 确认真正选中的是刚检查的条目,而不是另一组中的同名服务器。若问题只在一种网络发生,可在允许的条件下更换 Wi-Fi 或蜂窝网络对照,但不要同时更改配置,以免失去判断依据。

测试有响应,实际页面仍打不开

进入 Settings,查看 Test Method,弄清刚才进行的测试。测试响应不等于完整协议握手、DNS 解析和目标服务访问都正常。先测试另一个明确目标,判断是单站异常还是普遍失败;再回查 Config 中的规则和当前 Global Routing。若临时使用 Proxy 可恢复,而 Config 不行,优先检查规则顺序与最终匹配项,不要直接修改所有 DNS 或 TLS 设置。

连接反复变化,或只在切换网络后异常

检查是否启用了 On Demand,以及设备上是否存在其他会影响 VPN 连接的设置。为了排除自动触发条件,可以在记下原值后暂时停用 On Demand,回到手动连接流程复测。网络从 Wi-Fi 切到蜂窝后出现的中断,应与切换前的状态分别记录;一次重连恢复,不能直接证明原规则有误。

需要进一步观察时,使用 Diagnostics

Settings 中的 Diagnostics 可用于进一步排查。先保留错误发生时的时间、目标与状态,再查看相关诊断信息;不必为了“全面排查”同时改动 Proxy、TCP、UDP 等多个设置。向外描述问题时,只提供必要的错误文本与操作顺序,遮住订阅 URL、密码、认证标识等敏感内容。诊断信息也应先检查再分享。

如果完成上述检查仍不能连接,整理为一条可复现的过程:使用哪类网络、选择哪个 Type、在哪一步失败、系统或应用给出什么提示,以及 Direct、Proxy、Config 对照结果。服务器认证或订阅内容的问题,应向自己的服务商核对;应用获取与恢复问题可看App Store 指南,其他操作问题可进入常见问题。这些信息比“无法使用”更便于定位。

Shadowrocket Settings 页面,包含 Language、Test Method、On Demand、Diagnostics、Proxy、TCP 与 UDP 设置
Settings:先查看 Test Method 与 Diagnostics,调整前记录原值。
下载 Shadowrocket