官方手册 · 功能与设置

Shadowrocket 功能与常用设置

先决定连接如何处理，再调整自动连接、测试与诊断。服务器决定连接目标，Global Routing 决定处理方式，Config 中的 Rule 决定分流结果；这三层应分开检查。

Shadowrocket 覆盖 iPhone、iPad、Mac（Apple 芯片与 Intel）、Windows、安卓与 Linux。下文以 iPhone / iPad 的界面入口为操作基准；其他平台的入口位置、系统集成项与可用设置以实际界面为准。

首次配置先读入门指南 →

Global Routing：配置、代理与直连

Global Routing 控制当前连接采用哪一种整体处理方式。在 Home 打开 Global Routing 后，可按任务选择 Config、Proxy 或 Direct。中文说明中的“配置、代理、直连”分别对应这三个英文界面词；它们不是三台服务器，也不会替你补齐缺失的服务器参数。

界面选项 连接处理方式 适用任务 使用前提
Config（配置） 读取当前 Config，按 Rule 匹配结果选择策略。 日常按域名、目标地址等条件分流。 确认正在使用的配置，以及规则引用的策略。
Proxy（代理） 将通常的连接处理交给所选代理，实际仍受系统与相关设置约束。 临时检查当前服务器是否能够承载请求。 已选择有效服务器，且协议参数完整。
Direct（直连） 采用直接连接路径，不经所选代理服务器转发。 比较当前网络直接访问目标时的表现。 当前网络本身能到达目标。

日常使用优先核对 Config

希望部分目标使用 PROXY、其他目标使用 DIRECT 时，应选择 Config，并进入 Config 确认已启用正确文件。仅导入一个配置文件，并不等于它已经成为当前配置；同样，选中服务器也不代表所有请求都会经过该服务器。应把当前配置、Global Routing 和服务器选择一起核对。

排查时可以暂时切换 Proxy，观察相同目标是否恢复访问。如果 Proxy 正常而 Config 异常，下一步应检查规则命中、策略引用及 DNS，而不是立即更换全部协议参数。Direct 则用于建立直接连接的对照结果。每次比较应使用同一目标、同一网络，并重新发起请求，避免把旧连接误认为切换后的效果。

Proxy 不等于连接必然成功，Direct 也不等于关闭全部系统网络设置。完成测试后，应恢复原先计划使用的模式；长期停留在排查模式，可能让流量路径与原有预期不同。

Rule：匹配条件与处理策略

Rule 是“连接满足什么条件，就采用什么策略”的有序列表。入口在 Config 的当前配置中；需要编辑时，先保存原配置副本，再检查规则区段。规则通常自上而下匹配，较具体的条件应放在较宽泛的条件之前，FINAL 用于承接前面没有命中的连接。

常用规则类型如何区分

  • DOMAIN：匹配指定的完整域名，适合只处理一个明确主机名。
  • DOMAIN-SUFFIX：匹配指定域名及其子域名；适合把同一域名体系放入相同策略。
  • DOMAIN-KEYWORD：匹配域名中的关键字，范围较宽，使用前应确认是否会包含不相关目标。
  • IP-CIDR 与 IP-CIDR6：分别按 IPv4、IPv6 地址段匹配，不是按网址文字匹配。
  • GEOIP：依据目标 IP 的归属信息匹配，结果受地址数据库与实际解析结果影响。
  • FINAL：处理尚未命中的连接，应检查它是否符合默认路径的预期。

PROXY、DIRECT 与 REJECT 的作用

匹配类型回答“选中哪些连接”，策略回答“选中后怎么处理”。PROXY 交给代理路径，DIRECT 直接连接，REJECT 拒绝连接。配置也可能引用命名策略，此时要继续检查该名称实际指向什么，而不能只看到规则存在就认为配置已经完整。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.net,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

以上是用于解释语法的独立片段，不是完整配置，也不是可用服务器信息。第一行只匹配 example.com，不会自动包含其子域名；第二条规则才包含 example.net 及其子域名。最后的 FINAL,DIRECT 意味着未被前面选中的连接直接处理，而不是默认全部交给 PROXY。

编辑后保存并确认使用的是修改后的 Config，再以实际访问记录核对命中结果。一个页面可能同时请求多个域名，因此页面主域名命中规则，并不说明图片、登录或其他资源也采用相同路径。规则语法与示例可继续阅读规则关键字入门。

Subscribe 与服务器管理

服务器条目保存连接远端所需的协议、地址、端口及认证参数；Subscribe 用于从用户已有的订阅地址更新这类条目。Home 是查看与选择服务器的主要位置，手动填写通常从 Add Server 进入。导入前先确认拿到的是订阅地址、单个服务器链接，还是完整配置文件，三者不能只因都能复制为文字就混用入口。

