官方手册 / 入门操作

Shadowrocket 使用说明:导入与连接

按“添加资料 → 选择模式 → 连接 → 验证 → 排错”的顺序操作。先建立一次可复现的手动连接,再调整规则与自动连接条件。

操作设备:iPhone / iPad 先核对参数,再调整规则 界面词保留英文原文
步骤 01 / 准备连接对象

Add Server:添加与导入

先辨认资料类型。单个服务器、服务器订阅和 Config 配置文件不是同一种内容。

打开 Shadowrocket 的 Home,找到 SERVER 分组及 Add Server 入口。开始填写前,先查看已有资料:一组地址、端口和认证信息对应手动添加;一个服务器分享链接或二维码对应单条导入;会返回服务器列表的链接对应服务器订阅。包含规则、DNS 或策略设置的配置文件则由 Config 管理。链接都是网址,并不表示它们可以放进同一个入口。

手动填写 Add Server

  1. 点 Add Server,先打开 Type,按已有资料选择协议。协议决定后续显示的字段;截图中的 Password、Method 是对应类型的字段示例,不是所有协议都使用相同表单。
  2. 将服务器地址填入 Host,端口填入 Port。只填字段要求的值,不把完整分享链接塞进 Host,也不把端口附在地址末尾重复填写。
  3. 按资料填写认证与协议相关选项。核对大小写、首尾空格以及复制时是否混入换行。涉及 TLS、传输方式或服务器名称时,按原始参数设置,不凭名称猜测。
  4. 使用页面上的保存操作返回 Home,确认 SERVER 中出现对应条目。备注用于辨认服务器,备注相同不代表地址或认证信息相同。

如果手上是已有服务器的二维码,可以在 Add Server 页面使用 Scan QR Code。扫描后仍需检查识别出的 Type、Host 和 Port,再保存。Import from Cloud JSON 用于匹配该入口要求的 JSON 内容,不应当作任意订阅链接的通用粘贴位置。导入成功只说明资料被应用识别,不等于远端服务器已经连通。

已有订阅:区分服务器列表与配置文件

已有的是服务器订阅时,在 Add Server 中按资料类型选择 Subscribe,将完整订阅地址填入 URL,保存并等待列表获取完成。不要删改链接中的路径与查询参数;这些内容可能参与身份验证。返回 Home 后检查订阅分组是否出现服务器。若只出现分组名而没有条目,应先解决列表获取问题,不要直接进入连接步骤。

已有的是配置文件订阅时,进入 Config,使用其中的 Subscribe 入口添加对应配置地址,获取后核对并选择要使用的文件。Config 的 Subscribe 与服务器列表订阅承担不同任务:前者管理配置内容,后者管理连接对象。不能仅凭链接名称含有“订阅”就互换入口。需要整理多份订阅、确认分享格式或安排更新时,继续阅读订阅与服务器管理手册。

完成这一步后,应当能明确指出 Home 中准备使用的服务器,以及是否已有一个可供规则模式使用的配置文件。接下来选择 Global Routing,而不是立即反复切换连接开关。

Shadowrocket 的 Add Server 官方界面,显示 Type、Host、Port、Password、Method 及扫码导入入口
官方 App Store 截图:Add Server。先选 Type,再按实际显示的字段填写;截图所示字段不代表所有协议的表单。
步骤 02 / 确定流量处理方式

Global Routing:三种姿态

先确定当前希望如何处理流量,再检查配置文件;模式名称不是连接质量指标。

返回 Home,点 Global Routing。本教程将三种姿态写作配置(Config)、代理(Proxy)、直连(Direct),括号内对应应用中的英文选项。选择之后回到 Home,核对 Global Routing 一行实际显示的值。不要仅凭上一次操作的印象判断当前模式。

姿态处理依据与本次用途
配置(Config)按当前启用的配置文件与规则决定策略,适合核对分流结果。
代理(Proxy)按代理模式处理流量,适合先隔离规则因素,验证所选服务器。
直连(Direct)按直连方式处理流量,可作本地网络对照,不用于证明代理服务器可用。

如果第一次添加服务器,尚未准备好规则配置,可以先用代理(Proxy)验证连接对象。验证结束后,再切换到配置(Config)检查实际分流。Proxy 不是对所有故障的修复选项:服务器地址、认证信息或本地网络有问题时,换模式不会补齐这些条件。

