官方手册 · 功能与设置

Shadowrocket 功能与设置

先确定 Global Routing 的处理方式，再核对服务器、规则与 DNS。连接开关、路由模式和服务器选择分别控制不同环节，不能用其中一项的状态推断全部网络是否正常。

  • Home 与 Config
  • Data 与 Settings
  • 已有资料的导入与管理

本页面向 iPhone 与 iPad 上的 Shadowrocket，按“是什么、在哪里、怎么设、注意什么”说明常用功能。界面词保留英文，中文用于解释用途；具体入口、可选项及系统功能可用性以设备上的应用为准。需要从头完成首次连接，可先读入门指南；已有明确故障症状，可转到疑难手册。

Global Routing：配置、代理与直连

Global Routing 决定连接开启后采用哪一种总体处理方式。在 Home 找到 Global Routing，进入后按当前目的选择 Config、Proxy 或 Direct。它不是服务器列表，也不是连接成功提示：选择模式之后，仍需确认默认服务器及主连接开关。若应用中存在更细的配置选项，应结合当前 Config 一起核对。

界面选项 处理方式 适用场景 需要核对
Config（配置） 依据当前配置中的规则与策略处理请求。 日常按域名或地址分流。 正在使用的配置、规则顺序和兜底策略。
Proxy（代理） 总体采用代理模式处理流量，具体行为受相关配置影响。 临时验证代理路径，缩小规则排查范围。 选中的服务器、认证资料和目标可达性。
Direct（直连） 总体采用直连模式处理流量，具体行为受相关配置影响。 临时核对当前网络的直接访问情况。 本地网络本身是否可用，以及 DNS 设置。

模式切换的核对方法

日常使用已有分流配置时，先选 Config，并在 Config 界面确认当前启用的文件。若某个目标访问异常，可暂时切到 Proxy，用同一个目标、同一台服务器做对照；如果 Proxy 可以访问而 Config 不行，优先检查规则匹配和策略指向，不要立刻更换全部连接参数。对照完成后恢复原模式，避免把临时排查状态当作长期设置。

Direct 不等于关闭客户端。连接仍开启时，DNS、连接处理等行为仍可能受当前设置影响；若要判断问题是否来自本地网络，应另外关闭主连接开关，做一次相同目标的访问测试。一次只改一项并记录结果，才容易区分模式、服务器和本地网络三类原因。

规则分流：匹配条件与执行策略

规则分流把“请求匹配什么”与“匹配后怎么处理”分开。通常在 Config 中打开当前配置，查看或编辑规则；只有采用相应配置处理方式时，这些规则才会按其配置逻辑参与分流。修改前先保留原文件副本，确认正在编辑的就是启用中的文件，而不是名称相似的另一份配置。

规则类型用于描述匹配对象

DOMAIN 用于匹配指定域名，DOMAIN-SUFFIX 用于匹配域名后缀，DOMAIN-KEYWORD 用于匹配域名中的关键词。域名后缀规则适合表达一个域名及其子域名；关键词规则范围较宽，可能匹配到原本没有计划处理的域名，因此应尽量写得具体。

IP-CIDR 与 IP-CIDR6 分别描述 IPv4 和 IPv6 地址段，GEOIP 使用地址归属分类。域名访问是否需要先解析、解析得到什么地址，可能影响地址类规则的结果。不要把域名匹配失败与 DNS 失败混为一谈，也不要只看目标网站的名称就判断实际命中了哪条规则。

策略用于指定处理动作

PROXY 表示代理策略，DIRECT 表示直连，REJECT 表示拒绝。配置也可能引用自定义策略组；此时还需要检查组内最终选择的服务器。规则通常按顺序匹配，具体规则应放在较宽泛的规则前面，FINAL 用于前面均未匹配时的兜底处理。

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

以上是规则语法示例，不是完整配置。第二行比第一行的范围更宽，目的是展示两种匹配形式；实际使用时应按自己的目标删改，并核对是否需要保留该关键词规则。添加一条规则后，用明确的目标域名验证匹配结果，再继续添加下一条，避免同时叠加多种条件后难以定位问题。

Subscribe 与 Add Server：管理已有资料

