官方手册 入门操作 / iPhone 与 iPad 界面

Shadowrocket 使用教程订阅导入、规则与连接验证

按“添加 → 选模式 → 连接 → 验证 → 排错”的顺序操作。先确认一条已有服务器能够连接,再调整规则;一次只改一个设置,方便判断结果。

STEP 01 / ADD SERVER

添加服务器或导入已有订阅

先打开 Shadowrocket 的 Home,找到 SERVER 列表与 Add Server。已有订阅链接与单台服务器参数是两种不同的输入材料:订阅链接用来获取并更新一组服务器;手动添加则需要逐项填写一台服务器的信息。先判断手中的材料属于哪一种,只需选择对应路径,不必把两种方式都操作一遍。

已有订阅:使用 Subscribe

进入 Add Server,打开 Type 并选择 Subscribe,在 URL 中粘贴你已有的订阅地址。粘贴后检查开头、结尾以及换行,避免把聊天消息里的说明文字、引号或末尾标点一起带入。订阅地址可能包含访问凭据,不要把完整地址放进公开截图,也不要发给不相关的人。

保存后返回 Home,等待订阅获取完成,再检查 SERVER 中是否出现相应分组及服务器条目。订阅名称出现并不等于内容已经获取成功;应展开分组,确认里面确实有可选的服务器。若没有条目,先检查更新提示,而不是立刻打开连接开关。订阅导入失败与服务器连接失败属于不同环节,需要分别处理。

以后更新订阅,应使用已有订阅条目的更新操作,而不是反复新建同一地址。重复导入容易留下同名分组,使实际选择的服务器与正在检查的订阅不一致。更新前记下当前选中的服务器,更新后重新确认该条目仍然存在;条目名称和参数可能随订阅内容变化。

已有单台服务器:按 Type 填写参数

如果拿到的是 Host、Port 与认证信息,在 Add Server 选择对应的 Type。Shadowsocks、VMess、VLESS、Trojan 等协议的字段不同,不能只填写地址和端口就视为完成。以原始服务器信息为准填写;示例截图中的 Password、Method 只是所示类型的字段,不代表每一种协议都使用相同表单。

核对 Host 是否多出空格,Port 是否完整,以及 Password、加密方式或其他认证字段是否与原信息一致。若提供的信息包含 TLS、传输方式或服务器名称,也需要在对应选项中填写;不确定的参数应向原信息提供方确认,不要靠更换协议类型来猜测。

已有二维码时,可使用 Scan QR Code;只有材料明确为相应格式时才使用 Import from Cloud JSON。扫码后仍应检查识别结果,尤其是 Type、Host 与 Port。保存并回到 Home 后,先确认 SERVER 中出现条目,再继续下一步选择 Global Routing。更多导入格式问题见问答,订阅更新错误见订阅失败诊断。

Shadowrocket Add Server 页,显示 Type、Host、Port、Password、Method 及扫码和云端 JSON 导入入口
Add Server:先确定 Type,再填写该类型需要的字段。截图展示的字段不能套用到所有协议。

STEP 02 / GLOBAL ROUTING

选择 Global Routing 与当前配置

服务器添加完成后,回到 Home,点击 Global Routing。这里决定连接怎样被分配,不是用于更换订阅地址。先分清三种姿态:配置(Config)、代理(Proxy)、直连(Direct)。如果希望不同请求按已有规则处理,使用 Config;如果为了定位问题临时改变模式,测试结束后应恢复原来的选择。

配置(Config):依照当前规则处理

Config 会使用当前配置中的规则,为请求选择 DIRECT、PROXY 或其他已定义策略。进入底部 Config 页,确认正在使用哪份配置,再查看其中的 Rule。订阅通常负责服务器列表,配置文件负责规则等设置;导入订阅后,不应直接推断对应的规则配置也已自动选中。

官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑分段。初次上手先确认当前配置与 Rule,不需要把所有分段都改一遍,也不需要为了建立连接启用 HTTPS Decryption。已有可用配置时,修改前先保留副本,避免排错过程中失去原本能工作的设置。

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

Proxy 将连接交给当前代理策略处理,但不能修复不可用的服务器。Direct 用于直接连接,不经过所选代理服务器;切到 Direct 后某个页面能打开,只说明该页面的直连路径可用,不能证明代理已经配置正确。两种姿态适合做对照,不应把它们当作所有问题的固定解决办法。

规则通常按顺序匹配。下面只用于认识语法:第一行按域名后缀匹配,第二行按 IP 地理归属匹配,最后一行负责兜底。它不是需要整段导入的完整配置,实际策略名称必须在你的配置中有效。不要为了照抄示例直接覆盖现有 Rule,也不要把服务器地址写成示例域名。

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

在配置与策略确认后,返回 Home,再核对一次 Global Routing 显示的选择。此时先保持规则不变,继续连接测试;如果之后出现“Proxy 可用、Config 不可用”,再依据实际请求命中的规则排查。规则语法与策略的深入问题可查看问答和问题诊断。

Shadowrocket Config 配置文件编辑页,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:查看当前文件的规则分段。Global Routing 的模式选择入口在 Home,不在这张配置编辑页中。

STEP 03 / HOME

选择服务器并打开连接开关

回到 Home,在 SERVER 中找到刚才导入或手动添加的服务器,并点选准备使用的条目。分组标题与组内服务器不是同一层级,展开分组后确认实际选中的服务器。若配置使用策略组,还要确认负责该请求的策略没有指向另一台服务器,避免把“列表中点选过”误当成全部请求都会使用它。

