跳到教程正文
官方手册 · 首次连接

Shadowrocket 使用教程
订阅导入与连接设置

按“导入 → 模式 → 连接 → 验证 → 排错”的顺序操作。先完成一次可复查的连接,再调整规则与自动连接条件。

开始前:用户已安装 Shadowrocket,并已有自己的订阅链接或服务器信息。本站不提供、不销售、不推荐节点或订阅。本教程以 iPhone / iPad 界面为例,截图用于对照界面位置,实际显示以设备上的应用为准。

iPhone / iPad 版从 App Store 获取,$2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费,从本站下载页获取。客户端一次性买断 ≠ 线路套餐。尚未完成安装时,先查看下载与安装放行说明;iPhone / iPad 系统要求以 App Store 页面标注为准。

  • 操作界面 Home / Config / Settings
  • 准备资料 已有订阅或服务器参数
  • 操作原则 每次只调整一个变量

Add Server:添加服务器与导入订阅

打开 Shadowrocket 后,先停留在 Home,暂时不要打开顶部连接开关。在下方 SERVER 区域查看是否已有条目:已有条目时先核对它来自哪份资料;列表为空时,再根据手中的资料选择手动添加或订阅导入。这两种方式任选适合的一种即可,不必把同一份资料重复添加。

手动填写单个服务器

在 Home 点按 Add Server,进入添加页面。先打开 Type,选择与你已有服务器资料一致的协议类型。Type 会影响后续出现的字段,因此不要先把所有内容填完再更换类型,也不要根据服务器名称猜测协议。

接着填写 Host 和 Port。Host 填服务器地址,Port 填端口;不要把包含协议前缀、路径和查询参数的整段订阅链接填入 Host。若当前 Type 显示 Password、Method 等字段,逐项按原始资料填写,注意大小写及首尾空格。不同协议的认证字段并不相同,截图中的字段不是所有 Type 都必须填写的通用清单。

核对后使用页面上的保存操作,返回 Home。确认 SERVER 中出现刚添加的条目,再点按它使其成为当前选择。如果保存后找不到条目,先检查是否真正完成保存,而不是立即重复填写一遍。

使用已有订阅链接

同样从 Add Server 进入,在 Type 中选择 Subscribe,把自己已有的完整订阅链接粘贴到对应的 URL 输入位置。粘贴后从头到尾检查一次,尤其留意聊天软件附带的说明文字、换行、引号和末尾标点;链接中的认证参数不能擅自删除。

保存并等待导入完成后,回到 Home 查看相应分组及条目。订阅管理的是一组服务器资料,不等同于 Config 中的规则配置文件。列表有了条目,只能说明导入阶段得到结果,还需要继续选择模式并验证连接。后续需要刷新资料时,在对应订阅的管理操作中执行更新,避免把同一链接反复新增成多个分组。

Shadowrocket Add Server 页面,可核对 Type、Host、Port、Password 和 Method 字段
Add Server:先核对 Type,再填写该类型需要的字段。Scan QR Code 与 Import from Cloud JSON 是不同的导入入口。

已有对应二维码时,可以使用 Scan QR Code 并检查识别结果;Import from Cloud JSON 只用于相应格式的资料,不是任意订阅链接的替代入口。无论使用哪种导入方式,都应先确认资料类型,再选择入口。截图不能作为服务器地址、账号或密码的来源。

本步完成标志:Home 的 SERVER 中已有与你资料对应的条目,并能选中一个服务器。若提示解析失败或列表为空,先看步骤 05 的导入排查,不要通过更换 Global Routing 来处理链接格式问题。

Global Routing:选择 Config、Proxy 或 Direct

服务器添加完成后,返回 Home,点按 Global Routing。这里决定客户端如何处理接管到的流量,不负责修复服务器参数,也不会替你创建规则文件。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct);先理解当前选择,再进行连接测试,才能解释测试结果。

日常按规则使用:配置(Config)

配置(Config) 按当前配置文件中的规则处理请求。进入底部 Config,确认当前使用的是哪份配置,再打开查看其内容。在配置编辑页可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段;这些分段各有用途,不需要为了首次连接逐项修改。

