OFFICIAL MANUAL / GETTING STARTED

Shadowrocket 导入、连接与验证

从 Home 开始,先导入已有信息,再选择 Global Routing,最后用实际请求确认连接结果。

iPhone / iPad Add Server / Subscribe 连接与排错

以下按 iPhone / iPad 的操作顺序说明。界面布局可能随设备和应用更新调整,字段以当前应用显示为准;示例截图用于辨认页面,不代表需要逐项照抄其中的值。

STEP 01 / IMPORT

Add Server 与 Subscribe:导入已有信息

导入的目标是让 Home 出现可选择的服务器记录;记录出现并不代表已经建立连接。

打开 Shadowrocket 后进入 Home,先观察下方的 SERVER 分组。首次使用时,从 Add Server 进入添加页面;已经有记录时,也可以从此处继续添加。进入后先判断手头资料属于哪一种:一条用于获取服务器列表的订阅链接,还是一组明确的地址、端口和认证参数。两种资料对应不同入口,不应把整条订阅链接填入 Host。

已有订阅链接:选择 Subscribe

点击 Add Server 中的 Type,选择 Subscribe,再返回填写订阅地址的页面。将从自己的服务商处取得的完整链接粘贴到 URL 字段,确认没有多余空格、换行或被聊天软件截断的部分。若有备注字段,可用便于识别的名称区分用途;备注只是本地标识,不会替代链接中的认证信息。

保存后返回 Home,等待列表获取完成,再展开对应分组查看服务器记录。若只出现订阅名称而没有服务器条目,应先检查更新结果,而不是反复打开连接开关。后续更新时,对该订阅使用应用提供的更新操作,更新结束再检查记录是否仍然存在。地址失效、服务到期或返回内容格式不符,需要根据原服务资料核对,重新购买应用不能修复这些问题。

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

手动添加时,先在 Type 选择与已有资料完全一致的协议,再填写 Host 和 Port。Host 是服务器地址,不附加网页路径;Port 是服务端指定的端口,不根据协议名称猜测。以 Shadowsocks 为例,还需要逐字核对 Password 和 Method;其他 Type 可能显示不同的认证、TLS 或传输字段,应按对应资料填写,不将一种协议的字段套用到另一种协议。

页面底部的 Scan QR Code 可读取已有二维码,Import from Cloud JSON 用于导入相应格式的信息。扫码后仍需检查 Type、Host、Port 及认证字段,不把“成功识别二维码”等同于“参数一定有效”。若系统请求相机权限,按是否使用扫码功能决定;选择手动输入并不需要相机权限。

保存前再核对一次输入,返回 Home 后确认记录名称及分组。建议先选一条信息完整的记录完成后续步骤,避免同时导入多组资料后无法判断正在使用哪一条。此时先不修改 Settings 中的高级参数,下一步只处理 Global Routing 与配置文件的关系。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method 及底部导入入口
Add Server:先确定 Type,再填写该协议需要的参数;底部为 Scan QR Code 与 Import from Cloud JSON。

STEP 02 / ROUTING

Global Routing:配置、代理与直连

Global Routing 决定请求采用哪种路由方式;服务器记录负责连接参数,Config 负责规则与相关设置。

返回 Home,点击 Global Routing 查看当前姿态。界面中的三种选择在本教程中写作配置(Config)、代理(Proxy)、直连(Direct)。先读当前选择,再进行修改,不假设首次打开时一定处于某一种模式。推荐的日常选择是 Config,但前提是已经确认当前配置适合自己的使用需求。

配置(Config)按当前生效文件中的规则决定请求路径。若有可用配置,进入 Config,确认实际选中的文件,再打开编辑页面查看 General、Rule 等分段。Rule 中的规则通常从上到下匹配,先命中的规则决定策略;FINAL 用于处理前面未命中的请求。只查看文件内容并不等于已经切换生效文件,返回列表后还要确认选择状态。

