OFFICIAL MANUAL / SETTINGS

Shadowrocket 设置与功能说明

先确定请求如何判定，再决定连接何时启动。按 Global Routing、规则、服务器、系统触发与诊断的顺序核对，避免同时修改多项设置后失去排查依据。

Config / Proxy / Direct On Demand Data / Diagnostics

本篇面向 iPhone 与 iPad，界面词保留英文原文。具体可见选项以设备上的 Shadowrocket 为准；系统要求以 App Store 页面标注为准。

01 / GLOBAL ROUTING

配置、代理、直连三种姿态

是什么：Global Routing 决定客户端如何处理纳入其处理范围的请求。Config 按当前配置的规则判定，Proxy 使用代理姿态，Direct 使用直连姿态。这是请求判定方式，不是协议选择器，也不是速度档位。切到 Proxy 不会修正错误的服务器密码，切到 Direct 也不能证明代理服务器可用。

在哪个界面：在 Home 找到 Global Routing，进入后核对当前选中的 Config、Proxy 或 Direct。连接开关与 Global Routing 是不同控制项；看到开关打开，只能说明连接状态发生了变化，不能据此认定某个域名已经命中预期策略。

姿态与界面词 判定方式 适用检查 需要注意
配置 · Config 按照当前生效配置中的规则处理请求。 日常规则分流，或核对某个请求的匹配结果。 需要确认配置已启用，且规则顺序与兜底策略符合预期。
代理 · Proxy 对纳入处理范围的请求使用代理姿态。 短时判断故障是否与 Config 中的分流规则有关。 服务器参数和连接仍须有效，不等于所有系统通信都由同一策略处理。
直连 · Direct 对纳入处理范围的请求使用直连姿态。 对照当前网络直连是否正常。 不能用于验证代理链路，也不等于关闭所有系统网络设置。

按一次对照流程切换

  1. 记录当前 Global Routing、选中服务器与生效配置，确定可以恢复原状态。
  2. 先在 Config 下重现具体问题，记录目标域名与请求结果，而不只描述“无法上网”。
  3. 仅切换到 Proxy，使用同一个目标重新验证。若结果不同，再检查规则命中与策略指向。
  4. 如需判断基础网络，再用 Direct 对照；完成后恢复原先的 Config，并重新测试。

注意什么：测试期间不要同时更换服务器、修改 DNS 和重写配置。否则即使现象改善，也无法确定是哪一项变化产生了作用。实际行为还受配置中的特殊处理、系统路由与目标连接方式影响，应结合请求记录判断，而不是把姿态名称理解为绝对覆盖承诺。

02 / RULE MATCHING

规则类型、顺序与策略

是什么：规则将匹配条件与处理策略连接起来。DOMAIN 匹配指定域名，DOMAIN-SUFFIX 匹配域名后缀及相关子域名，DOMAIN-KEYWORD 按域名中的关键字匹配；IP-CIDR 与 IP-CIDR6 对应地址段，GEOIP 依据地址归属数据判断。USER-AGENT 依赖请求中可识别的相应信息，不能假定每条连接都具备该条件。

在哪个界面：在 Config 中确认当前启用的配置，再查看其中的规则内容。Home 的服务器选择不等于已经切换配置文件；编辑了另一个未生效文件，也不会改变当前请求的判定。检查前先核对文件与 Global Routing 是否为预期状态。

先读条件，再读策略

PROXY 表示交给代理策略处理，DIRECT 表示直接连接目标，REJECT 表示拒绝匹配请求。规则也可能指向配置中定义的策略组，此时还需要检查组内实际选择。策略名不是连接成功保证：命中 PROXY 后仍然可能因为服务器连接失败而无法完成请求。

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

上面是教学片段，不是可直接替换全部设置的完整配置。第一行域名规则针对 example.com 及其子域名，GEOIP 规则用于相应地址归属判定，FINAL 为此前未命中的请求提供兜底。example.com 仅用于说明语法，不代表需要修改的真实目标。

怎么设：先保留配置副本，再把更具体的例外条件放在较宽泛的条件之前，最后检查 FINAL。每次只添加一条有明确用途的规则，保存并确认配置生效后，用对应目标验证。若配置中已有同类规则，应先寻找重复或更早命中的条目，不要只在末尾不断追加。

注意什么：规则通常按顺序判定，前面的匹配会影响后面的规则是否有机会执行。地址类规则可能涉及域名解析，解析结果与数据库内容也会影响判定。REJECT 是请求级拒绝，不是页面内容编辑功能；误拦登录、资源或接口域名，可能表现为页面空白、图片缺失或操作失败。