Home 是选择服务器、查看分组和进行连接操作的主要位置。单个服务器可以通过 Add Server 填写；已有订阅则按应用中的 Subscribe 相关入口导入。两种方式都以用户已经持有有效资料为前提。订阅是批量取得服务器信息的方式，不代表导入后每一项都能连接，也不代表客户端购买包含这些服务。

手动添加与扫码导入

进入 Add Server 后先核对 Type，再按资料填写 Address、Port 以及对应的认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议需要的字段不同，不能把某一种协议的密码或密钥直接套入另一种。可选参数应逐项对照已有资料，不确定时保持原值并向资料提供方确认。

已有二维码时，可用 Scan QR Code 识别，再检查导入后的类型、地址及端口。扫码只是输入方式，不能替代参数核对。为服务器填写容易辨认的备注，随后返回 Home 点选默认服务器；确认选择状态后，再打开连接开关。列表中出现一条记录，只能说明资料已保存，不能据此认定连接已经建立。

订阅更新与敏感资料保护

已有订阅链接应完整粘贴，避免开头或末尾混入空格、换行。更新订阅会重新获取列表内容，名称、分组或条目可能随资料变化；更新后应重新检查原先选中的服务器是否仍存在。手动修改订阅生成的条目之前，先确认后续更新是否会覆盖这些修改，必要时保留独立记录。

订阅链接、密码、私钥与配置中的认证信息都应当作敏感资料保存。排查时不需要把完整链接发给他人；可以描述错误发生在哪一步，并隐去账号和认证字段。批量删除、重新导入或更换配置前，先备份有效资料，避免把服务器列表变化误认为客户端丢失购买记录。

On Demand：按条件触发连接

On Demand 用于按设定条件触发连接行为，不是检测服务器质量的工具，也不会补齐缺失的认证参数。在应用中进入 On Demand 相关设置，先查看现有条件，再按实际需要调整；如果当前界面的入口位置不同，可在 Settings 中查找对应选项，以应用显示为准。

设置之前，先用手动方式验证连接：选定服务器、开启主开关并允许系统添加 VPN 配置，再确认目标能够正常访问。手动连接已经失败时，先处理服务器、DNS 或网络问题，反复开启 On Demand 通常不能解决根因。手动验证通过后，再检查触发条件，并在希望使用的网络环境中观察实际结果。

切换 Wi-Fi 与蜂窝网络、锁屏再唤醒或更换网络后，连接状态可能发生变化，应分别检查。若出现刚断开又重新连接的现象，先看 On Demand 是否仍处于启用状态，再检查系统中是否有其他会影响 VPN 的配置。排查期间可暂时关闭 On Demand，改用手动开关，完成单一条件测试后再恢复。

Data：查看流量与连接线索

Data 用于查看应用记录的流量信息，具体分类、统计周期及可展开内容以当前界面为准。进入 Data 后，先看记录对应的时间和统计范围，再结合刚刚进行的访问操作观察变化。它适合帮助确认客户端是否记录到了相关活动，不应仅凭一个累计数字判断当前服务器的速度或服务状态。

需要做对照时，记录开始时间，关闭暂时不需要的后台任务，再访问一个已知目标，随后回到 Data 检查对应变化。若界面提供连接详情，可进一步核对目标、处理策略及相关记录。出现流量并不等于目标页面已加载成功；认证失败、重试、后台同步等活动也可能伴随数据传输。

Data 的统计口径可能不同于系统蜂窝数据统计或已有服务账户中的用量记录，不能直接替代计费依据。清除记录之前先保存排查需要的信息；分享记录时隐去目标中的个人标识、账户信息和服务器资料。若主要问题是耗电，应同时查看系统电池页面及后台活动，而不是单独依据总流量下结论。

Settings：DNS、测试、组件与同步

Settings 汇集常用设置及工具，但并非所有网络行为都只由这里决定：当前 Config 也可能包含 DNS 或其他相关参数。先确认配置内有没有同类设置，再修改全局选项。不同设备与系统可能显示不同入口，以下按功能名称定位，不把某个固定菜单层级当作所有设备都相同的路径。

DNS：先确认解析问题，再改解析设置

DNS 用于把域名解析为地址。检查 Settings 与当前 Config 中的 DNS 相关内容，记录原值及当前网络，再判断是否存在重复设置或相互影响。若服务器地址本身使用域名，连接建立之前也可能需要完成解析；因此目标网站打不开与服务器地址解析失败，需要分开检查。

