FEATURES / SETTINGS

Shadowrocket
功能与设置

先确定请求如何路由，再调整连接与诊断设置。每次只改一类参数，并用同一个访问目标核对结果。

本页是 Shadowrocket 官方手册的功能索引，主要说明 iPhone 与 iPad 上的操作。界面入口与可用选项请以设备上实际显示的英文文案为准。

查看首次连接教程 App Store 正版核对

01 / ROUTING

Global Routing：配置、代理与直连

Global Routing 是请求处理方式的总入口，通常在 Home 中打开。配置、代理、直连分别对应 Config、Proxy、Direct。它们决定流量的路由逻辑，不负责创建服务器，也不会修复服务器参数错误。选择姿态前，应先确认已有服务器信息已导入，当前选中的服务器确实是准备测试的对象。

姿态与界面词处理方式适用场景核对重点
配置 Config按当前启用的配置文件及规则决定策略。日常按域名或地址进行分流。配置是否启用、规则顺序及目标策略是否存在。
代理 Proxy将请求按代理姿态处理，具体行为受应用相关设置影响。临时验证当前服务器能否完成实际访问。服务器参数、网络可达性与目标访问结果。
直连 Direct按直连姿态处理请求，不以所选代理服务器作为常规出口。建立当前本地网络的访问基线。本地网络、DNS 与目标本身是否可访问。
  1. 在 Home 打开 Global Routing，先记下原选项，再切换到需要核对的姿态。
  2. 使用同一网络、同一目标完成一次实际访问；不要同时更换服务器与 DNS，否则难以判断变化来自哪里。
  3. 若 Proxy 可访问而 Config 不可访问，优先检查规则命中与策略引用，测试后恢复日常所需姿态。

02 / RULE ROUTING

规则分流：匹配对象与执行策略

规则把“哪些请求”和“如何处理”写在同一行。入口在 Config 中当前使用的配置文件；在 Global Routing 选择 Config 后，再核对这些规则的实际效果。规则通常自上而下匹配，较具体的条件应放在较宽泛的条件之前。前面的规则已经命中时，后面的同类规则不会用来补救这次选择。

DOMAIN 匹配完整域名；DOMAIN-SUFFIX 匹配指定域名及其子域名；DOMAIN-KEYWORD 按域名中的关键字匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 网段，GEOIP 根据 IP 地理数据库进行判断。域名规则与地址规则处理的对象不同，不能只看网页域名就推断某条地址规则必然命中。

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

上例仅用于说明语法：example.com 及其子域名使用 PROXY，其余交给最后的 FINAL,DIRECT。DIRECT 表示直连，REJECT 表示拒绝，PROXY 使用代理策略；若引用自定义策略组名称，必须确认该名称在配置中确实存在。示例不代表适合所有网络的完整配置，也不提供连接服务。

  1. 编辑前备份当前配置，只增加或调整需要核对的规则，不直接覆盖整份文件。
  2. 把精确例外放在较宽泛规则之前，将 FINAL 保留在规则列表最后作为兜底。
  3. 保存并确认启用的是刚修改的文件，再查看请求记录中的目标、命中规则与策略。

核对点：规则命中正确不等于目标服务器可达。若请求已经走向预期策略但仍失败，应继续检查服务器、解析与网络，而不是反复增加相同规则。更完整的语法说明见规则关键字与匹配顺序。

03 / SERVER MANAGEMENT

订阅与服务器：区分列表和单条参数

服务器管理以用户已有自己的订阅或服务器信息为前提。Home 的 SERVER 区域用于查看与选择服务器；Add Server 用于添加单条信息或相应类型的记录；Subscribe 用于订阅相关操作。订阅是一份可以更新的服务器列表，单条分享链接则主要描述一个服务器，两者不能仅凭“都是链接”就填入同一个字段。

