官方手册 / 快速上手

Shadowrocket 导入订阅与首次连接

首次设置只需完成三件事:导入一份已有资料、选定分流姿态、验证实际访问。不必先编辑配置文件,也不必同时添加多条服务器。

01 / ADD SERVER

添加服务器或导入订阅

打开 Shadowrocket,进入 Home,在 SERVER 分组找到 Add Server。先看手头资料的形式:一组独立的地址、端口和认证参数,按单条服务器添加;服务商给出的是一条用于拉取条目的链接,则按订阅导入。二者选一种即可,不需要为了首次连接重复录入。同一份资料无论以哪种方式添加,都应保留原有协议和参数,不要按截图里的字段猜填。

有单条服务器资料:先选 Type

进入 Add Server 后,先在 Type 选择资料注明的协议,例如 Shadowsocks 或 Trojan。所选协议决定后续有哪些字段。一般先填写 Host 和 Port,再根据界面补充 Password、Method 或该协议需要的其他参数。Host 填提供的服务器地址,Port 填单独的端口;不要把整条订阅链接拆开塞进这两个字段。如果有一份与该服务器对应的二维码,也可使用 Scan QR Code 导入,再核对协议和地址。字段不齐时,先向资料提供方核对,不必试填其他协议的参数。

有订阅链接:选择 Subscribe

在 Add Server 中将 Type 设为 Subscribe,把原始订阅链接完整粘贴到链接输入栏,再保存。链接中问号之后的部分也可能是载入条目所需的信息,不要手动删减,也不要把链接发到公开聊天或截图中。回到 Home,等待对应分组出现可选条目;如果只出现分组名称,展开后仍没有条目,先处理订阅载入问题,不要把空分组当作服务器来连接。保存只代表资料已经录入,并不代表客户端已经连通。看到可选条目后,再继续选择分流姿态。

Add Server 界面,显示 Type、Host、Port、Password、Method 和底部扫码入口
Add Server · 先选 Type,再填写该协议要求的字段。
02 / GLOBAL ROUTING

选择 Global Routing 姿态

返回 Home,点 Global Routing。这个入口决定客户端如何处理请求,不负责添加服务器,也不会替你打开连接。首次计划按规则使用时,选配置(Config);如果只是要判断某个请求走代理和直接访问时有什么区别,再短暂使用另外两种姿态作对照。

  • 配置(Config):使用当前配置文件的规则。不同请求可以分别匹配到 PROXY、DIRECT 或 REJECT,因此开关打开后,并不是所有请求都会走所选服务器。
  • 代理(Proxy):让客户端处理的请求走代理路径。可用它对照访问结果,判断异常是否只在按规则分流时出现;验证结束后记得切回日常使用的姿态。
  • 直连(Direct):让客户端处理的请求直接访问,不经代理服务器。它适合做对照,但与关闭顶部开关不同:切到 Direct 不等于停止客户端连接。

选择配置(Config)后,回到 Config 确认当前启用的是预期文件。可以打开该文件查看 General、Rule、Hosts、URL Rewrite 等分段;图中的 Add Rule 是编辑规则的入口,不是首次连接的必经按钮。尤其要区分 Home 里的 Config 姿态与底部的 Config 页面:前者让规则参与分流,后者用于查看或管理文件。在 Config 页面打开文件查看,也不等于把它设为当前启用的文件。

如果已经有可用配置,首次连接先保留原样。不要为了验证一个目标而清空 Rule 或把所有规则改成同一策略,否则之后很难分辨是服务器、配置还是目标本身发生了变化。需要了解规则顺序和 FINAL 时,再查看配置字段参考;现在回到 Home,准备接通。

Config 文件编辑界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config · 查看当前文件的 Rule 分段,不必先添加规则。
03 / HOME

在 Home 打开连接开关

在 Home 的 SERVER 中选中刚添加的服务器;如果导入的是订阅,先展开对应分组,再选中其中一个条目。确认名称或备注与手头资料对应,避免误用历史条目。随后看一眼 Global Routing 的当前值,确认没有停在仅用于对照的直连(Direct)。这时再打开 Home 顶部开关。点服务器条目和点连接开关是两个独立动作,只完成前一个不会启动连接。

