Shadowrocket 官方手册

Shadowrocket
快速上手

已有订阅或服务器信息 → 导入 → 选择模式 → 连接 → 验证。按下面的顺序操作,先完成一次可重复的连接检查,再调整规则。

操作顺序 / 01—05

先确认条目
再判断请求路径

以 iPhone / iPad 界面为例

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

这一阶段的目标是让 Home 中出现可选择的服务器条目,暂时不必打开连接开关。先判断手上的资料是哪一种:会更新服务器列表的订阅链接,还是某一台服务器的协议、地址和端口等参数。两种资料的填写方式不同,不要把整条订阅链接填进 Host,也不要把单个服务器地址当成 Subscribe 链接。

已有订阅链接:Type 选择 Subscribe

进入 Home,点右上角 + 打开 Add Server,点 Type 并选择 Subscribe。返回添加页后,在相应的链接输入项粘贴从你的服务商处获取的完整链接,再保存。输入前后不要增加空格或换行;如果链接经过聊天工具转发,留意是否只复制了显示文字,或遗漏了末尾的一段参数。

保存后返回 Home,等待订阅内容读取。成功获取内容时,列表中会出现相应分组或服务器条目。先检查列表是否为空,再确认条目是否可以选中。若只看到订阅记录而没有服务器,不要急着反复创建同一订阅,应先确认基础网络可用、链接仍有效,以及服务商提供的内容格式是否与导入方式相符。

已有单个服务器信息:按协议填写字段

同样从 Home 的 + 进入 Add Server,在 Type 选择资料中指定的协议。截图展示的是包含 Host、Port、Password、Method 的添加页面;其他 Type 的字段可能不同,应以切换后的实际界面为准。Host 填服务器地址,Port 填端口,Password 与 Method 等内容严格按已有参数填写,不凭名称相近自行替换。

若参数还涉及 UUID、TLS、传输方式或路径,也要逐项核对。服务器名称仅用于辨认,不能代替连接参数。页面中的 Scan QR Code 可用于读取已有的相应二维码;Import from Cloud JSON 是另一种资料导入方式,不应把任意文本或普通订阅链接当成该格式导入。只需选择与你已有资料匹配的一条路径,不必每种方式都操作一次。

进入下一步前:返回 Home,确认 SERVER 中有目标条目,并能明确辨认准备使用的那一项。若列表为空,先停在本步排查导入,不要通过修改 Global Routing 解决资料未读入的问题。

Shadowrocket Add Server 官方截图,展示 Type、Host、Port、Password、Method 与底部导入选项
Add Server:字段随 Type 而变化。

Global Routing:选择请求处理方式

有了服务器条目之后,再决定请求应该如何处理。在 Home 点 Global Routing,先认识配置(Config)、代理(Proxy)、直连(Direct)这三种姿态。这里选择的是请求处理方式,不是重新导入服务器;切换姿态也不会自动修复错误的地址、密码或已失效的订阅。

  • 配置(Config):按当前配置文件中的规则决定请求采用哪一种策略,适合已经准备好规则、希望区分不同请求路径的情况。
  • 代理(Proxy):让通常由此模式处理的请求使用代理路径,可用来对照检查当前选中服务器的可用性;不能将其理解为任何系统请求都必定经过同一路径。
  • 直连(Direct):使用直连路径。若预期请求通过代理服务器处理,应先确认没有误选这一项。

日常使用 Config 前,进入底部的 Config,确认当前选择的是预期配置文件。订阅通常用于提供或更新服务器列表,配置文件则负责规则及相关设置;导入 Subscribe 并不意味着已经同时导入了预期规则。截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 属于配置编辑分段,本次上手不需要逐项修改。

理解规则时,可以先记住“从上到下匹配,按命中的策略处理”。例如 DOMAIN-SUFFIX 用于域名后缀匹配,GEOIP 用于相应 IP 地理数据匹配,FINAL 用于前面规则未命中时的最终处理;PROXY、DIRECT、REJECT 是不同的处理策略。它们解释了为什么选中同一个服务器时,不同请求仍可能采用不同路径。

先保留已有配置,不要为了测试连接而随意添加 Add Rule,更不要在不清楚用途时启用 HTTPS Decryption。需要进一步理解模式与匹配关系,可阅读代理模式说明;App Store 获取、正版核验和账户问题则集中在正版指南。完成模式选择后,返回 Home,准备打开连接。

Shadowrocket Config 配置编辑官方截图,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:先确认使用的文件,再考虑修改规则。

Home:选中条目并打开连接

回到 Home,在 SERVER 分组中选中要使用的服务器。订阅分组名称与实际服务器条目可能同时出现在列表里,应确认选中的确实是目标条目,而不是只展开了一个分组。若你刚更新过订阅,原条目可能发生变化,连接前重新确认一次选中状态。

核对 Global Routing 后,打开 Home 顶部开关。首次连接时,系统可能要求允许添加 VPN 配置;先核对提示来自当前操作中的 Shadowrocket,再按系统要求确认,可能需要设备密码或身份验证。不要在授权尚未完成时连续切换开关。授权结束后返回应用,观察顶部原先的 Not Connected 状态是否发生变化,以及开关是否保持开启。