修改 DNS 时，一次只调整一个相关选项，用同一域名重复验证，并观察是否只在某种网络下失败。不要因为某个解析地址常见就直接替换整份配置，也不要把加密解析等同于所有连接都会成功。若改动无效，恢复原值，再继续检查路由规则、服务器参数和本地网络。

Test Method 与 Connectivity Test：明确测量对象

Test Method 用于选择相应测试采用的方法，可在 Settings 中核对可用方式；Connectivity Test 用于辅助检查连接。不同方法测量的环节不同，服务器返回测试结果并不代表每个网站都能访问。测试前确认默认服务器、网络环境与测试目标，比较结果时保持方法一致。

测试失败时，先核对测试方法和目标是否适合当前服务器，再检查地址、端口及认证参数。测试显示正常而实际访问失败时，应继续查看目标对应的规则和 DNS。不要把不同测试方法的数值直接排列后，当作稳定性或长期速度的结论。

Today Widget：检查系统支持与展示内容

Today Widget 是与系统组件相关的功能。在 Settings 中查看对应设置，再到系统提供的组件管理位置确认是否可添加，以及能够显示哪些内容。入口与展示能力会受系统支持影响，应以设备实际显示为准，不把组件缺失直接判定为服务器故障。

组件适合快速查看或执行其提供的操作；需要判断当前选中服务器、路由模式或详细错误时，仍应回到应用核对。若组件与应用状态暂时不一致，先打开应用刷新观察，再检查系统对组件的支持，不必因此立即删除已有配置。

iCloud：同步范围与独立备份

iCloud 相关功能用于在支持的条件下保存或同步相应配置内容。在 Settings 中核对开关及应用说明，并确认设备系统中允许应用使用 iCloud。同步前先保留独立备份；在另一台设备上打开后，检查实际出现的文件和内容，而不是假定全部服务器、密钥与设置都会一并迁移。

App Store 的购买记录与 iCloud 中的配置是不同资料。恢复已购应用不等于恢复全部连接信息；同样，配置同步完成也不能替代购买资格核对。准备换机时，可参考配置备份与迁移说明，先确认可用副本，再处理旧设备上的内容。

Diagnostics：保留最小复现过程

Diagnostics 用于收集或查看排查所需的诊断信息，具体工具和输出以 Settings 中的实际入口为准。先记录网络类型、Global Routing 模式、发生问题的时间及操作步骤，再执行对应诊断。这样可以把记录与一次明确的失败对应起来，避免在大量无关信息中寻找原因。

诊断文件可能含有域名、地址、设备环境或配置线索，导出和分享前应检查内容并隐去敏感资料。保留必要错误信息即可，不公开完整订阅链接、认证字段或私钥。详细的按症状排查流程见疑难手册。

设置核对顺序：先建立基线，再逐项调整

功能设置应围绕一个明确目标进行，例如“指定域名采用代理策略”或“只在某种网络条件下触发连接”。先保留当前可用配置，再记录服务器、模式和 DNS 的初始状态。不要同时更新订阅、修改规则和更换解析方式，否则即使访问恢复，也难以知道是哪一步产生作用。

  1. 核对输入资料。在 Home 检查服务器是否存在，Type、Address、Port 与认证字段是否对应已有资料，并明确默认选择。
  2. 建立手动连接基线。暂时排除 On Demand 的自动触发影响，手动开启连接，用一个明确目标验证当前状态。
  3. 确认 Global Routing。日常分流检查 Config；需要对照时临时切换模式，完成后恢复，并保留对照结果。
  4. 检查规则与解析。先看目标是否命中预期规则，再检查 DNS 和策略组指向，一次修改一个原因。
  5. 复查自动化与记录。恢复所需的 On Demand 条件，结合 Data 和 Diagnostics 检查实际行为，最后保留一份可用配置。

如果当前连接已经满足需求，不必为使用更多设置而逐项开启功能。保留能够解释、能够验证、能够恢复的配置，比叠加多个未确认用途的选项更便于维护。本文属于 Shadowrocket 官方手册；购买和安装入口见App Store 说明，首次操作顺序见入门指南，具体错误可在常见问题中继续查找。