官方手册 · 首次连接

Shadowrocket 使用教程
订阅导入与连接验证

适用于 iPhone 与 iPad。先保存已有服务器信息,再选择 Global Routing、完成系统授权,最后分别检查连接状态与实际访问。

  • 01导入已有信息
  • 02选择路由
  • 03连接并验证

STEP 01 / ADD SERVER

添加服务器或导入 Subscribe

打开 Shadowrocket,进入 Home。这里用于查看已有服务器、选择当前服务器并控制连接。首次使用时,先根据手里的资料判断添加方式:一条可以更新服务器列表的订阅地址使用 Subscribe;一组地址、端口、密码及协议参数使用手动添加。两种方式选择其一即可,不需要为了完成教程重复导入同一组资料。

已有订阅链接:选择 Subscribe

在 Home 点击右上角的添加按钮,打开 Add Server。在 Type 中选择 Subscribe,再把完整订阅链接粘贴到 URL。若页面提供备注栏,可填写便于自己识别的名称。订阅链接往往带有身份信息,复制时不要漏掉问号后的参数,也不要把网页标题、说明文字或末尾空格一起粘贴进去。

核对后保存,等待订阅内容获取完成,再返回 Home 检查列表。成功的判断不是“地址已经填进去”,而是出现可以选择的服务器条目。如果只看到订阅分组却没有服务器,先检查是否仍在获取、当前网络能否访问订阅地址,以及链接是否有效。不要连续重复添加;同一订阅出现多个分组会增加后续选择和更新的混淆。

订阅地址应当是服务商提供给客户端的地址,而不是账户登录页、订单页或普通说明页面。若返回的是网页而非可识别的订阅内容,修改 Global Routing 不会让它变成正确的订阅。应先从你的服务商处获取正确链接,再回到 Add Server 修改 URL。

已有单台服务器信息:匹配协议再填参数

同样从 Home 打开 Add Server,在 Type 中选择资料对应的协议,例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard。随后按服务商提供的信息填写。不同协议需要的字段不同:端口和密码不能代替 UUID,WireGuard 的密钥也不能填入其他协议的密码栏。不要仅凭服务器名称推测协议类型。

对于需要 TLS 的连接,还要核对 TLS、SNI 等相关参数;传输方式、路径及主机名也应与原始资料一致。保留证书验证设置,不要把关闭验证当作常规排错方法。填写完成后保存,回到 Home,点选准备使用的服务器并确认选择标记已经改变。到这里仅完成资料保存,下一步才决定请求如何经过这台服务器。

若服务商提供二维码,可在 Home 的添加相关入口使用 Scan QR Code,并按系统提示授予相机权限。导入后仍需打开条目核对协议与地址;识别成功不代表参数有效,也不表示连接已经建立。有关协议字段的详细含义,参见Settings 设置项参考与选项手册。

STEP 02 / GLOBAL ROUTING

选择 Global Routing 姿态

完成导入后,留在 Home,打开 Global Routing。这里决定客户端处理的请求采用什么路由方式,与“选择哪台服务器”是两个不同的操作。切换服务器不会自动把 Direct 改成 Proxy,导入订阅也不等于已经启用了合适的规则。每次首次连接前,都应分别确认服务器选择和路由姿态。

配置(Config):按当前规则处理

配置(Config)适合需要规则分流的日常使用。请求依据当前配置中的规则选择策略,可能经过 PROXY,也可能采用 DIRECT 或被 REJECT 处理。选择此姿态前,进入底部 Config,检查当前启用的是哪份配置;如果已有多份文件,不要只看名称,应确认实际选中项及其规则内容。

订阅和配置文件承担的任务不同:Subscribe 主要提供服务器资料,Config 承载规则及相关配置。列表里有服务器,不代表 Config 中已具备符合需求的规则。若服务商还提供配置说明,应先核对其用途再导入;不了解的远程配置不要直接替换现有文件。修改前保留原有配置,便于恢复。

代理(Proxy):先验证所选服务器路径