如果点开后又立即回到关闭状态,先检查系统授权是否完成,再查看是否有明确错误提示。此时问题未必在服务器线路上:应用尚未建立本地连接配置、系统操作被取消,或设备上的连接设置互相影响,都可能使连接没有真正开始。先记录提示原文,不要一次修改多个字段。

顶部显示已连接,说明连接配置已启用,但不能单凭这一点断定服务器和所有目标请求都正常。服务器参数错误、远端不可达或规则选择不符,都需要后续验证才能区分。下一步将分别检查条目连通性和实际访问结果。

初次上手时,建议暂时保持 On Demand 的现有设置,不要同时添加自动连接条件。这样在手动开关前后,状态变化更容易观察。需要结束本轮检查时,先在 Home 手动关闭;若稍后又自动连接,再到 Settings 检查 On Demand 的触发条件。

Shadowrocket Home 官方截图,展示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 与 Add Server
Home:先选 SERVER 条目,再打开顶部开关。

Connectivity Test:验证连接与实际请求

验证要分两层:先看所选条目能否完成当前测试,再看真正要使用的应用或页面能否工作。在 Home 使用 Connectivity Test,等待测试结束,留意是否返回结果或提示失败。测试方法会影响结果含义,因此不要只凭一个数字判断整体状态,也不要把单次失败直接解释为所有服务器都不可用。

随后打开你原本需要使用的应用或页面,执行一个简单、可重复的操作,例如重新加载同一个页面。测试时保持相同服务器与相同网络,避免同时从 Wi-Fi 切换到蜂窝网络,否则很难知道结果变化来自哪一项。已打开的页面可能显示缓存内容,必要时重新发起请求,而不是只观察原来已加载的画面。

如果 Connectivity Test 有结果,但实际应用仍不能访问,回到 Global Routing 核对模式。Config 会按规则分流,某个目标命中 DIRECT 时,其他目标经过代理并不代表它也经过代理。可以临时使用 Proxy 对同一目标作对照,测试后恢复原来的 Config,再检查相应规则;对照测试的目的是定位路径差异,不是要求长期保持某一种模式。

如果实际应用可正常使用而某种测试失败,应检查 Settings 中的 Test Method 及测试所用条件,不必立刻删除服务器。反过来,如果测试能通过而某个功能异常,也应把问题限定到该目标、该网络或该请求类型,不能推导出“所有功能正常”。一次可复核的验证记录应包含所选条目、Global Routing、基础网络,以及成功或失败的具体操作,不需要包含订阅链接或密码。

Settings:按失败位置检查

排查时遵循“基础网络 → 资料是否正确 → 当前模式 → 具体请求”的顺序。每次只改变一项,完成后回到验证步骤重复同一个测试;如果结果没有改善,先恢复原值,再检查下一项。这样能够保留可用设置,也便于说明问题发生在哪一环。

导入后没有服务器条目

先在关闭连接的状态下确认基础网络可用,再检查链接是否完整、是否选择 Type 为 Subscribe,以及链接是否仍在有效期内。订阅状态和访问限制需要向你的服务商核实。不要通过修改 Host 或随意更换链接参数来“修复”订阅,也不要不断添加相同记录;先保留一条便于核对的订阅,再进行更新检查。

有条目,但连接或测试失败

手动添加的服务器,应逐项核对 Type、Host、Port 及认证字段;需要 TLS 或特定传输参数时,一并与已有资料比较。订阅导入的条目则先更新并重新选择。确认系统时间准确,并区分 Wi-Fi 与蜂窝网络下的结果。若只有某个条目失败,可用你已有的另一条记录做对照,但不要把名称相似的参数拼在一起尝试。

已连接,但只有部分应用异常

先检查 Global Routing 与 Config,再确认失败目标预期命中的是 PROXY、DIRECT 还是 REJECT。若只有特定请求类型异常,记录现象后再查看相关设置,不要同时调整 DNS、TCP、UDP 等多项内容。Settings 中出现这些设置项,并不意味着首次使用都需要更改;保持已知配置通常更便于定位差异。

自动重连或测试结果难以解释

在 Settings 查看 On Demand,核对是否存在与你当前网络相符的自动连接条件。手动关闭后又出现连接状态,应先确认这一项,而不是反复删除服务器。测试结果与实际访问不一致时,查看 Test Method,明确当前测试关注的内容,然后回到同一网络重新执行一次。

仍无法定位时,可以进入 Diagnostics 查看可用诊断信息。记录错误原文、发生步骤与可重复操作即可;对外分享前移除订阅完整链接、认证信息、二维码和其他私人数据。诊断信息用于缩小范围,不能替代服务商对服务器状态的确认。

最终应能把问题归到一个明确环节:未读入资料、未完成系统授权、服务器连接失败,或请求路径不符。导入问题回到第 01 步,规则问题回到第 02 步,不要在没有记录的情况下从头改完所有选项。

Shadowrocket Settings 官方截图,展示 Language、Test Method、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:先查看 Test Method、On Demand 与 Diagnostics。