官方手册 · 操作教程
Shadowrocket 使用教程 订阅导入与连接检查
按“准备信息 → 导入 → 选择路由 → 连接 → 验证”的顺序操作。先用一个服务器确认完整流程,再整理订阅与规则,避免同时修改多处设置。
首次操作建议从第一步开始。已有列表但无法访问时,先跳到第四步确认现象,再按第五步定位,暂时不要删除原有配置。
STEP 01 / IMPORT
添加服务器或导入已有订阅
先判断手中的信息属于哪一种:一条用于更新服务器列表的订阅链接,还是一台服务器的地址、端口与认证参数。两种资料的填写位置不同,不能把订阅链接直接填入服务器地址栏。打开 Shadowrocket 后进入 Home,查看已有列表;如果已经存在同一来源的分组,先确认是否需要更新原分组,避免反复添加产生重复条目。
已有订阅链接:从 Add Server 选择 Subscribe
在 Home 点击右上角添加按钮,进入 Add Server。打开 Type 选择项,选择 Subscribe,然后把完整订阅链接粘贴到 URL 栏。为它填写一个自己容易辨认的名称,保存后回到 Home,等待订阅内容加载。名称只用于辨认,不会改变订阅对应的连接参数。
粘贴前检查链接是否完整,尤其留意末尾参数有没有被聊天软件换行、截断或附带空格。订阅地址通常包含个人访问凭据,不能仅凭域名相同就认为两条链接等价。需要重新获取时,应从你自己的服务商处取回完整链接,不要拼接别人提供的参数,也不要将链接提交到不熟悉的网页测试。
返回 Home 后,应能看到分组及其中的服务器条目。如果只出现分组名称而没有内容,先查看是否有更新失败提示,再检查当前网络能否取得订阅内容。订阅更新失败与某台服务器无法连接是两个阶段的问题:前者尚未取得列表,后者是在已有参数的情况下建立连接失败,后续排查不要混在一起。
已有单台服务器信息:逐项核对 Type 与参数
若手中是单台服务器资料,同样从 Add Server 开始,但 Type 应选资料中对应的协议,而不是 Subscribe。按原资料填写服务器地址、端口及认证信息。不同协议显示的字段会有所差别;填写密码、加密方式或其他连接参数时,以你的服务器实际配置为准,不能用另一份教程的示例值替换。
只有在资料明确要求时才填写额外的传输与 TLS 相关选项。域名、路径及其他字段可能区分大小写,缺少其中一项也可能导致连接失败。若拿到的是可导入的二维码,可以使用应用提供的 Scan QR Code,导入后仍应打开条目检查协议和地址是否符合预期。二维码只是资料载体,并不证明服务器有效。
保存后回到 Home,点击准备使用的服务器,确认它成为当前选择。先保留一个明确的测试对象,不要在每次测试前随机切换。到这里完成的只是“把连接资料放进应用”,还需要选择流量如何处理,再建立系统连接。
STEP 02 / GLOBAL ROUTING
选择 Global Routing 姿态
在 Home 打开 Global Routing。这里决定流量按什么方式处理,与“当前选中了哪台服务器”是两个不同设置。首次使用时先看清当前选中项,再根据目的选择配置(Config) / 代理(Proxy) / 直连(Direct)。选好后返回 Home,不要只停留在选项页面而忽略实际生效的状态。
配置(Config):按当前配置中的规则处理
Config 会根据当前使用的配置决定请求走向。规则可能将一部分请求交给 PROXY,将另一部分交给 DIRECT,也可能使用 REJECT。因此,选中服务器并不代表每个请求都会经过它。如果你已有可信且适用于当前环境的配置,先到 Config 查看当前启用的是哪一份,再回到 Global Routing 选择 Config。
订阅和配置不要混为一谈:Subscribe 主要用来取得并更新服务器信息,Config 则承载规则等设置。导入订阅后,不等于已经导入了一套符合你需要的分流规则。初次检查时不必立刻编辑 DOMAIN-SUFFIX、GEOIP 或 FINAL;先确认当前配置及其用途,复杂规则问题再查阅分流相关常见问题。
代理(Proxy):用于对照检查代理连接
当你不确定是规则没有匹配,还是当前服务器本身不可用时,可以暂时选择 Proxy,保持同一服务器和同一测试页面不变,做一次对照。它用于按代理姿态处理流量,但不应据此推断所有系统流量都必然经过相同路径。若 Proxy 下能访问而 Config 下失败,排查重点应转向当前配置、匹配策略及名称解析,而不是立即删除订阅。
直连(Direct):检查直接访问路径
Direct 用于按直接连接方式处理流量,不适合用来验证代理服务器是否有效。它可以作为基础网络检查的一部分,但和关闭系统连接并不完全是同一个操作。测试结束后,回到 Global Routing 恢复需要的姿态,并记住当前设置;后面的每次验证都应说明是在 Config、Proxy 还是 Direct 下完成的。
STEP 03 / CONNECT
打开连接开关并完成系统授权
回到 Home,依次确认服务器选择和 Global Routing 当前项,再打开顶部连接开关。首次建立连接时,系统可能弹出添加 VPN 配置的授权提示。确认提示是在刚刚主动连接 Shadowrocket 后出现,再选择允许,并按设备要求完成密码或生物识别认证。这里授权的是建立系统网络连接所需的配置,不是为服务器自动补齐缺失的参数。
如果刚才取消了提示,应用就可能无法继续连接。返回 Home 再次尝试,留意是否重新出现授权窗口。若仍无法完成,可在系统 Settings 中查看 VPN 相关配置与状态;不同系统版本的入口文字可能有所变化,应以设备实际显示为准。不要为了排查而随意删除工作或学校管理的网络配置,受管理设备应先确认相关限制。
授权完成后回到应用,观察开关能否保持开启,以及系统是否显示已建立 VPN 连接。若开关立即回落,先记录应用提示,再检查授权状态和当前服务器资料,不要持续快速重复点击。若设备已有其他 VPN 连接,应先明确当前由哪一项管理连接,避免在切换过程中把旧状态误认为本次操作的结果。
连接开关保持开启只说明连接流程进入了下一阶段,不能证明目标网站已经能够访问。服务器认证、域名解析、远端可用性与规则处理仍可能出现问题,所以接下来必须进行实际访问检查。此时先不要调整 On Demand 等自动连接选项,手动流程稳定后再考虑自动化,能够减少排查变量。
STEP 04 / VERIFY
使用 Connectivity Test 与实际访问验证
先在应用中使用 Connectivity Test,查看当前服务器的测试结果。测试反映的是特定测试方法和目标下的响应情况,适合作为初步线索,不代表所有网站、应用或传输方式都能正常工作。出现响应时仍需继续访问目标页面;测试没有响应时,也应结合实际访问和错误提示判断,不能只凭一个结果修改全部设置。
保持连接开启,切换到浏览器,打开一个自己熟悉、能够辨认内容是否正常的页面。必要时重新加载,或新开一个页面减少旧缓存的干扰。先观察是否能完成加载,再看登录、图片或其他必要内容是否正常。如果只测试浏览器已经保存的页面,即使断开网络也可能看到部分内容,这不能作为连接成功的依据。
接着选择另一个用途不同的页面作对照。记录当前网络是 Wi-Fi 还是蜂窝、Global Routing 选项、当前服务器及访问现象。如果两个页面表现不同,不要立刻把问题归结为客户端整体失效;可能是规则走向不同,也可能是目标网站自身状态、DNS 或远端连接条件不同。
需要判断规则是否按预期工作时,查看应用当前提供的连接记录或诊断信息,重点找目标域名对应的处理策略。Config 下出现 DIRECT 并不必然是错误,要结合规则的预期用途;只有当本应使用 PROXY 的请求实际走了其他策略,才继续检查对应配置。Data 中的流量变化可辅助观察活动,但不能独立证明某个页面经过了指定服务器。
如果暂时改过 Proxy 或 Direct,现在恢复原先需要的 Config,再重试同一页面。只有在目标路由姿态下也能复现正常结果,才算完成本次流程。若结果不一致,保留现有配置和测试记录,进入下一步按层排查,不要用反复重装代替定位。
STEP 05 / TROUBLESHOOT
按顺序排查常见失败点
排查时每次只改变一个条件,再重复第四步的同一组测试。先记下问题属于“订阅无法加载”“连接开关不能保持”“已连接但所有页面失败”还是“仅部分页面失败”。这四种现象对应的环节不同;把现象分清,通常比同时更换服务器、配置和 DNS 更容易得到可用结论。
先确认基础网络,再检查订阅内容
关闭 Shadowrocket 的连接,检查当前网络本身能否打开平时可直接访问的页面。公共 Wi-Fi 可能需要先完成网络登录;基础网络尚未可用时,先处理网络问题。然后回到应用更新你已有的订阅。更新失败时,检查链接完整性、服务状态与返回提示;更新成功但没有条目时,向你自己的服务商核实链接内容与有效状态。
不要通过连续重新添加同一链接来尝试修复,这只会让列表更难辨认。也不要把“旧条目仍然显示”当作更新成功的证明,旧列表可能仍被保留。需要反馈时只描述错误提示和发生阶段,订阅链接中的个人参数不应出现在公开截图或消息里。
连接失败:核对参数与系统授权
若服务器已经出现在 Home,但连接仍失败,打开该条目,逐项比对 Type、地址、端口、认证信息及资料要求的附加字段。优先修正明确不一致的字段,不要随意尝试所有选项。手动添加时遗漏参数、导入资料过期,以及设备上的系统授权未完成,都可能表现为连接失败,但处理方法不同。
若同一服务器只在某一种网络下失败,可在条件允许时切换 Wi-Fi 与蜂窝作一次对照。保持其他设置不变,避免把切换服务器带来的差异误判为网络差异。远端服务器是否运行、账户是否有效及连接限制,需要由你自己的服务商或服务器管理者核实。
部分页面失败:检查 Config、DNS 与测试条件
若 Proxy 下可用而 Config 下失败,先确认 Config 中当前启用的文件,再检查目标请求对应的策略。修改前保留原配置;一次只改一条相关设置,测试后记录结果。若域名访问失败而其他请求仍有响应,DNS 是检查方向之一,但不能仅凭这一现象确定原因,更不应直接套用来源不明的整套设置。
若只有单个网站失败,还应考虑网站本身的服务状态或访问要求。测试同一页面时尽量使用相同浏览器与网络条件;涉及登录的页面,也要区分账户问题和网络错误。错误提示能提供线索,单纯的“打不开”不足以判断发生在哪一层。
整理脱敏信息,再查具体问题
仍无法定位时,整理设备系统、当前 Global Routing 姿态、协议类型、基础网络是否正常、Connectivity Test 现象及具体错误文字。可以说明修改过哪些设置,但不要包含订阅完整地址、密码或二维码。前往连接故障常见问题按现象继续检查;需要核对 App Store 获取、设备恢复或商店地区时,阅读获取指南,不要把安装问题和连接问题混为一项。
完成后保留的三项信息
确认当前选中的服务器、Global Routing 姿态和 Config 文件名称。下次出现访问变化时,先对照这三项以及当前网络,再决定是否需要更新订阅。准备调整配置或迁移设备前,先保留现有设置;详细问题集中在常见问题继续查阅。
返回第一步重新核对