OFFICIAL MANUAL / QUICKSTART

Shadowrocket
导入与连接教程

按五步完成一次基本连接:先确认输入信息,再选模式、连接并验证。适用于 iPhone 与 iPad 上的首次操作。

这是官方手册的入门流程。建议预留约十分钟操作与核对;规则语法和系统化诊断另见疑难手册。

STEP 01 / IMPORT

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

先判断手中的资料是什么,再选导入入口。订阅地址通常用于取得一组可刷新的服务器;单条分享链接描述一个服务器;手动参数则由服务器地址、端口、协议和认证等字段组成。三者并不等同,不能仅凭地址看起来以某种格式开头,就把它填入任意输入框。资料类型不明确时,先核对原始说明,不要靠反复尝试不同协议完成导入。

使用 Subscribe 导入已有订阅

  1. 打开 Shadowrocket,在 Home 点右上角加号,进入 Add Server。打开 Type,选择 Subscribe,再填写你自己的订阅地址。
  2. 为这条订阅填写便于辨认的名称,检查地址没有缺失字符、首尾空格或复制时带入的换行。订阅地址可能含有认证信息,应完整粘贴,不要随意删去问号之后的内容。
  3. 保存并返回 Home,等待订阅内容获取完成。正常情况下,列表中会出现订阅分组及其服务器。若只出现订阅名称却没有服务器,先检查是否有获取失败提示,而不是立即打开连接开关。

Config 页面用于管理配置文件;配置文件可能包含规则、DNS 和策略等内容,不等同于服务器订阅。首次操作要分清当前正在添加的是哪一类资料:仅持有服务器订阅时,先按上面的 Add Server → Subscribe 路径完成导入,不要把它当作规则配置文件使用。已有完整配置的用户,也应分别确认配置是否启用、服务器列表是否已经取得。

使用 Add Server 填写服务器参数

如果你持有的是手动参数,在 Add Server 中把 Type 设为资料指定的协议,再依次填写地址、端口和认证内容。选择不同协议后,表单会显示相应字段;加密方式、传输设置、TLS 与服务器名称等内容需要与原始资料一致。不要因为某个字段有默认值就认定可以省略,也不要为尚不理解的字段随意补值。填完后保存,返回 Home 核对名称和服务器是否出现。

若资料是单条分享链接,可在复制后留意应用提供的导入提示,并在确认前核对解析出的协议与地址;若资料是二维码,可使用 Scan QR Code。二维码里仍然可能含有敏感连接信息,不应公开展示。不同导入方法最终都应得到可选中的服务器项;看到名称只是导入完成的线索,还不能证明参数和服务状态有效。

列表准备好后,下一步先确定流量处理方式,再打开连接。

STEP 02 / GLOBAL ROUTING

选择 Global Routing 三种姿态

在 Home 打开 Global Routing,可以选择配置(Config)、代理(Proxy)或直连(Direct)。这里控制的是整体路由姿态,并不是服务器协议,也不会修复错误的连接参数。第一次测试应记住选了哪一种,否则即使网页能打开,也难以判断是代理连接成功,还是实际使用了直连路径。

姿态处理方式入门时的用途
配置(Config)按当前启用配置中的规则与策略处理。在配置已确认后核对分流结果。
代理(Proxy)以所选代理服务器处理连接,具体行为仍受应用及系统设置影响。简化初次测试,核对代理路径是否可用。
直连(Direct)直接连接目标,不以当前代理服务器转发。检查基础网络,作为故障对照。

如果现在只是核对刚导入的服务器能否工作,可以先选代理(Proxy),并在 Home 选中准备测试的服务器。这样能暂时减少规则匹配带来的变量。测试完成后再决定日常使用的模式;不要把“代理模式能打开网页”理解为“配置规则也已经正确”。两者检查的是不同层次,需要分开验证。

使用配置(Config)前,前往 Config 确认当前启用的是你准备使用的配置文件,而不是仅仅把文件保存到了列表。规则通常按顺序匹配,匹配结果决定连接采用哪种策略。导入服务器不会自动生成符合个人用途的分流规则,因此不能根据服务器名称推断某个网站一定走代理。初学阶段不必同时改写规则、DNS 和策略组,先建立一条能够验证的连接路径即可。

