Shadowrocket 功能与设置详解 - Shadowrocket iPad版

Home / Global Routing

三种路由姿态

配置、代理、直连分别对应 Config、Proxy、Direct。它们决定总体处理方式，不等于连接开关，也不等于规则行中的策略名称。

界面取值	处理方式	何时使用	先检查什么
Config · 配置	依据当前启用配置中的规则决定策略。	日常按域名、地址段等条件分流。	Config 是否选中预期文件，规则与 FINAL 是否完整。
Proxy · 代理	以代理路径作为总体路由方式，具体仍受系统与应用处理范围约束。	短时对照测试代理路径，判断是否为规则匹配问题。	所选服务器能否连接，以及认证、DNS 与目标服务是否正常。
Direct · 直连	以直连路径作为总体路由方式，不依赖代理服务器转发。	测试当前网络直接访问目标的表现。	本地网络、DNS 与目标本身是否可达。

在哪里设置，如何验证

在 Home 找到 Global Routing，先记下原来的取值，再选择要测试的姿态。使用 Config 前，进入 Config 确认实际启用的是准备好的文件，而不是仅仅把文件下载到了列表里。之后回到 Home，确认所选服务器并开启连接；用同一个目标进行前后对照，避免更换目标后失去可比性。

Proxy 能访问而 Config 不能访问时，应进一步查看命中的规则及其策略；这只是定位线索，不能据此断定规则一定写错。Direct 也不能访问时，要先检查当前网络和目标状态。Direct 不等于关闭系统 VPN 配置；如果需要完全停止客户端接管连接，应使用连接开关，并检查 On Demand 是否可能再次触发。

部分界面还会显示 Scene，它用于场景相关配置，不属于本节的三种基础对照。开始排查时，先固定一种明确的姿态，避免同时引入场景切换条件。

Config / [Rule]

规则类型与执行策略

规则描述“什么请求匹配”，策略描述“匹配后怎么处理”。在 Config 姿态下，规则从上到下检查，首条命中后停止，不按关键词长短自动排序。

先写具体条件，再写兜底

DOMAIN 匹配完整域名；DOMAIN-SUFFIX 匹配指定域名及其子域名；DOMAIN-KEYWORD 按域名中的关键词匹配，范围通常更宽。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址段；GEOIP 根据 IP 归属数据匹配，结果受数据库与解析过程影响，不能当作网站所属地的证明。

USER-AGENT 针对可获取的 User-Agent 信息匹配，不宜假定它能覆盖所有应用请求，尤其不能把它当作通用应用身份识别。FINAL 是兜底规则，放在最后处理前面没有命中的请求；若提前放置，后续规则便没有匹配机会。

用于阅读的规则片段

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

example.com 与 example.net 为教学域名。这是规则顺序示例，不是适合直接覆盖现有配置的完整文件。

PROXY、DIRECT 与 REJECT

PROXY 交给代理路径，DIRECT 走直连，REJECT 拒绝对应请求。规则里出现 PROXY 并不会自动补全服务器参数；仍要保证所需服务器或策略选择有效。REJECT 适合明确知道应阻止的目标，若范围过大，页面中的认证、图片或接口也可能一起失败。

在 Config 打开当前文件，检查 [Rule] 段，再逐项核对类型、匹配值、策略和顺序。修改前保留原文件，一次只调整一条条件；重新发起目标请求并查看记录，确认命中结果。不要为了修复一个域名，把大范围关键词规则直接放到最前面。

查看规则与配置参考大全

Home / SERVER / Add Server

订阅与服务器管理

服务器条目保存连接参数，Subscribe 用于从用户已有订阅更新条目，Config 则负责规则等配置内容。这三者互相关联，但不能相互替代。

Subscribe：批量导入与更新

在 Home 通过添加入口进入 Add Server，选择 Subscribe，并填写自己已有的订阅地址。保存后执行更新，回到 SERVER 检查是否实际生成条目。订阅地址通常包含访问凭据，不应放进公开截图、聊天记录或诊断分享内容。

