官方手册 · 首次连接

Shadowrocket 使用教程:导入订阅与首次连接

先把已有的服务器信息正确放进 Shadowrocket,再选择流量走向、打开连接并验证结果。以下五步以完成一次可复查的连接为目标,不需要在首次使用时调整所有设置。

操作前提:已安装客户端,并持有自己的连接信息

用户应已装好 Shadowrocket:iPhone / iPad 从 App Store 获取,电脑与安卓从下载页免费安装。iPhone / iPad 版 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;iPhone / iPad 系统要求以 App Store 页面标注为准。

本教程以 iPhone / iPad 界面为例。开始前请确认已有自己的订阅链接或服务器信息;订阅从你的服务商处获取,本站不提供节点或订阅服务。客户端一次性买断 ≠ 线路套餐,安装客户端本身不会自动产生可用服务器。

建议先保留当前配置和服务商给出的原始参数,不急着删除旧条目。首次操作只使用一条明确的服务器或一份已知用途的订阅,并保持当前网络不变。这样出现异常时,能够分清是信息导入、服务器连接,还是规则选择造成的差异。

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

先分清拿到的是单条服务器信息、服务器订阅链接,还是配置文件链接。它们虽然都可能表现为一段文字或一个 URL,但导入后出现的位置与用途不同:服务器信息决定连接到哪里,配置文件主要决定请求如何处理。不要因为链接以 HTTPS 开头,就直接认定它应放进 Config。

单条服务器:从 Home 进入 Add Server

打开 Shadowrocket 的 Home,点击右上角添加入口进入 Add Server。先在 Type 中选择服务商指定的协议,再按原始信息填写地址、端口和对应认证字段。Shadowsocks、VMess、VLESS、Trojan 等协议的字段并不相同,不应把某个协议的密码或标识填进另一个协议的表单。

填写时逐项对照,而不是只检查地址和端口。若服务商还给出了 TLS、Server Name、传输方式或路径等参数,也需要按要求填写;这些内容不能根据服务器显示名称推测。保存后返回 Home,在 SERVER 区域确认新增条目存在,再点选准备使用的服务器。名称只是方便辨认的备注,不是判断参数是否正确的依据。

服务器订阅:在 Add Server 中选择 Subscribe

如果拿到的是服务器订阅链接,在 Add Server 的 Type 中选择 Subscribe,将完整链接填入 URL,并设置便于识别的备注后保存。订阅链接应从你的服务商处获取;复制时不要带入说明文字、换行或前后的引号,也不要自行删除问号后面的参数。

导入并拉取内容后,回到 Home 检查 SERVER 列表是否出现对应分组与服务器。保存了一条订阅记录,不等于已经成功取得服务器内容;若列表仍为空,应先检查订阅是否拉取成功,再继续后面的连接步骤。更新已有订阅也不等于需要重复添加一份,先找到原订阅的更新操作,避免相同条目堆叠后选错。

Config 中的 Subscribe:用于配置文件订阅

如果提供的是规则配置文件链接,再进入 Config,使用其中的 Subscribe 相关入口添加或管理配置文件订阅。导入后核对文件是否可用,以及实际启用的是哪一份配置。不要把服务器订阅和配置文件订阅互相替代:Home 有服务器,并不能证明 Config 已选好规则;Config 有文件,也不能证明 Home 已有可用服务器。

若手中是二维码或单条协议链接,可使用应用提供的扫码或剪贴板导入入口,但只处理来源明确、自己已有的信息。订阅 URL 可能包含访问凭据,不要把完整链接、二维码或认证字段贴到公开页面。需要区分更多入口时,可阅读Subscribe、Add Server、扫码与剪贴板导入说明。确认 SERVER 中已经有可选条目后,再进入下一步。

选择 Global Routing:Config / Proxy / Direct

回到 Home,点击 Global Routing,先决定本次连接要使用哪一种姿态。这里控制的是请求的处理方向,不是服务器参数,也不会修复失效的订阅。初次使用时,应把“服务器选哪条”和“请求按什么方式处理”分开核对,避免只改了其中一项便以为整个连接条件都已改变。