导入后先检查结构，再测试

  1. 使用与你已有信息相对应的入口导入；单个条目可按 Add Server 中的协议类型填写，二维码可从 Scan QR Code 读取。
  2. 打开导入后的条目，核对协议、地址、端口，以及该协议要求的认证和传输参数。
  3. 在 Home 选择要使用的服务器，先运行 Connectivity Test，再实际访问一个已知目标。
  4. 若使用 Config，继续检查规则引用的策略是否能正确指向当前服务器或有效策略。

订阅更新会依据远端内容重新获取条目。若直接修改订阅管理下的服务器，下一次更新可能覆盖本地调整，因此长期需要保留的修改应先另行备份。不同订阅中名称相似的条目，也未必拥有相同地址或参数；建议使用能够区分来源与用途的本地备注。

订阅中包含服务器列表，不代表同时包含适合当前需求的 Rule 或 DNS 设置。更新失败时，先确认地址是否完整、是否仍有效，再检查当前网络能否访问订阅地址。不要在公开截图、日志或讨论中展示订阅链接中的认证部分；需要求助时应先移除认证信息与个人标识。

删除订阅或批量清理前，先确认是否仍有配置引用其中的服务器。服务器可选与服务器可用是两回事：Connectivity Test 的结果也受测试方法影响，后文会说明如何判断。完整的添加与导入过程见入门指南。

On Demand：按条件建立连接

On Demand 用于让系统在满足已设条件时建立连接，适合希望减少重复手动操作的场景。在 iPhone / iPad 的 On Demand 设置入口中，先检查已有条件，再决定是否启用；条件类别与入口位置以当前应用及系统界面为准。它解决的是“何时连接”，不是“请求应交给哪条规则”。

先验证手动连接，再启用自动条件

先关闭 On Demand，以手动方式确认服务器、Config 和 DNS 都能正常工作，然后一次只增加一组必要条件。若按网络环境设置条件，应在相应环境下验证连接和断开行为，再切换到另一个环境复查。只在一个 Wi-Fi 下成功，并不能说明移动网络或其他 Wi-Fi 的行为也符合预期。

On Demand 可能使用户手动断开后又重新连接，这是系统重新满足连接条件的结果，不应直接判断为开关失效。需要暂时停止时，先调整或关闭 On Demand，再断开当前连接。只改变 Global Routing 不一定会停止系统按条件建立连接，两者属于不同层次。

自动连接也不能修复过期订阅、错误密码或不可达服务器。建议在规则与服务器稳定后再启用，避免在基础配置尚未验证时，把反复重连与参数错误混在一起排查。电量表现应结合网络切换频率、连接持续时间与实际流量观察，不能仅凭开关状态作结论。

Data：流量统计与观察边界

Data 用于查看应用记录的流量情况，帮助判断是否有持续传输、某次操作是否产生数据，以及较长时间内的使用趋势。在 Data 中先看统计范围与当前显示周期，再读取数值；不同平台或界面可能提供不同粒度，不应假定所有设备都有完全一致的统计项目。

用可重复的小操作建立对照

需要观察某个任务时，先记下当前统计，再打开一个目标、完成一次明确操作，随后回到 Data 查看变化。若当前界面提供重置功能，应先保存需要保留的记录，再重置并开始新一轮观察。统计重置只是清除本地观察基准，不会重置用户已有服务的用量。

Data 不等于运营商账单，也不等于用户已有服务的计费记录。隧道封装、重传、后台请求和统计口径都可能造成差异。看到流量增加只能说明记录范围内发生了传输，不能单凭数值判断某个网页已经完整加载，更不能据此推断内容是否来自预期服务器。

若发现待机期间持续产生流量，应结合系统后台活动、On Demand 条件与请求记录检查来源。不要为压低某一个统计数字而同时关闭多个系统功能；先定位连接，再判断是否需要调整，才能保留可比较的结果。

Settings：常用项与调整方法

Settings 集中提供测试、系统集成与诊断相关入口。部分网络行为也可能由当前 Config 控制，因此修改设置前应先确认作用范围：是全局选项、当前配置内容，还是某个服务器的独立参数。建议记录原值，一次修改一个变量，并用相同目标重新测试。

DNS：先确认解析结果，再判断路径

DNS 把域名解析为地址，其设置可能位于 Settings 的相关入口，也可能由当前 Config 的 DNS 项定义。先查看当前配置是否已有 DNS 内容，再检查所填地址是否可达、是否符合预期。不要只因网页打不开就反复更换 DNS，也不要假定更换 DNS 会自动改变 Global Routing。

域名规则与地址规则观察的对象不同：域名可能正确匹配，但解析后的目标地址仍不可达；也可能服务器连接正常，而域名解析失败。排查时记录具体域名、解析结果与错误阶段，能更快区分 DNS、规则和服务器问题。修改后应重新发起请求，必要时按实际界面处理缓存，避免拿旧解析结果验证新设置。