Config 模式需要核对哪些内容

选择配置(Config)之前,进入 Config,确认当前选中的文件确实是本次准备使用的文件。打开查看时,可以按截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段辨认内容。初次连接只需核对已有设置,不必为了完成教程逐一启用这些功能;尤其不要把 HTTPS Decryption 当作普通连接的必要步骤。

在 Rule 中,关注访问目标匹配哪条规则、该条规则使用什么策略,以及最后的兜底处理。规则通常按顺序匹配,前面的命中可能让后面的规则不再参与同一次判断。下面仅用于辨认语法,不是要求整段替换现有配置:

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

这组示例分别表达域名后缀匹配、局域网地址段匹配和最终策略。PROXY、DIRECT 是策略词,不是服务器地址。通过 Add Rule 添加内容前,要确认插入位置与已有规则关系;仅追加一条规则而不看顺序,可能得不到预期效果。规则关键字与 DNS 的详细解释见概念速查,本次先保留可核对的最小改动。

到这里应当得到一个明确组合:“选中的服务器 + 当前 Global Routing + 当前 Config 文件”。连接失败时保留这三个信息,后续才能分辨问题来自哪一层。

Shadowrocket 的 Config 配置文件编辑官方界面,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
官方 App Store 截图:Config 文件编辑。Global Routing 在 Home 选择;这里展示配置文件内部的分段与 Rule 编辑入口。
步骤 03 / 建立手动连接

Home:开关与系统授权

先选中服务器,再打开顶部开关。系统授权与远端可用性需要分别确认。

回到 Home,在 SERVER 分组中点选本次使用的服务器,核对选中标记。一个分组里有多条服务器时,查看列表不等于已经切换到其中某条;也不要把订阅分组名称当成当前连接对象。确认后,再看一眼 Global Routing 是否仍是上一步选择的姿态。

  1. 找到 Home 顶部连接开关。截图中的 Not Connected 表示拍摄时未建立连接,不是导入资料失败的提示。
  2. 打开连接开关。首次建立连接时,系统可能提示添加 VPN 配置;核对发起应用为 Shadowrocket,再按系统提示允许,并完成设备要求的认证。
  3. 返回 Shadowrocket,等待状态反馈。若授权被取消,先重新发起连接并完成授权,不要立即修改服务器密码或规则。
  4. 连接状态建立后,保持当前服务器与模式不变,进入下一步做实际访问验证。不要在验证前同时更新订阅、换服务器和改 DNS。

系统 VPN 配置用于让设备按应用设置接管相应网络流量,它不是为用户创建远端服务器。授权通过,也不表示订阅有效期、服务器认证和远端网络都已通过检查。反过来,如果系统授权没有完成,继续测试服务器参数也不能代替这一操作。

如果开关打开后很快恢复关闭,先观察是否出现明确错误,并检查设备上是否有正在占用连接的其他 VPN 配置。需要切换时先停止原连接,再重试 Shadowrocket;不要删除来源和用途不明的设备管理设置。如果开关保持开启但网页无法访问,保留现场,按后面的验证与排错顺序处理。

首次手动连接尚未确认成功之前,先不调整 On Demand。自动连接条件会增加判断变量,让“谁触发了重连”与“服务器是否可用”混在一起。先得到一次能够主动开启、验证、主动关闭的完整结果,再考虑自动化。

Shadowrocket 的 Home 官方界面,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 分组与 Add Server
官方 App Store 截图:Home。连接前依次核对 SERVER 选中项、Global Routing 与顶部开关,再运行 Connectivity Test。
步骤 04 / 区分状态与结果

Connectivity Test:验证是否生效

测试结果、实际访问和规则命中是不同层次的证据,不能只看开关。