直连(Direct)可用于比较连接开关开启与关闭时的基础访问情况,但它不是服务器可用性的证明。如果目标网页在直连时本来就能访问,切换后仍能打开并不能说明代理已经生效。返回 Home 后,再看一遍 Global Routing 的当前值和选中服务器;模式与服务器这两项都确认后,再进行连接授权。

本步核对点:能够说清当前是 Config、Proxy 还是 Direct;使用 Config 时知道启用的是哪份配置,使用 Proxy 时知道选中的是哪个服务器。

STEP 03 / CONNECT

打开开关,完成连接授权

回到 Home,选中一个信息已核对的服务器,再打开顶部连接开关。首次建立连接时,系统可能提示允许 Shadowrocket 添加 VPN 配置。确认提示来自刚才主动发起的操作后,按系统指引完成授权;系统可能要求设备认证。这个步骤是在设备上允许应用建立相应的网络连接配置,并不是购买提示,也不会替你验证服务器信息。

  1. 先观察当前选中项,避免只展开了订阅分组,却没有选中实际服务器。需要比较多个服务器时,一次只测试一个,并记住名称。
  2. 打开连接开关后,按需处理系统授权提示。若先前取消了授权,返回应用重新发起连接,留意是否再次出现提示,不必先删除应用。
  3. 授权完成后回到 Home,检查开关是否保持开启,以及应用是否显示连接相关状态。不要在状态尚未稳定时连续反复切换。

系统 VPN 状态表示相应连接配置正在使用,但不保证远端服务器可达,更不保证所有网站均可加载。某些错误参数会在实际发起请求时才表现出来。因此,本步的目标只是确认“应用可以建立本机连接状态”,下一步还要用测试结果和实际访问共同验证,不能只凭状态标识结束操作。

如果开关立即回落,先看是否有系统提示被忽略或取消,再检查设备是否存在正在使用的其他 VPN 配置。由单位或学校管理的设备还可能受管理策略限制,此时应遵循设备管理要求,不要删除不认识的系统配置。iPad 与 iPhone 的页面布局可能因显示空间而不同,但仍应根据 Home、服务器选中项和连接开关来定位操作,而不是照着某个固定屏幕位置盲点。

第一次验证期间,建议暂时保持当前网络不变,也先不要启用或调整 On Demand。按需连接可能影响后续自动连接行为,如果同时改动,容易把自动重连误认为开关操作失败。若你原本已经设置了 On Demand,先记录其状态;结束测试时若发现连接自动恢复,应先检查该设置,而不是反复关闭同一个开关。

本步核对点:授权由本人主动确认,连接开关能够保持预期状态;没有把系统 VPN 标识当作远端连接成功的唯一依据。

STEP 04 / VALIDATE

Connectivity Test 与实际访问核对

连接开启后,先运行 Connectivity Test,观察选中服务器对应的结果。测试结果可以作为定位线索:超时值得先检查服务器及基础网络,有响应则说明对应测试取得了结果。但测试目标、测试方式与实际网页请求并不完全相同,所以出现时间数值不等于网页一定正常,也不代表所有协议功能都已验证。不要只按数值大小判断连接是否适合当前用途。

接着打开浏览器,访问一个你熟悉且有权访问的网页,确认页面内容能实际加载,而不是仅看到浏览器缓存中的旧页面。可以主动刷新页面,并再验证一个不同网站;若只验证单一站点,站点自身故障可能被误判为整条连接失效。检查时同时记录当前网络、选中服务器和 Global Routing 模式,便于之后做有意义的比较。

  1. 核对基础网络。在允许中断连接的情况下关闭 Shadowrocket,确认原本应能直接访问的网页仍可加载。若基础网络本身异常,先处理 Wi-Fi 登录、信号或蜂窝数据权限等问题。
  2. 核对代理路径。回到应用,确认选中服务器和代理(Proxy),再次打开连接并访问目标。若有自己可信的出口信息查询方式,可把结果作为额外证据;仅看网页能否打开并不足以证明路径。
  3. 核对规则路径。需要分流时再切换为配置(Config),重新发起访问,并结合应用可查看的连接记录核对所用策略。保留切换前后的测试条件,避免把网络变化混入结论。

