官方手册 · 功能与设置

Shadowrocket 功能介绍
与常用设置

先确定 Global Routing，再检查 Config 与当前服务器；连接正常后，再设置 On Demand、DNS 与同步。每次只改变一个变量，便于核对设置对实际连接的影响。

按步骤查看使用说明 App Store 正版获取说明
  • Home
  • Config
  • Data
  • Settings

GLOBAL ROUTING

三种路由模式的使用时机

Global Routing 决定进入 Shadowrocket 的连接按什么方式处理。在 Home 中打开 Global Routing，选择 Config、Proxy 或 Direct。中文说明分别称为配置、代理、直连；这三个选项改变路由方式，并不负责创建服务器，也不会替你补齐连接参数。设置完成后返回 Home，核对当前服务器与连接开关。

模式 处理方式 适用时机 核对重点
Config（配置） 依据当前启用的配置规则选择策略。 需要按域名、地址段等条件分流时。 启用的配置文件、规则顺序、策略引用。
Proxy（代理） 以代理路由处理流量，仍受系统与应用适用范围限制。 临时检查当前服务器能否承载目标连接时。 服务器可用性、协议参数、目标访问结果。
Direct（直连） 以直连路由处理流量，不借此验证代理服务器。 临时检查本地网络与目标本身是否可达时。 本地网络、域名解析、目标服务状态。

日常需要规则分流时使用 Config。若某个目标在 Config 下失败、在 Proxy 下可以访问，应优先检查规则命中了什么策略，而不是立即更换协议。如果 Direct 也无法访问，则应继续核对本地网络和目标状态；一次访问失败本身不能说明问题一定出在客户端。

Proxy 与 Direct 适合作为对照条件，但不要在测试结束后忘记恢复原模式。切换模式后，已有长连接未必立即重建；验证时重新发起请求，必要时在保存设置后重新连接。Global Routing 也不等于系统所有通信的绝对覆盖范围，系统服务和应用自身的连接行为仍可能影响观察结果。

RULE MATCHING

规则类型、策略与匹配顺序

规则用于描述“什么连接交给什么策略”。在 Config 中检查当前启用的配置文件与规则内容，并让 Global Routing 使用 Config。规则类型说明匹配条件，策略说明匹配后的处理方式；二者不能混为一谈。通常应先放范围明确的规则，再放范围较大的规则，最后检查兜底项。

DOMAIN

DOMAIN-SUFFIX

按域名后缀匹配。例如 example.com 可覆盖该域名及其子域名。DOMAIN 用于精确域名，DOMAIN-KEYWORD 则按关键字匹配；关键字过宽容易覆盖原本不想处理的目标。

ADDRESS

GEOIP

依据 IP 归属数据库匹配，并非按页面使用的文字或内容判断。数据库记录、解析结果和实际服务部署位置可能不同，不能仅凭网站名称推断它会命中哪个 GEOIP 条件。

NETWORK

IP-CIDR / IP-CIDR6

分别匹配 IPv4 与 IPv6 地址段。设定前核对地址族和前缀长度；同一域名可能返回不同地址，只有 IPv4 规则时，不应据此推断 IPv6 连接也会得到相同处理。

FALLBACK

FINAL

作为前面条件未匹配时的兜底规则。它不带域名或地址段匹配值。检查 FINAL 的策略有助于解释为什么一个没有专门规则的目标最终仍走了代理或直连。

PROXY、DIRECT 与 REJECT

PROXY 表示代理处理，DIRECT 表示直连处理，REJECT 表示拒绝对应连接。配置中若使用自定义策略或策略组名称，还需确认引用名称存在且拼写一致。下面是语法说明片段，不是完整配置文件；其中的示例域名只用于解释规则结构。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

REJECT 的作用对象是连接，而不是页面里的某一块内容。若页面正文与其他资源共用域名，拒绝该域名可能同时影响正常功能。USER-AGENT 等条件也依赖客户端能够取得相应信息，并非适用于所有加密连接。修改规则后，应结合实际连接记录核对目标、命中项与最终策略，不要只凭页面看起来是否变化作判断。

需要理解协议字段与选择依据时，可继续阅读协议技术参考。规则命中错误与协议参数错误属于不同层次，排查时先确定流量去了哪里，再检查那里能否建立连接。

SERVER MANAGEMENT

已有订阅与服务器管理

服务器条目保存单个连接所需的地址、端口、协议与认证参数；订阅则用于取得和更新一组条目。这些信息主要在 Home 管理。用户已有订阅时，可通过 Add Server 进入添加流程，选择 Subscribe 并填写完整链接；已有单个服务器信息时，选择实际协议类型，再按资料逐项录入。已有二维码可使用 Scan QR Code，导入后仍需检查内容。

导入之后先核对，再连接

保存后检查条目名称、协议类型、服务器地址与端口，确认选中的确实是准备使用的服务器。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的参数结构不同，不能只修改 Type 就把一种协议转换成另一种。TLS 名称、传输设置等附加字段也应与已有资料一致，不应为使测试通过而随意关闭验证。

订阅更新用于重新获取远端列表，并不保证原来的条目名称和数量保持不变。更新前先核对订阅分组，更新后再次确认当前选择。若手工编辑了订阅生成的条目，还应留意后续更新是否覆盖修改；需要长期保留的独立设置，应先确认应用中的保存与管理方式。

列表为空与连接失败分别处理

列表为空时，先检查链接是否复制完整、是否夹带空格，以及返回内容是否符合支持的订阅格式，再确认已有订阅的有效状态。列表存在但连接失败时，才进入地址、端口、认证和网络可达性的检查。Config 中的路由配置与 Home 中的服务器列表用途不同，导入订阅不代表已经启用合适的分流配置。