导入前先判断手中的内容是订阅地址、单条分享链接，还是需要手动填写的参数。使用 Add Server 时，选择与原信息一致的类型，再逐项核对地址、端口、认证与传输设置。使用订阅时，应在相应的 Subscribe 入口添加并执行更新；具体入口位置以当前界面为准。二维码可通过 Scan QR Code 导入，但扫描成功只说明内容被识别，不代表参数一定可用。

Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等协议使用的认证和传输字段并不完全相同。例如 VLESS 的认证信息不能直接当成其他类型的密码填写；是否需要 TLS、传输路径或服务器名称，应以用户已有的原始服务器信息为准，不靠尝试常见值补齐。

  1. 更新已有订阅前，记录当前使用的服务器名称及所属分组，必要时保存自己的配置备份。
  2. 更新后确认列表确实刷新，并检查原选中项是否仍然存在；被移除或改名的记录需要重新选择。
  3. 先运行 Connectivity Test，再完成实际访问。测试结果和网页加载结果应分别记录。

04 / CONFIG FILE

Config：配置文件与服务器列表分开管理

Config 管理规则及相关配置内容，它与服务器列表的用途不同：服务器参数说明连接到哪里、如何认证，配置文件说明请求如何分流以及采用哪些相关设置。更新订阅并不意味着当前配置文件也会随之更新；导入了一份配置，也不能据此认定所有服务器参数已经准备好。

在 Config 中先确认当前启用的文件，再进入该文件的查看或编辑入口。修改前保留可恢复副本，记录原来的 Global Routing 姿态。若添加来自用户自己已有来源的配置，应先阅读其中的规则、策略引用与解析设置，避免不理解用途就启用。文件可保存不代表每个策略名称都能正确引用。

核对点：保存修改后确认启用标记所在的文件，重新发起目标请求，并查看实际命中。回退时应恢复配置文件及相关设置，而不是只改服务器名称。复杂规则问题可转到疑难手册按症状继续排查。

05 / ON DEMAND

On Demand：按网络条件触发连接

On Demand 用于按预设条件触发连接行为，适合已经确认手动连接正常、希望在特定网络条件下自动处理连接的情况。它不是服务器可用性的保证，也不会自动修正配置错误。在应用中打开 On Demand 设置入口，逐项阅读当前可用的网络条件和动作；条件项目以设备实际显示为准。

  1. 先关闭按需触发，仅用手动开关确认服务器、路由姿态与访问结果都符合预期。
  2. 进入 On Demand，一次只启用需要的一类条件。若界面允许按 Wi-Fi 或网络名称区分，应核对名称是否与当前网络完全一致。
  3. 按条件切换网络，观察系统连接状态及目标访问结果；再次回到原网络，确认恢复行为也符合预期。

注意：开启按需规则后，手动断开可能又触发连接，表现为开关重新打开。需要稳定停止连接时，应先检查 On Demand 是否仍在生效。不要仅凭这一现象判断应用异常；排查时先临时关闭自动条件，再测试手动连接，能够减少状态反复变化带来的干扰。

06 / DATA

Data：核对流量变化与访问记录

Data 提供客户端侧的流量统计与相关记录入口，用来观察请求活动和数据变化。查看时先确认统计范围、时间范围与当前界面显示的计量单位，再进行比较。客户端记录与用户已有连接服务的计费统计口径可能不同，不能把这里的数值直接当作剩余额度或账单依据。

操作时先打开 Data 记录基线，再进行一次可控的访问，例如加载一个固定页面，然后返回查看变化。若需要判断分流，结合可用的请求记录检查域名、目标地址和策略；若需要判断速度，则要保持网络、服务器和测试目标一致。总量增加只说明存在数据活动，不证明某个指定页面已经完整加载。

核对点：后台任务、系统请求以及其他应用活动都可能同时产生流量。排查时减少无关活动，并在操作前记下统计范围。清除记录可能失去故障线索，应先保存必要信息；向他人描述问题时，只保留与该次测试有关的片段，隐藏域名之外可能涉及个人使用情况的内容。

07 / SETTINGS

Settings：解析、测试与辅助功能

Settings 中的选项影响不同环节，不应把它们当作一组需要全部打开的开关。先确定问题属于名称解析、连通性测试、快捷操作、配置同步还是诊断，再进入相应项目。下列入口位置与可用选项可能随设备及应用界面变化，实际操作以当前英文文案为准。

DNS：先区分解析和连接

