Shadowrocket 官方手册 · 功能与设置

Shadowrocket 功能与设置

设置先从路由模式开始，再检查服务器、配置文件与解析方式。本页以 iPhone 和 iPad 上的操作为主，把常用功能按“是什么、在哪里、怎么设置、注意什么”展开。界面入口和可用选项以设备上实际显示为准；系统要求以 App Store 页面标注为准。

日常使用通常不需要同时调整很多选项。先用已有服务器信息建立可用连接，再选择适合的 Global Routing 模式。每次只改一个设置，记录修改前的值，才能在访问异常时区分服务器、规则、DNS 与本地网络的问题。

查看首次连接教程 正版核对与下载指南 →

Global Routing：配置、代理与直连

Global Routing 决定连接采用哪一类路由方式。在 Home 找到该入口，进入后选择 Config、Proxy 或 Direct。这三种模式分别对应配置、代理与直连；它们不是三个服务器，也不会替代服务器的地址、认证与协议参数。

模式 主要行为 适用场景 检查重点
Config 配置 依据当前生效配置中的规则决定策略。 需要按域名、地址或其他匹配条件分流。 是否选中正确配置，规则引用的策略是否有效。
Proxy 代理 以代理模式处理流量，具体行为仍受相关设置影响。 临时判断异常是否与配置中的分流规则有关。 当前服务器能否连接，代理路径是否可用。
Direct 直连 以直连模式访问，不依赖所选代理服务器转发。 对照本地网络的访问情况。 本地网络与 DNS 是否正常，目标是否可直接访问。

如何选择与验证

已有明确分流需求时，先在 Config 中确认生效文件，再把 Global Routing 设为 Config。若某个目标访问失败，可临时切到 Proxy 对照同一目标的结果；若代理模式正常、配置模式异常，优先查看规则匹配与策略指向，而不是立即更换全部服务器参数。

Direct 适合做本地网络对照，但不等同于关闭系统 VPN。检查连接是否关闭，应查看 Home 的连接开关和系统状态。测试结束后恢复原来的模式，避免把临时排查用的设置留作日常设置。

规则分流：先匹配，再执行策略

规则由“匹配类型、匹配内容、策略”等字段组成。它描述的是某类连接应如何处理，而不是服务器的连接参数。通常在 Config 中打开当前配置，检查 [Rule] 段。编辑前先保留可恢复的副本；修改完成后，还要确认该配置确实处于生效状态。

规则类型与匹配对象

DOMAIN 用于完整域名匹配；DOMAIN-SUFFIX 用于域名后缀匹配；DOMAIN-KEYWORD 检查域名中的关键词。三者覆盖范围不同，域名问题应先确认需要精确匹配还是包含子域名，再选择关键字，不要把完整网址中的路径直接当作域名填写。

IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围；GEOIP 依据地址数据库进行匹配，结果受数据库与解析结果影响。USER-AGENT 针对请求中可识别的相应字段，存在可见性限制，不适合假定能覆盖所有应用连接。规则能否判断某个请求，取决于当时可获得的信息。

策略与顺序

DIRECT 表示直接连接，PROXY 表示代理策略，REJECT 表示拒绝匹配连接。配置也可能引用自定义策略名称；名称必须与文件中实际存在的定义对应。规则通常按顺序匹配，较具体的规则应放在较宽泛的规则之前，FINAL 则负责未被前面规则命中的连接。

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

这段内容只说明语法与顺序，不是完整配置。示例中的域名用于文档演示。添加规则后，用目标域名对应的新连接检查结果；已建立的长连接不一定随修改立即重新选择路径。若需要重新连接，请先结束测试请求，再建立新请求。

查阅规则关键字与策略术语 →

Config：配置文件与生效范围

Config 是管理配置文件的入口。配置可能包含通用参数、DNS、规则和策略定义，因此它影响的不只是单条分流规则。服务器条目保存在列表中，并不意味着某份配置已经启用；同样，保存了配置修改，也不代表当前路由模式一定会按这份文件分流。

