官方手册 · 首次设置

Shadowrocket 设置教程

从添加已有服务器或订阅开始,按顺序设置分流、打开连接,再用实际请求检查结果。

01 导入资料

在 Add Server 添加服务器或导入订阅

打开 Shadowrocket,进入 Home。在 SERVER 区域找到 Add Server,打开添加页面。先看手里的资料是哪一种:一组协议、主机和端口等字段通常对应单条服务器;服务商提供的订阅地址则用于读取一组条目。不要把订阅地址粘进单条服务器的 Host 字段。

手动填写单条服务器

先在 Type 选择资料注明的协议类型,再核对页面随类型显示的字段。以截图中的字段为例,Host 填主机名或地址,Port 填端口号;如果该类型显示 Password 或 Method,按资料逐一填入或选择,不用其他协议的同名字段来推断。粘贴后检查首尾有无多余空格,也不要把主机和端口整串填进同一个字段。保存后回到 Home,确认新增条目出现在 SERVER 中。

用 Subscribe 导入已有订阅

在 Add Server 中选择 Subscribe,把服务商给出的完整订阅地址填进地址栏并保存。复制时不要删掉问号后面的参数,也不要把链接和备注一起粘贴。回到 Home,待列表载入后展开对应分组,确认里面确实有可选服务器。分组出现但没有条目时,先排查订阅读取问题,不要把空分组当作已经导入成功。

如果手里的是单条服务器二维码,可以在 Add Server 使用 Scan QR Code,识别后仍要确认类型和主要字段。截图中的 Import from Cloud JSON 是另一种导入入口,不用于代替 Subscribe。核对完列表,记住接下来要测试的那一条;先按下一步决定流量如何处理,再打开连接。

Shadowrocket 的 Add Server 界面,显示 Type、Host、Port、Password、Method,以及底部两个导入入口
Add Server:先选 Type,再填写该类型需要的字段。

02 选择模式

在 Global Routing 选择流量处理模式

回到 Home,点开 Global Routing。这里决定的是流量如何处理,并不负责选择服务器,也不等于打开连接。为了检查日常规则分流,通常先用配置(Config);如果只是想做一次对照测试,可临时选择另外两种姿态,测试后再切回原来的选项。

  • 配置(Config):按当前配置文件中的规则决定请求走代理、直连或其他指定策略。适合检查不同目标是否按预期分流。
  • 代理(Proxy):把由客户端处理的流量交给代理路径,而不是按配置文件逐条分流。适合暂时验证已选服务器能否处理实际请求。
  • 直连(Direct):由客户端处理的流量不经代理服务器转发。适合作为同一设备、同一网络下的对照,不等于关闭 Home 的连接开关。

选用 Config 时,先确认配置文件

Home 的 Global Routing 显示 Config,表示当前选择使用规则;底部的 Config 则是查看和管理配置文件的入口。进入后,确认当前选用的是哪一个文件,再打开相应的编辑页查看 Rule。不要只凭文件名相似就认定两个配置内容相同。截图中的 General、Hosts 与 Rule 各有用途,首次验证分流主要看 Rule,不需要逐项修改。

例如 DOMAIN-SUFFIX,example.com,PROXY 表示符合该域名后缀的请求使用 PROXY 策略。实际验证要选配置里确实存在的目标,并检查它前面是否有更早命中的规则,以及未匹配请求会落到哪条兜底策略。初次连接不必先点 Add Rule;用现有规则完成一次验证,等能区分服务器问题和规则问题后再修改。协议参数可查技术参考,模式用途可查代理模式。

Shadowrocket 的 Config 文件编辑界面,含 General、Rule、Hosts、URL Rewrite 和 HTTPS Decryption 分段
Config 编辑页:在 Rule 核对规则内容和顺序。

03 建立连接

在 Home 打开连接开关

返回 Home,在 SERVER 下打开刚导入的分组,点选要使用的服务器。如果同一分组里有几条名称相似的记录,先确认当前选中的确是准备测试的那一条。再读一遍 Global Routing 当前显示的模式,避免上一步做对照时留下了其他选项。要验证规则,就把模式保持在 Config。

