官方手册 · 功能与设置
Shadowrocket 代理模式
先确定 Global Routing,再检查 Config 与服务器。连接开关、请求采用的策略和最终能否访问,是三个需要分别验证的环节。
模式选择
规则匹配
设置验证
以下以 iPhone / iPad 常见界面为操作参照;不同平台的入口位置和可用设置可能不同,以当前应用显示为准。Shadowrocket 提供 iPhone / iPad、Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版本,获取入口见全平台下载 。
客户端一次性买断 ≠ 线路套餐。 iPhone / iPad 版在 App Store $2.99 一次性付费;Mac / Windows / 安卓 / Linux 版免费。订阅或服务器信息从你的服务商处获取,本站不提供、不销售、不推荐节点或订阅。
Global Routing
规则分流
订阅与服务器
On Demand
Data
Settings
验证顺序
模式选择
Global Routing 三种模式
配置、代理、直连分别对应界面中的 Config、Proxy、Direct。模式决定请求如何选择路径,不等同于连接开关。
是什么: Global Routing 是整体路由方式的选择入口。在 Home 中找到 Global Routing,进入后查看当前勾选项。初次设置时,应先导入已有服务器并确认可用,再决定日常使用哪一种模式;不要为了尝试不同选项而同时更换服务器、DNS 和配置文件。
如何选择与恢复
已有经过确认的规则配置时,通常从 Config 开始。若某个目标在 Config 下失败,而同一服务器在 Proxy 下可以访问,应回到规则与策略检查,不必立即重导订阅。若 Direct 也无法访问本应直连的目标,先检查 Wi-Fi、蜂窝网络或目标服务状态。每次只改变一个条件,记录对照结果,结束测试后恢复原计划使用的模式。
注意什么: 选择 Direct 不等于关闭连接,选择 Proxy 也不保证目标服务一定可用。系统仍可能显示连接状态;判断请求走向应结合请求记录,而不是只看系统状态图标。排查时还要区分新请求与已经建立的连接,切换后重新发起访问再观察。
匹配条件与执行策略
Config 与规则分流
规则类型描述“匹配什么”,策略描述“匹配后怎么处理”。两者不能互相替代。
规则类型如何区分
在 Config 中查看当前配置的 Rule 内容。DOMAIN 用于精确域名,DOMAIN-SUFFIX 用于域名后缀,DOMAIN-KEYWORD 用于域名关键字。IP-CIDR 与 IP-CIDR6 描述地址范围,GEOIP 按地址对应的地区数据匹配;其结果受数据和解析情况影响,不能把它当作网站所属地区的保证。
USER-AGENT 是否能够匹配,取决于请求中是否存在可供检查的相应信息。不要假定所有连接都能提供它。添加规则前先明确目标请求实际使用的域名或地址,避免把页面显示名称误当成请求域名。
策略如何区分
DIRECT 表示直接连接,REJECT 表示拒绝,PROXY 表示交由相应代理策略处理。配置也可能引用自定义策略名称,因此规则中出现的名称必须与配置中定义的策略对应。仅在规则末尾写入一个名称,不会自动创建可用服务器或策略。
处理误匹配时,应先确认命中了哪条规则,再决定修改匹配值还是策略。若目标被 REJECT 命中,更换服务器通常不会改变结果;若规则引用的策略不可用,则需要检查该策略自身的成员与选择状态。
规则顺序与验证方法
以下仅是规则语法样张,不是完整配置,也不提供服务器信息。example.com 用于说明后缀匹配,实际配置应使用你需要处理的目标。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
规则通常按顺序检查,先命中的规则决定请求采用的策略。具体规则应放在覆盖范围更大的规则之前,FINAL 用作前面没有匹配时的最终处理。编辑前保留当前可用配置的副本,在 Config 中确认新配置已经启用,然后将 Global Routing 设为 Config,重新访问目标,并在请求记录中对照命中规则与策略。
注意什么: 远程配置更新可能覆盖本地改动。需要长期保留的自定义内容,应结合当前应用提供的配置管理方式单独维护。保存成功只说明内容已写入,不说明规则已经被选中或目标请求一定经过该条规则。
连接信息管理
订阅与服务器管理
Subscribe 管理一组服务器的更新来源,Add Server 管理具体连接信息;Config 则负责规则与相关配置。
导入与手动添加
是什么、在哪: 在 Home 中查看已有服务器及其分组,通过添加入口进入 Add Server。已有订阅链接时使用应用支持的 Subscribe 入口;已有单台服务器信息时,按对应协议填写。二维码可通过 Scan QR Code 导入,但扫描前仍需确认内容来自你的服务商。
怎么设: 订阅链接从你的服务商处获取,完整保留其中的路径、查询参数和大小写,粘贴前后检查是否混入空格或换行。手动添加时,先选协议,再逐项填写服务器地址、端口和该协议要求的认证、传输及 TLS 参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等协议的字段并不相同,不应直接套用另一种协议的填写方法。
导入完成后,先确认 Home 出现服务器条目,再选择一个条目进行 Connectivity Test,并尝试实际访问。订阅导入成功意味着获得了列表,不代表其中每台服务器都可用;Connectivity Test 有结果也不代表所有网站都能访问,两类验证需要分别进行。
更新、重命名与删除
订阅内容发生变化时,对相应订阅执行更新,再检查服务器数量、分组和当前选择是否改变。更新失败时先确认本地网络可以访问订阅地址,再核对链接是否失效、返回内容是否为应用可识别的格式。错误页面、登录页面或普通网页不能当作服务器订阅导入。
注意什么: 批量清理前区分订阅生成的条目与手动添加的条目。订阅更新可能重建其管理的内容,不宜依赖对自动生成条目的临时修改。订阅地址通常含有访问凭据,截图、日志与求助信息中应遮盖完整链接及认证字段;不要把它粘贴到公开评论或不必要的检测工具中。
查看订阅导入与首次连接教程 →
连接触发条件
On Demand 按需连接
On Demand 处理何时建立连接;Global Routing 与规则处理建立连接后如何分流。
是什么、在哪: On Demand 用于依据所设条件触发连接。在 Settings 中查找 On Demand 或对应的按需连接设置入口,查看当前条件和开关状态。可配置条件应以当前平台实际显示为准,不要将其他设备上的设置列表视作本机必有选项。
怎么设: 先关闭自动触发的干扰,手动连接并确认服务器、DNS 与规则都能正常工作,再设置按需条件。如果当前界面提供针对 Wi-Fi、蜂窝网络或指定网络的条件,逐项确认哪些情况下连接、哪些情况下不触发。保存后在可控环境下切换一次网络,观察连接是否符合预期,再测试目标请求采用的策略。
注意什么: On Demand 不是服务器故障修复工具。手动连接已经失败时,开启它只会重复遇到相同问题。若关闭连接后又自动连上,先检查按需条件及系统中的相关连接设置,不要立即删除配置。临时排查时记录原条件并暂停自动触发,排查结束后再恢复,避免把预期中的自动连接误判为异常。
用量观察
Data 流量统计
统计用于观察客户端记录的传输情况,不能替代服务商用量或运营商账单。
是什么、在哪: 打开 Data 查看应用提供的流量统计,先阅读当前页面标注的统计范围与时间范围,再比较上传、下载或不同类别的数据。若某个平台把相关内容放在其他入口,应以实际界面名称和说明为准。
怎么用: 排查某次操作是否产生流量时,先记录当前值,只进行一次明确操作,再回到 Data 查看变化。长期观察前应确认计数是否跨连接保留、是否存在重置选项,以及本次重置会影响哪些记录。不同范围的数据不要直接相减后认定为某个应用的精确用量。
注意什么: 协议开销、重传、统计口径与计费周期都可能造成差异。Data 有增长只能说明应用记录到了传输,不能单独证明某个网页请求通过了指定服务器。需要核对分流时仍应查看请求与策略;怀疑后台用量异常时,再结合系统的应用网络用量和电池记录进行对照。
常用项逐项说明
Settings 常用设置
先保留能够正常连接的基线。下面各项应分别调整,调整后使用相同目标进行验证。
DNS
是什么、在哪: DNS 负责把域名解析为地址;相关设置可能位于 Settings 或当前 Config 的配置内容中。先确认正在使用哪份配置,以及该配置是否定义了 DNS,避免只改全局入口却忽略配置中的相关设置。
怎么设、注意什么: 从当前可工作的解析方式开始,只在有明确需求时切换到自定义 DNS 或 DNS over HTTPS。填写后用同一域名重新发起请求,对照解析结果、访问结果与记录。DNS over HTTPS 端点自身也必须可达,它不会自动修复错误的规则、认证信息或不可用服务器。详细取舍见DNS 设置说明 。
Test Method
是什么、在哪: Settings 中的 Test Method 用于选择连接测试的方法。不同方法观察的是不同环节;测试结果应连同所选方法一起阅读,不能只比较一个孤立数值。
怎么设、注意什么: 对照服务器前保持测试方法、测试目标与本地网络一致,再执行 Connectivity Test。端口可连接不等同于完整代理请求成功,测试目标可访问也不等同于其他目标可访问。若测试与实际体验不一致,先核对测试方法和目标,再查看实际请求记录,不应据此频繁更换全部设置。
Today Widget
是什么、在哪: Today Widget 是相关平台提供的快捷查看或操作入口。在 Settings 查找对应设置,并在系统提供的组件管理界面确认是否可以添加;不同系统版本的呈现方式可能不同。
怎么设、注意什么: 先在应用内完成服务器选择和连接验证,再配置组件中实际可用的项目。添加后测试一次快捷操作,并返回应用核对当前状态。组件显示可能存在刷新间隔,不宜把未及时更新的文字当作连接失败的唯一依据;组件缺失时先检查当前系统与应用是否提供该入口。
iCloud 同步
是什么、在哪: iCloud 相关设置用于应用支持的数据同步或备份能力。在 Settings 查看具体说明,同时检查系统的 iCloud 权限、账户和可用存储。同步范围以应用明确列出的项目为准,不假定所有数据都会迁移。
怎么设、注意什么: 首次启用前保留本地可用配置,先在一台设备完成上传或同步,再在另一台核对内容。遇到冲突时先辨认哪份是需要保留的内容,避免连续覆盖。同步不等于持续有效的独立备份,删除动作也可能传播;服务器凭据与订阅链接应按敏感数据管理。
Diagnostics
是什么、在哪: Diagnostics 提供定位连接与请求问题的辅助信息。进入 Settings 中的相应入口,先查看工具实际检查的对象和当前输出,不把单项诊断结果扩大解释为整个网络的结论。
怎么用: 记录发生问题的目标、当前 Global Routing、选中的服务器以及网络类型,再复现一次。检查是域名解析失败、连接超时、认证失败还是策略选择不符合预期,随后只调整对应环节。相同故障在不同网络出现时,也应分别记录,不要混在同一次诊断里。
注意什么: 导出或分享前检查日志中是否含有服务器地址、订阅链接、认证字段及个人访问记录,按最小必要范围提供。需要进一步定位时,可按症状进入排查手册 ;不需要为了求助公开完整配置。
设置后的检查
按顺序验证配置
把“服务器可用”“模式正确”“规则命中”分开确认,能够减少反复改动。
检查输入。 在 Home 核对服务器或订阅是否已导入,协议字段是否完整;不要只看条目名称判断导入正确。
检查连接。 使用一致的 Test Method 执行 Connectivity Test,再发起实际请求。测试失败时先定位服务器、本地网络或认证信息。
检查模式。 在 Global Routing 确认 Config、Proxy 或 Direct 是当前准备验证的模式,避免测试结束后遗留临时选择。
检查配置。 使用 Config 时确认正确的配置处于启用状态,核对规则顺序、策略引用与最终处理。
检查自动行为。 最后恢复 On Demand 等自动触发项,切换网络复测一次,确认自动连接与分流均符合预期。
如果一次修改后出现异常,先恢复上一步的可用设置,再按单一变量重新验证。需要从导入开始操作时,阅读首次使用教程 ;已经能够连接但个别目标失败时,优先阅读按症状组织的排查手册 。客户端下载与安装问题统一在全平台下载页 处理,不需要通过修改规则解决。