连接开关开启后,在 Home 运行 Connectivity Test,观察本次服务器在当前测试方式下的反馈。返回结果可以帮助判断连通情况,但不能单凭某个数值推断所有网站都能访问,也不能把测试失败直接解释成密码错误。测试所用的方式与目标会影响结果,后面排错时应保持测试条件一致。

  1. 验证真实请求。 打开浏览器,访问本次实际需要使用的页面,重新加载并检查页面内容是否继续返回。只看到之前已打开的内容可能是缓存,不能作为新连接成功的充分依据。
  2. 对照当前姿态。 如果当前为代理(Proxy),先确认所选服务器能完成请求;如果当前为配置(Config),还要检查目标是否命中了预期规则。直连(Direct)下可以访问某个页面,不说明该请求使用了代理。
  3. 核对不同策略。 使用自己已知且允许访问的目标,分别检查应走 PROXY 与 DIRECT 的请求。在应用提供的连接记录中对照目标、命中规则与策略;连接记录的保留和显示范围以当前应用界面为准。
  4. 复测同一个目标。 需要调整时,只改一个变量,然后重新打开同一页面。记录修改前后的模式、服务器与现象,避免把目标网站差异误判成设置变化的结果。

如果 Proxy 能访问、Config 不能访问,优先回看当前配置文件、规则顺序和 DNS,而不是立刻重建订阅。如果两种模式都不能访问,应先检查服务器与本地网络。若只是单个站点失败,继续核对该目标对应的规则和服务状态,不必直接重置全部设置。

步骤 05 / 按失败位置检查

Settings:常见失败点

从前置条件到规则逐层排查。每次只调整一项,复测后再决定下一项。

列表没有出现:先检查导入

如果订阅保存后没有服务器条目,先确认链接完整、使用了对应的 Subscribe 入口,并且本地网络能完成获取。学校、公司或公共 Wi-Fi 可能需要先完成网络登录;必要时在自己的 Wi-Fi 与蜂窝网络间做一次对照。订阅地址含有认证信息时,检查复制是否截断,但不要把完整链接发到公开页面。需要确认服务状态时,通过已有服务的管理渠道核对,不要用不明地址替换。

有条目但不能连接:核对服务器参数

重新打开服务器编辑页,对照原始资料逐项检查 Type、Host、Port 及认证信息。先核对协议,再核对该协议需要的附加设置;仅改一个 Password 并不能修正 Type 选错。订阅生成的条目可能在更新时被重新写入,长期手动修补之前,应先确认订阅数据本身是否正确。删除或重新导入前保留必要备份,具体整理方法见服务器管理手册。

已连接却打不开:回看模式、规则与 DNS

先确认 Home 当前选中的服务器,再检查 Global Routing。只在 Config 下失败时,查看实际启用的文件、Rule 中的匹配顺序以及 FINAL 的处理;不要因为文件名称相似就认为内容一致。表现为域名访问失败时,再检查配置中的 DNS 设置及本地网络对解析请求的影响。一次同时更换 DNS、服务器和规则文件,会让结果失去可比较性。

进入 Settings,核对 Test Method,确保前后使用相同测试方式。需要进一步定位时,使用 Diagnostics 查看可用的诊断信息,并记录错误发生的动作与目标。诊断文本可能含服务器地址或连接资料,分享之前先去掉订阅认证参数、密码和其他私人信息。不要为了排查一个网页问题,连续改动 Proxy、TCP、UDP 下所有选项。

自动连接与速度问题:最后处理

只有手动连接已通过验证后,才到 Settings 设置 On Demand,按实际网络条件建立自动连接行为。修改后分别检查进入与离开对应网络时的表现;自动触发不等于远端连接一定成功。如果出现意外重连,先停用相关条件并恢复手动验证,再逐项恢复。

连接可用但速度不符合预期时,先用同一设备、同一目标和同一模式比较本地网络,再比较自己已有的其他服务器。Connectivity Test 的结果不能直接换算成下载速度;目标服务响应、远端线路和设备当前网络都可能影响体验。记录能够重复出现的现象,比一次性批量修改设置更有助于定位。

完成排查后,保留能够复现成功的服务器、模式与配置文件,再逐项恢复需要的规则或自动连接条件。协议字段与规则关键字不清楚时查阅概念速查;涉及多订阅、更新、删除与备份时进入订阅与服务器管理手册。本教程到一次可验证的连接为止,不要求首次操作就调整全部设置。

Shadowrocket 的 Settings 官方界面,显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
官方 App Store 截图:Settings。排错时优先核对 Test Method 与 Diagnostics;On Demand 留到手动连接验证通过后再设置。