代理(Proxy)用于让请求采用代理路径,可在初次验证时做短暂对照,帮助区分服务器连接问题与分流规则问题。它不是自动修复选项:Host、认证信息或服务状态不正确时,切换 Proxy 仍然可能失败。直连(Direct)用于直连路径,可作为基础网络对照;选择它之后,不能用目标请求的直连结果证明代理服务器已生效。

如果已有配置,保持其余设置不变,先在 Config 下完成连接;若只有服务器资料,尚未确认当前配置,可暂用 Proxy 做一次明确的连接测试,测试结束后再整理 Config。不要为了完成首次连接而同时启用 URL Rewrite 或 HTTPS Decryption,这些分段不是普通连接的前置要求,且有各自的适用条件。

下面片段只用于辨认规则的结构,不要求在首次上手时粘贴。第一行匹配指定域名后缀,第二行提供最终策略;示例中的域名不是测试服务,也不包含连接资料。

DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

规则编辑、DNS 与策略的细节见Settings 与配置选项手册。本教程只要求记住当前模式、当前配置与所选服务器,三者记录清楚后再进入连接步骤,后续排错才能复现相同条件。

Shadowrocket Config 官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:在 Rule 查看匹配条目;配置文件编辑页与 Home 的 Global Routing 选择不是同一个操作位置。

STEP 03 / CONNECTION

Home:选择服务器并打开连接

连接开关用于启停系统网络扩展;首次系统授权与服务器认证是两个不同环节。

回到 Home,在 SERVER 分组中点选要使用的服务器,确认选择标记落在预期记录上。若分组中包含多条记录,不以排列顺序推断哪一条正在使用。随后再次确认 Global Routing 的显示值与上一步一致,再打开页面顶部 Not Connected 附近的连接开关。

首次连接时,系统可能弹出添加 VPN 配置的提示。这是系统允许应用创建网络连接配置的授权流程,不是要求再次购买应用,也不是订阅更新提示。阅读提示中的应用名称,确认是当前操作触发后,按系统要求完成确认;设备可能要求密码或系统认证。授权后返回 Shadowrocket,观察顶部状态是否改变。

如果选择了取消,应用不能按该流程完成连接,应在准备好后重新触发开关并完成系统授权。若设备由组织管理,配置限制也可能影响授权,此时应按设备管理要求处理,不反复修改服务器密码。系统授权完成,只说明网络扩展具备运行条件,尚不能证明远端服务器已正确响应。

状态改变后,先停留片刻并观察是否立即断开,再进行下一步验证。连接开关保持打开、系统出现 VPN 标识与目标服务能正常访问,是不同层次的结果;其中任一项都不能单独代替完整验证。若开关立即回落,先记录提示内容与当前模式,不连续快速开关,以免混淆诊断记录。

首次手动连接建议暂不额外配置 On Demand。它用于按条件触发连接,并不是“首次连接必开”的设置。如果之前已经设置过自动连接条件,应先记下其状态,避免手动关闭后又被自动触发,误以为开关失效。连接稳定并完成验证之后,再单独配置自动化行为。

Shadowrocket Home 官方截图,显示 Not Connected 连接开关、Global Routing、Connectivity Test 与 SERVER 分组
Home:顶部查看连接状态,中部确认 Global Routing 与 Connectivity Test,下方选择 SERVER 中的服务器。

STEP 04 / VERIFICATION

Connectivity Test:核对实际请求

验证需要把测试结果、实际访问和规则路径放在一起看,不能只比较一个耗时数字。

先测试连接,再访问目标

在 Home 点击 Connectivity Test,等待当前测试结束,记录是成功响应、超时还是其他提示。该结果与测试方式、测试目标及当前网络条件有关;一次测试成功不代表所有域名和所有协议都能访问,某项测试失败也需要结合实际请求判断。

随后打开自己有权使用的目标服务,执行一次明确操作,例如重新载入一个页面。避免只看已经缓存的内容;必要时刷新页面或重新打开目标应用。先只测试一项,记录发生时间及错误提示,便于在连接记录中寻找对应请求。

再确认请求走向