Test Method：决定测试结果代表什么

在 Settings 的 Test Method 中选择测试方法，会影响相关连接测试的行为。应先读清当前方法的测试对象与判定条件，再比较服务器结果。不同方法得到的数值不能直接混排，也不能将一个测试数值等同于浏览器下载速度。

对比时保持方法、网络与测试目标一致。某服务器测试失败但实际访问正常时，应先核对测试方法是否适用于该连接；测试成功但页面异常时，应继续检查目标服务、DNS 与规则。Connectivity Test 是缩小范围的工具，不是对所有应用请求的保证。

Today Widget：系统快捷入口

Today Widget 用于系统支持的小组件场景，相关选项可在 Settings 中查看；能否添加及显示形式取决于系统与当前应用提供的入口。先在应用内完成服务器选择和手动连接验证，再按系统的小组件编辑流程添加。若系统没有显示相应入口，应以实际可用功能为准。

小组件适合查看状态或执行快捷操作，复杂编辑仍应回到应用中进行。若小组件状态与应用内显示暂时不同，先打开应用核对连接，再检查系统刷新情况，而不是立即删除配置或重新导入订阅。

iCloud：同步范围与备份顺序

iCloud 相关同步入口需要结合系统账号、iCloud 可用状态以及应用设置检查。启用前先在 Settings 查看具体同步对象，不要假定全部服务器、Config、统计与连接状态都会一起同步。不同设备的本地选择和系统权限，也不一定随同步内容迁移。

第一次在另一台设备使用前，先备份两端重要配置，再确认哪一份内容是需要保留的主副本。遇到缺项时先等待同步并核对账号与网络，避免连续导入多份同名文件。同步属于内容传递，不替代连接验证；完成后仍要逐台检查 Global Routing、当前 Config 与服务器。

Diagnostics：按故障阶段收集信息

Diagnostics 用于查看或执行当前版本提供的诊断项目，通常可从 Settings 的相关入口进入。它的用途是把“不能用”拆成可判断的问题：服务器能否建立连接、域名能否解析、请求命中什么规则，以及错误是否只发生在某个目标。应以界面实际提供的项目为准，不必为了收集信息把所有诊断选项长期打开。

一次诊断保留四类上下文

  1. 环境：当前使用 Wi-Fi 还是移动网络，故障是否只在一个网络出现。
  2. 模式：Global Routing 当前为 Config、Proxy 还是 Direct，正在使用哪个配置。
  3. 对象：失败的是订阅更新、服务器测试，还是某个目标的实际请求。
  4. 现象：记录界面显示的具体错误、出现时间及可重复的操作步骤。

如果所有目标都无法连接，优先检查当前网络、服务器地址与端口、认证参数以及系统时间。若只有一个目标异常，优先查看该目标的 DNS、规则命中与服务状态。若仅 Config 异常而 Proxy 正常，则先检查配置引用与分流规则，不要从重新安装开始。

需要分享诊断信息时，先去掉订阅认证信息、密码、个人访问域名及其他敏感内容。诊断完成后关闭不再需要的详细记录，并妥善处理导出的文件。关于超时与连接失败的具体顺序，可阅读连接超时排查说明；协议字段差异则见协议技术参考。

常用设置的检查顺序

不建议把所有选项一次调完。先建立最小可验证的连接，再逐步加入规则、自动连接和系统快捷入口，能够明确每项变化带来的影响。下面的顺序也适用于已有配置突然出现异常后的复查。

  1. 确认输入：核对已有服务器或订阅信息的类型，检查协议、地址、端口和认证参数是否完整。
  2. 确认服务器：在 Home 选中预期条目，使用一致的 Test Method 运行 Connectivity Test，并进行实际访问。
  3. 确认模式：核对 Global Routing；需要按规则处理时，使用 Config 并确认当前文件。
  4. 确认命中：检查 Rule 的顺序、策略引用和 FINAL，结合请求记录判断目标走向。
  5. 确认解析：检查 DNS 的来源与作用范围，不把解析失败和服务器失败混为一谈。
  6. 加入自动化：手动连接稳定后再启用 On Demand，按网络环境逐项验证。
  7. 保留基准：保存配置副本，用 Data 与 Diagnostics 对照后续变化，再考虑小组件和同步设置。

每完成一项都重新测试相同目标，并记录修改前后的结果。若新设置导致异常，先恢复刚修改的选项，而不是继续叠加补救设置。这样既能保留可用配置，也能让下一次排查从明确的状态开始。

本页用于查阅功能职责与设置边界。尚未完成首次导入，可按入门指南逐步操作；需要核对获取渠道、平台安装或购买恢复，请前往全平台下载指南；具体问题可在FAQ按类别查找。