选择配置前的检查

  1. 打开 Config，确认待使用的文件来源和内容。只使用已理解用途、来源可信的配置。
  2. 保留当前可用配置的副本，核对新配置中策略名称、规则顺序以及 DNS 设置。
  3. 选择要生效的配置，返回 Home 检查 Global Routing 是否为 Config。
  4. 用一个明确的测试目标建立新连接，检查实际结果；异常时恢复副本，再逐项定位差异。

远程配置可能在更新后覆盖本地修改。需要长期保留的自定义内容，应先了解当前文件的更新方式，再决定如何维护。不要把陌生配置中的全部选项原样迁移到日常环境；尤其是涉及证书、请求处理或解析行为的内容，应单独确认用途与影响范围。

订阅与服务器管理

Home 中的服务器列表用于选择连接端点。单个服务器包含协议类型、地址、端口和认证等参数；Subscribe 则通过已有订阅地址更新一组服务器。导入内容应来自用户已有的服务信息，参数需要与服务端保持一致。

Add Server：手动添加与核对

在 Home 进入 Add Server，先选正确的协议类型，再填写地址、端口和认证信息。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 与 Hysteria2 的参数并不相同，不能仅凭服务器名称判断协议。若服务信息包含 TLS、传输方式或服务器名称等字段，应逐项对应，不要靠尝试随机开关获得偶然可用的组合。

保存后返回列表选中该服务器，先进行 Connectivity Test，再建立实际访问请求。测试通过只说明该测试条件下有响应，不保证所有目标、协议与持续传输都正常；测试失败也需要结合本地网络与测试方法判断。

Subscribe：导入、更新与删除

需要导入已有订阅时，在 Add Server 中选择 Subscribe，填入自己的订阅地址并保存。更新后检查分组和服务器条目是否出现，再选中一个条目测试。若订阅失败，先核对完整地址、订阅状态及当前网络是否能访问该地址，不要连续重复导入同一内容。

订阅更新可能重新生成条目，因此不宜把重要的手工修改只留在受订阅管理的条目里。删除某个服务器与删除整个订阅的影响不同；清理前先确认选中的对象，并记录当前使用的分组。订阅地址往往带有访问凭据，截图、日志与备份中都应遮盖完整地址及认证字段。

查看订阅失败的检查方法 →

On Demand：按条件触发连接

On Demand 用于根据设置的网络条件触发连接行为。它解决“何时建立连接”，并不决定“某个域名走哪条策略”；后者仍应由 Global Routing 和配置规则处理。在 Settings 中查找 On Demand，可用条件与入口以当前界面为准。

设置与试运行

先关闭自动触发，手动验证当前服务器与配置能正常连接，再进入 On Demand 设置需要的条件。若界面提供网络类型或指定网络相关选项，只勾选确有需求的条件，保存后在对应网络环境下测试。检查触发前后的连接状态，确认行为与预期一致，再保留该设置。

自动连接不是服务器故障恢复的保证。网络切换、系统调度以及服务器状态都可能影响建立连接的过程。若关闭连接后又自动连接，应先检查 On Demand，不要把它误判为连接开关失效。临时排查时可先停用自动触发，完成手动测试后再恢复。

Data：读取流量统计

Data 用于查看客户端记录的流量情况。进入该界面后，先确认所显示的统计范围、时间范围和分类，再比较上传与下载数据。页面中的累计值与当前速率不是同一个指标，不能把一段时间内的总量直接当成当前连接速度。

如何用统计辅助判断

需要观察一次访问时，先记录当前读数，再进行一个明确的操作，例如打开一个页面，随后回到 Data 查看变化。尽量避免同时进行系统更新、云端同步或其他大流量任务，否则变化无法归因到单一操作。若使用重置功能，先保存需要保留的读数，并确认重置范围。

客户端统计与服务侧计费可能采用不同的时间周期、流量口径与协议开销处理方式，因此数值不一定相同。Data 适合观察趋势与定位异常活动，不应替代服务侧的用量记录，也不能仅凭累计流量判断订阅是否到期。连接开关处于开启状态但数据没有变化时，应结合实际请求与诊断信息继续检查。

Settings：常用项与调整边界

Settings 包含解析、测试、快捷操作、同步与诊断等入口。部分行为也可能由当前配置文件控制。调整前应先区分“应用中的选项”和“配置文件中的参数”，记录原值，并确认实际生效的是哪一处，避免在两处重复修改后无法解释结果。

