官方手册 · 首次连接
Shadowrocket 使用教程订阅导入、连接与规则分流
先让一个已有服务器正常连接,再核对规则是否按预期工作。以下操作以 iPhone / iPad 界面为例,按五步顺序完成,不需要在首次连接时修改所有设置。
先确认信息类型
Add Server:添加服务器与订阅导入
打开 Shadowrocket,先停留在 Home。下方 SERVER 是查看和选择服务器的位置;首次使用时,应先把自己的信息加入列表,而不是直接打开顶部开关。订阅地址、单个服务器分享链接和配置文件用途不同,不能仅凭它们都能复制为文本就混用入口。先看已有资料说明的是一组服务器的更新地址,还是某一个服务器的连接参数,再决定下面的导入方式。
已有订阅链接:选择 Subscribe
在 Home 打开 Add Server,进入 Type 后选择 Subscribe,再返回填写页面,把完整的已有订阅地址粘贴到 URL 字段。备注用于辨认这组服务器,可以写成自己容易区分的名称。保存前检查地址前后是否夹带空格、换行或聊天记录中的说明文字;地址中的参数属于完整链接的一部分,不要只保留问号前的路径,也不要把其中的认证参数改成示例文字。
保存后回到 Home,等待订阅内容读取完成,检查 SERVER 中是否出现对应分组和服务器条目。只保存了订阅名称但没有服务器,并不代表导入已经成功;此时先确认订阅更新结果,再继续连接。后续想获取这组服务器的变动,应更新原来的 Subscribe 条目,而不是每次重复添加同一个地址。订阅链接通常带有访问凭据,截图、求助或备份时都应注意保护。
已有单个服务器信息:按 Type 填写
如果拿到的是服务器地址、端口和认证信息,在 Add Server 中先选择资料对应的 Type。以 Shadowsocks 为例,再逐项核对 Host、Port、Password、Method;其他协议的字段会随 Type 改变,应按原资料填写。Host 是服务器主机名或 IP,不要擅自加上网页路径;Port 应与资料一致;Password 和 Method 也不能凭记忆替换。协议选择错误时,即使地址和密码看起来正确,也可能无法建立连接。
已有二维码时,可使用 Scan QR Code 导入,并按系统提示允许相机访问;已有单条分享链接时,可复制后返回应用,按导入提示检查内容。导入完成仍要查看 Type、Host 与 Port 是否符合原资料。Import from Cloud JSON 是另一种结构化导入入口,不应把普通订阅地址直接当作 JSON 使用。首次连接只需完成一种合适的导入方式,不必把每种入口都操作一遍。
本步完成标志:Home 的 SERVER 下已有可辨认的服务器,轻点需要使用的条目后,它处于选中状态。先记住所选条目的名称,下一步选择 Global Routing 时仍需保留这个选择。多订阅整理、更新策略和删除备份的详细做法见订阅与服务器管理手册。
确定流量处理方式
Global Routing:选择分流模式
服务器已经加入列表后,回到 Home,轻点 Global Routing 查看当前模式。这里决定流量按哪种方式处理,不负责替你补齐服务器信息。日常希望按配置文件区分代理与直连时,使用配置(Config);临时验证所选服务器能否承担目标访问时,可以用代理(Proxy)进行对照;需要让流量直接连接目标时,使用直连(Direct)。三种模式不是三个不同的服务器,也不是速度等级。
| 模式 | 含义与用途 |
|---|---|
| 配置(Config) | 根据当前配置文件的规则和策略处理流量,适合按规则分流的日常使用。 |
| 代理(Proxy) | 让流量走代理路径,用于明确需要代理的场景或临时对照检查。 |
| 直连(Direct) | 让流量直接连接目标,可用于检查当前网络直接访问的情况。 |
选择配置(Config)后,再进入 Config 确认准备使用的配置文件已启用。Subscribe 管理的是服务器列表,Config 管理的是配置;订阅导入成功,不等于已经自动获得适合所有目标的规则。打开配置文件后,可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次连接只需核对当前配置及 Rule 中的规则意图,不要为了跟随教程同时启用重写或解密功能。
下面三行仅用于理解规则顺序,不是要求覆盖现有配置。DOMAIN-SUFFIX 匹配目标域名后缀,GEOIP 根据目标 IP 的地区匹配,FINAL 处理前面没有命中的流量。规则通常从上到下检查,因此宽泛规则放在前面可能先命中。PROXY 和 DIRECT 是策略名称;如果自己的配置使用自定义策略组,还应确认规则引用的名称确实存在。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
截图中的 Add Rule 是新增规则的入口,但首次连接前不必立即添加规则。先用已有配置完成连接与验证,发现某个目标的处理路径不符合预期后,再修改相应规则。修改前保留原配置,测试时只更改一处,便于恢复。更多设置项说明可查看设置手册;本页后面的生效验证会说明怎样判断模式与规则是否真正符合预期。
本步完成标志:Home 显示预期的 Global Routing 模式;如果选择配置(Config),Config 中也有明确启用的配置文件。接下来回到 Home 建立连接,不要在尚未验证服务器时继续堆叠规则改动。
完成系统连接授权
Home:打开连接开关
回到 Home,再确认一次 SERVER 中所选条目。列表里有多个服务器时,看到某个名字并不意味着它就是当前选择;先轻点要使用的条目,再检查 Global Routing。顶部显示 Not Connected 时,表示当前尚未连接。准备好后打开顶部开关,等待系统或应用给出下一步反馈,避免连续快速切换导致难以判断当前状态。
首次连接时,系统会请求允许添加 VPN 配置。确认提示来自正在操作的 Shadowrocket 后,按系统步骤允许,并根据设备要求完成密码或生物识别认证。这是让客户端接管相应网络流量的系统权限,不是导入订阅的一部分。如果之前取消了授权,服务器列表仍可能保留,但顶部开关无法正常建立连接;应再次发起连接并完成授权,而不是重新添加同一份订阅。
授权结束后返回 Home,观察顶部状态是否从 Not Connected 改变,并保持连接。系统界面也可能显示 VPN 状态标识,但这只能帮助确认网络隧道处于启用状态,不能单独证明远端服务器可用,或每个目标都走了正确的策略。先保持当前服务器和模式不变,进入下一步进行实际访问验证。
如果开关刚打开就恢复关闭,先记录提示内容。检查授权是否完成、是否有其他 VPN 连接正在启用,以及刚才是否误选了信息不完整的条目。处理连接冲突时,只保留本次要测试的连接,再重新操作。不要在这一步同时更换网络、服务器、模式和配置,否则即使偶尔连接成功,也无法知道哪个条件起了作用。
本步完成标志:应用连接状态已改变且没有立即断开。这里先不启用 On Demand;自动触发连接应留到手动连接稳定之后设置,避免排错时刚关闭连接又被条件重新触发。
把连接状态与访问结果分开检查
Connectivity Test:验证是否生效
连接打开后,在 Home 使用 Connectivity Test,先检查服务器的可达性。测试结果应结合所用测试方式理解:某一次测试有响应,说明该测试条件下能够得到反馈,不代表所有网站、所有协议和所有时段都同样可用;某个条目超时,也需要结合实际访问和测试方式进一步确认。不要仅按列表中的一个测试数值反复切换服务器。
接着打开浏览器,访问自己原本要使用的目标,等待页面完成加载,再做一次正常操作,例如打开同一站点中的另一页。为了减少缓存影响,可刷新页面或用新的浏览会话复测。首次验证应使用同一个目标、同一个网络和同一个服务器;只确认一个页面标题出现,或者只看到系统 VPN 标识,都不足以说明整个访问过程正常。
如果使用配置(Config),还需要区分“能访问”和“分流正确”。在 Data 中查看相关连接记录,结合目标域名、命中规则与策略判断实际路径。预期走代理的访问应对应 PROXY 或自己的代理策略组;预期直连的访问应对应 DIRECT。记录显示直连并不一定是故障,可能正是规则的设计结果;反过来,访问成功也可能只是直连成功,不能据此认定代理服务器已经通过验证。
遇到某个目标只有在代理(Proxy)下能使用、配置(Config)下却失败的情况,优先检查 Config 中的规则命中、策略名称与目标解析结果。若两种模式都失败,再回到服务器字段和当前网络检查。直连(Direct)可用于对照目标在当前网络中的直接访问情况,但不同路径的结果差异只是定位线索,不应直接当作某个组件损坏的结论。对照结束后,恢复原来准备日常使用的模式。
至此可以先保持当前设置使用。需要自动连接时再到 On Demand 配置条件,并分别测试条件触发和退出后的行为。添加更多规则、整理多个订阅或调整更新策略属于后续管理工作,详见订阅与服务器管理手册;不必为了完成首次连接一次性做完。
一次只改变一个条件
Settings:常见失败点排查
排查时先分清失败发生在哪一层:订阅取不回来、服务器没有选中、连接开关无法保持,还是连接后某个目标不能访问。不同现象对应的检查位置不同。先记录当前网络、服务器、Global Routing 和具体提示,再按下面顺序回看。每改一项就重新测试同一目标,确认没有改善时恢复原值,避免把原本可用的设置也一起改乱。
Subscribe 更新失败或没有服务器
先检查复制的是否为完整订阅地址,而不是用于打开管理页面的普通网页链接。确认没有空格、换行和被截断的参数,再检查当前网络本身能否正常访问。订阅地址的有效性与客户端是否安装成功是两件事;地址失效、认证条件改变或返回内容格式不符,都可能导致列表没有更新。需要核对地址时,应向自己已有服务的提供方确认,不要把含凭据的完整链接贴到公开场合。
连接建立失败或 Connectivity Test 超时
手动添加的条目优先核对 Type、Host、Port 和认证字段;存在 TLS 或其他传输选项时,也应以原资料为准,不要为了试通随意关闭验证。随后确认系统授权是否完成,再用同一条目在另一个自己可用的网络上对照测试。如果只是测试结果异常,可到 Settings 查看 Test Method,确认测试方式与目标条件适合当前连接;改变测试方式后,应同时检查真实访问,而不是仅比较显示结果。
已连接但页面打不开,或仅部分目标失败
先按上一节在代理(Proxy)与配置(Config)之间做短暂对照。若只有配置(Config)失败,应检查当前启用文件及 Rule 中的命中顺序;若多个目标都失败,则回查服务器和网络。DNS 解析异常也可能表现为页面无法打开,应结合连接记录判断是否取得目标地址。不要在没有线索时成批新增域名规则,也不要把所有失败都归因于订阅更新。
开关自动变化或需要收集诊断信息
到 Settings 查看 On Demand 是否已经启用,以及触发条件是否符合当前网络。排错期间可先暂停自动触发,以手动开关复现问题;确认基线正常后再逐项恢复。需要进一步定位时,可使用 Diagnostics 收集线索,重点保留发生问题的时间、错误提示与复现步骤。分享诊断记录前,遮盖订阅地址、认证参数和个人访问内容,只提供排查所需的信息。
Settings 中还可能看到 Proxy、TCP、UDP 等选项。这些项目并非首次连接必须调整的清单,不应仅因为目标使用失败就逐个随意切换。如果恢复原配置后仍能稳定复现,带着明确的失败现象查看设置说明;涉及订阅分组、服务器字段或更新管理时,再进入服务器管理手册继续定位。
本步完成标志:能说明问题发生在哪一步、哪些条件已经验证、下一项准备检查什么。保留可恢复的配置和一次只改一项的记录,比反复删除重装更有助于缩小问题范围。