官方手册 · 首次连接步骤

Shadowrocket 订阅导入与连接教程

按“添加 → 选模式 → 连接 → 验证 → 排错”完成首次设置。
以 iPhone / iPad 界面为例,先验证已有服务器,再检查规则分流。

  • 已有订阅或服务器信息
  • 英文界面词对照操作
  • 官方 App Store 截图

开始前:确认安装与连接资料

先分清手里的资料是哪一种:一条用于更新服务器列表的链接,通常应按 Subscribe 导入;单个服务器的地址、端口和认证参数,则应按对应 Type 添加。两种方式任选符合资料的一种,不必把同一份内容重复导入。订阅链接可能含有个人凭据,不要发到公开页面,也不要交给不明工具处理。

下方截图用于辨认页面与字段,并非需要照抄的连接资料。设置项是否出现会随所选 Type 与应用界面有所不同;填写时以自己的服务商参数为准。首次操作先完成一条可验证的连接,再处理多订阅、复杂规则或自动连接,出现问题时更容易确认原因。

STEP 01 · Home / Add Server

添加服务器或导入 Subscribe

打开 Shadowrocket,先停留在 Home。若当前已有连接,先关闭顶部开关,避免边修改边连接。找到 Add Server,或点页面上的添加入口进入 Add Server。接下来根据资料类型,选择订阅导入或单个服务器填写;保存后都应回到 Home 检查结果。

已有订阅链接:选择 Subscribe

在 Add Server 的 Type 中选择 Subscribe,将从你的服务商处获取的完整订阅链接填入 URL。粘贴后检查开头与结尾,去掉复制消息时附带的引号、说明文字或换行,不要自行删改链接中的查询参数。为订阅填写便于自己辨认的名称,再保存并等待列表读取完成。返回 Home 后,检查是否出现对应分组和服务器条目。

保存订阅不等于已经连接。若分组出现但里面没有服务器,先检查链接是否仍有效、当前基础网络能否读取订阅,以及服务商是否要求重新生成链接。不要把“订阅地址”和某一台服务器的 Host 混填:前者用于读取列表,后者是单个连接目标。订阅更新会影响列表,手工改参数前应先保留原资料,避免下一次更新后无法辨认改动。

已有单个服务器:按 Type 填写

在 Type 选择与资料一致的协议,例如 Shadowsocks、VMess、VLESS 或 Trojan。随后核对 Host、Port 及该类型要求的认证和传输字段。截图展示的 Password、Method 等字段只对应适用的类型,不能当作每一种协议都需要的固定清单。Host 不要混入网页路径;Port 应与服务商资料完全一致;Password、标识和密钥都要保留大小写。

若拿到的是二维码,可使用 Scan QR Code,并在系统询问时允许相机访问;Import from Cloud JSON 只用于相应格式的资料,不应把普通订阅链接随意放进去。导入后仍要打开条目检查 Type 和关键字段。最后返回 Home,确认 SERVER 下可以选中该条目。此时先不要判断连接是否正常,下一步先确定流量应该采用哪种模式。

Shadowrocket 的 Add Server 页面,显示 Type、Host、Port、Password、Method 及二维码导入入口
Add Server:先选 Type,再按自己的资料填写对应字段。
STEP 02 · Global Routing / Config

选择 Global Routing 的三种姿态

服务器出现在列表后,回到 Home,点 Global Routing。这里决定的是请求怎样选择去向,并不负责补齐服务器资料。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先明确测试目的,再选择模式,避免把“服务器能否连接”和“规则是否命中”混成同一个问题。

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

日常希望区分代理与直连时,使用配置(Config)。随后进入 Config,确认当前选中的是准备使用的配置文件,而不是仅看见文件已下载就认为已经启用。打开配置可以检查 General、Rule 等分段;规则部分决定请求命中 PROXY、DIRECT 还是 REJECT。首次设置不必逐项修改,先确认配置来源与用途,再保留原文件用于恢复。