拨动页面顶部与 Not Connected 状态相邻的开关。首次启动时,iPhone 或 iPad 可能弹出添加 VPN 配置的系统提示。确认提示对应刚打开的 Shadowrocket,再按系统提示允许并完成设备验证。返回 Home 后,等待连接状态更新;如果刚打开就回到 Not Connected,先按排查步骤检查授权和连接冲突,不必反复拨动开关。

顶部状态显示已连接,只能说明设备端的连接已建立,不能证明刚选的服务器可用,也不能证明某个网站已经命中预期规则。首次测试时,尽量保持设备所用的网络不变,并记下当前服务器、模式和配置文件名。这样即使下一步结果不符合预期,也能按同一组条件复测。

Shadowrocket 的 Home 界面,显示 Not Connected 开关、Global Routing、Connectivity Test 和 SERVER 分组
Home:上方是连接开关,下方是服务器列表。

04 核对结果

用 Connectivity Test 与实际请求验证

先在 Home 点击 Connectivity Test,等测试结果更新。关注刚才选定的条目,不要拿邻近服务器的结果作判断。出现可用结果,只表示该条目在当时的网络和测试方法下得到了响应;超时也不直接证明配置错误,因为测试目标不可达或当前网络不稳定都可能造成同样的现象。要验证具体用途,下一步仍要发起真实请求。

配置模式下,分别验证两种路径

使用 Config 时,在当前配置中各找一个预期走 DIRECT 和 PROXY 的目标。打开浏览器或相应应用,重新发起请求,留意显示的是不是缓存内容。若能查看对应请求的匹配记录,按请求发生的时间找到实际目标域名和所用策略,对照 Rule 中的规则顺序。网页地址栏里的主域名不一定是全部请求的目标;页面图片或登录接口可能走不同域名,因此不能只凭页面能打开就判定所有流量都命中了同一规则。

结果不一致时,只改变一个条件

如果只有预期走代理的目标失败,保持网络和选中的服务器不变,可临时用 Proxy 对同一目标复测。Proxy 下可用而 Config 下失败,优先查目标实际命中的规则或策略;两种模式下均失败,再查服务器参数和测试方法。如果用于对照的是直连路径,则临时切到 Direct,确认不经服务器时同一目标的表现。测试结束后切回原模式,按原来的设置重试一次。

05 定位失败点

按失败现象检查 Settings 和连接条件

从最早出现异常的环节查起。条目没有读入,就先查导入;开关无法保持打开,就先查设备端连接;能连上但个别请求失败,再查服务器、测试方法与规则。每次只改一个条件,随后重做刚才失败的操作。

分组为空,或重新导入后仍找不到条目

回到 Add Server 确认类型是否选成了 Subscribe,并核对地址是否完整、是否仍是服务商当前提供的地址。手动添加时则检查 Type 与资料是否匹配、Host 和 Port 有没有填反。重复导入同一个地址通常不能解释失败原因。若需要记录求助信息,只记错误提示和发生的步骤,不分享完整订阅链接、密码或密钥。

开关回弹,或断开后又自动连上

开关回弹时,先核对首次出现的系统提示是否已确认,并检查设备上是否另有活动的 VPN 连接。受单位管理的设备可能限制配置变更,遇到管理提示应先问设备管理员。若现象相反,即手动断开后又连上,进入 Settings 查看 On Demand 是否启用,记录自动连接发生时的网络环境,再判断是否为按需连接条件触发;不要把自动重连与服务器测试超时混为一谈。

测试超时,或只有部分应用访问异常

在 Settings 里记下 Test Method,回 Home 对同一服务器再测一次。如果手里已有同一订阅的另一条服务器,可以在不改变模式和网络的情况下对照。只有一条失败时,优先复核该条参数;多条都失败时,先确认设备的基础网络和测试条件。测试有结果但只有部分应用异常时,查看 Diagnostics 中可用的诊断信息,记下失败时刻、目标域名和实际模式,再对照验证步骤定位。先记录,再修改,不要同时改规则、切服务器和换网络。

Shadowrocket 的 Settings 界面,包含 Test Method、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:核对测试方法、按需连接和诊断入口。