官方手册 / 功能与常用设置
Shadowrocket 设置说明
先确定 Global Routing 的工作方式，再检查 Config 中的规则与策略，最后调整按需连接、DNS 和测试选项。每次只改一项，用相同目标验证，才能判断变化来自哪里。
- 路由入口 Global Routing
- 配置入口 Config
- 统计入口 Data
按功能查找设置
以下为页内章节链接，不会切换或隐藏正文。各项名称以设备上当前应用显示为准；遇到位置差异时，先按英文名称查找，不要套用其他设置项。
Global Routing：配置、代理与直连
是什么：Global Routing 决定客户端处理请求时采用哪种路由方式。三种常用姿态是 Config（配置）、Proxy（代理）和 Direct（直连）。它们不是速度档位，而是决定是否按配置规则判断去向的工作方式。
在哪个界面、怎么设：在 Home 中打开 Global Routing，选择所需模式，再返回核对当前显示。日常需要按域名、地址等条件分流时使用 Config；需要暂时检查选中代理连接是否可用时使用 Proxy；需要对照本地网络直接访问情况时使用 Direct。
| 界面选项 | 工作方式 | 适用场景 | 先检查什么 |
|---|---|---|---|
| Config（配置） | 按当前启用配置的规则及策略处理请求。 | 需要区分直连、代理或拒绝的日常使用。 | 启用的文件、规则顺序、策略名称。 |
| Proxy（代理） | 将客户端接管的请求按代理方式处理，仍须考虑应用及系统的相关处理条件。 | 隔离规则因素，核对所选代理的可用性。 | 选中服务器、连接参数、测试目标。 |
| Direct（直连） | 将客户端接管的请求按直连方式处理。 | 对照本地网络，检查是否为代理路径问题。 | 当前网络本身能否访问同一目标。 |
注意什么：Direct 不等于关闭客户端连接，Proxy 也不应被理解为系统内每一种通信都必然经过同一路径。模式切换后，已有长连接可能继续沿用先前状态；验证时重新发起请求，必要时结束相关连接再测试。为排查临时切到 Proxy 后，应记得恢复原先需要的 Config。
规则分流：匹配条件与策略去向
是什么：规则由匹配条件和处理策略组成。匹配条件回答“这是哪个请求”，策略回答“匹配后送到哪里”。在 Config 模式下，常见规则按顺序判断，前面命中的规则会影响后续规则是否还有机会生效，因此应把明确、范围小的例外放在宽泛条件之前。
在哪个界面、怎么设：在 Config 中检查当前启用的文件，进入对应编辑入口查看规则。先确认目标需要按完整域名、域名后缀还是 IP 网段匹配，再填写规则值与策略。保存后确认启用的是刚修改的文件，并对同一目标重新发起连接。
| 规则关键字 | 匹配依据 | 核对要点 |
|---|---|---|
DOMAIN | 完整域名。 | 只填域名，不填路径或协议前缀。 |
DOMAIN-SUFFIX | 域名后缀及相应子域名。 | 后缀范围可能覆盖多个服务。 |
DOMAIN-KEYWORD | 域名中包含的关键词。 | 匹配范围较宽，先排查误命中。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址网段。 | 核对地址族、前缀长度及解析条件。 |
GEOIP | IP 地理归属数据。 | 数据归属不等于服务实际使用地区。 |
FINAL | 前面规则未命中时的最终去向。 | 作为兜底放在规则末尾。 |
DIRECT、PROXY 与 REJECT
DIRECT 表示直连，PROXY 表示使用代理策略，REJECT 表示拒绝。配置也可能引用自定义策略组名称；名称需要在该配置中有对应定义，不能仅凭文字猜测其实际出口。规则关键字的大小写及分隔符应保持规范。
以下仅为规则语法示意，不是应用界面，也不是可直接覆盖现有文件的完整配置。示例中的 example.com 只用于说明后缀匹配。
DOMAIN-SUFFIX,apple.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY注意什么：规则不按预期工作时，先看更靠前的规则是否已经命中，再核对请求记录中的实际域名和 IP。一个页面可能访问多个域名，只给主域名添加规则不一定覆盖全部资源。不要通过反复增加宽泛关键词来掩盖真正的匹配问题。
Subscribe：已有订阅与服务器管理
是什么：Subscribe 是通过用户已有的订阅地址导入并更新服务器信息的方式。订阅通常管理一组服务器；单独添加服务器则由用户维护各项参数。订阅更新与 App Store 中的应用更新是两件事，更新其中一项不会自动替代另一项。
在哪个界面、怎么设：在 Home 使用添加入口进入 Add Server，按当前界面提供的 Subscribe 选项填写自己的订阅地址与备注，保存后执行更新，再检查分组及条目是否出现。已有二维码可通过 Scan QR Code 导入；导入后仍应检查类型、地址和端口，而不是只看备注名称。
手动维护服务器时，在 Add Server 中先选正确的协议类型，再填写地址、端口和对应凭据。备注只用于辨认，不决定连接行为。建议用便于识别的用途或自定义名称区分条目，避免多个同名项目导致误选。
注意什么：订阅地址可能含个人访问凭据，不要放进公开截图、日志或反馈文本。更新后条目名称、分组和数量可能随源内容改变；对订阅条目的本地修改也可能被后续更新影响，修改前先保留必要记录。更新失败时应区分地址失效、请求超时与内容解析失败，不要立即删除仍可用的整组条目。
本站只讲解已有内容的导入与管理。订阅是否有效、是否允许多设备使用及其服务期限，应以用户已有服务的说明为准，不能从应用购买记录推断。
多协议：先匹配类型，再填写参数
是什么：协议决定客户端与服务器之间如何建立连接及交换数据。Shadowrocket 可处理多种协议，常见名称包括 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2；具体可选类型及参数以应用内 Add Server 显示为准。
在哪个界面、怎么设：在 Add Server 的类型选择中，按已有服务器信息选择相应协议。随后逐项核对地址、端口、认证信息，以及该类型要求的 TLS 或传输相关字段。导入链接也需要包含正确类型；不能把某种协议的字段直接照搬到另一种类型。
注意什么：相同服务器地址不代表不同协议可以互换，显示名称也不能证明参数正确。域名、TLS 校验名称、传输路径等字段用途不同，填入前应对照自己的连接资料。连接失败时优先检查缺项和输入错误，不应把关闭证书校验当作常规排查步骤。协议名称本身也不能保证特定网络中的速度或稳定性。
Config：配置文件的启用与变更
是什么：Config 是配置文件的管理入口。配置可以包含规则、策略与其他相关选项；服务器订阅则主要解决连接条目的导入与更新。两者用途不同，导入订阅后不应假定分流规则也已按个人需求设置完成。
在哪个界面、怎么设：在 Config 查看文件列表，先记录当前启用项，再打开待修改文件。编辑前保留原文件副本，阅读其中已有规则与策略组的关系；保存后选择相应文件并核对当前启用状态。若使用远程来源，先确认内容用途与可信程度，再决定是否更新。
注意什么：远程文件的后续更新可能改变本地预期，尤其是规则顺序、策略组名称或解析设置。不要把来源不同的规则片段直接拼接而不检查引用关系。出现问题时，恢复上一个已验证可用的文件通常比继续叠加修改更便于定位。配置中若含私人地址或凭据，备份与同步时同样需要按敏感信息处理。
On Demand：按条件触发连接
是什么：On Demand 用于按条件触发或维持系统 VPN 连接行为。它与规则分流不是同一层设置：On Demand 处理“何时连接”，Config 中的规则处理“连接后请求走哪里”。启用按需连接不会自动修正服务器参数或补齐规则。
在哪个界面、怎么设：打开应用内 On Demand 设置入口，先检查现有条件，再按当前界面支持的网络条件添加规则。可围绕 Wi-Fi、蜂窝网络或域名相关条件组织按需行为，具体动作与字段以应用内显示为准。首次设置建议只保留一个明确条件，确认生效后再扩展。
- 先在手动连接状态确认已有服务器和配置能够正常使用。
- 记录测试所用网络，添加相应条件与动作，检查规则顺序。
- 切换到符合条件的网络，观察系统 VPN 状态及实际请求。
- 再测试不符合条件的场景，确认不会出现意外重连或断开。
注意什么：Wi-Fi 名称要精确核对，多个条件重叠时要检查先后顺序。开启 On Demand 后，手动断开可能因条件再次满足而重新连接；这是排查时需要先确认的因素。临时排查应先停用按需触发，避免自动行为干扰对照；测试完成后再恢复原设置。按需连接也不等于停止后台通信，电量表现仍取决于实际请求、网络状况及重连频率。
Data：流量统计与请求核对
是什么：Data 提供客户端记录范围内的流量统计，可用于观察上传、下载及相关请求变化。它适合回答“哪段时间出现了传输”“哪些请求值得继续检查”，不能直接替代蜂窝网络账单或用户已有服务中的用量记录。
在哪个界面、怎么设：进入 Data，先核对当前统计范围与显示口径，再查看相关记录。测试某个目标时记下开始时刻，发起少量新请求，随后对照流量变化；需要进一步确认路由结果时，结合应用内可查看的连接记录检查目标和去向。重置统计前先保存需要对比的数值。
注意什么：应用记录、系统统计和远端用量可能因为计数时段、协议开销及统计范围不同而不一致。不能仅凭下载数字较大就判断某条规则错误，也不能把测试期间其他应用的后台通信算作目标请求。排查时尽量保持测试条件一致，避免同步、媒体播放等并行传输干扰判断。
Settings：解析、测试、组件与同步
Settings 中的选项影响不同层面的行为。先说明要解决的问题，再调整对应设置；功能名称、可用范围及入口以当前应用与系统显示为准。
DNS：先区分解析问题与连接问题
是什么、在哪里：DNS 将域名解析为 IP 地址。检查 Settings 中的 DNS 相关选项时，也要核对当前 Config 是否包含解析设置，避免只修改了并未实际使用的项目。
怎么设、注意什么：先保留原有值，用同一个域名核对解析是否成功，再根据已有网络要求选择系统 DNS 或自定义解析方式。使用 DNS over HTTPS 时，还要考虑解析服务自身的可达性；若解析请求依赖尚未建立的连接路径，可能形成启动问题。网页打不开不一定是 DNS 原因，错误地址、服务器认证与规则去向应分别检查。详细原理可阅读DNS 设置说明。
Test Method：统一测试方式再比较
是什么、在哪里：Settings 中的 Test Method 影响 Connectivity Test 使用的测试方式。测试结果反映的是所选方法、目标及当时网络条件，不是对服务器完整使用体验的保证。
怎么设、注意什么：按界面提供的选项选择一种方法，保持测试目标与网络不变后再比较已有条目。方法不同的数值不宜直接排序；测试超时也不必然代表所有应用请求都无法连接。应再用实际需要访问的目标验证，并区分握手失败、解析失败和目标响应慢。不要通过反复测试把瞬时最低值当成稳定表现。
Today Widget：快捷操作后的状态核对
是什么、在哪里：Today Widget 提供系统组件中的快捷入口。相关选项在 Settings 中核对，添加组件则通过系统提供的组件编辑界面完成；可用形式取决于设备与系统实际显示。
怎么设、注意什么：先在主应用完成服务器和路由选择，再添加所需组件。通过组件执行操作后，可返回 Home 核对连接状态与选中项。系统组件的显示可能存在刷新间隔，不能只依据旧的组件文字判断当前连接；若操作未生效，先打开主应用确认授权及状态。
iCloud：同步范围与设备差异
是什么、在哪里：iCloud 相关选项用于应用支持范围内的数据同步。在 Settings 核对应用同步选项，同时检查系统中的 iCloud 访问权限。应用购买记录与配置同步分属不同机制，不应混为一谈。
怎么设、注意什么：在原设备确认同步状态，再到另一设备检查实际同步到的项目；修改前保留一份可恢复的配置。不要假定所有本地历史记录、系统 VPN 授权和设备状态都会完整迁移。同步内容也可能包含私人服务器资料，应妥善管理账户与设备访问权限。新设备首次连接仍需按系统提示完成相应授权。
Diagnostics：用对照记录定位问题
是什么：Diagnostics 是诊断相关功能入口，用于查看或收集排查所需的信息。诊断的目的不是一次修改所有选项，而是把失败定位到本地网络、服务器连接、域名解析或规则处理中的某一层。
在哪个界面、怎么设：从 Settings 查找 Diagnostics，按当前界面提供的工具检查连接或记录。先写下失败目标、网络类型、Global Routing 模式及启用的 Config，再复现一次问题。若诊断要求临时开启记录，完成复现后及时关闭，并检查导出内容是否含敏感资料。
- 检查基础网络。确认设备当前网络本身可用，区分整个网络不可用与单一目标异常。
- 检查服务器。核对已有连接资料，使用 Connectivity Test，并记录测试方法，而不是只记一个数值。
- 检查模式与规则。临时使用 Proxy 对照 Config；若表现不同，再检查规则命中及策略引用。
- 检查解析。仅在域名解析异常时检查 DNS，避免把服务器认证失败归因于解析。
- 恢复测试改动。恢复原模式、按需条件及记录设置，保留一次只改一项的结论。
注意什么：诊断记录可能暴露访问域名、服务器地址、订阅参数或认证信息。对外说明问题时，保留错误类型和必要上下文，遮蔽私人字段；不要公开完整配置与原始订阅地址。工具输出只是证据的一部分，应与实际请求及当前设置共同判断。