例如下面两行表示:匹配 example.com 及其子域名的请求使用 PROXY,其他尚未命中的请求使用 DIRECT。这只是解释语法的片段,不是完整配置,也不是本教程要求直接导入的模板。规则从上向下匹配,较早命中的规则会决定结果,因此 FINAL 应留在规则末尾。

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

代理(Proxy)与直连(Direct):分开验证原因

短时检查所选服务器能否承担代理请求,可先用代理(Proxy),这样能减少规则分支对测试的干扰。直连(Direct)则用于检查基础网络直接访问目标的表现,并不表示代理服务器已通过验证。三种姿态不是连接质量等级,也不保证设备上的所有系统流量都按同一种方式处理;系统路由与相关设置仍可能影响实际路径。

切换后返回 Home,检查 Global Routing 一行是否显示预期选项。若在 Proxy 下可以访问,而切回 Config 后某个目标失败,排查重点应转向当前配置的规则与解析,不宜立即反复替换服务器。需要理解匹配顺序、策略或完整配置结构时,继续阅读规则参考;只想快速辨认名词,可看概念速查。

Shadowrocket 的 Config 配置编辑页面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段和 Add Rule 入口
Config:检查正在使用的配置与 Rule 分段;模式切换入口在 Home 的 Global Routing。
STEP 03 · Home / SERVER

选中服务器,再打开连接开关

完成模式选择后返回 Home。在 SERVER 分组中点选要使用的服务器,确认选中标记确实落在目标条目上。订阅分组名称与具体服务器名称不是一回事;只展开分组并不等于切换了当前服务器。若列表里有多个相似名称,可以打开条目核对地址与 Type,再返回选择。

检查 Global Routing 后,打开 Home 顶部的连接开关。第一次建立连接时,系统可能提示允许添加 VPN 配置。阅读提示,确认是刚刚主动发起的操作,再允许并按照系统要求完成设备认证。这一步授权应用建立相应网络连接,不会自动补全服务器信息或修正错误参数。

完成系统提示后回到 Shadowrocket,观察顶部是否由 Not Connected 变为连接状态。若之前取消过授权,重新打开开关时应再次留意系统提示;若设备由组织管理或受到系统限制,需按设备管理要求处理,不能通过反复点击开关解决。不要在尚未看清提示内容时连续切换,以免无法判断当前处于授权阶段还是实际连接阶段。

顶部显示连接状态,只能说明连接机制已经启用,不能单独证明订阅里的每台服务器可用,也不能证明每个目标都走了代理。保持当前选中的服务器和模式不变,接着做下一步测试。若开关打开后立即回落,先记录是否出现系统提示或错误信息,再按最后一节从授权、配置与网络逐项定位。

首次手动验证时,建议先不要同时调整 On Demand。按需连接可能在网络条件满足时重新触发连接,会让手动断开与重连的观察变复杂。先确认手动路径能重复成功,再根据实际需要设置自动连接条件;On Demand 的含义可在概念速查中查看。

Shadowrocket 的 Home 页面,顶部为 Not Connected 开关,下方有 Global Routing、Connectivity Test、SERVER 分组和 Add Server
Home:先选 SERVER 条目,再检查 Global Routing,最后打开顶部开关。
STEP 04 · Connectivity Test

用测试、实际访问与规则记录验证生效

连接开关保持开启后,先在 Home 运行 Connectivity Test。它用于获得当前测试方法下的可达性线索,不是所有网站、所有协议都可用的保证。测试没有返回结果时,也不能立即认定所有连接都失败;测试目标、方法以及当前网络环境都可能影响结果,后续还需要实际访问验证。

打开浏览器,重新加载你实际需要访问的目标页面。不要只观察已经打开的旧标签页,因为缓存内容可能使断开状态看起来也能访问。检查页面的新内容能否加载,必要时换一个你有权访问的目标交叉验证。此时不要同时切换服务器与模式,否则即使访问恢复,也难以知道是哪项变化起了作用。

Config 模式要检查两种去向

若使用配置(Config),分别选择一个按自己规则应走 PROXY 的目标,以及一个应走 DIRECT 的目标测试。两者都能打开,并不自动代表规则正确;还应结合应用内可查看的连接记录,核对请求目标、命中规则及采用的策略。DIRECT 本来就应直接连接,不能因为此类页面能打开,就认定代理服务器工作正常。

