官方手册 / 设置参考
Shadowrocket 功能与设置
先在 Home 确认如何转发流量,再检查 Config 的规则;需要自动连接或排查异常时,再调整 Settings。以下以 iPhone / iPad 的界面为例。
Global Routing
在 Home 选择分流模式
连接开关和分流模式是两项设置。连接开关控制 Shadowrocket 是否接管流量,Global Routing 决定被接管的流量按什么方式处理。在 Home 打开 Global Routing,选择 Config、Proxy 或 Direct。初次配置时,可以先用 Proxy 验证服务器能否转发,再切回 Config 验证实际规则。
| 界面选项 | 流量怎么走 | 什么时候用 |
|---|---|---|
| Config(配置) | 按当前配置的规则和策略处理。 | 日常分流,例如让局域网服务直连,其他指定请求使用代理。 |
| Proxy(代理) | 将被接管的流量交给当前选中的代理服务器。 | 暂时排除规则匹配的影响,验证服务器转发。 |
| Direct(直连) | 被接管的流量直接访问目标,不经过代理服务器。 | 对照当前网络的直连表现。 |
排查时保持网络、服务器和测试目标不变,每次只切换一项。Proxy 可用而 Config 不可用时,先检查是否启用了预期的配置,再看规则是否被前面的条目先匹配。Direct 也失败时,先确认当前网络能否访问该目标。Direct 不等于关闭连接;若要对照完全不经过 Shadowrocket 接管的结果,应关闭 Home 的连接开关后再测。
规则分流
在 Config 修改匹配条件与处理策略
一条规则由匹配条件和处理策略组成。在 Config 确认当前启用的是哪份配置,保留一份原配置供恢复,再编辑其中的 Rule。保存后回到 Home,确认 Global Routing 已选 Config。若编辑的是另一份配置,仅保存不会让它生效。
- 按域名:
DOMAIN匹配指定主机名;DOMAIN-SUFFIX匹配域名及其子域名;DOMAIN-KEYWORD匹配域名中的指定字符串。只想覆盖一个主机时,优先用DOMAIN,避免关键词误匹配其他域名。 - 按地址:
IP-CIDR和IP-CIDR6分别匹配 IPv4、IPv6 网段;GEOIP按目标 IP 的地理归类匹配,而不是按域名后缀或设备所在地判断。同一域名解析到不同地址时,按 IP 匹配的结果可能随之变化。 - 按请求特征与默认处理:
USER-AGENT依赖请求中可以识别的 User-Agent,不适合作为所有连接的通用条件。FINAL处理此前没有匹配到的请求,应放在规则列表末尾。
常用策略是 PROXY、DIRECT 和 REJECT,分别用于代理转发、直接访问和拒绝请求。规则通常按顺序匹配,先命中的条目决定走向。具体例外放在宽泛规则之前;否则后面的例外即使写对了,也可能轮不到它生效。
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
这段示例让 status.example.com 先命中直连规则,example.com 及其其他子域名走代理,未匹配的请求走直连。示例仅用于说明顺序,不是整份配置。验证时用新请求分别访问例外目标和普通目标;仍有疑问时,参照 规则语法与匹配顺序 逐条缩小范围。
订阅与服务器
在 Home 管理 SERVER 列表
SERVER 列表保存可选的服务器。手动添加适合已有单台服务器参数的情况:在 Home 打开 Add Server,选择服务商指定的协议,填写对应的地址、端口和认证字段,再保存。不同协议的字段不同;遇到不认识的字段,先按服务商提供的资料核对,别把一个协议的设置照搬到另一个协议。
订阅用于导入并更新一组服务器。订阅从你的服务商处获取。在 Add Server 中选择 Subscribe,填写已有的订阅地址并保存,再回到 SERVER 检查是否出现对应的条目。续期或更换订阅地址后,更新相应的订阅组,然后重新确认当前选中的服务器;旧条目可能已替换,列表中仍有条目不代表正在使用的那一项仍然有效。
把「订阅能否更新」「服务器能否通过 Connectivity Test」「目标服务能否访问」分开检查。订阅能更新只说明客户端取到了列表,不代表列表中的每台服务器都可达;测试通过也不代表当前规则一定会把目标请求交给这台服务器。向他人求助时,可说明协议名和出错步骤,不要附上完整订阅地址、认证信息或包含这些内容的截图。
On Demand
在 Settings 管理何时发起连接
On Demand 决定系统在满足条件时是否自动发起 VPN 连接;它不替代 Global Routing,也不会自动将 Config 切换成 Proxy。建议先在 Home 手动建立一次连接并确认系统 VPN 配置权限已就绪,再到 Settings 打开 On Demand,按界面提供的网络条件设置自动连接的范围。
首次设置时只验证一种条件。例如只验证进入某个 Wi‑Fi 网络后是否连接:先确认网络名称与条件一致,再离开并重新接入该网络,回 Home 查看连接状态。确认这一步有效后,再添加其他条件。酒店或公共 Wi‑Fi 若需要先完成网页认证,可先完成认证,再验证自动连接;认证前后的网络连通性并不相同。
如果手动断开后连接又自行建立,先检查当前网络是否仍满足 On Demand 的条件,而不是反复关闭 Home 开关。排查时可暂时停用 On Demand,手动测试同一目标;手动也失败时,优先检查网络、服务器和分流设置,确认手动可用后再恢复自动连接。
Data 流量统计
记录基线,再对照上传与下载
Data 用于查看客户端记录的流量。打开 Data 后,先确认当前所看的统计范围、时间范围和单位,再比较上传和下载。验证单次操作时,可先记下当前读数,再发起一次可控的小流量请求,完成后回到同一视图看增量。测试期间尽量避免同时播放视频或下载文件,后台活动也可能计入同一段时间。
Data 的统计范围、计量方式和时间窗口可能与服务商账单不同,不能直接用来核对线路余额。计数不变时,先确认连接仍然开启、请求不是直接从缓存读取,并检查当前视图是否包含该连接。准备清除统计前,先确认操作影响的范围;若需比较调整前后的变化,保留原来的读数和测试时间,比只留一张总量截图更有用。
Settings 常用项
区分解析、测试、快捷入口与同步
DNS:先确认由哪份配置决定解析
DNS 把主机名解析为地址,解析异常有时看起来像服务器连不上。遇到只有部分域名失败的情况,先在 Config 查看当前配置的 DNS 相关设置;如果配置的 [General] 中有 dns-server,修改前先记下原值。一次只改一个设置,重新建立连接后用同一个域名发起新请求。若局域网服务的名称原本由本地网络解析,盲目换用其他 DNS 可能反而让这些名称无法解析。
Test Method:先统一测试条件
Test Method 决定 Connectivity Test 如何判断连接结果。在 Settings 查看当前 Test Method,选择与排查目标相符的方式,再回到 Home 执行 Connectivity Test。如果界面同时允许调整测试目标,就用相同目标比较前后结果。单次超时可能来自测试目标或当前网络,单次成功也不表示其他网站一定可达;需要判断业务访问时,还要测试实际遇到问题的目标。
Today Widget:确认快捷入口的操作范围
Today Widget 是快捷入口,不是另一个分流模式。若 Settings 中提供 Today Widget,在客户端确认相关设置,再到系统的小组件管理界面查看是否可添加。添加后可试一次连接操作,并回到 Home 核对最终状态及当前 Global Routing。若系统未列出对应组件,继续在 Home 操作即可,不需要为此更改规则或服务器。
iCloud 同步:确认内容范围再跨设备启用
在 Settings 查看 iCloud 相关选项,先确认哪些项目可以同步,并检查两台设备是否登录同一 iCloud 账户。可以先用一项不含凭据的配置改动验证同步,再到另一台设备核对其实际启用的配置。不要把同步当作完整备份,也不要假设同步会一并复制系统的 VPN 权限或当前连接状态;换机后应逐项检查。
Diagnostics:记录能复现的问题
遇到反复超时或断开时,先记录发生时间、网络类型、Global Routing 模式和失败范围。若 Settings 提供 Diagnostics,可在复现窗口内查看诊断信息,再对照 Home 的连接状态与 Connectivity Test 结果。不同测试尽量保留相同条件;分享记录前移除服务器地址、订阅链接、认证字段和不必要的访问记录,只留下定位问题所需的信息。
客户端获取与相关手册
iPhone / iPad 版在 App Store 产品页 $2.99 一次性付费,系统要求以 App Store 页面标注为准。Mac(Apple 芯片版与 Intel 版)、Windows、安卓、Linux 版免费,安装包及各系统首次打开的放行说明见客户端下载;安装包由本站 /dl/ 提供。
还没完成首次连接,可先看快速上手。需要按阶段复查权限、连接和日常维护时,参阅完整使用手册;遇到具体错误提示时,可查疑难解答。