代理(Proxy)让客户端处理的请求按代理姿态路由,适合在首次测试时减少规则分流带来的判断变量。选择 Proxy,再回到 Home 核对所选服务器,随后进入连接步骤。它不是修改服务器参数的工具,也不能修复已经失效的账户或错误的密码。

如果 Proxy 下可以完成实际访问,而 Config 下同一个请求失败,说明两次请求可能走了不同策略,应转向检查配置与规则命中情况,而不是马上删除服务器。测试完成后,可以按日常需求切回 Config,并再次验证。不要把一次成功当成所有规则、所有目标都已经正确的证据。

直连(Direct):作为基础网络对照

直连(Direct)采用直连姿态,不通过所选远端代理服务器转发相应请求。它适合与代理路径做对照,但不用于证明服务器连接正常。若 Home 已选择服务器而 Global Routing 仍是 Direct,打开连接开关后也不能据此判断代理路径已经生效。

这三个姿态没有适用于所有情况的固定选择。首次排查可先用 Proxy 验证已有服务器,再切到 Config 检查规则行为;Direct 用来观察基础网络。有关规则顺序、FINAL 及 DNS 的深入设置,继续阅读选项手册,本页先完成一次可重复的连接验证。

STEP 03 / VPN

打开开关并完成 VPN 授权

返回 Home,再检查一遍当前服务器与 Global Routing。确认后打开顶部连接开关。第一次建立连接时,系统可能询问是否允许 Shadowrocket 添加 VPN 配置;这是客户端接入系统网络处理所需的授权步骤。先确认提示中的应用名称,再按系统指引允许,并完成设备要求的密码或生物识别认证。

如果此前取消了授权,客户端可能无法保持开关开启。此时不必重新导入订阅,可再次尝试连接并处理系统提示。若设备受到组织管理,或系统限制不允许添加 VPN 配置,应先核对设备管理要求,而不是不断更换服务器。系统授权完成,只说明客户端取得了相应权限,并不代表远端服务器已经可用。

授权后返回 Shadowrocket,观察开关是否保持开启、连接状态是否稳定。系统 VPN 标识在不同设备与系统布局中的显示位置可能不同,不要把某个图标是否常驻当作唯一判断依据。下一步还需要使用 Connectivity Test 和实际访问,确认连接能否承载请求。

若设备还有其他正在使用系统 VPN 的连接,先核对当前由哪项配置接管,避免误把其他连接的状态当成 Shadowrocket 的结果。首次测试期间也先检查 On Demand:自动触发的连接行为可能让手动开关的观察变得不直观。先明确当前连接来源,再决定是否调整按需连接条件。

需要结束测试时,回到 Home 关闭连接开关,并确认状态已改变。切换 Wi-Fi 与蜂窝网络后应重新验证,因为两个网络到同一服务器的可达性可能不同。连接保持开启、测试返回结果、目标页面加载成功是三个不同层面的现象,接下来要分别记录。

STEP 04 / CONNECTIVITY TEST

验证连接状态与实际访问

在 Home 找到 Connectivity Test 并执行测试,观察服务器列表中的结果。测试方式可能受当前 Settings 中的相关设置影响,因此结果只能按所用测试方法解释。返回一个时间值,通常说明对应测试获得响应;显示超时则表示该次测试没有在时限内完成,不能直接推断服务器永久失效。

Connectivity Test 与真实应用请求并不完全相同。某种探测获得响应,不代表 TLS、认证、DNS 以及目标站点访问都正常;反过来,服务器未响应某种探测,也不一定意味着所有业务请求都无法建立。不要仅凭延迟数字选择“已经成功”,更不要把它当作实际加载速度或稳定性的保证。

使用同一个目标做前后对照

保持 Shadowrocket 连接,打开浏览器访问一个平时可以识别加载结果的页面,检查正文与必要资源是否完整出现,而不只是看到缓存的页面标题。再打开一个新的页面或刷新内容,减少已有缓存造成的误判。测试时先固定网络、服务器和路由姿态,不要在一次失败后同时更改多项条件。

