官方手册 · 功能与设置
Shadowrocket 代理模式与设置
Global Routing 决定连接如何分配，Config 保存规则与网络参数，Home 管理服务器和连接状态。先分清这三层，再调整 On Demand、DNS 或测试方式，才能判断一次改动实际影响了什么。
本页以 iPhone、iPad 上的常用操作为主。界面入口可能随设备与应用界面调整，具体选项以当前应用显示为准；系统要求以 App Store 页面标注为准。
- 路由姿态 Config / Proxy / Direct
- 规则执行 自上而下匹配
- 设置原则 一次只改一项
Home · Global Routing
三种姿态的适用范围
Global Routing 位于 Home，用来选择连接的总体处理方式。配置、代理、直连分别对应界面中的 Config、Proxy、Direct；中文仅说明含义，操作时按英文选项辨认。进入 Global Routing 后选择所需姿态，再回到 Home 核对当前服务器与连接开关。选择姿态与启动连接是两个动作，只改变选项不等于连接已经建立。
| 界面选项 | 处理方式 | 适用情形 | 先核对 |
|---|---|---|---|
| Config | 按当前配置中的规则决定策略 | 日常按域名或地址分流 | 正在使用的 Config、规则顺序与最终规则 |
| Proxy | 将适用连接交给当前代理处理 | 临时检查代理链路是否可用 | 当前选中的服务器及连接参数 |
| Direct | 将适用连接直接发往目标 | 检查本地网络或比较直连表现 | 本地网络与目标本身是否可达 |
Config：按规则分配连接
需要让部分网站使用 PROXY、其他连接使用 DIRECT 时，通常选择 Config。先在 Config 页确认当前使用的文件，再回 Home 选择 Config。规则文件只是保存在列表中、却没有被选为当前配置时，修改它不会改变实际分流。排查时还要区分文件里的策略名称与 Home 选择的服务器：前者决定如何处理，后者影响代理连接的实际去向。
Proxy：检查代理链路
Proxy 适合用来缩小故障范围。例如同一目标在 Proxy 下可以访问，在 Config 下失败，可以继续检查命中规则与 DNS，而不必立即改动全部服务器参数。它不是对所有系统连接必经路径的保证；系统流量、已有连接和配置相关的绕过行为仍需分别判断。完成对照后，应恢复原先需要的姿态。
Direct：检查直连路径
Direct 用于直接连接目标，不等同于关闭 Home 的连接开关。需要保留应用连接状态、同时比较本地网络表现时，可以临时选择 Direct；需要停止由应用建立的 VPN 连接时，则应操作 Home 的开关，并检查 On Demand 是否会再次触发。不要把 Direct 当成 DNS 设置的重置按钮，解析问题仍需单独检查。
Config · Rule
规则类型与执行策略
规则由匹配条件和处理策略构成，通常在 Config 页编辑当前配置的 Rule 内容。规则按顺序判断，命中适用规则后使用对应策略，因此更具体的规则应放在更宽泛的规则之前。编辑前保存一份可恢复的配置，修改后核对当前启用文件；验证时重新发起访问，避免把已有连接的表现误当成新规则的结果。
| 关键字 | 匹配对象 | 使用注意 |
|---|---|---|
DOMAIN | 一个完整域名 | 用于只指定某个主机名的情形 |
DOMAIN-SUFFIX | 指定域名及其子域名 | 不要填写协议头或网页路径 |
DOMAIN-KEYWORD | 域名中包含的关键词 | 覆盖范围较宽，需留意误匹配 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址范围 | 确认地址与前缀长度对应 |
GEOIP | 地址所属地区数据 | 结果受地址库与解析结果影响 |
FINAL | 前面没有命中的连接 | 通常作为规则末尾的兜底 |
PROXY、DIRECT 与 REJECT
PROXY 表示按代理策略处理，DIRECT 表示直接连接，REJECT 表示拒绝连接。它们是规则中的策略关键字，不是服务器协议名。若配置使用自定义策略组，还应检查组内选择与可用成员，不能仅看到规则末尾有一个名称就认定实际连接一定经过某台服务器。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT这段教学示例让 example.com 及其子域名使用 PROXY，其余未匹配连接使用 DIRECT。example.com 只是规则示例，不是服务器或订阅。实际网站可能调用其他域名上的图片、登录或接口，首页可访问不代表所有相关请求都命中同一规则。需要扩展时，应从实际请求记录确认域名，而不是不断放宽关键词。
Home · SERVER · Subscribe
订阅与服务器管理
Home 的 SERVER 区块用于查看和选择服务器。订阅则是批量导入、更新用户已有服务器信息的一种方式，两者都不等于规则配置。以下操作以用户已有自己的订阅或服务器信息为前提；本站只说明管理与使用方法，不提供、不销售、不推荐节点或订阅。
Add Server：手动填写已有信息
在 Home 打开 Add Server，先按已有资料选择 Type，再填写地址、端口及身份验证字段。Shadowsocks、VMess、VLESS、Trojan 等协议的字段要求不同，不应只因为地址相同就套用另一种 Type。涉及 TLS、传输方式或相关名称字段时，逐项按原有资料核对；保存后回到 SERVER 选择该条目，再执行 Connectivity Test。
Subscribe：导入与更新已有订阅
通过 Add Server 中相应的 Subscribe 类型填写已有订阅地址，保存后检查生成的分组和条目。订阅地址可能包含身份凭据，粘贴前确认内容完整，不带前后空格或换行，也不要公开到截图、文章或聊天记录中。完整的首次导入流程见已有订阅与服务器导入。
更新订阅是重新读取远端提供的条目，不是更新应用本身。更新后应核对当前服务器是否仍然存在、名称或分组是否发生变化，以及手动修改的字段是否被重新覆盖。准备清理重复条目时，先辨认它来自订阅还是手动添加，避免下一次更新重新出现。二维码等导入方式也只用于已有资料，导入后仍需核对协议和参数。
Settings · On Demand
按需连接的触发条件
On Demand 用于根据网络条件触发连接行为，例如切换到指定 Wi-Fi、使用蜂窝网络，或满足相关域名条件时进行连接判断。它处理的是“什么时候连接”，Global Routing 处理的是“连接之后怎么路由”，两者不能互相替代。应先确认手动连接可用，再配置自动触发。
在 Settings 中找到 On Demand 相关设置，按当前界面提供的条件添加规则。先只设置一个能复现的条件，例如某个 Wi-Fi 名称，再切换网络观察结果。确认连接与断开行为符合预期后，再增加其他条件；若存在多条规则，应核对顺序、适用网络和动作，避免范围较宽的规则抢先匹配。
Wi-Fi 名称需要与实际网络一致，蜂窝网络条件则需要在真实网络切换后验证。域名触发不应只用已打开的网页判断，因为缓存和已有连接可能影响观察结果。测试时关闭旧页面，重新发起请求，并检查系统与 Home 中的连接状态。
手动关闭后又出现连接状态，应先检查 On Demand，而不是反复删除配置。临时排查时可以先停用相关触发条件，再测试手动开关；测试结束后按原有需求恢复。完整的条件设置思路见On Demand 按需连接说明。
Data
流量统计的观察方法
Data 用于查看应用记录的流量信息，帮助判断连接期间是否有数据传输。进入 Data 后，先辨认当前界面显示的统计范围、时间范围与上下行含义，再比较数值变化。应用内部统计与系统蜂窝用量、网络服务的计量口径可能不同，不应把其中一个数字直接当作另一个系统的账单依据。
观察某个问题时，可先记下当前读数，再执行一次明确的访问操作，然后返回 Data 检查变化。如果应用提供重置入口，只有在确认无需保留现有记录后再使用；重置统计不会重置服务器、规则或远端服务的用量。后台活动也可能产生传输，测试期间应尽量减少其他应用的请求干扰。
有上传却看不到预期下载，只能说明传输没有按预期完成，不能单凭这一现象确定是服务器、DNS 还是目标响应异常。需要结合 Connectivity Test 与请求记录继续判断。Data 也不是连接速度承诺：一次短请求的流量变化，不能代表持续下载表现，更不能代替实际业务访问测试。
Settings · 常用项
解析、测试与辅助设置
Settings 集中放置应用行为和辅助功能，但部分网络参数也可能来自当前 Config。调整前应先辨认该项作用于应用整体，还是仅作用于一个配置文件。不同设备上的入口、可用性及系统支持可能不同，以下按功能说明检查方式，不把某一界面布局当成所有设备的固定位置。
DNS：先确认生效来源
DNS 将域名解析为地址。检查 Settings 的 DNS 相关选项时，也要查看当前 Config 的 General 段落是否设置了 dns-server 等字段。记录原值后一次只改一个来源，不要同时更换解析设置、服务器和 Global Routing，否则即使恢复访问也难以确定原因。
[General]
dns-server = system这行表示使用系统提供的解析设置，是理解字段含义的示例，不是适合所有网络的固定答案。出现测试有响应、网页却打不开的情况，应分别检查域名解析、连接建立与目标响应。已有解析缓存可能让一次修改看起来没有生效，验证时需要重新发起请求，并确认正在使用的配置。详见DNS 解析失败排查。
Test Method：统一测试口径
Test Method 决定 Connectivity Test 使用的测试方式。可在 Settings 的测试相关设置中查看当前选项，并按界面允许的范围调整测试目标或方式。不同方式测量的阶段不同，不能把不同测试口径的结果直接排序比较；对比服务器时，应保持测试方式、目标和当前网络一致。
Connectivity Test 成功，只能说明该次测试条件下得到响应，不能证明所有网站、所有协议都可用。若测试方式涉及某个目标，而该目标自身不可达，结果也可能失败。应先核对测试条件，再使用一个实际需要访问的目标完成复核。
Today Widget：查看快捷入口
Today Widget 用于系统支持的小组件或快捷展示场景。先在 Settings 查看相关选项，再到系统允许的小组件管理位置确认是否可以添加。可用形式与操作能力受系统及应用支持影响，不应把其他设备上看到的布局直接套用到当前设备。
从组件操作后，如果状态显示与预期不同，应返回 Home 核对连接开关、当前服务器和 Global Routing。组件是辅助入口，不代替完整设置页；首次系统授权、参数编辑和详细排查仍需在应用或系统对应页面完成。
iCloud：区分同步与恢复
iCloud 相关功能用于在支持的范围内保存或同步资料。使用前先确认设备已登录预期的 iCloud 账户，系统允许应用使用 iCloud，并在应用中检查可同步的具体项目。不要假定打开同步就包含所有服务器、配置、历史记录与统计，实际范围应以当前界面说明为准。
更换设备或合并资料前，保留独立备份，观察同步完成情况，再检查当前 Config 和 SERVER。App Store 的购买记录与配置同步是两件事：恢复应用购买不等于找回连接资料。已有资料若含凭据，应按敏感信息保存，并避免在公开位置展示同步或导出内容。
Diagnostics：保存必要诊断信息
Diagnostics 用于收集或查看排查所需的信息。先记下问题发生时间、当前网络、路由姿态及复现操作，再进入 Settings 中的 Diagnostics 相关入口查看可用内容。若界面提供额外记录开关，仅在复现问题所需的时间内开启，完成后恢复日常设置。
分享诊断内容之前，检查其中是否包含订阅地址、服务器信息、身份凭据、访问域名或个人网络名称，并做必要遮盖。记录越多不一定越容易定位；一份能对应明确操作与时间的记录，通常比多次随意切换设置后产生的大量内容更便于判断。
检查顺序
把设置变更连成流程
- 保留原始状态。记下当前 Config、Global Routing 和所选服务器，保存可恢复的配置。涉及订阅或账户资料时，不在公开记录中写入完整凭据。
- 先检查本地网络。确认 Wi-Fi 或蜂窝网络本身可用。需要对照时临时使用 Direct，测试后恢复原姿态；不要把本地网络故障与规则错误混在一起。
- 验证已有服务器。检查 Type、地址、端口与验证字段，再在相同 Test Method 下执行 Connectivity Test。测试后还要访问实际目标，确认不只是测试请求得到响应。
- 最后调整规则。在 Config 下检查命中顺序与 FINAL，一次只修改一处。重新发起访问，确认目标及其相关请求是否使用预期策略。
- 恢复自动行为。手动连接稳定后，再开启 On Demand，检查网络切换场景；随后核对 Data 与必要的 Diagnostics，结束临时测试与额外记录。
新用户可从快速上手按顺序完成首次设置；已经出现具体症状时，转到疑难手册的连接问题逐项排查。需要辨认界面词或规则关键字时，可查阅术语手册。