更新失败时，先确认链接没有空格、换行或失效参数，再检查当前网络能否请求该地址。更新只说明订阅内容被重新获取，不代表其中每个服务器都可连接。订阅管理的条目可能在后续更新时重建，重要的手工修改应另行记录。

Add Server：手工填写与扫码

已有单个服务器参数时，在 Add Server 选择相应协议，再按实际资料填写地址、端口、认证与传输选项。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的字段含义不同，不要只替换协议名称而保留上一条记录的参数。

Scan QR Code 只是录入方式，不负责核验来源与可用性。扫码后仍要核对协议、地址及关键参数；二维码也可能包含敏感信息。保存条目后先进行 Connectivity Test，再选择该条目测试实际访问，避免把“已添加”误认为“已连接成功”。

整理列表时保留可追溯性

给条目使用便于辨认的备注，但不要在名称中写密码。区分订阅生成的记录与手工记录，删除前确认是否仍有配置引用。若服务器测试正常但目标访问异常，应继续检查 Global Routing、规则、DNS 和目标服务，不要反复删除再导入同一份内容。完整的第一次连接流程可参阅快速上手。

Settings / On Demand

按网络条件触发连接

On Demand 用于在符合设定条件时，由系统触发 VPN 连接行为。它回答的是“什么时候建立连接”，而不是“这个域名走哪条路径”。Wi-Fi、Cellular 等条件与 Global Routing、[Rule] 分别属于不同层次，启用后仍要保证当前配置和服务器可以正常工作。

在 Settings 查找 On Demand，先阅读当前界面列出的条件与动作，再为明确的使用场景设置。涉及 Wi-Fi 名称时，要核对具体网络，不要仅凭相似名称判断。初次设置建议只保留一个容易复现的条件，确认行为符合预期后再增加其他条件。

建议验证顺序

先手动连接，确认当前配置能正常访问所需目标。
设置一条 On Demand 条件，保持其他设置不变。
切换到对应 Wi-Fi 或 Cellular，观察系统连接状态。
再切换到不满足条件的网络，核对实际行为。

系统调度、网络切换与应用状态都可能影响触发时机，不应把它视为精确到秒的定时器。

若发现手动断开后又重新连接，先检查 On Demand 条件，而不是立即删除系统 VPN 配置。排查普通连接故障时，可以先记录并暂时关闭按需触发，完成手动连接测试后再恢复。频繁切换网络时也应留意认证页面：需要网页登录的 Wi-Fi，应先完成网络自身的接入流程。

Data

流量统计的阅读边界

Data 用于查看客户端记录范围内的流量信息。进入 Data 后，先辨认当前显示的是哪个统计范围、方向或时间区间；不同页面的汇总口径可能不同。上传与下载计数能帮助观察连接是否发生，但不能仅凭一个总数判断目标页面是否完整加载，也不能把客户端统计直接等同于运营商账单。

测试时记录开始前的显示值，再进行一项明确操作，结束后查看变化。后台同步、系统请求、重试及协议开销都可能产生额外流量；如果一边播放内容一边测试其他网站，统计变化便难以归因。需要重新建立观察基线时，先记录旧数据，再使用当前界面提供的重置功能，注意重置不会恢复已经清除的本地统计。

Data 不能代替订阅额度查询。用户已有服务的额度、有效期与结算口径应查看其原有账户说明；客户端显示的流量不是服务端剩余可用量的保证。排查异常增长时，优先结合请求记录确定来源，再缩小测试范围，而不是直接把全局姿态改成另一种后长期放置。

Settings

常用设置逐项检查

设置项是否显示、支持哪些选项，以当前系统及应用界面为准。先记录原值再修改；如果相关能力受配置文件控制，也要核对 Config，避免只修改界面上的一处。

DNS：先分清解析与连接

是什么：DNS 将域名解析为地址，其结果可能影响后续 IP 类规则与连接路径。域名解析成功不表示服务端口可用，连接失败也不一定是 DNS 的问题。