进一步排查时，应把“规则没命中”“命中了错误策略”“策略正确但连接失败”拆成三个问题。它们对应不同设置，不能统一靠增加域名规则解决。可继续阅读排查手册，按症状检查实际请求链路。

03 / SERVERS & SUBSCRIBE

已有订阅与服务器管理

是什么：服务器条目保存协议、地址、端口、认证与传输等参数；Subscribe 用于更新用户已有订阅中的条目。订阅侧重条目来源与维护，Config 侧重规则及相关设置，两者不能直接画等号。导入了一批服务器，不代表当前规则已经调整，也不代表这些服务器都能建立连接。

在哪个界面：从 Home 查看服务器列表，通过 Add Server 添加用户已有的服务器信息；已有订阅的导入按 Subscribe 对应入口操作。使用 Scan QR Code 前，应先确认二维码来源可信。界面中的字段会随协议变化，只填写当前协议需要的内容，不把另一种协议的参数生搬到同一表单。

导入后核对四项

  1. 核对协议与服务器地址。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段含义不同，名称相近不代表可以互换。
  2. 逐项核对端口、认证信息与传输参数；服务端要求 TLS 或特定名称时，按用户已有配置准确填写。
  3. 选择一个条目执行 Connectivity Test，再进行真实请求验证。列表里出现名称只表示导入结果，不表示连通性已确认。
  4. 记录条目来源和更新方式。需要保留的手工改动先备份，避免下一次 Subscribe 更新后难以恢复。

怎么设：先导入、后选择、再测试，最后才调整规则。订阅失败时，先核对链接是否完整、当前网络能否访问来源、账号侧订阅是否仍有效；成功更新后检查实际条目是否改变，而不是仅凭一次提示判断所有设置都已完成。分享排查材料时，遮盖订阅凭据、密码及个人地址信息。

注意什么：不要把订阅更新当作修复所有连接问题的步骤。某个服务器超时，可能与参数、网络或服务器状态有关；反复删除重导入会丢失有价值的对照信息。完整导入顺序可查看入门指南，正版入口与购买核验见App Store 获取说明。

04 / ON DEMAND

On Demand 按需连接

是什么：On Demand 让系统依据已设置的条件触发连接，解决“何时建立连接”的问题；Global Routing 与规则解决“请求如何处理”的问题。开启 On Demand 不会自动生成分流规则，也不会修正服务器参数，因此应在手动连接能够正常使用之后再设置。

在哪个界面：在 Settings 中查找 On Demand，查看本机实际提供的网络条件与对应动作。配置过程中可能涉及系统 VPN 配置授权；系统弹窗用于确认配置写入，不表示服务器连通性已通过检查。已有其他系统 VPN 配置时，也应确认当前启用的是预期配置。

从单一触发条件开始

  1. 先暂时停用按需触发，手动建立连接，验证当前服务器与 Config 都能按预期工作。
  2. 记录 On Demand 原有设置，只修改一个网络条件与动作；若有 Wi-Fi 条件，仔细核对网络名称。
  3. 在允许的情况下切换 Wi-Fi 与蜂窝网络，观察触发结果，再检查请求是否按原定规则处理。
  4. 测试结束后记录有效条件，避免多条互相覆盖的条件让行为难以解释。

注意什么：手动断开后再次连接，可能是系统重新满足按需条件，而不一定是开关失效。要停用自动触发，应回到 On Demand 核对相关设置，不只反复点击 Home 开关。需要网页认证的 Wi-Fi，应先完成网络本身的认证，再判断连接问题。设备状态、系统策略和网络变化都会影响触发时机，不应把按需连接理解为每个应用各自独立的代理开关。

05 / DATA

Data 流量统计与观察范围

是什么：Data 用于观察客户端记录的流量情况，帮助判断测试期间是否产生了通信，以及上传、下载是否有变化。它不是线路账户余额页面，也不能替代服务方的计费记录。统计值反映客户端所能记录的范围，不应直接视作设备全部网络通信的总量。

在哪个界面：进入 Data，先查看当前显示的统计对象与范围。不同设备上实际提供的明细可能不同，阅读时以本机标题和选项为准。若界面提供重置统计的操作，先保存需要的记录，再决定是否使用；重置本地数字并不会改变外部服务的计费周期。

怎么设：做一次固定目标测试前，记录 Data 中的起始状态；仅打开需要检查的页面或应用，等待请求完成后再对照变化。尽量暂停后台下载与系统更新，否则统计增长可能来自其他任务。需要判断某个目标走了哪条策略时，还要结合请求记录，不能单凭总流量增加就认定它经过了 PROXY。

