官方手册 / 功能与设置

Shadowrocket
功能与常用设置

先确认 Global Routing,再检查服务器、规则与 DNS。每次只改一个设置,并用相同目标复测,才能判断变化来自哪里。

01Global Routing:选择流量处理方式

Global Routing 决定进入 Shadowrocket 的连接按什么方式处理,不是服务器协议选项。在 Home 打开 Global Routing 后,可以核对当前选中的模式。日常按配置分流使用 Config;需要判断代理路径是否可用时,可以暂时使用 Proxy;需要比较直接连接结果时,可以使用 Direct。切换模式不等于重新导入服务器,也不会自动修正错误的服务器参数。

界面值处理方式何时使用需要留意
Config(配置)按当前配置中的规则与策略处理连接。需要区分域名、地址和不同用途的连接。确认当前启用的配置,以及规则命中的策略。
Proxy(代理)以代理方式处理进入客户端的连接。临时检查当前代理路径是否可用。仍需有效服务器;不应把模式名称当作连接成功的证明。
Direct(直连)直接连接,不通过代理服务器转发。比较当前网络下的直接访问结果。不是关闭连接开关,也不能验证代理服务器的可用性。

设置时先记下原来的模式,再选择用于测试的模式,访问一个明确的目标,记录结果后恢复日常设置。Proxy 下正常、Config 下异常时,应优先检查配置和规则,而不是反复更换协议。如果界面还显示 Scene,应按该项实际配置的场景另行核对;本表只解释 Config、Proxy、Direct 三种基本方式。

02Rule:规则类型与策略

规则分流把连接的目标信息与规则逐条比较,再交给匹配的策略处理。进入 Config,确认正在使用的配置,再查看或编辑其中的 Rule。只有在 Global Routing 使用 Config 时,才应按配置规则解释访问结果。排查前先保留当前配置副本,避免一次修改多条规则后无法还原。

DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀,DOMAIN-KEYWORD 按域名中的关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围,GEOIP 按地址归属信息匹配。选择规则类型时,要先判断手中依据是域名还是 IP 地址;不要把网页地址中的路径或查询参数直接当作 DOMAIN 的值。

规则语法示例自上而下匹配
  1. 01DOMAIN-SUFFIX,example.com,PROXY
  2. 02DOMAIN-KEYWORD,ads,REJECT
  3. 03IP-CIDR,192.168.0.0/16,DIRECT
  4. 04FINAL,PROXY

PROXY 表示交给代理策略,DIRECT 表示直接连接,REJECT 表示拒绝连接;颜色只是辅助标记,判断时以英文策略名为准。规则从上到下匹配,命中后不再继续寻找后面的规则。因此更具体的例外通常放在宽泛规则之前,FINAL 放在末尾,为前面均未命中的连接提供兜底策略。

上面的 example.com 仅用于解释语法,不是服务入口。关键词规则容易覆盖比预期更多的域名,修改后应检查实际命中记录。需要完整的顺序和策略示例,可阅读自定义规则与 FINAL 兜底说明。

03Subscribe 与服务器管理

服务器条目保存连接所需的协议和参数,Subscribe 用来管理已有订阅提供的一组条目。规则配置与服务器列表解决的是不同问题:前者决定怎么分流,后者决定代理连接使用什么服务器。即使列表里已有条目,仍要确认当前选择的服务器有效,并核对 Global Routing 的模式。

Add Server:逐项核对已有信息

在 Home 使用添加入口进入 Add Server,按已有服务器信息选择 Type,再填写地址、端口及该协议要求的认证、传输或 TLS 参数。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的字段不完全相同,不应把一种协议的参数机械套用到另一种协议。保存前尤其要核对端口、大小写和额外选项,不能只检查地址一项。

Subscribe:导入与更新分开检查

在添加入口中选择 Subscribe,填入自己已有的订阅地址并保存。更新后检查分组及条目是否符合预期,再选择服务器进行 Connectivity Test。订阅可以被解析并不代表其中每条服务器都可连接;测试有结果也不代表目标网站一定可访问,最终仍需实际打开目标页面验证。

Scan QR Code 和剪贴板导入适合已有分享信息的情况。导入后仍要进入条目核对 Type 与关键参数。管理多份订阅时使用易辨认的备注,更新前注意是否存在手动调整过的条目,删除分组前确认影响范围。订阅地址和分享信息可能包含认证内容,不应放到公开截图、日志或讨论中。更细的更新、整理和备份步骤见节点管理手册。

04On Demand:按条件发起连接

On Demand 用于根据已设置的网络条件决定是否自动发起连接,不负责替代 Rule 选择网站策略。先在 Home 手动验证服务器和配置可用,再进入 Settings 中的 On Demand 检查开关与条件。具体可配置条件以当前应用界面为准,不必为了开启此功能而同时改动 DNS 或规则。

设置时先明确需求:是网络变化后需要自动连接,还是某些网络下不需要连接。按界面提供的条件完成设置后,分别在条件满足与不满足的网络中观察结果,同时检查系统中的 VPN 状态和应用里的连接状态。只测试一次手动打开开关,不能说明自动触发条件已经正确。

如果关闭连接后又出现自动连接,应先回到 On Demand 检查,而不是立即删除服务器。临时排查时可以先停用 On Demand,让连接状态由手动控制;排查完成后再恢复需要的条件。网络变化后的行为还会受到系统状态影响,因此要把“未触发连接”和“已连接但访问失败”分开处理。

05Data:查看流量统计