DNS：先确认解析链路

DNS 将域名转换为连接所需的地址。可在 Settings 中查看 DNS 相关选项，并核对 Config 内是否已有解析设置。遇到域名访问异常时，先比较不同目标、不同本地网络的表现，再检查解析结果及访问路径，不要把所有连接失败都归因于 DNS。

需要调整时，一次只修改一个解析选项，使用同一目标重新测试，并考虑缓存对结果的影响。选择的解析服务本身必须在当前路径上可达；改变 DNS 不会修复错误的服务器密码、失效的订阅或无法建立的传输连接。局域网名称与公共域名也可能有不同的解析需求，修改后应分别验证。

Test Method：明确测试测量的对象

Test Method 决定连通性测试使用的方法，可在 Settings 中查找。不同方法关注的链路环节不同，结果不能直接混在一起排序比较。先选定适合当前排查目的的方法，再返回 Home 执行 Connectivity Test，比较同一网络、同一方法下的结果。

较低的测试耗时不等于持续传输更快。若测试有响应但实际访问失败，继续核对目标、规则、DNS 和传输参数；若只有某一种测试方法失败，应先确认该方法的测试条件是否成立，而不是直接删除服务器。

Today Widget：快捷入口与状态确认

Today Widget 用于相关快捷操作或信息展示，可在 Settings 中查看可配置内容，并在系统支持的位置添加。系统提供的展示方式与功能可用性以设备实际界面为准。

设置后先进行一次手动操作，再回到 Home 检查服务器选择与连接状态。快捷入口只是操作路径的缩短，不会替代服务器配置，也不应把短暂未刷新的展示状态作为唯一判断依据。

iCloud 同步：同步前先保留副本

iCloud 同步用于在符合条件的设备间同步应用支持的内容。在 Settings 中检查相关选项，同时确认系统的 iCloud 状态和应用权限。启用前先在各设备保留必要副本，再确认要以哪台设备上的内容作为整理基准。

不要假定同步会包含所有统计、系统授权和临时连接状态。同步内容与处理方式以当前界面说明为准。两台设备同时编辑可能使变更难以追踪，建议先在一台设备完成整理，确认另一台收到预期内容后再继续操作。换机后的应用恢复与配置同步也是两项不同任务。

Diagnostics：按问题采集信息

Diagnostics 是辅助定位问题的入口，可在 Settings 中查找。先写下故障发生时的网络类型、路由模式、目标和操作，再使用界面提供的诊断功能。一次仅复现一个问题，才能把诊断记录与实际现象对应起来。

需要整理记录时，保留错误类别、发生顺序和必要的设置名称，遮盖订阅地址、认证信息、个人域名与网络标识。诊断输出用于解释连接过程，不代表应把所有显示出的参数都改一遍。测试完成后，将仅为排查开启的记录选项恢复到日常状态。

设置检查顺序：从连接到自动化

把基础连接、分流和自动化分开验证，通常比同时调整多个设置更容易定位问题。下面的顺序适用于新配置验收，也适用于修改后出现异常的情况。

  1. 确认服务器信息。检查 Home 中选中的条目、协议与认证参数，订阅导入的条目还需确认最近一次更新是否成功。
  2. 确认路由模式。记录 Global Routing 当前值；需要排查规则时，使用同一目标做模式对照，并在测试后恢复原值。
  3. 确认生效配置。打开 Config 核对文件、策略名称和匹配顺序，不只检查编辑过的文件是否已保存。
  4. 检查 DNS 与实际请求。将解析问题、连接建立问题与目标响应问题区分开，避免只凭一个测试耗时判断全部链路。
  5. 观察 Data 并按需诊断。以明确的一次访问作为样本，结合 Diagnostics 记录解释结果，不把统计差异直接视为计费异常。
  6. 最后启用自动化与同步。手动连接稳定后，再逐项验证 On Demand、快捷入口和 iCloud 同步，保留可恢复的配置副本。

如果问题只发生在某个本地网络，优先保留同一服务器和同一配置，对照网络环境；如果只发生在 Config 模式，优先检查规则。按变量逐项缩小范围，可以减少无关修改，也便于在记录中说明问题发生的位置。

查看连接问题问答 查阅界面与协议术语 →