官方手册 · 首次连接

Shadowrocket 入门指南

按导入、选路、连接、验证、排查的顺序操作。首次使用先完成一条可验证的连接,再调整规则与自动连接设置,避免一次改变多个条件。

准备好信息后,先确认拿到的是一条服务器分享信息,还是能更新多个条目的订阅地址。两者填写位置不同,不能仅凭链接外观判断;不确定时向提供该信息的服务商核对类型。订阅地址、密码和二维码可能包含访问凭据,请不要放进公开截图或留言。

01 · Add Server / Subscribe:添加已有信息

打开 Shadowrocket,进入 Home。首次使用时,列表中可能还没有服务器条目,这是尚未导入信息的正常状态。点击右上角加号进入 Add Server,随后根据手中的信息选择导入方式。先完成下面其中一种即可,不需要为了开始使用而把同一份信息重复添加多次。

已有订阅链接:选择 Subscribe

在 Add Server 的 Type 中选择 Subscribe,将自己的完整订阅地址填写到 URL,给它设置容易辨认的名称后保存。粘贴时留意地址前后是否混入空格、换行或说明文字,不要删除地址中问号后的参数,这些参数可能用于识别自己的订阅。保存并等待更新完成,再回到 Home 查看订阅分组及其下的服务器条目。

看到订阅名称并不一定表示服务器已经导入成功。继续展开或查看对应分组,确认实际出现可选服务器;如果只有分组、没有条目,应先检查订阅更新结果,而不是立即打开连接开关。更新失败时,保留原地址进行核对,确认订阅仍有效、当前网络可以访问该地址,并向服务商确认输出格式适用于 Shadowrocket。不要为了让它显示内容而随意替换地址中的参数。

已有单个服务器:按协议填写

如果拿到的是服务器参数,在 Add Server 里先选择与资料一致的 Type,再填写地址、端口和认证信息。不同协议显示的字段不同,例如某些类型使用 Password,某些类型使用 UUID;这些值不能互换。服务器地址、TLS 相关名称与传输路径也可能各有用途,应逐项照原资料填写,不要把几个看似相近的字段合并成一个值。协议字段的详细含义可另查协议技术参考。

若已有服务商提供的二维码,可从 Home 的添加入口使用 Scan QR Code,导入后仍需查看条目详情并核对类型和地址。扫描只是减少输入,并不证明信息仍然有效。保存后返回 Home,点选准备使用的服务器,确认它处于选中状态。至此完成的是“把信息放进客户端”,下一步还要决定哪些连接交给它处理。

02 · Global Routing:确定连接姿态

在 Home 点击 Global Routing,选择配置(Config)、代理(Proxy)或直连(Direct)。这三项决定连接如何选路,不是三种服务器协议,也不代表不同速度等级。首次验证时应明确记住当前选择,否则同一服务器在不同姿态下出现不同访问结果,很容易被误认为参数忽然失效。

配置(Config):按已有规则分流

日常需要规则分流时选择配置(Config)。它依据当前启用的配置处理连接,因此选择之前先进入 Config,确认已有可用配置且选中的是预期那一份。规则通常按从上到下的顺序匹配,命中后使用对应策略;DIRECT 走直连,PROXY 交给代理策略,REJECT 拒绝连接。配置中如使用策略组,还需确认组内实际选择,不能仅凭 Home 选中某个服务器就推断所有策略组都会采用它。

如果当前没有自己的有效配置,不要只选择 Config 后就假定分流已经完成。先用下一种姿态验证服务器,再回头整理配置。不要在不了解内容的情况下覆盖已有 Config;有旧配置时先保留副本,后续只修改需要检查的规则。关于 Rule 匹配边界和配置恢复的较长说明,可在FAQ中继续查阅。

代理(Proxy)与直连(Direct):用于明确路径

代理(Proxy)适合短暂检查所选服务器是否能够处理实际请求。它通常把由客户端处理的连接交给代理路径,便于先将规则因素与服务器因素分开;但服务器可用性仍取决于地址、参数和网络。验证结束后,如需按规则使用,应切回配置(Config)并再次验证,而不是把一次 Proxy 测试结果当作分流配置正确的证明。

直连(Direct)让由客户端处理的连接采用直连路径,不用于证明代理服务器已经可用。需要对照网络基线时可以使用它,但更改后应记得恢复预期姿态。选好 Global Routing 后返回 Home,确认服务器选中状态仍然正确,再进行首次连接。

03 · Home:打开开关并允许 VPN 配置

回到 Home,先看一次所选服务器和 Global Routing,再打开顶部连接开关。首次连接时,iPhone / iPad 可能弹出添加 VPN 配置的系统提示。确认这次操作来自刚刚打开的 Shadowrocket 后允许添加,并按系统提示使用设备密码或生物识别完成验证。这里授权的是设备创建本地 VPN 配置的能力,不是在购买或开通服务器。

授权完成后返回 Shadowrocket,观察连接开关能否保持开启,客户端是否显示已连接。若系统设置中出现 VPN 状态,也只能说明系统侧连接配置已启用;它不是服务器的可用性报告。服务器密码错误、目标域名解析异常或规则走向不符时,仍可能保持连接状态,所以还要完成下一节的实际访问验证。

