官方手册 · 快速上手

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

以 iPhone / iPad 界面为例,从已有的订阅或服务器信息开始。依次完成导入、选择 Global Routing、打开连接和实际访问验证;遇到问题时按发生阶段回查。

  • Home → Add Server
  • Config / Proxy / Direct
  • Connectivity Test → 实际访问

第一步:Add Server 添加与订阅导入

先确认手中资料属于哪一种:一整条订阅链接、单个服务器的分享内容,还是地址、端口与认证参数组成的服务器信息。三者的导入方式不同。不要把订阅链接直接当成服务器地址填写,也不要仅凭服务器名称判断协议。打开 Shadowrocket 后进入 Home,点击右上角加号进入 Add Server,再按下面两条路径选择一种操作即可。

已有订阅链接:选择 Subscribe

在 Add Server 中点开 Type,选择 Subscribe,将自己的完整订阅链接填入 URL,并在备注项写一个便于辨认的名称,然后保存。复制链接时应包含完整的查询参数;从聊天记录或笔记中复制后,尤其要检查首尾空格、换行以及误带的中文标点。订阅链接可能包含访问凭据,不要把它粘贴到公开页面,也不要向他人展示完整内容。

保存后返回 Home,检查订阅是否已拉取出服务器列表。若只出现订阅名称但没有服务器,先查看是否有错误提示,再在对应订阅的操作菜单中执行更新。订阅地址本身需要通过当前网络访问;客户端尚未连接时,无法访问订阅地址也会导致初次更新失败。这与“服务器已经导入但连接失败”是两个阶段,应分别处理,不要连续重复添加同一条订阅。

看到服务器条目后,点选其中一个作为首次验证对象。如果有多个分组,先记住这次选择的订阅和服务器名称,后面测试时保持不变。更新订阅会重新读取远端内容,可能改变服务器数量或参数;因此初次验证期间不必反复更新,更不要同时手动改写多个服务器字段。

已有单个服务器信息:按实际协议填写

仍从 Home 的加号进入 Add Server,在 Type 中选择与你已有信息一致的协议,例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard。接着逐项填写地址、端口以及该协议要求的认证与传输参数。不同协议的必填项并不相同,密码、UUID、密钥、TLS 和传输设置也不能互相替代;应以你持有的完整参数为准,而不是凭经验补齐。

填写完毕后保存,回到 Home 检查新增条目是否出现。若使用二维码,可通过 Scan QR Code 读取自己已有的分享内容,识别后仍需确认协议和必要字段。任何导入方式都只是把信息写进客户端,并不证明服务器当前可用。完成这一阶段的标准是“列表里有正确条目且可以选中”,下一步再决定这些条目如何参与流量处理。

第二步:选择 Global Routing 姿态

在 Home 点击 Global Routing,先看清当前选项,再决定是否切换。三种姿态写作配置(Config)/代理(Proxy)/直连(Direct)。它们决定连接的处理方式,不是三份服务器列表,也不会为设备创建新的订阅。首次上手时,应先验证服务器能否工作,再考虑更细的规则分流,避免把服务器问题与配置问题混在一起。

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

代理(Proxy)适合用作首次连接的对照条件:客户端接管的连接使用当前代理选择,便于检查刚导入的服务器能否完成实际请求。选好 Proxy 后返回 Home,再确认选中的是准备测试的服务器。此时先不要同时修改 DNS、传输参数或配置规则;保持条件简单,后面的测试结果才容易解释。

配置(Config):使用当前配置中的规则

配置(Config)按当前启用的配置规则处理连接。打开 Config,确认已选中的配置是准备使用的那一份,再返回 Home 选择配置(Config)。规则可能将不同目标分别交给 PROXY、DIRECT 或其他已定义策略,因此“已连接”不代表每一个请求都经过同一台服务器。订阅导入解决服务器列表,Config 解决规则与策略,两者不要混为一谈。

例如,下面的规则表示匹配相应域名后采用 PROXY 策略。这里只用于认识语法,不要求首次上手就把示例写入配置;单独复制一行也不能代替完整配置。

DOMAIN-SUFFIX,example.com,PROXY

直连(Direct):建立不经代理转发的对照

直连(Direct)表示连接不经代理服务器转发,适合检查基础网络是否可用,或与 Proxy 下的同一请求进行比较。它不会修复无效订阅,也不能证明服务器正常。需要注意,在应用内选择 Direct 与彻底关闭连接开关是不同操作:前者仍是客户端中的一种处理姿态,后者是停止当前连接。选定用于测试的姿态后,再进入下一步打开连接。

第三步:打开开关并确认连接权限

回到 Home,先确认服务器条目处于选中状态,再检查 Global Routing 是否仍为刚才决定的姿态,最后打开顶部连接开关。顺序很重要:如果没有确认服务器和模式就直接打开,后面即使访问成功,也可能无法判断实际使用的是哪个条目或哪种处理方式。

首次连接时,系统会提示添加 VPN 配置。阅读提示,确认这是刚刚主动发起的 Shadowrocket 操作,再按系统要求允许,并使用设备密码或生物识别完成确认。这里的 VPN 配置是系统提供的网络连接权限,并不是另一份订阅。若取消了这一步,回到应用后可能仍然无法建立连接,需要重新打开开关并完成系统确认。

