官方手册 / 首次连接

Shadowrocket 订阅导入
与首次连接教程

从已有配置开始,依次完成添加、选择 Global Routing、连接与验证。先确认每一步的结果,再进入下一步,避免同时改动多个设置。

01 / IMPORT

Add Server:添加服务器或导入订阅

打开 Shadowrocket,先停留在 Home。下方 SERVER 用于显示可选的服务器;尚未添加资料时,没有可用条目属于正常情况。先判断手中的资料是哪一种:一组 Host、Port 和认证参数属于单条服务器信息;用于获取一组服务器的完整地址属于订阅链接。这两种资料的导入方式不同,不要把整个订阅地址填入 Host。

已有订阅链接:选择 Subscribe

在 Home 点 Add Server,进入添加页面后点 Type,选择 Subscribe。把自己的完整订阅链接填入 URL 对应输入框;如有备注字段,可写一个便于识别来源的名称。粘贴后检查开头、末尾是否带空格或换行,尤其不要漏掉问号之后的参数。参数可能用于识别订阅权限,缺失后即使地址看起来相近,也可能返回错误或空内容。

保存后返回 Home,等待订阅内容获取完成,再查看 SERVER 是否出现条目。若只出现订阅名称而没有服务器,先按第五步检查获取结果,不要立刻反复添加同一地址。之后更新订阅应针对已有订阅执行更新;重复导入可能产生多个相似分组,使后续选中哪一条变得难以判断。

已有单条参数:按 Type 填写

再次打开 Add Server 时,Type 应与服务商提供的协议一致。以 Shadowsocks 为例,对照填写 Host、Port、Password 和 Method;Host 通常只填域名或 IP 地址,Port 单独填写。不要把说明文字、网页路径或整段分享内容直接放入 Host。其他协议出现的字段可能不同,应以该 Type 实际显示的字段和原始资料为准,不能照抄截图里的字段组合。

如果手中是适配的二维码,可在添加页面使用 Scan QR Code 读取,再检查识别后的 Type 与地址是否正确。Import from Cloud JSON 用于相应的 JSON 导入,不是任意订阅链接的通用入口。保存成功后回到 Home,确认新条目能够被选中。此时只完成了“资料已进入客户端”,还没有证明服务器可用;下一步先确定流量如何处理。

订阅链接、二维码及认证字段都可能包含访问权限。截图求助前应遮住完整地址和认证内容;不必为了排错公开整份配置。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method 和导入入口
Add Server:先选 Type,再按已有资料填写;截图用于辨认字段,不作为连接参数。

02 / ROUTING

Global Routing:选择配置、代理或直连

服务器已出现在 Home 后,点 Global Routing,查看当前的处理方式。这里决定流量采用哪种路径,不负责补全服务器资料,也不会自动修正认证错误。三种姿态分别写作配置(Config)、代理(Proxy)、直连(Direct)。初次操作先弄清当前选项,再开始连接,才能解释后面的测试结果。

配置(Config):按当前配置逐条匹配

配置(Config)根据当前启用的配置决定请求使用 DIRECT、代理策略或其他处理方式。打开 Config 可以查看配置文件;进入文件后,General、Rule、Hosts 等分段分别管理不同设置。截图中的 Add Rule 是添加规则的入口,不是添加服务器的入口。第一次使用时,先确认启用的是哪一份文件,已有配置则先保存副本,不建议一边测试服务器一边改写整套规则。

例如 DOMAIN-SUFFIX,example.com,DIRECT 表示匹配该域名及其子域名后使用 DIRECT。规则通常依次检查,前面的匹配结果会影响后续处理;FINAL 用于此前规则均未匹配时的最终策略。若配置使用了策略名称,还需确认对应策略能够找到有效目标。规则文件存在,并不意味着其中引用的策略一定已经正确关联。

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

代理(Proxy)将可代理流量交给所选代理,适合短暂检查“这条服务器路径能否完成请求”。它不意味着设备上每一种流量都一定经过代理,具体仍受应用能力与系统网络行为影响。直连(Direct)则使用直接连接;即使连接开关处于开启状态,Direct 也不能用来证明所选服务器正在承载请求。

建议先记录当前姿态。若已有配置来源和用途明确,可保持 Config;若需要隔离规则影响,可临时切到 Proxy 做对照,测试结束后再恢复 Config。不要把 Proxy 当成修复所有问题的办法。关于协议字段及技术取舍,可继续阅读协议详解;本页先把连接流程走完。

Shadowrocket Config 官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:配置文件中的 Rule 与 Home 的 Global Routing 有关,但两者不是同一个设置入口。

03 / CONNECTION

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

返回 Home,在 SERVER 分组中点选准备使用的服务器,确认该条目出现选中标记。订阅名称只是组织条目的方式;看见一个分组,不等于已经选好实际服务器。若列表较长,先记下当前条目的备注,后面更换服务器时才有明确的对照对象。然后再次核对 Global Routing 显示的姿态是否符合第二步的选择。

点 Home 顶部的连接开关。首次使用时,系统会询问是否允许添加 VPN 配置,这是建立系统网络连接所需的授权。确认来自当前操作后允许,并按设备提示使用密码或系统认证完成操作。若中途取消,先返回应用查看状态;不要因为列表已经有服务器,就认为系统授权也已完成。