如果点开后立即关闭,先回想首次系统提示是否被取消。可以打开系统 Settings,搜索 VPN,检查是否存在对应配置,以及设备是否受到管理限制。若设备由学校或单位管理,应遵循其管理要求;不要在不清楚作用的情况下删除其他 VPN 配置或描述文件。另一个正在工作的 VPN 也可能影响连接,测试前先明确当前由哪个配置承担连接。

首次上手建议先维持手动连接,不急着启用 On Demand。自动连接会让设备在网络变化后再次建立连接,容易干扰“关闭后作对照”的判断。手动验证通过后再阅读 On Demand 的适用条件。连接途中也不必反复快速切换开关:等状态稳定,记录实际出现的错误,再进入下一步,比连续重试更容易保留故障线索。

04 · Connectivity Test:验证测试与实际访问

先在 Home 使用 Connectivity Test 检查服务器条目的可达性,观察所选条目是否返回结果。它适合快速发现明显超时,但测试方式和目标会影响结果,因此不要把一次显示的数值当作完整体验,也不要把某个测试超时直接等同于所有请求都会失败。测试完成后,保持当前服务器与 Global Routing 不变,再进入浏览器做实际访问。

打开一个平时熟悉、当前应当正常工作的网页,先看能否完成加载,再换一个不同站点确认。只测试一个页面时,目标网站本身的故障、缓存内容或登录状态都可能干扰判断。看到页面不等于已经验证代理路径;需要结合 Global Routing 与当前 Config 的 Rule,确认这次请求本来应该采用 DIRECT 还是 PROXY。

如客户端的连接记录提供该请求的匹配信息,可核对目标域名、命中的规则与策略。使用配置(Config)时,某个站点正常直连可能正是规则预期;不能因为它没走代理就认定连接没有生效。相反,如果预期交给 PROXY 的请求没有按计划处理,应检查规则顺序、配置选择及策略组,而不是马上更换服务器资料。

为了形成清楚的对照,可以记下三个结果:当前姿态、Connectivity Test 是否返回、浏览器实际请求是否成功。必要时只切换一次代理(Proxy)复测同一目标:Proxy 正常而 Config 异常,优先考虑规则或策略配置;两者都失败,则继续检查服务器参数和网络。复测完成后恢复日常需要的姿态,避免将临时诊断状态留作长期设置。

最后,先关闭再重新打开浏览器中的目标页面,减少旧缓存带来的误判。不要通过连续刷新同一页面推断所有应用的连接状态;不同应用可能保持已有连接,需要重新发起请求才能观察设置变化。能够说明“选了什么、请求走向哪里、结果如何”,才算完成这次首次验证。

05 · 常见失败点:按层检查,不同时改多项

连接失败时,从最先没有达到预期的步骤开始。尚未导入成功,就先修复导入;服务器测试持续超时,就先确认参数;只有配置(Config)结果不符,再检查规则。把问题按层拆开,可以避免在本来正确的地方继续修改,导致原先一个错误变成多个错误。

  1. Home 没有可选服务器:检查订阅下是否实际产生条目,更新时是否报错,以及是否误把单个服务器信息填到了 Subscribe。仅有一个订阅名称不代表内容已解析完成。向自己的服务商核对格式和有效状态,不需要先更改 Global Routing。
  2. 有条目,但 Connectivity Test 超时:进入条目详情,逐项核对地址、端口、Password 或 UUID,以及 TLS 和传输参数。字符大小写、路径开头的斜杠、复制时漏掉的尾部内容都值得检查。不要凭印象把端口改成常见值,必须以自己的原始资料为依据。
  3. 测试与请求均失败:检查设备日期、时间和时区是否正确,先启用系统自动设置后重试。时间偏差可能影响证书或认证。随后在条件允许时分别使用 Wi-Fi 与蜂窝网络测试,同一轮测试保持服务器和参数不变;仅一个网络失败时,记录网络差异,不急着重建全部配置。
  4. 连接开关无法保持:回到系统 VPN 设置确认添加权限与当前连接配置,再检查是否有其他 VPN 正在接管连接。如果系统有设备管理限制,应联系设备管理方确认。只在理解影响并保留原配置的前提下处理冲突,不随意删除证书或重置整台设备网络。
  5. Proxy 可用,Config 不符合预期:确认 Config 中启用的是正确文件,检查目标请求命中的 Rule 和对应策略。较早命中的宽泛规则可能使后面的细分规则没有机会执行;策略组指向失效条目时,也会出现服务器单独测试正常而实际连接失败的情况。
  6. 只有某个网页或应用异常:先区分目标服务故障、域名解析失败和连接路径错误。不要马上关闭 TLS 验证或大范围更改 DNS。记录异常域名、错误提示、当前网络和路由姿态,再阅读FAQ 的规则与故障排查说明,按对应现象继续处理。

每完成一项修改,都回到同一个验证目标重新测试,并记录结果是否变化。向服务商核对时只提供必要的错误现象、协议类型和脱敏参数,不公开完整订阅地址、认证信息或二维码。如果需要理解协议字段为何不同,再阅读协议技术参考;首次上手不必先学完所有协议才能建立连接。

完成后保留一份明确的使用记录:已有信息已导入、选中了哪个条目、Global Routing 采用哪种姿态、测试与实际访问分别是什么结果。后续更新订阅或调整 Config 时,每次只改变一层并重复验证。这样即使网络环境变化,也能从上次成功的状态开始检查。