确认权限后返回 Shadowrocket,观察开关及连接状态是否保持。部分设备会在状态栏或控制中心显示 VPN 标识,但标识只能说明系统连接状态,不能单独证明目标页面已经通过预期路径访问。若开关立即回落,优先检查应用显示的错误与系统权限,而不是先改动规则。设备如果正在使用其他 VPN 连接,应先停止不需要的连接,避免测试对象不明确。

本轮手动验证期间,可以暂不配置 On Demand。它用于按条件触发连接,与当前的手动开关不是同一件事。先把“手动打开后保持连接、目标可以访问”这条基础流程完成,再根据实际需要了解按需连接。到此仍只完成了连接动作,下一步需要通过测试和真实请求确认结果。

第四步:Connectivity Test 与实际访问验证

先使用 Connectivity Test 对列表中的服务器做连通性检查,并留意测试方式。测试返回的时间只反映本次测试目标与当时网络条件,不能等同于网页下载速度,更不能保证所有应用的请求都成功。某个条目能得到结果,可以作为继续验证的依据;出现超时则说明需要进一步检查,但还不能仅凭一次结果认定是哪一个参数有误。

接着打开浏览器,访问一个你平时有权使用、并且知道正常表现的页面,发起新的请求。不要只盯着已经加载好的旧页面,因为缓存可能让页面在网络异常时仍然显示。必要时刷新页面或重新进入目标应用,再检查是否能持续加载文字、图片及后续内容。保持同一个服务器、同一个模式与同一个网络,先完成一轮稳定的观察。

随后返回 Shadowrocket,在 Data 查看测试期间是否出现流量变化。流量变化说明有连接活动,但后台同步也可能产生数据,因此它是辅助证据,不能替代实际访问结果。同样,在配置(Config)下看到流量,并不表示某个指定域名一定命中了 PROXY;需要结合当前规则和应用内可见的连接记录判断。

如果结果不明确,采用单变量对照:记录当前服务器与模式,先用代理(Proxy)测试同一目标,再切换直连(Direct)重新发起请求,其他设置保持不变。若 Proxy 成功而 Config 失败,应优先检查配置选择和规则;若 Direct 也无法访问平时正常的页面,应先确认 Wi-Fi 或蜂窝网络本身。网络切换会改变条件,切换后要重新做一轮测试,不要把两轮结果直接混在一起。

验证通过后,再选择日常所需的模式。有有效规则配置时可使用配置(Config),需要统一使用当前代理时再选择代理(Proxy)。首次流程的完成标准不是某个图标变色,而是服务器选择明确、模式符合预期、连接保持,并且目标应用能够完成实际请求。

第五步:按失败阶段回查,不同时改多处

出现问题时,先回答“卡在哪一步”,再决定检查对象。保留原来的可用信息,每次只调整一个条件并重新测试。连续删除订阅、重建服务器、切换模式和修改 DNS,会让前后结果失去可比性;重复导入同一内容还可能留下名称相似的条目,增加选错服务器的机会。

导入失败或服务器列表为空

先检查链接是否完整、是否仍有效,以及当前基础网络能否访问订阅地址。网页地址、订阅地址与单服务器分享内容不是同一种数据,应回到 Add Server 检查 Type 是否选为 Subscribe。若出现认证、到期或内容格式提示,应向你已有服务的提供方核对原始资料,不要通过反复改写链接参数碰运气。详细说明见问答中的订阅与节点导入分类。

条目已出现,但连接测试或实际请求失败

手动添加的服务器先逐项核对协议、地址、端口和认证参数;涉及 TLS 或其他传输选项时,也应与原始资料逐项对应。由订阅生成的条目则优先确认订阅更新结果,避免把临时手动修改当成长期修复。可以选用自己列表中的另一个已有条目进行同样测试,但一次只更换服务器,保持模式和目标不变。

连接开关无法保持

返回系统设置检查 VPN 配置是否已获允许,并确认设备没有尚未处理的权限提示。受管理的设备可能限制 VPN 配置,遇到明确的管理提示时应联系设备管理员。不要把权限问题当成规则问题;在开关无法保持的阶段,修改 DOMAIN-SUFFIX 或其他规则通常不能解决连接权限本身。

Proxy 可用,Config 下部分目标失败

先到 Config 确认当前启用的配置,再检查相关目标是否被规则分到预期策略。规则顺序、DIRECT 与 PROXY 的选择以及最终兜底规则都会影响结果。如果只有部分域名异常,还要结合 DNS 和连接记录继续判断,但不建议第一次使用就同时替换整份配置与 DNS 设置。规则、DNS 及 Settings 的系统化说明见完整手册。

测试偶尔成功,切换网络后又失败

先在同一种网络下重复实际请求,确认是否存在可复现的条件,再分别记录 Wi-Fi 与蜂窝网络的表现。测试数字低并不意味着持续传输一定稳定,单个页面失败也不代表所有连接失效。需要进一步求助时,提供所处步骤、模式、协议类型和已隐去敏感信息的错误提示即可;不要发送完整订阅链接、密码或密钥。

日常使用时,记住一条最短检查顺序:先看基础网络,再看服务器选择,再看 Global Routing,最后检查配置与目标请求。更新订阅或调整设置后,都按第四步重新验证一次。更复杂的多订阅维护和诊断留到基础流程稳定后再做,避免让首次连接承担过多变量。