配置、代理与直连的用途和检查重点
姿态 处理方式 首次使用的检查重点
配置(Config) 按照当前启用配置中的规则决定策略。 核对 Config 中的活动配置,确认规则与预期一致。
代理(Proxy) 以代理路径处理请求,用于检查所选服务器的连接能力。 核对 Home 当前选中的服务器,不将其理解为配置规则已生效。
直连(Direct) 以直连路径处理请求。 适合建立对照,不用于验证代理服务器是否可用。

已有适用规则配置、希望按域名或地址分流时,选择配置(Config),随后到 Config 核对当前启用文件。只是看见一份文件列在页面中,还不足以说明它正在使用。若暂时不确定规则是否正确,可以先记下原姿态,临时选择代理(Proxy)测试服务器;确认基本连接后再返回配置(Config),比较同一目标的访问结果。

直连(Direct)主要用于对照当前网络的直接访问情况。切换到直连后网页可以打开,不代表之前选中的服务器已经恢复,也不代表连接开关必然关闭。完成对照后,应回到自己原本需要的姿态,并再次查看 Home 显示的 Global Routing 值。

第一次只改姿态,不同时改规则

先保留配置文件原样。若代理(Proxy)正常、配置(Config)异常,下一步应检查活动配置与匹配结果,而不是立即重填所有服务器参数。规则关键字、策略与匹配顺序见规则与配置参考。

本页不要求建立一套新规则。先明确当前姿态、所选服务器和活动配置这三个条件,再打开连接,后面的验证结果才有可比性。

打开 Home 连接开关并允许 VPN 配置

在 Home 的 SERVER 区域点选刚才核对过的服务器,再确认 Global Routing 的值,最后打开页面顶部的连接开关。首次连接前可能看到 Not Connected;操作后应观察状态是否发生变化,而不是连续多次点击开关。反复开关会打断当前过程,也容易把系统授权提示和应用状态混在一起。

首次出现系统授权时如何处理

首次使用时,系统会要求允许 Shadowrocket 添加 VPN 配置。核对提示对应的应用后选择允许,并按系统要求使用设备密码或生物识别完成确认。这一步是在设备上建立承载连接的系统配置,不是添加服务器,也不会修改服务商给出的订阅内容。若此前拒绝了请求,可返回应用重新发起连接,再按系统提示处理。

授权结束后回到 Shadowrocket,查看顶部开关与连接状态。系统设置中存在一份 VPN 配置,只能说明配置已经建立;它不能单独证明服务器可达、认证成功或网页访问正常。即使系统显示 VPN 已连接,仍需要完成下一步的实际请求验证。

开关立即关闭或状态没有变化

先确认 Home 中确实选中了一条服务器,而不是仅完成订阅记录的添加。然后检查系统授权是否完成,以及是否有其他 VPN 连接或设备管理策略影响当前连接。不要直接删除不明用途的系统配置;受管理的设备应遵循设备管理要求。

首次排查时可以先不启用 On Demand。它用于按条件触发连接,不是手动连接的必要前提;将自动触发行为与手动开关混在一起,会让“为什么刚关闭又连接”更难判断。如果此前已经启用 On Demand,先记下原设置,再暂时关闭自动触发做一次手动测试。

当开关能够保持开启、应用状态已经更新后,进入验证步骤。此时不要急着更换服务器或调整 DNS,先检查当前这组条件下到底能完成哪些请求。

用 Connectivity Test 与实际访问验证生效

连接是否生效应分三层判断:系统连接是否建立、所选服务器是否能完成测试、目标请求是否按预期处理。任何一层的成功都不能替代另外两层。建议先在当前 Wi-Fi 或蜂窝网络下完成整组检查,再决定是否换网络,避免测试条件不断变化。

先做 Connectivity Test,再发出实际请求

在 Home 使用 Connectivity Test,观察所选服务器的测试结果。不同测试方式可能检查不同环节,因此测试响应只适合说明该次测试的结果,不能承诺所有网页和应用都可用。也不要仅凭列表中的一次响应时间就连续切换服务器;先确认正在使用的条目与刚测试的条目相同。

接着打开浏览器,访问平时确认可用的 HTTPS 页面,并重新加载一次。若页面已经缓存,看到旧内容不一定代表发生了新的网络请求。可以再检查另一项正常网络操作,例如打开页面内尚未访问的链接,但不要用来源不明的检测页面作为唯一判断依据。

配置(Config)下还要核对实际策略