重点先看 Rule:规则通常按顺序匹配,命中后的策略可能是 PROXY、DIRECT 或 REJECT。例如下面一行表示对相应域名后缀使用 PROXY。它只是语法示意,不是完整可用配置,也不提供任何服务器资料。

DOMAIN-SUFFIX,example.com,PROXY

如果已有完整规则配置,应先确认已选用该文件,再回 Home 将 Global Routing 设为配置(Config)。仅导入订阅,并不代表规则文件也已替换。不要因为编辑页出现 Add Rule 就连续添加重复规则;先确认原有规则是否已覆盖目标请求。

临时对照:代理(Proxy)与直连(Direct)

代理(Proxy) 用于以全局代理方式做对照,适合检查问题是否与规则选择有关,但仍依赖当前服务器和对应参数可用。它不能保证某个目标一定能够访问,也不会修正密码、端口或 TLS 字段。

直连(Direct) 用于以直接连接方式做对照。若目标在此姿态下可以打开,只能说明该目标在当前网络的直接访问结果,不能据此判断代理服务器正常。做完对照后,回到 Global Routing 恢复原先准备使用的配置(Config),避免把临时测试状态当作日常设置。

Shadowrocket Config 配置编辑页面,显示 General、Rule、Hosts 等分段及 Add Rule 入口
Config:核对当前配置中的 Rule;Global Routing 本身从 Home 进入选择。

首次验证不需要开启 HTTPS Decryption,也不需要为此安装证书。先保留已有配置的必要设置,把“服务器是否可用”和“规则是否命中”分开判断。需要进一步了解不同协议字段及设计取舍时,查看协议详解,不要仅为了测试而切换成与服务器不匹配的 Type。

Home:打开顶部连接开关

完成模式选择后返回 Home,再检查一次 SERVER 中当前选中的条目。订阅下存在多个条目时,导入完成与选中服务器是两件事;应明确本次测试使用哪一个,避免把不同条目的结果混在一起比较。

点按 Home 顶部连接开关。首次连接时,iPhone / iPad 可能显示添加 VPN 配置的系统提示。核对提示来自 Shadowrocket 后,按系统流程允许;如果系统要求设备验证,完成后返回客户端。这里授予的是设备上的网络配置权限,不表示已购买或启用任何线路服务。

回到 Home,观察顶部状态是否仍为 Not Connected。开关打开后如果立即关闭,或者系统授权没有完成,应先处理权限与连接建立的问题;不要把这种情况当作某个网站的规则匹配失败。已经允许过配置的设备,不一定每次都出现相同提示。

若设备还启用了其他会接管网络的 VPN 配置,测试时应先确认当前实际使用的是哪一个。受组织管理的设备还可能限制 VPN 设置;这类限制需要由设备管理方确认,不应通过反复删除配置来尝试绕过。

连接状态发生变化后,继续下一步做实际请求验证。系统显示 VPN 状态或客户端开关保持开启,只能证明相应配置正在运行,不能单独证明远端认证成功、DNS 正常或每一条规则都符合预期。

Shadowrocket Home 页面,顶部为 Not Connected 开关,下方有 Global Routing、Connectivity Test 和 SERVER 分组
Home:核对 SERVER 选择、Global Routing 与顶部连接状态,再执行 Connectivity Test。

本步完成标志:系统授权流程已完成,Home 不再停留在 Not Connected。若状态正常但页面打不开,保持当前服务器不变,进入下一步收集具体结果。

Connectivity Test:核对是否按预期生效

在 Home 点按 Connectivity Test,等待本次检测结束。检测结果与所用测试方法、测试目标及当前网络有关,因此应把它作为线索,而不是把一次成功理解为所有应用都能正常使用。先记录测试是否完成、是否超时,再观察实际使用场景。

  1. 打开一个实际需要访问的页面。使用浏览器发起新的请求,避免只看已经缓存的页面。如果只有某一个页面失败,先确认该目标本身是否可用,不要立即重置整个客户端。
  2. 确认测试时的 Global Routing。配置(Config) 下,请求可能按规则走 DIRECT;页面能够打开,并不必然说明使用了 PROXY。代理(Proxy) 与直连(Direct) 的对照结果也要分别记录。
  3. 结合请求记录查看处理路径。在应用可用的请求记录中查找刚才访问的域名,核对命中的规则与策略。记录需要由新的请求产生;没有记录时,先确认连接仍开启以及请求确实重新发起。
  4. 恢复日常状态后再测一次。如果为了排查临时切换了姿态,恢复配置(Config),对同一目标重新测试,确认问题是否随模式改变而变化。