在哪与怎么设：在 Settings 查找 DNS 相关设置，同时检查当前 Config 的 [General] 段是否包含解析设置。根据已有网络需求核对解析器和相关选项，一次只修改一项，并使用同一域名重新测试。

注意什么：不要把随机更换 DNS 当作通用修复。网络中的内网域名、认证页面及 IPv6 行为可能有不同要求；缓存也可能让修改效果不能立刻体现。保留修改前后的解析结果，才便于判断差异。

Test Method：决定测试代表什么

是什么：Test Method 决定 Connectivity Test 使用的探测方式。不同方法所测的链路环节不同，返回结果不适合脱离方法直接比较。

在哪与怎么设：在 Settings 找到 Test Method，查看当前可选方法与测试目标。记录选项后回到 Home 执行 Connectivity Test；做服务器之间的对照时，保持同一方法、同一目标和相近网络条件。

注意什么：探测成功不等于所有网站都可访问，某种探测失败也不能单独证明认证参数错误。不要为了追求较小的显示值反复更改方法；应补充实际目标访问测试，结合错误信息判断。

Today Widget：快捷操作与状态确认

是什么：Today Widget 提供系统小组件相关的快捷访问能力，实际可用形式受系统支持范围影响。它是操作入口，不是独立的一套路由配置。

在哪与怎么设：在 Settings 查看 Today Widget 相关选项，再到系统的小组件管理界面检查能否添加。按当前系统允许的方式配置后，执行一次快捷操作，并回到 Home 核对连接与所选服务器。

注意什么：小组件展示可能存在刷新间隔，不能仅凭旧状态判断当前连接。若入口未显示，先检查系统支持和应用实际选项，不要依照其他设备的界面位置强行寻找。

iCloud：同步不等于完整备份

是什么：iCloud 相关功能用于在符合条件的设备间同步应用支持的数据，具体同步范围以界面说明为准，不应假定服务器凭据、配置及所有 Settings 都会完整同步。

在哪与怎么设：先检查系统 iCloud 权限与账户状态，再到 Settings 核对应用内同步选项。切换前保留现有配置，在另一设备查看具体内容是否已到位，而不是只确认文件名出现。

注意什么：网络、可用空间及同步冲突可能影响结果。删除内容前确认是否会影响其他设备；同步也不能代替独立备份。导出文件或配置可能包含服务器凭据，保存和传递时应限制访问范围。

Settings / Diagnostics

诊断与最小改动排查

Diagnostics 用来收集或查看诊断线索，帮助区分解析、连接、认证与规则路径等问题。在 Settings 找到对应入口后，先阅读当前提供的工具与输出说明，再复现一次故障。不同平台和界面提供的内容可能不同，不要把某项工具的缺失理解为应用没有连接能力。

排查应从一个明确目标开始：记下使用 Wi-Fi 还是 Cellular、Global Routing 的取值、所选服务器、当前 Config 和失败表现。先确认基础网络，再看服务器连通与认证，然后检查 DNS 和规则命中，最后恢复 On Demand 等自动化行为。每轮只改一个变量，测试完成后记录是否改善，避免一组改动掩盖真正原因。

例如 Proxy 下目标可访问而 Config 下失败，可以保留服务器不变，检查该域名是否先被较宽的规则命中，以及命中策略是否符合预期。如果两种姿态都失败，应转向服务器参数、当前网络与目标状态，而不是不断移动 FINAL。规则问题、服务器问题和系统网络问题需要不同证据。

分享诊断内容前，检查其中是否包含订阅地址、认证字段、个人域名、设备信息或访问记录，并按需要遮盖。仅提供复现步骤、相关错误和必要的规则片段即可；不要公开整份配置来换取排查建议。恢复正常后，把临时测试设置还原，并再次确认日常使用的 Config 与 On Demand 条件。

继续查阅配置结构与规则匹配参考