若需要确认规则分流,在配置(Config)下访问一个自己知道预期策略的目标,然后回到应用的 Data 或连接记录相关页面,按目标域名与请求时间定位对应记录,核对它实际使用的策略。不能因为某个网页能打开,就断言它一定经过代理;DIRECT 路径同样可能正常返回页面。

如果结果与预期不符,保持同一个目标、同一条服务器和同一个网络,临时切到代理(Proxy)再测一次。代理(Proxy)正常而配置(Config)异常,通常应先查规则与配置;两者都失败,则优先检查服务器、认证或当前网络。完成测试后恢复需要的姿态,不要把临时排查设置遗留为日常设置。

  1. Home 顶部连接状态已变化,当前服务器与计划使用的条目一致。
  2. Connectivity Test 的结果已观察,并与实际网页访问分别记录。
  3. Global Routing 当前姿态明确;使用配置(Config)时,活动配置已核对。
  4. 如需验证分流,已经检查目标请求记录,而不只是查看系统 VPN 标识。

以上检查通过后,首次连接就具备了可复查的基线。后续修改规则、DNS 或 On Demand 时,每次只改一类设置,再重复这组检查,便能定位变化来自哪里。

常见失败点:按出现问题的环节回查

遇到异常时,从最早失败的环节开始,不要一次执行重装、改 DNS、换服务器和改规则。先记下当前网络、服务器、Global Routing 姿态,以及出现问题的具体操作。描述“订阅保存后列表为空”比笼统描述“连不上”更容易缩小范围。

导入后 SERVER 为空,或订阅不能更新

回到导入步骤,核对使用的是服务器订阅入口还是配置文件入口。检查链接有没有截断、空格或缺失参数,再确认当前网络能够完成订阅拉取。拉取失败与代理连接失败是两个问题;旧服务器仍然可用时,也不能据此断言订阅更新地址一定可达。

若地址返回登录页面、提示失效或没有预期内容,应从你的服务商处确认链接状态和格式,不要自行拼接认证参数。需要保留排查证据时,记录错误提示即可;公开截图应遮住完整 URL、二维码、密码及其他认证信息。

连接开关不能保持开启,或服务器测试失败

先回查系统授权与连接步骤,再核对服务器地址、端口、认证和传输参数。尤其要区分备注名称与真实地址,确认协议类型没有选错。随后在允许的情况下用另一种正常网络做同样测试;换网络后有差异,只能说明网络条件影响结果,不能直接确定是哪一端故障。

如果多条服务器来自同一份订阅,同时失败时还应确认服务状态与认证是否有效;单条失败则先检查该条参数或可用状态。不要为了试错而随机更改 TLS、Server Name 或路径,这类参数应与服务端要求一致。

测试有响应,但网页仍然无法打开

先确认不是只有一个目标页面异常,再比较代理(Proxy)与配置(Config)的表现。若仅部分域名失败,应检查对应请求记录、实际策略和 DNS 解析情况。DNS 负责把域名解析成地址,改动它不会修复错误的服务器密码,也不应把每一次访问失败都归结为解析问题。

暂时保留系统 DNS 作为对照,先记录原设置再调整。若需要比较系统 DNS、自定义 DNS 与 DNS over HTTPS,阅读DNS 设置与解析排查说明。本轮排查只改一个解析设置,随后重复同一目标访问,避免改变后无法判断效果。

代理(Proxy)正常,配置(Config)不符合预期

进入 Config 检查活动配置,再查看目标请求命中了哪条规则。规则通常按顺序匹配,较宽的规则如果排在较具体规则之前,可能先决定处理结果;FINAL 则承担前面没有命中时的最终策略。还应检查是否匹配了 REJECT,而不是把所有失败都当作服务器断开。

首次连接教程到这里保持轻量即可,不需要立即重写整份文件。关于 General、Rule、Host、URL Rewrite 的结构,以及 DOMAIN-SUFFIX、IP-CIDR、PROXY、DIRECT、REJECT 的具体含义,继续查阅Shadowrocket 规则与配置参考。需要重新建立测试基线时,返回本教程的 Global Routing 步骤,按固定条件重新测试。

排查结束后恢复日常设置

恢复计划使用的 Global Routing 姿态,确认选中的服务器与活动配置,再决定是否恢复 On Demand。保留能够复现问题的错误描述,不保留临时试错参数;不要在未确认原因时删除仍可用的原配置。