打开顶部 Not Connected 旁的开关。首次连接时,系统会请求添加 VPN 配置,阅读提示并允许,按系统要求完成设备认证,然后返回 Shadowrocket。VPN 配置权限用于建立系统网络连接;允许权限不是导入服务器的替代步骤,也不意味着服务器地址、密码已经通过验证。

返回后观察顶部连接状态是否发生变化,以及开关是否保持开启。若系统提示尚未完成,应先完成提示,不要在弹窗存在时反复点击。如果拒绝过权限,可再次发起连接并按提示操作;仍无法添加时,检查系统是否有设备管理限制,或是否存在其他正在建立的 VPN 连接。

开关能保持开启,只说明本地连接已建立到相应阶段,不代表每个目标都能访问。先不要同时更换 DNS、规则和服务器,保持当前设置进入下一步验证。需要断开时,关闭 Home 顶部开关;如果断开后又自动连接,先记下现象,稍后检查 Settings 中的 On Demand。

Shadowrocket Home 页,顶部为 Not Connected 开关、Global Routing 和 Connectivity Test,下方为 SERVER 与 Add Server
Home:依次确认所选服务器、Global Routing 与顶部开关。Connectivity Test 用于下一步检查,不代替真实访问验证。

STEP 04 / CONNECTIVITY TEST

验证连接结果,而不只看开关

先在 Home 使用 Connectivity Test 检查候选服务器。测试结果受 Test Method、测试目标和当前网络影响,因此应在相同测试条件下比较。测试有响应可以作为继续验证的依据,但不能证明所有网站、所有协议或所有应用都已经正常工作;单次超时也需要结合实际访问进一步判断。

接着打开浏览器,访问你实际需要使用的目标,并重新加载页面。不要只查看一个已经打开很久的标签页,因为缓存内容可能掩盖新的请求是否成功。再访问一个你确认可以直接连接的页面,用来区分基础网络是否正常。若基础网络本身不可用,先恢复 Wi-Fi 或蜂窝数据,再继续检查客户端。

如果当前使用 Config,需要核对目标请求匹配了哪条规则、最终采用了哪个策略。可结合当前版本提供的请求记录查看目标域名与处理结果。Config 下部分连接使用 DIRECT 是规则分流的正常可能结果,不能因为它没有经过代理就直接判断连接失效。相反,即使连接开关开启,错误命中的 DIRECT 也可能让需要代理的目标无法访问。

当出现“测试有响应,但实际目标打不开”,先记下目标、所用网络、当前模式和服务器,然后一次只调整一项进行对照。例如临时从 Config 切到 Proxy 后重新访问相同目标:若结果发生变化,应优先检查规则或策略;若没有变化,再检查服务器参数、DNS 或目标自身状态。完成对照后恢复原设置,避免遗留测试模式。

如果真实访问符合预期,首次连接流程就已完成。之后再逐项调整规则与 On Demand,每次修改后重复相同目标的验证。若仍然失败,按照下面的症状分支继续检查,不要在没有记录的情况下清空全部配置。

STEP 05 / SETTINGS

设置检查与常见失败点

排错先回答“失败发生在哪一步”:订阅没有导入、服务器测试超时、连接开关无法保持,还是连接后只有部分请求失败。不同症状对应不同检查点。先保留当前配置与错误提示,再按下面的顺序缩小范围;暂时不要同时修改服务器、规则和 DNS,否则很难确认哪一项改变了结果。

订阅更新失败:先检查获取环节

确认订阅地址完整,粘贴时没有多余空格、换行或标点,并向原信息提供方确认地址是否仍有效。订阅返回空列表、认证失败和网络超时不能混为一谈。已有条目仍可用时,可保留它用于对照;不要因为更新失败就立即删除全部服务器。详细流程见Shadowrocket 订阅失败排查。

服务器超时:核对参数,再比较网络

重新检查 Type、Host、Port 及认证字段,确认 TLS 与传输参数没有遗漏。保持服务器参数不变,分别在可用的 Wi-Fi 与蜂窝数据下测试;如果结果随网络变化,优先检查网络环境。如果同一网络下只有某一条服务器失败,应核对该条目的状态,而不是马上重置所有系统网络设置。

连接后无法访问:区分规则与 DNS

先确认基础网络能够直接访问正常目标,再比较 Config 与 Proxy 下同一目标的结果。若只在 Config 中失败,检查命中规则和策略;若表现为域名无法解析,应查看当前配置中的 DNS 设置。不要一次填入多组不明 DNS 地址,也不要把更改 DNS 当成服务器认证失败的解决方法。

频繁重连或耗电:检查 On Demand

进入 Settings,找到 On Demand,检查是否设置了自动连接条件。若正在排查自动重连,可暂时停用相关条件并手动连接,观察现象是否变化,测试完成后按实际需求恢复。耗电判断应结合系统电池统计与使用时段,不能只凭状态栏显示 VPN 就认定是异常。

Settings 中的 Test Method 会影响 Connectivity Test 的解释,Diagnostics 可用于进一步收集诊断线索。记录具体操作与错误内容比反复切换开关更有帮助。不要为了一次连通性测试随意修改 Proxy、TCP、UDP 的所有高级选项;只有明确知道某个选项与当前症状有关时才调整,并保存调整前的值。

iPad 按照相同的 Home、Config、Settings 界面词定位即可;横屏时页面空间和分栏表现可能不同,不必照着截图坐标寻找按钮。若基础流程完成后问题仍在,转到问题诊断按症状继续排查;协议与设置项的概念问题见协议相关问答。

Shadowrocket Settings 页,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:排错时重点核对 Test Method、On Demand 与 Diagnostics,只调整与现象相关的项目。