DNS 用于把域名解析成地址。在 Settings 检查 DNS 相关项目，并同时留意当前 Config 是否包含影响解析的设置。延迟测试正常但网页打不开时，可能是解析、TLS、目标服务或规则等环节的问题，不能只凭一个症状确认 DNS 出错。先记录现有解析设置，再测试同一个域名；确需调整时仅改变一个相关项目，并保存回退办法。

核对点：不要把代理服务器地址、订阅地址和 DNS 地址互相代填。若改动后仅部分域名恢复，应继续检查该域名命中的策略与解析结果。详细流程见DNS 解析失败排查清单。

Test Method：明确测试测到了什么

Test Method 决定连通性或延迟测试采用的方法，可在 Settings 中检查。不同方法验证的链路环节不同，因此不同方法产生的数值不宜直接排序比较。先阅读当前所选方法及关联目标，再运行 Connectivity Test；如需切换方法，应对同一组服务器重新测试，而不是把旧结果与新结果混在一起。

核对点：响应快不等于持续传输快，测试超时也不必然代表所有业务请求都会失败。最终仍需用实际目标验证，并记录当时的路由姿态。

Today Widget：快捷操作仍依赖现有配置

Today Widget 是与系统小组件相关的辅助入口。若当前应用和系统提供相应项目，可先在 Settings 检查可配置内容，再按系统支持的方式添加或管理。系统版本要求以 App Store 页面标注为准；组件是否可添加及展示方式，也应以设备实际提供的入口为准。

添加前先在应用内确认选中服务器和连接状态，添加后再核对组件显示与实际状态是否一致。快捷入口不代替配置检查；若显示没有及时变化，应回到应用和系统状态中核实，而不是反复触发连接。

iCloud：同步后仍需检查本机状态

iCloud 相关功能用于在支持的范围内保存或同步应用数据，可在 Settings 检查对应选项。使用前确认设备已登录自己的 Apple 账号，并检查系统是否允许应用使用 iCloud。先保留本机可恢复副本，再按界面提供的方式执行同步或恢复；同步范围应以选项说明为准，不假定所有数据与系统授权都会一并转移。

核对点：另一台设备上仍要检查当前配置、服务器选择和 VPN 配置授权。不要把 iCloud 同步当作实时连接状态同步，也不要在不清楚覆盖方向时连续执行恢复。

Diagnostics：保留可复现的故障线索

Diagnostics 用于辅助收集诊断信息，在 Settings 查找相应入口。先记录问题发生的网络、路由姿态和操作步骤，再按界面指引采集一次相关结果。复现时保持测试目标一致，并在重试前写下上一轮改过的项目，避免日志对应不上实际设置。

注意：诊断内容可能包含服务器地址、请求信息或认证相关字段。导出或分享前应逐项检查并遮盖敏感信息，保留足以说明问题的最小片段。诊断信息用于缩小排查范围，不应仅凭单条错误文字就同时重置所有设置。

08 / VERIFICATION

设置后核对：按一条请求逐层确认

功能之间存在前后关系：服务器参数提供连接基础，Global Routing 决定处理姿态，Config 决定规则策略，DNS 参与解析，Data 与 Diagnostics 提供观察线索。判断设置是否有效，最好沿同一条请求逐层核对，而不是以开关是否亮起作为终点。

  1. 核对连接基础。确认使用的是用户已有且参数完整的服务器，当前网络本身可用，系统所需的 VPN 配置授权已完成。
  2. 核对路由姿态。确认 Global Routing 与测试目的相符；若使用 Config，再检查启用文件及规则命中。
  3. 核对实际访问。运行测试后加载固定目标，记录成功、超时或具体错误，不将延迟数字当作唯一结论。
  4. 核对自动行为。恢复日常设置前，检查 On Demand 是否会再次改变连接状态，并保留本次有效设置的记录。

尚未安装时，请先阅读App Store 正版核对与购买说明。Shadowrocket 唯一获取入口为 App Store；商店开发者为 Shadow Launch Technology Limited，应用 ID 为 932747118。价格、系统要求及购买适用范围以 App Store 页面标注为准。首次导入可接着阅读使用教程，持续出现的异常则按疑难手册逐项排查。