官方手册 首次使用流程

Shadowrocket 使用说明:
订阅导入、连接与验证

按五个步骤完成首次配置。先让一个已有服务器能够连接,再核对规则;出现问题时,回到最早失败的一步,不要同时改动多项设置。

截图为 App Store 官方展示图,用于辨认页面与字段。具体排列可能随应用界面调整,请以设备上显示的英文界面词为准。

01 添加服务器与导入订阅

从 Home 开始,在 SERVER 分组附近找到 Add Server,也可以使用页面上的添加入口打开。接下来只选一种导入方式:持有完整订阅链接时使用 Subscribe;持有单个服务器的协议、地址、端口与认证资料时手动填写;持有用户自己的配置二维码时使用 Scan QR Code。不要把三种资料混填在同一个字段中。

使用 Subscribe 导入已有订阅

  1. 先从自己的服务商处取得完整订阅链接。复制时保留路径、查询参数和末尾字符,不要只复制域名,也不要把说明文字一并选中。
  2. 进入 Add Server,打开 Type 选择 Subscribe。在 URL 字段粘贴链接,按需要填写便于自己辨认的名称,再保存。
  3. 返回 Home,等待订阅读取完成。确认出现对应的订阅分组或服务器条目,再选中其中一个条目。名称出现但没有可选服务器时,应先检查订阅读取结果,而不是直接尝试连接。

订阅链接通常包含访问凭据,应按密码对待。不要把完整链接贴进公开截图、文章评论或排错记录。更新订阅会重新读取远端内容;如果更新失败,先保留现有条目,确认链接是否仍有效、当前网络是否能访问订阅地址,再决定是否重新导入。反复添加同一个地址容易造成重复列表,并不能修复远端返回错误。

使用 Add Server 手动填写参数

手动添加时,先设置 Type,再填写该协议要求的字段。截图展示的是包含 Host / Port / Password / Method 的表单,其他协议可能显示不同选项。Host 应填服务资料给出的服务器地址,Port 填对应端口;不要把带路径的订阅链接填进 Host。Password、Method 或其他认证参数必须与服务器端一致,不能根据名称猜测,也不要仅因某个选项看起来常见就替换它。

若资料是二维码,可在 Add Server 中使用 Scan QR Code,按系统提示允许相机访问,识别后仍需核对 Type 与地址。Import from Cloud JSON 用于相应格式的资料,不应作为普通订阅 URL 的替代入口。保存后回到 Home,确认新条目存在且可以选中;完成这一步后再选择 Global Routing。

Shadowrocket 的 Add Server 页面,包含 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先选择 Type,再填写对应协议需要的参数。

02 选择 Global Routing

添加完成后返回 Home,点开 Global Routing。这里决定请求如何选择路径,与“选中了哪台服务器”是两个独立设置。首次使用应先明确当前要验证什么,再选择姿态。三种姿态分别是配置(Config) / 代理(Proxy) / 直连(Direct),不要仅凭顶部连接开关判断是否正在使用代理。

姿态处理方式与使用时机
配置(Config)按当前选中的配置文件匹配规则,适合需要区分 PROXY 与 DIRECT 的日常使用。
代理(Proxy)以所选代理处理请求,适合先确认服务器基本可用;它与按网站匹配规则不是同一种验证。
直连(Direct)按直连方式处理请求,可用于对照基础网络是否正常;不应用它检验服务器的代理效果。

Config 文件与 Config 姿态的关系

Home 的 Config 姿态负责选择“按配置处理”,底部 Config 页面则用于管理配置文件。进入 Config,先确认准备使用的文件已被选中;打开文件时,可以看到 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 等分段。初次连接只需确认文件来源可信、Rule 中策略指向明确,不需要为了完成基础连接而逐段启用其他功能。

规则按顺序匹配,前面的条件命中后会影响实际路径;FINAL 用于前面条件均未命中时的兜底。下面只是用于理解顺序的示例,不是可直接替代现有文件的完整配置。它表示 example.com 及其子域名使用 PROXY,其他请求交给 DIRECT。修改真实文件前先保存副本,也不要把自己的业务域名未经核对就批量套入示例。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

如果尚不确定现有规则是否正确,可先用 Proxy 姿态验证已选服务器;服务器可用后再返回 Config 验证分流。若 Proxy 能访问而 Config 不符合预期,优先检查所选文件、规则顺序及目标策略,不要立即重填服务器密码。规则细节可继续阅读指定网站的 DOMAIN-SUFFIX 与 FINAL 设置;App Store 获取与账号问题另见App Store 指南。

Shadowrocket 的 Config 配置文件编辑页面,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:核对当前文件与 Rule 内容。Add Rule 用于添加规则,并非添加服务器。

03 选择条目并打开连接

回到 Home,在 SERVER 列表中点选准备使用的服务器,核对选择标记位于预期条目上。订阅分组名称只是管理线索,不应代替实际条目的选择。随后再看一次 Global Routing:如果刚才切到 Direct 做了对照,此时需要切回用于本次验证的 Proxy 或 Config,否则连接开关即使打开,也不是在验证预期的代理路径。

  1. 点击 Home 顶部连接开关。尚未建立连接时,页面可能显示 Not Connected;打开后观察状态是否发生变化。
  2. 首次使用时,系统可能请求添加 VPN 配置。阅读系统提示,确认此次操作由自己在 Shadowrocket 中发起,再允许添加,并按提示完成设备认证。
  3. 返回 Shadowrocket,确认顶部开关保持开启、状态没有立即退回未连接,再进入下一步实际验证。若开关自动关闭,应先处理系统授权或配置问题,不要跳过。