在 Config 姿态下,某些请求命中 DIRECT 是正常分流结果,不代表连接没有建立。查看应用提供的 Log 或连接记录,结合域名、命中规则与策略判断;日志入口及显示字段以当前应用为准。若请求采用了与预期不同的策略,应回到当前 Config 检查,而不是先更换服务器。

需要对照时,只修改 Global Routing 这一项,在 Proxy 下对同一目标复测,然后恢复原模式。若 Proxy 可用而 Config 不符合预期,优先检查规则和解析;若两者都失败,再检查服务器和基础网络。每次对照保持相同目标和网络,结论才有参考价值。

订阅列表中显示的测试耗时主要用于当前测试条件下的比较,不是实际下载速率,也不是稳定性的承诺。首次完成连接后,建议记下可用的服务器、Global Routing 和配置文件名称。以后修改设置时,用这组已验证条件作为恢复点,可以缩小问题范围。

STEP 05 / DIAGNOSTICS

Settings:常见失败点的排查顺序

排错先分层定位,再修改设置;每次只改一项,复测后决定保留还是恢复。

先看基础网络与导入结果

基础网络是所有连接的前提。先关闭连接开关,在当前 Wi-Fi 或蜂窝网络下访问原本能够直连的服务;若同样失败,应先处理网络接入。公共 Wi-Fi 可能要求先完成网络登录,未完成时订阅更新和服务器连接都可能受影响。切换网络做对照时,记录切换前后的结果,不将不同网络中的测试数字直接比较。

如果 SERVER 中没有可选记录,问题仍在导入层。重新检查 Subscribe 地址是否完整、更新是否报错,以及原服务资料是否仍有效。若列表存在但单条记录失败,打开该记录检查 Type、Host、Port 和认证参数;有 TLS 或传输设置时,还要核对对应字段。设备日期与时间明显不正确时,也应先纠正,再复测涉及证书的连接。

再看模式、规则与 DNS

连接状态保持但目标不可用时,先确认没有停留在 Direct。若 Proxy 与 Config 的结果不同,检查当前生效文件及 Rule 的顺序,尤其是过早匹配的规则和末尾 FINAL。不要只编辑一个未启用的文件,再用另一个文件的结果判断修改是否有效。

DNS 负责域名解析,解析失败与服务器握手失败不是同一件事。只有在错误提示或记录指向解析环节时,再查看当前配置中的 DNS 设置。不要将网上看到的地址整批覆盖进配置,也不要同时更改 DNS、规则和服务器。先保留原值,修改一项后对同一目标复测;相关字段和推荐取值见选项手册中的 DNS 与诊断说明。

最后检查测试方式与自动连接

进入 Settings,查看 Test Method 与 Diagnostics。Test Method 会影响测试结果的含义,不能把不同方法得出的耗时当成同一种指标。Diagnostics 用于进一步定位问题,具体入口和可用工具以当前应用显示为准。保留诊断时,重点记录发生时间、当前网络、所选模式和报错文本,不必公开整份配置。

手动关闭后再次连接,或网络变化后行为与预期不同,应检查 On Demand 的触发条件。它可以根据条件发起连接,排错时要区分自动触发与手动开关。Proxy、TCP、UDP 等分段也不是首次使用时必须调整的项目;没有明确问题依据时,保留当前值,默认值以当前应用显示为准。

需要向自己的服务商核对服务器状态时,只提供必要的错误信息,并遮盖密码、订阅地址、认证标识及二维码。若已经得到一组能够稳定复现的失败条件,可继续阅读服务器超时与连接失败排查顺序;若要调整设置含义与取值,则转到Settings 设置项参考,不在首次上手阶段一次性修改所有选项。

Shadowrocket Settings 官方截图,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:按问题查看 Test Method、On Demand 与 Diagnostics;其他高级参数不作为首次连接的必改项。

CHECKPOINT / NEXT REFERENCE

上手完成检查

已有记录可选、模式与配置明确、连接状态保持、实际请求符合预期,才构成一次完整的上手验证。

后续只需围绕实际需求逐项调整。规则匹配与 FINAL、DNS、On Demand、Log 等内容集中在选项手册中;购买、重新安装与已购恢复则查看获取应用页面。