例如,配置(Config) 下某个本地目标由 DIRECT 处理,这是规则生效的一种正常结果;命中 REJECT 的请求则需要检查规则是否符合自己的使用意图,而不是直接归因于服务器不可达。若代理(Proxy) 下可以访问、配置(Config) 下不行,应优先检查当前配置与规则顺序。

对照测试期间保持同一个服务器、同一个目标和同一种接入网络,每次只改变一个条件。先换服务器、再换 Wi-Fi、同时修改 DNS,虽然可能让现象改变,却很难知道真正原因。完成验证后,可以先关闭再重新打开一次连接,确认使用的是保存后的设置,而不是尚未应用的编辑内容。

至此,若连接状态、实际访问与规则记录能够互相对应,就完成了首次设置。后续再考虑自动连接与更细的规则调整;不需要为了“设置完整”而把所有选项都打开。

Settings:常见失败点与检查顺序

排错时先描述现象:是订阅无法保存、SERVER 为空、测试超时、开关自动关闭,还是连接后只有个别请求失败。不同现象对应不同检查位置。下面按操作链顺序检查,不必从头删除所有资料重来。

订阅导入失败或列表为空

返回订阅条目,核对完整 URL,确认没有粘贴到 Host,也没有把普通网页地址当作订阅地址。再检查自己已有订阅的有效状态,并确认当前网络能够请求该地址。更新没有返回可识别内容时,切换 Global Routing 并不能修复远端返回的格式。详细自查见订阅解析失败或列表为空说明。

条目存在,但测试失败

先核对当前选中项,再进入它的编辑页面检查 Type、Host、Port 和认证字段。对于需要 TLS 或其他附加参数的类型,应按原始资料逐项比对,不要凭经验补填。密码、UUID、密钥等字段用途不同,不能互相代替。仍失败时,可在保持配置不变的前提下,分别用 Wi-Fi 与蜂窝网络测试,记录现象是否随网络变化。

测试结果与实际访问不一致

进入 Settings 查看 Test Method。不同测试方法测量的对象不同,某种方法失败并不能直接推导所有实际请求都失败。先固定一种方法完成对照,再结合浏览器请求和规则记录判断。不要只根据列表中的单个测试结果连续切换多个服务器。

连接后只有部分请求异常

回到 Global Routing,短暂使用代理(Proxy)做对照。若现象仅在配置(Config) 下出现,优先核对当前选用的 Config、Rule 中较早命中的条目及最终策略。如果表现为域名解析错误,再检查配置内 DNS 相关设置;不要同时改写所有字段。查看 Proxy、TCP、UDP 相关选项时,也应先确认问题是否确实属于对应流量类型。

Shadowrocket Settings 页面,显示 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 设置入口
Settings:先核对 Test Method;需要自动连接或诊断时,再查看 On Demand 与 Diagnostics。

自动重连与 On Demand

如果手动关闭后又出现连接,检查 Settings 中的 On Demand。它按设定条件触发连接,不负责判断服务器资料是否正确。首次排错时先记录现有条件;如果这些条件影响手动对照,可暂时停用后测试,结束时再按需要恢复。建议在手动连接已经验证正常之后,再设置按需连接,避免同时排查触发条件和服务器问题。

需要进一步定位时记录哪些信息

可在 Settings 查看 Diagnostics 相关入口,记录问题发生时使用的网络、Global Routing 姿态、协议 Type、是否仅影响某个目标及具体错误文字。分享诊断信息前,遮盖订阅链接中的认证参数、密码、密钥和个人网络地址;完整订阅链接本身可能具有访问权限,不应放在公开截图中。

如果原始资料已失效或远端拒绝认证,应联系自己已有服务的提供方确认状态;客户端重装不能恢复远端权限。需要重新操作时,回到本页的添加与导入步骤;协议字段的含义与取舍则查看协议详解。把“在哪一步失败”说明清楚,比一次更改所有设置更便于定位。

Shadowrocket 官方下载