把观察结果与下一步检查对应起来
观察结果说明与下一步
显示连接,但目标打不开继续检查所选服务器、域名解析与规则,不只看顶部状态。
Proxy 可访问,Config 失败检查当前生效配置、规则顺序以及是否命中 REJECT 或非预期 DIRECT。
测试未返回,实际访问正常核对 Settings 中的 Test Method,不仅凭单次测试结果下结论。
只有某一个目标失败聚焦该目标的规则、解析与服务状态,先保留其他已成功的设置。

Data 中出现上传或下载读数,可以辅助确认发生了流量,但统计本身不等于某条规则已经命中。把“开关已启用”“服务器可用”“规则去向正确”分成三项核对,判断会更可靠。完成一次成功验证后,记下当前服务器、Global Routing 和配置名称,作为下一次排错的参照。

STEP 05 · Settings / Diagnostics

按失败现象检查,不同时改多项

遇到失败时,先保留刚才的观察结果:是订阅读不到、开关无法保持、测试未返回,还是仅某个目标打不开。进入 Settings 前,先关闭连接,确认基础 Wi-Fi 或蜂窝网络能够完成正常访问;如果当前网络还需要网页认证,应先完成认证,再回到 Shadowrocket 重试。

订阅为空或参数有误

若没有服务器可选,回到订阅条目检查链接是否完整、是否已失效,以及服务商是否变更了订阅内容。重新更新前先确认正在处理哪一个分组,不必为同一链接连续创建多份订阅。单个服务器连接失败时,逐项对照 Type、Host、Port、Password 及协议对应字段;不要用其他类型的字段凑出一份看似完整的配置。

只有某条服务器异常、而自己已有的另一条可以正常连接时,应优先核对异常条目的资料与可用状态。需要重新获取资料时,从你的服务商处获取。不要把问题描述成“应用连接失败”就省去当前模式、条目类型和基础网络情况,这些信息决定后续应检查哪一层。

开关、测试与实际访问分别处理

开关无法保持时,先确认系统添加 VPN 配置的授权是否完成,再检查是否有其他 VPN 连接占用或设备管理限制。测试结果与实际访问不一致时,进入 Settings 查看 Test Method,记录原选择后再尝试适合当前目的的测试方式。只修改一项,回 Home 复测,再决定是否保留;不要为了让测试显示结果而同时改 DNS、规则和服务器。

若 Proxy 下正常、Config 下异常,返回 Config 核对生效文件以及 Rule 顺序。优先检查目标是否提前命中 REJECT、是否被 DIRECT 规则接走,以及末尾 FINAL 是否符合自己的预期。不要直接清空所有规则;先保存原配置,再针对单个目标调整并验证。更完整的定位方法见规则与配置参考。

需要进一步反馈时整理最小信息

可在 Settings 的 Diagnostics 中查看诊断入口,结合当次操作收集线索。记录失败发生在 Wi-Fi 还是蜂窝网络、所用 Type、Global Routing、具体错误文字,以及切换到自己已有的其他条目后是否仍失败。对外分享前,应遮去订阅完整链接、密码、密钥、个人地址与账户信息;截图中只保留与问题有关的字段和提示。

如果某项改动没有改善结果,就恢复改动前的状态,再检查下一项。恢复到最后一次成功的组合,比叠加多项不确定设置更容易复现。关于授权、订阅更新和常见界面疑问,可以接着查看问答;本页到这里完成首次使用闭环,不继续展开复杂配置。

Shadowrocket 的 Settings 页面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP 等设置入口
Settings:测试异常先核对 Test Method,进一步定位时使用 Diagnostics。

完成后保留成功配置,再安排其他设备

能够重复连接、实际访问符合预期,并确认 Config 下的规则去向后,即可保留当前设置。以后更新订阅或修改规则时,一次只变更一类内容;出现问题先恢复到已验证的状态。需要管理更多规则时转到规则参考,无需在第一次连接时一次完成全部高级设置。