首次打开开关时,系统可能提示添加 VPN 配置。确认提示是由刚才在 Shadowrocket 中打开开关触发的,再按设备提示允许;若系统要求验证身份,使用设备本身的验证方式。完成后回到 Home,等开关稳定,查看顶部是否离开 Not Connected。若不小心取消了提示,回到 Home 后先确认开关状态,再尝试打开一次;如果仍立即退回断开状态,跳到排查常见失败,不要连续反复点按。

看到连接已建立,只能确认设备侧连接已经启动。它不能证明所选服务器能访问某个特定目标,也不能证明某条规则已经命中。先保持设备在当前 Wi-Fi 或蜂窝网络上,不要边连边换网络;让服务器和 Global Routing 保持不变,下一步分别检查测试结果和实际访问。

Home 界面顶部显示 Not Connected 开关,下方有 Global Routing、Connectivity Test、SERVER 和 Add Server
Home · 选中 SERVER 条目,再操作顶部开关。
04 / CONNECTIVITY TEST

用测试与实际访问验证连接

在 Home 点 Connectivity Test,查看选中条目能否返回测试结果。先分清两个结论:开关稳定开启,说明设备侧连接已启动;测试有结果,说明在当前测试方式下获得了响应。无论结果显示响应还是超时,都只反映当时的测试条件,不能用来判断所有站点或所有应用是否可访问。不要仅凭一次测试结果就更换整份订阅或配置。

接着打开一个平时能稳定访问、且你知道预期分流方式的页面,执行一次新的加载。不要把已经显示在屏幕上的旧页面当作成功;重新载入并确认新内容确实返回。如果期望的是 Config 下的分流,最好分别选一个预期走 DIRECT 的目标和一个预期走 PROXY 的目标做验证。即便两个页面都能打开,也只能确认访问成功;如需确认具体命中的规则,应对照当前文件的 Rule 顺序,不能只凭页面是否打开倒推策略。

如果同一个目标在配置(Config)下失败,可以暂时改成代理(Proxy),用同一网络、同一服务器和同一目标重新测试;必要时再切到直连(Direct)比较。只有 Config 失败时,优先查看当前配置文件和匹配顺序;Proxy 也失败而 Direct 正常时,优先核对服务器资料和测试结果。三种姿态都失败时,先检查基础网络和目标本身是否可用。记下在哪种姿态成功或失败,再切回预期姿态,带着这个结果进入下一步。

05 / SETTINGS

按故障现象排查并复测

订阅已保存,但 SERVER 没有条目

先确认导入时选择的是 Subscribe,再检查粘贴的链接是否带有换行、少了末尾字符,或误用了服务商的登录页地址。回到 Home 查看分组是否已载入;如果分组一直为空,向原服务商核对链接是否仍有效。手动添加的条目如果能显示但不能连通,则回到该条目的编辑页核对 Type、Host、Port 和认证参数。订阅刷新失败与单条服务器连接失败是两个不同问题,重装客户端通常不是第一步。

开关弹回,或手动断开后又自行连接

如果开关打不开,先检查首次 VPN 配置提示是否已完成,再确认系统是否有另一条 VPN 连接在运行。如果开关可以关闭,但切换 Wi-Fi 或蜂窝网络之后又恢复连接,到 Settings 查看 On Demand。记录原设置;若设备允许调整,可在手动测试期间暂时关闭自己设置的按需连接,复测后再恢复。这样能把手动开关的结果和按需条件触发的结果分开观察。

连接稳定,但访问结果不一致

先用上一步的对照结果找范围。只有配置(Config)失败时,从当前启用的文件与 Rule 顺序看起;Connectivity Test 和代理(Proxy)访问都失败时,再核对所选服务器与当前网络。到 Settings 查看 Test Method,可先记录所用的测试方式,避免把不同测试条件下的结果当作直接对照。需要查看诊断信息时,可从 Diagnostics 入手;分享截图或诊断内容前,遮住订阅链接和认证信息。

每次只改一处,然后按「检查开关 → 运行测试 → 重新加载同一页面」复测。这样即使问题仍在,也能把失败范围缩小到录入、设备连接或访问路径中的一层。需要继续检查 DNS、规则或其他连接异常时,查看连接问题问答;遇到不熟悉的协议或设置名称,先查术语表。

Settings 界面,列有 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings · 从 Test Method 或 On Demand 核对测试与连接条件。

DOWNLOAD / 全平台获取

按设备获取 Shadowrocket