这里的系统 VPN 授权用于建立客户端需要的网络处理通道,不会替用户补齐订阅或服务器资料。连接状态改变也只说明通道状态变化,不能单独证明远端服务器、DNS 和目标网站都正常。不要把系统状态栏中的 VPN 标识当作唯一验收结果,仍需运行测试并打开实际页面。

若设备上另有正在工作的 VPN 配置,先停止其他连接,避免同时争用系统网络通道。受管理的设备可能限制 VPN 配置添加;遇到这类限制应核对设备管理策略,不要反复删除所有网络设置。首次连通前也不必启用 On Demand,保持手动开关更容易看清每次操作与状态变化的对应关系。

Shadowrocket 的 Home 页面,展示顶部 Not Connected 开关、Global Routing 的 Config、Connectivity Test、SERVER 分组和 Add Server
Home:按“选条目 → 核对 Global Routing → 打开开关”的顺序操作。

04 验证连接与分流生效

连接后先在 Home 运行 Connectivity Test,观察当前测试方法的返回结果,再打开浏览器访问自己确实需要使用的网站。测试成功表示被测路径在当前方法下有响应,不等于所有协议、所有网站都可用;测试失败也不一定等于认证参数错误。测试目标暂时不可达、测试方法差异或基础网络异常,都可能影响结果。

把“服务器可用”和“规则正确”分开验收

  1. 先检查基础网络:暂时停止连接,确认设备本身可以正常访问日常网站。若基础网络不通,应先处理 Wi-Fi、蜂窝网络或网络登录页面。
  2. 再检查服务器:使用已核对参数的条目,在 Proxy 姿态下连接,访问一个预期应能通过该服务器访问的目标。失败时先记录具体症状,不立即改规则。
  3. 最后检查分流:切回 Config,分别访问一处预期走 PROXY 和一处预期走 DIRECT 的目标。如果当前界面提供请求或连接记录,再对照目标域名、命中规则与策略。

同一网页可能加载多个域名的资源。主页能打开而图片或登录失败,可能是不同资源走了不同规则,不能只给主域名新增一条规则后就认定排查完成。浏览器缓存和已建立的连接也可能延续旧结果;改变规则后应重新发起请求,必要时关闭原页面再打开,避免把缓存页面当作新连接的证据。

如果需要查看网络使用情况,可以进入 Data 核对可用统计,但有流量变化不等于目标请求一定命中 PROXY。验收时应同时记录“当前服务器、Global Routing 姿态、测试目标、实际结果”四项。完成这四项对照后再考虑自动连接或更细的分流规则,首次配置到这里即可停止扩展设置。

05 Settings 与常见失败点

排错从最早出现问题的阶段开始:导入时就失败,先查订阅;条目已保存但测试失败,先查服务器;开关无法保持开启,先查系统授权;Proxy 可用但 Config 异常,先查规则。进入 Settings 后可以辨认 Test Method / On Demand / Diagnostics / Proxy / TCP / UDP 等项目,但不要为了“可能有效”而把所有选项切换一遍。

订阅无法读取或列表为空

重新核对 Subscribe 的 URL 是否完整,尤其是问号之后的参数、复制时混入的空格与换行。确认填入的是订阅地址而不是网页控制台地址。订阅返回空内容、认证失败或格式不适配时,重复保存通常不会改变结果;应向自己的服务商核对地址有效性、访问条件和内容格式。排错时保留错误文字,分享截图前遮盖 URL、账号与认证字段。

条目存在,但 Connectivity Test 失败

先确认 Home 实际选中的条目,再对照 Type、Host、Port 以及该协议需要的认证字段。进入 Settings 查看 Test Method,理解当前使用的测试方式;不同方式测试的目标与能力不同,不要把某一种测试失败等同于所有请求失败。若用户已有另一个确认可用的条目,可以保持其余设置不变进行对照。没有对照条目时,先核实原始参数,不要自行猜测替代端口或加密方式。

开关退回关闭,或关闭后又自动连接

开关无法保持开启时,检查系统 VPN 配置请求是否完成,是否有其他活动 VPN 连接,以及设备是否受到管理策略限制。关闭后又自动连接时,检查 Settings 中的 On Demand 是否符合自己的预期。建议先暂时关闭自动连接条件,完成手动连接与断开的复测,再按实际需要设置 On Demand;它不负责修复无效的服务器信息。

能连接,但某个网站或部分功能失败

先比较 Proxy 与 Config 下的结果。若仅 Config 异常,检查当前选中的文件、Rule 的排列以及 FINAL;若两种姿态都失败,再区分是目标站点、DNS、服务器能力还是协议参数问题。看到 Settings 中的 TCP、UDP 不意味着必须同时修改它们,只有确认受影响功能使用了相应传输方式后,才核对服务端是否支持及相关设置是否一致。

保留可复查的诊断记录

需要进一步定位时,再使用 Diagnostics 中适用的诊断功能,记录失败发生的环节、网络类型、当前姿态和可复现的操作。每改一项就重新执行第四步;无效改动及时恢复,避免最终不知道哪一份设置仍然可信。发送任何记录前检查服务器地址、密码、订阅参数及个人访问内容,按需要遮盖敏感信息。配置文件的分段说明可见.conf 结构详解,不要为了排错直接覆盖整份配置。

Shadowrocket 的 Settings 页面,展示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:按问题选择相关设置。首次连接不需要逐项调整所有选项。