授权后回到 Home,观察顶部是否从 Not Connected 转为连接状态。如果仍是 Not Connected,或开关很快回到关闭状态,应先检查系统授权和应用提示,而不是直接修改 Rule。若设备同时启用了其他 VPN 连接或受到设备管理策略限制,系统可能无法按预期建立当前连接;应先确认设备允许使用该 VPN 配置,再重试。

连接状态建立后,先不要马上切换多个条目,也不要同时开启 On Demand。保持一个服务器、一种姿态和同一网络,进入下一步验证。顶部状态主要说明系统连接已建立,并不单独证明远端认证、目标服务与每条规则都正常;把“连接开关打开”和“请求成功”分开判断,能减少很多不必要的反复操作。

Shadowrocket Home 官方截图,顶部显示 Not Connected、Global Routing 和 Connectivity Test,下方为 SERVER 与 Add Server
Home:按 SERVER → Global Routing → 顶部开关的顺序核对。截图中的 Not Connected 为界面示例状态。

04 / VERIFICATION

Connectivity Test:分别验证连通性与规则

连接开启后,在 Home 点 Connectivity Test,等待测试结束。它适合检查当前条件下的连通情况,但测试目标和你实际使用的服务不一定相同。一次成功不能代表所有网站和应用都可访问;一次失败也应结合测试方式、当前网络和目标服务状态判断,不要只凭一个结果删除订阅。

先验证目标请求能否完成

打开浏览器或需要使用的应用,访问一个你有权使用、且明确知道预期行为的目标服务。尽量使用新请求,而不是只看已经缓存的页面。若测试成功但目标仍失败,记录是域名无法解析、连接超时,还是服务已经返回了登录或权限提示。这些现象发生在不同阶段,服务返回业务提示往往不能简单归为代理连接失败。

再验证请求走了哪一条路径

需要确认 Config 是否生效时,查看应用可用的请求记录,围绕同一个目标核对域名、命中规则和最终策略。使用 DIRECT 的请求不应仅因页面打开就被认为经过了服务器;反过来,代理策略命中也不保证远端目标一定接受请求。若记录中没有预期域名,先重新发起请求,确认是否命中了缓存,或应用是否使用了其他域名。

结果不明确时,可以保持服务器与网络不变,仅把 Config 临时改为 Proxy,再访问同一目标。若 Proxy 可用而 Config 不可用,优先检查规则顺序、策略引用与 DNS 相关设置;若两者都不可用,则先回查服务器参数、远端状态和网络条件。对照完成后恢复原姿态,保留失败现象与更改记录,进入下一步逐项排查。

05 / DIAGNOSTICS

Settings:按失败阶段检查设置

排错从最早失败的一步开始。若第一步尚未获取到服务器,就不必先研究规则;若已经连接但某个目标异常,则应围绕该目标观察请求。Settings 中的 Test Method、On Demand 与 Diagnostics 分别涉及测试方式、按需连接和诊断,不应把它们一起切换成一组“通用修复设置”。修改前记下原值,测试后能够恢复。

导入失败:先核对资料类型与完整性

确认订阅是放入 Subscribe 的对应输入框,而不是 Host。检查链接是否完整、是否带额外空格,以及自己的订阅权限是否仍有效。能在浏览器打开某个网页,不代表该地址就是客户端可读取的订阅内容;如果返回登录页面或错误说明,应从自己的服务商处重新核对资料。不要在反复尝试过程中清空已有且仍可工作的条目。

连接失败:分开检查参数与系统授权

若开关不能保持开启,先回看系统 VPN 配置是否添加成功、是否被其他连接占用。若开关能开启但请求失败,再逐项核对 Type、Host、Port 和认证字段。二维码导入也需要核对,尤其是资料已经变更而二维码仍是旧内容的情况。设备日期与时间异常也可能影响安全连接,应保持系统时间准确。认证被拒绝或远端不可用,需要由你自己的服务商确认服务器状态。

测试与实际使用不同:检查 Test Method

在 Settings 查看 Test Method,了解当前测试使用的方法。不同测试方式观察的层面不同,某项测试失败不必然代表实际业务请求失败;同样,能测得一个结果也不能证明目标服务可用。回到第四步,用同一目标发起实际请求并对照记录。若怀疑当前网络限制了某种传输,可以在有权限的另一网络下重试,但保持服务器和姿态不变。

状态反复变化:检查 On Demand 与诊断记录

On Demand 用于根据条件触发连接。初次排错时先记录其状态,必要时暂时关闭自动触发,再手动进行一次完整的连接与断开测试,避免自动行为干扰观察。随后可在 Diagnostics 中查看可用信息;提供问题描述时保留错误文字、触发步骤和网络类型,遮住订阅地址、认证字段及不必要的请求详情。

完成后应能回答三个问题:资料是否成功导入、系统连接是否建立、目标请求实际走了什么策略。若其中一项还不确定,就返回对应步骤重做验证,而不是继续叠加设置。需要重新走一遍时,可回到添加与导入步骤;涉及协议字段含义与选型时,再查阅协议详解。

Shadowrocket Settings 官方截图,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:根据失败现象检查相关设置,先记录原值,再做单项对照。