订阅链接可能包含访问凭据。反馈问题时只描述错误类型，截图和日志应遮盖链接参数、认证字段与个人地址；不要把完整链接粘贴到公开讨论区。具体导入顺序见使用说明。

ON DEMAND

按需连接的条件与验证

On Demand 用于根据已配置的条件触发系统建立 VPN 连接。它解决的是“何时连接”，不是“连接后如何分流”；后者仍由 Global Routing 和当前配置决定。它也不同于订阅自动更新，不会通过自动连接补齐失效的服务器信息。

在 Settings 中查找 On Demand，检查当前版本显示的条件项，再按实际使用的网络环境设置。首次设置前，应先在 Home 手动连接并验证服务器可用，之后再开启自动触发。若包含 Wi-Fi 相关条件，逐项核对网络名称与对应动作，避免把原本要排除的环境设为连接条件。

设置后分别在符合与不符合条件的环境下测试，并观察系统 VPN 状态及应用中的连接状态。手动断开后又连接，不一定是开关失效，也可能是 On Demand 条件再次成立。临时排查时，先记录原条件，再暂停 On Demand，完成手动测试后恢复。

DATA

流量统计与连接结果的区别

Data 用于查看客户端记录的流量信息。进入 Data 后，先确认页面展示的统计范围与计数含义，再比较上传、下载等项目。流量计数说明客户端观察到了数据传输，不代表目标页面一定正常，也不能单独证明所有请求都使用了预期策略。

需要观察某个操作时，先记下现有计数，再完成一次明确的访问，随后返回比较变化。若当前界面提供清零操作，应在确认不需要历史数据后使用，并记住清零只影响相应统计，不会清除服务侧用量。后台应用和系统活动可能同时产生流量，测试时尽量减少其他传输。

Data 不是订阅剩余额度的统一查询入口。客户端统计与已有服务的计费记录可能因统计周期、协议开销和重置时间而不同。检查“用量为何不一致”时，先对齐时间范围与统计口径；检查“为什么无法访问”时，则转向连接记录、DNS 与服务器状态，不要把流量数字当作可用性结论。

SETTINGS & DIAGNOSTICS

常用设置的检查顺序

Settings 集中提供连接、测试及辅助功能相关设置，部分选项也可能由当前 Config 中的内容控制。操作时以当前应用实际显示的项目为准，先记录原值，再修改一项并验证。不要把多份配置中的 DNS、测试和自动连接选项一次叠加，否则很难判断哪一项导致变化。

DNS：先确认由哪一层控制

DNS 把域名解析为地址，解析结果会影响后续连接与部分规则匹配。先在 Settings 检查 DNS 相关选项，再查看当前 Config 是否包含 DNS 设置；不要只改一处就假定已经生效。使用已有配置时，应先理解其中解析请求的路由与回退安排。

遇到域名无法访问而地址可达的情况，可把解析作为检查方向，但这只是线索。证书名称、服务端要求和缓存也可能造成差异。更改 DNS 后重新发起请求，必要时重新连接，并结合诊断结果核对；不应仅凭某个解析地址看起来熟悉就判断设置正确。

Test Method 与 Connectivity Test

Test Method 用于选择连接测试采用的方法，Connectivity Test 用于执行相应测试。先在 Settings 核对 Test Method，再回到服务器列表对需要检查的条目进行测试。不同方法测量的对象不同，结果不能直接当作下载速度，也不宜把不同方法得到的数值混在一起排名。

测试成功只能说明对应测试条件下完成了交互，不能保证所有目标均可访问。测试失败也应结合方法、目标和当前网络判断；有些测试行为可能受网络条件限制。比较条目时保持方法和网络环境一致，最后仍以实际业务访问结果为准。

Today Widget：辅助入口与状态核对

Today Widget 是系统小组件相关的辅助功能。在 Settings 中查看对应选项，并在设备系统允许的位置添加或管理组件。可用位置、展示形式与操作能力受系统环境和应用当前实现影响，以设备实际显示为准。

组件状态不宜替代 Home 中的完整检查。若通过组件操作后发现状态不一致，返回应用确认连接开关、Global Routing 与服务器选择。首次使用仍应在应用内完成配置和必要的系统授权。

iCloud：区分同步与购买记录

iCloud 相关功能用于应用支持范围内的数据同步。在 Settings 中核对同步选项，并检查设备系统中的 iCloud 可用状态。另一台设备上看到资料前，应确认两端使用的账户、同步权限与网络条件符合要求；不要假设任意修改都会立即出现在另一端。

同步范围以应用当前说明为准，不能默认包括全部服务器凭据、统计历史和系统 VPN 授权。重要配置调整前先保留可恢复的副本。App Store 已购记录与 iCloud 数据同步属于不同机制，恢复购买不等于恢复配置，导入配置也不等于完成购买。

Diagnostics：保留线索后再修改

Diagnostics 用于收集和查看排查连接所需的信息。在 Settings 查找对应入口，先复现一次问题，再检查或导出当前可用的诊断内容。记录问题发生时的网络类型、Global Routing、目标域名、当前配置与错误现象，有助于区分解析、建连和规则处理阶段。

反馈前检查日志是否包含订阅地址、认证信息、个人域名或其他敏感内容，并按需要遮盖。诊断日志是一段时间内的观察记录，不是所有历史行为的完整证明。若更改设置后问题消失，也应记录改动项，而不是继续批量重置其他选项。

本文主要说明 iPhone 与 iPad 上的功能。Mac、Apple TV 与 Apple Vision 的兼容性、系统要求及购买适用条件，以 App Store 页面标注为准；不同设备的界面安排可能不同，不应将本页操作位置直接视为所有设备的固定布局。