如果使用 Config,还应通过请求记录或日志核对该目标匹配的规则与实际策略。页面打开可能来自 DIRECT,不能单凭“能访问”证明它经过了 PROXY。需要验证代理路径时,可暂时切到 Proxy 重复同一测试,随后恢复原姿态,再比较两次结果。具体记录入口以当前应用内显示为准。

如果需要核对出口信息,应使用自己信任的测试目标,并结合规则记录判断。某个目标的出口结果只说明该次请求的路径,不代表设备上的每一个请求都采用相同路径。尤其在 Config 下,不同域名、地址与应用请求可能匹配不同规则,这是分流的预期行为。

首次验证的完成标准是:已保存并选中正确服务器、明确当前 Global Routing、系统连接保持开启、实际目标请求得到符合所选策略的结果。建议记下当时的网络类型、服务器备注与路由姿态,之后出现问题时可以用相同条件重测,而不是凭印象比较。

STEP 05 / CHECKLIST

按失败位置排查常见问题

先判断问题发生在导入、连接还是访问阶段。导入失败时尚未完成服务器资料获取,反复切换 Proxy 没有针对性;开关能够开启但页面失败时,也不应首先重装应用。保留现有条目与配置,每次只改变一项设置,并用同一目标重新测试,才能知道哪项变化产生了影响。

订阅保存后没有服务器

回到订阅编辑处检查 URL 是否完整,尤其注意复制换行、参数截断及链接过期。确认当前基础网络能够获取订阅内容;如果订阅地址本身无法访问,需要先解决获取路径或链接有效性。服务商侧的订阅状态与应用购买状态分开管理,重新购买客户端不会恢复一条已失效的订阅。

如果以前有条目而更新后变少,应先检查订阅返回内容是否改变,以及是否存在筛选条件,不要立即批量删除。订阅更新可能覆盖其管理的服务器参数,手动修改前先记录原值。仍无法确认时,向你的服务商核对订阅有效性;交流时隐藏链接中的身份参数。

Connectivity Test 超时或服务器无法使用

先确认已经点选预期的服务器,再核对 Type、地址、端口和认证信息。需要 TLS 时检查 SNI 与相关传输参数,避免把域名、地址和主机字段相互替换。检查 iPhone 或 iPad 的系统日期与时间是否准确,错误时间可能影响证书验证。不要通过随意关闭安全校验来掩盖参数问题。

接着在已有服务器中选择另一条已知可用的条目,保持路由姿态与目标不变做对照;也可在允许的情况下切换当前网络后重测。如果仅某一网络失败,应优先考虑该网络到服务器的可达性;如果所有网络都失败,再核对账户状态与服务器资料。测试结果仍需与实际页面访问结合判断。

开关开启后立即关闭

先检查系统 VPN 授权是否完成、是否有其他系统 VPN 正在切换连接,以及设备管理是否施加限制。再确认当前配置能够被客户端正常读取。如果刚修改过 Config,先恢复此前可用的配置,再测试开关。连接无法保持与服务器响应慢不是同一个问题,不宜混在一起处理。

若 On Demand 已启用,检查其条件是否在当前网络下自动连接或断开。首次验证时应先理解这些条件,必要时暂时停用自动触发并记录改动,完成手动测试后再按需要恢复。反复点按开关会让状态变化更难追踪,应等本次操作完成再继续。

部分页面正常,部分页面失败

先比较 Proxy 与 Config 对同一目标的结果。若只有 Config 失败,检查规则顺序、命中的策略和目标是否被 REJECT;若两个姿态均失败,再检查服务器参数、DNS 与目标本身的状态。不要一开始就替换整份规则,先定位具体请求,避免让已经正常的部分同时发生变化。

DNS 影响域名如何解析,路由规则决定请求如何处理,两者有关联但不是同一设置。出现域名解析错误时,应先核对当前配置与 Settings 中实际生效的 DNS 设置;不要把多个来源的设置混合粘贴。详细参数与日志阅读方法放在选项手册中,本页只保留首次连接所需的排查顺序。

完成排查后,回到连接验证步骤重做同一组检查。确认可用后,再按日常需要选择 Config 并逐项调整设置。后续每次修改都保留可恢复的起点,比同时更改服务器、规则与 DNS 更容易维护。