Subscribe：导入已有订阅
从 Home 的添加入口进入相应类型，选择 Subscribe 后填入用户已有的订阅地址，保存并更新列表。先检查更新能否成功，再查看返回条目是否符合预期；名称相似不代表参数相同，选择时应核对条目所属分组。
更新可能替换订阅生成的记录，因此不要把长期保留的手动改动只写在这些条目里。更新失败时检查链接是否完整、是否过期，以及当前网络能否访问订阅地址，不要通过反复删除全部配置来尝试解决。
官方手册 · 功能参考
Shadowrocket
Shadowrocket
功能与常用设置
先确认流量处理模式，再调整规则、连接条件与诊断选项。
iPhone / iPad 版从 App Store 获取，$2.99 一次性付费；Mac（Apple 芯片与 Intel）、Windows、安卓、Linux 版免费。各平台获取方式集中在获取应用页，电脑与安卓安装包通过本站 /dl/ 分发。iPhone / iPad 系统要求以 App Store 页面标注为准。
先看 Global Routing
再看 Config 与 SERVER
最后检查 Settings
下文以 iPhone / iPad 的界面词说明操作位置；其他平台的入口排列、系统集成功能和可用设置可能不同，请以当前安装版本显示的项目为准。本文讲解如何使用用户已有的订阅或服务器信息，不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐。
01 · 模式
Global Routing：配置、代理与直连
Global Routing 决定客户端怎样处理进入隧道的连接。在 Home 中找到 Global Routing，按使用目的选择 Config、Proxy 或 Direct。它不是服务器协议选项，也不是连接开关：选对模式之后，仍需确认 Home 当前选中的服务器与连接状态。
| 界面词 / 中文含义 | 处理方式 | 适用情况 | 先检查什么 |
|---|---|---|---|
| Config / 配置 | 按照当前配置中的规则决定策略。 | 需要区分代理、直连或拒绝连接。 | 已选中的配置文件、规则顺序及最终规则。 |
| Proxy / 代理 | 通常将进入隧道的流量交给当前代理处理。 | 临时检查服务器是否能够建立实际连接。 | 当前服务器、认证参数及目标服务可用性。 |
| Direct / 直连 | 通常让进入隧道的流量直接连接目标。 | 对照检查问题是否与代理路径有关。 | 本地网络、DNS 与目标网站自身状态。 |
日常按规则使用时选择 Config，再到 Config 确认启用的是哪一份文件。需要定位故障时，可以短暂切换 Proxy 或 Direct 做同一目标的对照测试；测试完成后恢复原模式。切换模式只改变处理方式，不会自动修复错误的地址、密码或证书设置。
02 · 分流
规则类型与 PROXY / DIRECT / REJECT
规则由“匹配条件”和“处理策略”组成。在 Config 打开当前配置，查看规则列表或编辑内容；回到 Home 后，Global Routing 必须使用 Config，规则才会按配置参与分流。常规规则按顺序匹配，较具体的条件应放在较宽泛的条件前面，最终用 FINAL 处理剩余连接。
PROXY 表示交给配置中的代理策略，DIRECT 表示直连，REJECT 表示拒绝。策略名称必须能被当前配置识别；若文件引用了自定义策略组，还要确认该组已经定义并选中了可用项。不要只修改规则末尾的名字而忽略对应策略是否存在。
右侧片段仅说明语法，不是完整配置，也不对应真实线路。添加前备份当前文件；每次只修改一条规则，保存并确认当前配置后再建立新连接，避免多个变化叠加后难以判断原因。
Rule · Policy
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,DIRECT| 规则关键字 | 匹配对象 | 设置注意 |
|---|---|---|
DOMAIN | 指定的完整域名。 | 域名不包含协议前缀和 URL 路径。 |
DOMAIN-SUFFIX | 域名本身及其子域名。 | 适合按站点域名范围配置。 |
DOMAIN-KEYWORD | 域名中出现的关键词。 | 匹配范围较宽，要留意误命中。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 分别核对地址族与网络前缀长度。 |
GEOIP | IP 地理归属数据库中的区域。 | 结果取决于数据库与实际解析到的地址。 |
USER-AGENT | 可读取的 User-Agent 请求字段。 | 并非所有连接都能提供该字段，不能代替通用的应用识别。 |
FINAL | 此前未匹配的连接。 | 通常置于末尾，明确兜底策略。 |
03 · 信息管理
Subscribe 与 Add Server
服务器记录保存单个连接的协议、地址、端口和认证信息；订阅则用于批量取得并更新这些记录。两者都以用户已有信息为前提。订阅与 Config 不是同一个概念：导入服务器列表之后，仍需单独确认正在使用的规则配置和 Global Routing 模式。
Add Server：填写单条记录
在 Home 打开 Add Server，先按已有信息选择协议类型，再逐项填写服务器地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段并不相同，不能仅凭地址格式猜测类型。
使用 Scan QR Code 时，导入后仍要核对协议与关键字段。保存后在 SERVER 列表选中相应条目，先做 Connectivity Test，再尝试真实访问；测试通过只能说明对应测试条件下的结果。
04 · 连接条件
On Demand：按条件触发连接
On Demand 用于让系统在符合条件时建立或恢复 VPN 连接。它回答“什么时候连接”，而 Global Routing 回答“连接后怎样处理流量”。两者作用不同：启用 On Demand 不会自动选择合适的服务器，也不会替代 Config 中的规则。
在哪里设置、怎样验证
在 Settings 中查找 On Demand，查看当前版本提供的网络条件和连接行为。先用手动连接确认服务器可用，再启用按需连接；若界面提供 Wi-Fi、蜂窝网络或指定网络条件，只配置确实需要的项目，不必一次填满。
保存后切换一次相应网络，再回到 Home 检查连接状态，并用新请求验证实际访问。测试时同时记录当前网络与触发条件，避免把系统短暂的网络重连误认为规则分流错误。
暂停连接时注意什么
开启 On Demand 后，手动关闭连接不一定意味着之后一直保持断开，系统可能在条件再次满足时重新连接。如果需要明确暂停，先检查按需设置是否仍在生效，再观察 Home 的连接状态。
按需连接依赖系统权限、网络状态与当前配置。频繁切换网络时，重新建立隧道可能造成短时等待；应先简化触发条件逐项验证，而不是同时调整 DNS、服务器与规则。
05 · 用量观察
Data：流量统计与请求观察
Data 用于查看客户端记录的传输用量及当前版本提供的连接信息。进入 Data 后，先辨认页面统计的是当前会话、累计值还是某个时间范围，再观察上传与下载的变化。如果界面提供重置统计，应在记录必要数据后操作，并记下重置时点，方便之后比较。
排查时可以先关闭其他正在传输的任务，记录当前数值，再访问一个目标，观察是否产生新流量。若能够查看连接详情，可结合域名、目标地址和命中的策略判断处理路径；“有流量”只能表明发生了传输，不能独立证明目标网页完整加载或全部连接都采用同一策略。
客户端的统计口径与系统、网络运营方或服务器端记录可能不同，协议封装、统计时间范围、直连流量是否计入等都会影响结果。Data 不应作为远端账户剩余额度的依据，也不能仅凭某次上传量判断是否存在异常。准备分享截图或日志时，先检查其中是否含有访问记录和服务器信息。
06 · 常用设置
Settings：DNS、测试与系统集成
进入 Settings 前，先记下当前配置与已有值。不同平台和系统版本的项目可能有所差别；下面按功能解释，不要求将所有开关都打开。若配置文件也包含同类设置，应同时检查其内容，避免只改界面选项却忽略当前配置的影响。
DNS：域名解析
DNS 把域名转换成连接所需的 IP 地址。检查 Settings 中的 DNS 相关项目，并在 Config 查看当前配置是否定义了解析行为。设置时使用自己确认可用的解析服务，区分普通解析、加密解析和代理路径，不把不同格式的地址混填到同一字段。
出现“地址可连接但域名打不开”时，优先检查解析是否失败、返回的地址族是否可达，以及解析请求自身的路由。更改后按当前界面提供的方式清理缓存或重新连接，再发起新请求。不要为了某个网站的一次失败直接关闭所有 IPv6 或重写全部 DNS。
Test Method：测试方法
Test Method 决定服务器列表测试所采用的方法，在 Settings 查找该项目。应先了解选项测试的是连接建立还是指定目标的响应，再通过 Home 的 Connectivity Test 运行测试。对比多个条目时保持方法、目标与本地网络一致。
显示的时间不是下载速度，也不能预测所有网站的体验。目标站点的状态、握手过程和网络瞬时变化均会影响结果；某种方法失败时，用实际请求复核，不要只因单次结果就删除记录。
Today Widget：快捷查看与操作
Today Widget 是系统小组件相关的快捷入口，适用于系统与当前版本仍提供该能力的环境。在 Settings 查看相应选项，再到系统支持的小组件管理界面添加。可用布局与操作方式以设备上实际显示为准。
首次配置仍应回到 Home 确认服务器、Global Routing 与连接权限。小组件状态可能存在刷新间隔；如果显示与实际访问不一致，先打开应用核对，而不是反复切换快捷开关。小组件也不能代替 On Demand 的条件配置。
iCloud：配置同步
iCloud 用于在支持此功能的设备之间同步相应配置内容。在 Settings 或配置管理中的云端入口查看可同步的项目，并检查系统 iCloud 权限与登录状态。同步范围以当前界面说明为准，不默认包含所有服务器记录、统计或连接状态。
启用前保存本地备份；多台设备不要同时编辑同一份配置。发生内容冲突时，先比较文件再决定保留哪份，避免覆盖仍在使用的规则。配置可能含有订阅地址和认证字段，是否同步应结合自己的账户与设备访问权限决定。
07 · 排查
Diagnostics：按证据缩小范围
Diagnostics 提供当前版本可用的诊断入口。在 Settings 中找到 Diagnostics，按问题选择相应工具或记录方式。先明确是在更新订阅、建立连接、解析域名还是访问目标时失败，再进行对应检查；不要把所有失败都归结为服务器速度。
- 确认本地网络。暂时断开客户端连接，检查本地网络是否能正常访问原本可达的服务，排除 Wi-Fi 登录页、系统网络切换等因素。
- 核对连接参数。检查协议、地址、端口、认证与 TLS 相关字段，注意复制时带入的空格或遗漏内容。证书错误应核对域名、设备时间与参数，不应直接忽略验证。
- 分离模式与规则。使用同一目标分别验证 Proxy 与 Config。前者正常而后者失败时，重点查看规则命中、策略引用与 DNS 路径。
- 记录最小复现。记下发生问题的网络类型、操作步骤、目标与错误提示。只在需要时开启详细记录，复现后停止，减少无关数据与隐私暴露。
日志中可能含有目标域名、IP 地址、订阅链接或身份字段。分享前应遮去敏感部分，但保留错误类型与必要上下文；只有一句“无法连接”，通常不足以区分解析失败、握手失败和规则选择错误。
08 · 检查顺序
修改设置后怎样确认生效
推荐按“Home 选择服务器 → Config 确认文件 → Global Routing 选择模式 → 建立连接 → 发起新请求 → Data 或 Diagnostics 查看结果”的顺序检查。每次只改一个影响因素，并保留原值；如果结果变差，先恢复该项，再继续排查。首次使用可从快速上手按步骤操作。
已经导入订阅，为什么没有按规则分流？
订阅主要提供服务器记录，不必然包含所需的规则配置。先在 Home 确认 Global Routing 为 Config，再检查 Config 中选中的文件、规则顺序及策略引用。导入成功不等于当前文件已经生效。
Connectivity Test 正常，网页仍打不开，先查什么？
先确认测试与实际访问使用的是同一条服务器记录，再检查目标域名的 DNS 结果、命中的规则及连接错误。测试目标和真实网页可能走不同路径，一次响应不能代表所有访问均正常。
关闭连接后又自动连接，应该改哪个项目？
先检查 On Demand 的启用状态与触发条件。它可能在网络条件满足时重新连接；如需暂停，应先调整按需行为，再回到 Home 验证状态。不要通过删除服务器或配置文件来代替关闭按需连接。
电脑和安卓是否也能使用 Shadowrocket？
可以。iPhone / iPad 版 App Store $2.99 一次性付费，Mac（Apple 芯片与 Intel）、Windows、安卓、Linux 版免费。请到全平台获取说明选择对应平台；具体设置入口和系统集成功能以该平台界面为准。