注意什么：上传和下载的比例取决于实际业务，短时变化不能说明服务器速度稳定。协议开销、重试和统计口径也可能造成数值差异。排查耗电时，可把 Data 与系统电池、蜂窝网络使用记录对照，但不要只凭流量较大就断定客户端异常；持续传输本身就会增加网络活动。

06 / SETTINGS

Settings 常用项

Settings 集中管理部分应用偏好，但不是全部配置的唯一来源。DNS 等设置也可能由当前 Config 定义，检查时应同时查看生效配置与相关界面。以下操作以本机实际显示的入口为准；不存在的选项不要用相似名称替代，更不要在配置中猜写字段。

DNS：解析与路由分开检查

是什么、在哪：DNS 将域名解析为地址，相关设置需在 Settings 的对应入口及当前 Config 中共同核对。解析成功不等于代理连接成功，解析失败也不一定是服务器认证错误。域名规则与地址规则使用的信息不同，因此 DNS 改动可能影响规则结果。

怎么设：先记录原配置，确认是所有域名异常还是个别域名异常，再核对解析设置及其可达性。一次只修改一处，保存并重新验证同一目标；必要时重新建立连接，减少旧连接对观察的干扰。注意：不要叠加多个来源不明的 DNS 改动，也不要把某个解析服务当作所有故障的统一答案。

Test Method：测试结果的含义

是什么、在哪：在 Settings 查找 Test Method，它影响连通性测试采用的方法，随后可回到 Home 使用 Connectivity Test。测试方法不同，检查的网络环节也可能不同；某种探测没有响应，不必然等于实际业务请求都失败。

怎么设：对比服务器时保持相同 Test Method、相同网络和接近的测试时间，再使用实际目标验证。注意：测试数字不是吞吐量承诺，最小的测试值也不保证所有网站最快。调整方法只改变观察方式，不会替服务器修复端口、密码或传输配置。

Today Widget：快捷入口与连接状态

是什么、在哪：Today Widget 属于快捷操作相关设置，是否能添加及展示方式取决于本机系统支持。先在 Settings 核对对应选项，再按系统提供的组件管理入口操作；组件入口不能取代 Home 中的完整配置检查。

怎么设：添加后回到应用内确认当前服务器与 Global Routing，再测试快捷操作是否对应预期连接。注意：组件显示可能存在刷新间隔；若显示与实际不一致，以应用内状态和真实请求为依据。未看到对应选项时，不要为了追求同样外观而改动无关网络设置。

iCloud：同步与恢复分开处理

是什么、在哪：iCloud 相关选项用于应用支持的数据同步或备份操作，可在 Settings 对应入口与系统 iCloud 设置中核对。应用购买记录属于 App Store 账户范围，不等于配置数据已经同步，两者需要分别确认。

怎么设：先确认设备登录的 iCloud 账户、系统权限与可用空间，再检查应用显示的同步范围。迁移前保留本地副本，在新设备逐项核对服务器、Config 与选择状态。注意：不要假定所有数据都会自动覆盖或即时到达；订阅和认证信息属于敏感内容，处理同步文件时同样需要限制访问。

07 / DIAGNOSTICS

Diagnostics 与设置验证顺序

是什么：Diagnostics 用于收集和查看排查信息，帮助把故障定位到解析、规则、服务器连接或请求阶段。诊断信息是判断依据，不是自动修复结果。应先有明确症状，再选择本机提供的相关工具，而不是把所有开关同时打开。

在哪个界面：在 Settings 中查找 Diagnostics 或对应诊断入口，同时结合 Home 的 Connectivity Test、Data 和可用的请求记录。工具是否可见以及输出内容，以当前设备上的界面为准。若需要开启额外记录，只在排查期间使用，完成后恢复原设置，避免长期保留不必要的详细数据。

一次故障保留一组可对照证据

  1. 记录前提：写明 Wi-Fi 或蜂窝网络、Global Routing、当前服务器和 Config，不记录密码等凭据。
  2. 检查基础网络：确认网络本身可以通信，必要时检查 Wi-Fi 的网页认证是否完成。
  3. 检查服务器：运行 Connectivity Test；若失败，核对协议、地址、端口、认证、传输参数与系统时间。
  4. 重现单一目标：请求一个明确域名，检查是否解析成功、命中何种规则，以及实际使用了什么策略。
  5. 只改一个变量：修改后重测同一目标；未改善就恢复，避免残留改动影响下一步判断。

注意什么：超时只描述请求未在等待范围内完成，不直接指出是哪一端有问题。只有个别目标失败，应优先检查目标与规则；全部目标都异常，才进一步检查基础连接和公共设置。提交诊断材料前，遮盖订阅链接中的凭据、服务器认证信息、个人域名及可识别活动的内容，保留与症状相关的最小范围。