如果 Proxy 下正常而 Config 下异常,优先核对启用配置和匹配策略,而不是立即换掉服务器;如果所有模式下同一网页都异常,还应考虑网站自身、基础网络和 DNS 等因素。浏览器已有连接也可能影响切换后的观察,必要时关闭相关页面再重新访问。一次只改变一个条件,才能知道是哪一步带来了变化。

验证结束后,把 Global Routing 留在你实际准备使用的姿态。用于测试的 Proxy 不必成为长期默认值,Config 也只有在规则符合预期时才有意义。日常使用前再打开常用应用检查一次,因为网页测试不能覆盖每个应用的连接需求。规则关键字和 DNS 的进一步解释见术语表,持续异常的排查路径见疑难手册。

本步核对点:测试结果与实际网页加载均已查看,当前模式明确;若使用 Config,已确认其行为符合预期,而不是只确认开关处于开启状态。

STEP 05 / CHECKPOINTS

按失败阶段,一次核对一项

出现异常时先回想最后一个已完成的核对点:是资料尚未导入、开关不能保持开启、测试超时,还是测试有结果但网页打不开?这四种现象对应不同环节。直接重装或同时修改大量设置,会丢失原始状态,也难以判断问题来源。先保存已有资料和配置名称,按下面顺序缩小范围,再决定是否需要深入诊断。

导入后没有服务器:先核对资料类型与获取结果

检查粘贴的是订阅地址还是配置文件地址,是否误把网页说明地址当作订阅。再看原始链接是否完整,是否包含复制附带的空格,以及应用是否提示获取失败。订阅地址能在浏览器打开一个页面,并不保证返回内容就是可导入的服务器列表。已有订阅的有效期或访问条件,应向你原有服务商核对;不要在公开讨论中贴出完整地址、二维码或认证字段。已有列表时也不要为排查而反复删除订阅,先保留当前可用信息。

开关无法保持开启:先核对系统授权

返回第三步,检查是否取消了添加 VPN 配置的系统提示,以及设备上是否有其他正在使用的 VPN 配置。受管理设备按管理要求处理。若关闭后又自动连接,检查 On Demand 是否启用,把自动连接行为和手动开关问题分开判断。此阶段还没有证明请求到达服务器,优先核对本机状态,不要一开始就改 DNS。

Connectivity Test 超时:核对服务器和网络

先确认选中的确实是准备测试的服务器,再检查地址、端口、协议和认证参数是否与原始资料一致。对订阅导入项,可在保留现有信息的前提下更新订阅,确认是否有内容变化。随后用自己已有的另一个服务器作对照,或在条件允许时切换 Wi-Fi 与蜂窝网络测试;每次只换一个条件。超时并不能单独证明是哪项参数出错,也不能仅凭一次结果判断服务状态。

测试有结果但网页打不开:区分 DNS、规则与目标站点

先换一个正常的目标网页,确认是单站点还是普遍异常;再对比 Proxy 与 Config。如果只在 Config 下失败,检查当前启用配置及命中策略。如果多个目标都无法解析,再核对 DNS 设置是否被改动,并记录原值后一次调整一项。不要直接复制一整份来历不明的配置覆盖当前内容,因为这会同时改变多个变量。测试正常仅说明相应测试完成,网页涉及的域名解析、传输和站点响应仍可能各自失败。

若上述步骤仍不能定位,整理一份不含敏感信息的记录:设备类型、当前网络、所选模式、是否完成授权、错误提示原文,以及已做过哪些单项对照。服务器密码、完整订阅地址和认证信息不应包含在记录中。接下来可按症状进入疑难手册,或在常见问题查找对应说明,不必把所有设置重新做一遍。