Data 用于查看客户端记录的流量情况。打开 Data 后,先识别当前页面显示的统计范围和分类,再解读上传、下载等信息。统计值表示相应范围内的记录,不等同于服务器账户的计费账单,也不能单独证明某个目标正在通过 PROXY 访问。

观察某次操作时,可以先记下测试前的统计,再访问一个明确目标,回到 Data 比较变化。设备上的后台活动也可能产生流量,因此测试时尽量保持操作单一。若界面提供不同范围的统计,比较前应保持范围一致;若准备清除统计,先记录需要保留的数据。

发现流量增长与预期不同时,下一步是结合 Global Routing、实际命中的规则和连接记录判断,而不是直接认定服务器异常。Direct 测试与 Proxy 测试也应分别记录,避免把不同路径下的结果混在一起。需要核对服务使用量时,以用户已有服务的账户记录及其统计口径为准。

06Settings:常用项的调整方法

Settings 集中提供客户端行为及相关工具设置。进入后先阅读当前项目的说明,并记下已有值;若某项还受到当前 Config 影响,应一并核对配置。以下按功能解释常见项目,具体入口层级和可用选项以当前应用内显示为准,不按旧界面位置盲目寻找。

DNS:先区分解析与连接

DNS 负责把域名解析为地址。网页无法打开而 Connectivity Test 有结果时,解析环节只是可能原因之一,还需排除规则、服务器和目标本身的问题。检查 Settings 中的 DNS 项及当前配置的 DNS 设置,确认是否有手动指定内容,再决定要修改哪一处。不要同时更换解析设置、服务器和路由模式,否则无法确认是哪一步起作用。

修改前记录原值,修改后对同一域名复测,并结合记录确认失败发生在解析还是连接阶段。域名规则与地址规则的判断依据不同,解析结果变化也可能影响后续地址规则。不要只凭一次网页加载速度判断 DNS 设置优劣;完整思路见DNS 设置与网页解析排查。

Test Method:统一测试口径

Test Method 控制 Connectivity Test 使用的测试方式。在 Settings 查看当前选项后,保持测试方式与测试目标一致,再比较服务器结果。不同测试方式关注的环节可能不同,数值不能脱离方法单独比较。若某条目没有结果,应检查所选方法的适用条件,不要立刻删除条目。

测试通过只代表该测试涉及的路径有响应,不保证所有网站、所有协议或整个访问过程均正常。改变 Test Method 后应重新执行测试,并另外打开实际需要访问的页面,才能把测试结果与使用结果对应起来。

Today Widget:快捷查看与操作

Today Widget 用于相关系统小组件入口的显示或快捷操作设置。在 Settings 核对对应选项,再到设备的系统小组件管理界面查看可添加的内容。系统提供的展示位置和操作能力可能不同,应以设备实际显示为准。通过小组件操作后,仍可回到 Home 核对服务器、Global Routing 和连接状态,不能仅凭小组件外观判断访问路径。

iCloud:同步前先保留副本

iCloud 相关选项用于应用提供的同步或云端保存能力。使用前先确认设备系统中的 iCloud 状态,再查看 Shadowrocket 内相应设置及其说明。不要假定打开一个开关就会同步全部服务器、配置和统计;同步范围以应用所列内容为准。

多设备操作前先保留重要配置,避免两台设备同时修改同一份内容。同步后分别检查实际生效的 Config、服务器选择与 Global Routing,不把“已同步”当作“已完成连接设置”。包含认证信息的配置和订阅属于敏感数据,保存及分享时应单独留意。

07Diagnostics:用记录定位故障环节

Diagnostics 提供诊断相关入口,用来协助区分网络、解析及连接问题。在 Settings 查找 Diagnostics,按当前界面提供的工具执行检查。开始前记下所用网络、选中服务器、Global Routing 和发生问题的目标,然后只重现一次问题,让诊断记录能与这次操作对应。

阅读结果时按顺序确认:域名是否解析、连接是否发起、实际走哪项策略、服务器是否返回可用响应。不同工具测试的对象不同,某一项成功不意味着后续环节也成功。若 Proxy 可用而 Config 不可用,优先查看规则命中;若两者都失败,再检查服务器信息和当前网络;若仅某个域名异常,则围绕该域名继续排查。

保存或提交诊断信息前,应检查是否包含订阅地址、服务器认证、完整配置和不必公开的访问记录,移除敏感内容后再分享。描述问题时保留操作顺序和可复现现象,比只写“无法连接”更有帮助。需要逐项执行的清单,可阅读已连接却无法访问的排查说明。

08设置后的验证顺序

功能之间有关联,但不应同时调整。首次使用先按使用教程完成已有信息导入和手动连接,再逐步加入规则、On Demand 与同步。已经可以正常访问的配置,应保留可恢复的副本,作为之后比较的基准。

  1. 确认输入。检查服务器协议、地址、端口和认证参数,确认订阅更新是否成功,当前条目是否确实被选中。
  2. 确认模式。在 Home 查看 Global Routing,用明确的测试目的选择 Config、Proxy 或 Direct,测试后恢复日常模式。
  3. 确认路径。在 Config 下检查命中的规则、策略与 FINAL,避免宽泛规则先于具体例外生效。
  4. 确认结果。实际访问目标,并结合 Data 和 Diagnostics 理解现象;测试响应与页面可用性分别记录。
  5. 恢复自动行为。基础访问正常后,再启用所需的 On Demand 和同步设置,重新检查网络切换后的表现。

本文以 iPhone 与 iPad 上的使用流程为主。设备系统要求及其他 Apple 设备的兼容性,以 App Store 页面标注为准;功能入口与选项以当前应用内显示为准。