SHADOWROCKET / OFFICIAL MANUAL

Shadowrocket 代理模式与常用设置

先确认 Global Routing,再检查规则、服务器与 DNS。连接开关已打开,并不意味着所有请求都经过同一种策略。

本页按“是什么、在哪个界面、怎么设置、注意什么”组织。以下操作路径以 iPhone / iPad 界面词为参照;Mac、Windows、安卓、Linux 同样适用这些路由概念,具体入口与可用选项以当前平台界面为准。

01 / GLOBAL ROUTING

配置、代理、直连三种模式的边界

Global Routing 决定流量采用哪套处理逻辑;服务器选择决定需要代理时使用哪个出口。两者不是同一个设置。

是什么:三种模式对应界面里的 Config、Proxy、Direct。Config 按当前配置中的规则分流;Proxy 用于统一走代理路径的检查;Direct 用于统一直连的对照。日常需要区分不同目标时,先使用 Config,再检查具体规则。

在哪、怎么设:在 Home 找到 Global Routing,打开后选择模式,再返回 Home 确认服务器选择与连接开关。选择 Config 前,应先到 Config 页面确认已启用所需文件;只导入了文件但没有启用,不能据此判断规则已生效。

Global Routing 三种模式的适用情形和检查重点
中文说明 / 界面词处理思路适用情形检查重点
配置 / Config按当前配置规则决定策略。日常分流,需要分别处理不同域名或地址。启用的配置、规则顺序、策略指向。
代理 / Proxy将接管的请求统一交给代理路径。短时验证所选服务器是否能处理目标请求。服务器参数、可达性、DNS 与目标服务。
直连 / Direct将接管的请求直接交给当前网络。对照本地网络是否可达,缩小排查范围。当前 Wi-Fi 或移动网络本身的连接条件。

注意什么:这里的“统一”针对客户端实际接管的流量,不等于对设备所有系统活动作保证。Direct 也不等于关闭连接开关;客户端仍可能参与请求处理与记录。测试结束后应恢复原先模式,避免一次临时切换影响后续判断。若 Proxy 可访问而 Config 不可访问,应优先检查匹配规则与策略,不要立刻重建全部服务器信息。

02 / RULES & POLICIES

规则确定匹配条件,策略确定处理方式

是什么:规则由匹配类型、匹配内容与策略组成。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀及其子域,DOMAIN-KEYWORD 按域名中的关键字匹配。后缀规则通常比宽泛关键字更容易审查,填写时只写域名部分,不把协议前缀或网页路径混进去。

IP-CIDR 与 IP-CIDR6 分别用于 IPv4、IPv6 网段;GEOIP 根据 IP 地址的地区数据库匹配,其结果会受数据库与解析结果影响。USER-AGENT 依赖请求里可读取的相应字段,并非所有连接都具备这个条件,不能把它当成通用的应用识别方式。

在哪、怎么设:到 Config 打开当前使用的配置,查看规则内容及排列。匹配通常按从上到下的顺序进行,先命中的规则决定策略。因此更具体的例外应放在宽泛规则之前,最终兜底放在末尾。修改前先保留原文件;每次只调整一类条件,保存后确认当前启用的仍是这份配置。

规则语法示例

以下只用于解释顺序和策略,不是一份完整配置,也不对应任何实际线路。

DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

注意什么:PROXY 表示交给代理策略,DIRECT 表示直连,REJECT 表示拒绝请求;配置也可能引用自定义策略组名称,必须确认该名称实际存在。FINAL 是此前规则均未命中时的兜底,不是“再次测试所有规则”。关键字匹配范围过大时可能影响无关目标;遇到异常应看请求命中的规则,而不是只看规则文本中是否出现目标名称。

03 / SUBSCRIBE & SERVER

订阅更新与服务器参数分开管理

是什么:服务器条目描述一个连接所需的协议、地址、端口及认证信息;Subscribe 用于从用户已有的订阅地址更新一组服务器。Config 则负责规则等配置内容。订阅导入成功,不代表已经选好配置;启用配置,也不代表其中引用的服务器一定存在。

在哪、怎么设:在 Home 使用添加入口进入 Add Server。导入已有订阅时选择 Subscribe,完整粘贴服务商提供的地址,填写便于辨认的名称后保存;更新结束后回到 Home 检查分组是否出现,再选择要使用的服务器。用户已有单个服务器参数时,选择对应 Type,按原始资料逐项填写。使用 Scan QR Code 时也应在保存前核对解析出的类型和地址。

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等协议的字段并不通用。应以当前平台显示的 Type 和已有参数为准,不能仅因服务器地址相同就替换协议。涉及 TLS、SNI、传输路径或其他附加字段时,保留原始资料中的取值,不凭名称猜测。

注意什么:订阅是更新入口,不是连接成功证明。若更新失败,先判断是地址无法访问、认证失效,还是返回内容不能解析;若更新成功但连接失败,再检查选中的条目和参数。订阅更新可能覆盖组内条目的手动改动,长期保留的修改宜先记录或另存。订阅地址、二维码与导出文件可能包含认证信息,交流问题时应遮去敏感内容。

04 / ON DEMAND

On Demand按网络条件触发连接

是什么:On Demand 用于依据网络条件触发连接行为。它解决“什么时候连接”的问题,Global Routing 解决“连接后如何分流”的问题。启用 On Demand 不会自动替用户补齐服务器或配置,也不能代替对现有连接的验证。

在哪、怎么设:在 Settings 找到 On Demand,先阅读当前界面的条件项,再按需要设置 Wi-Fi、移动网络或指定网络相关条件。初次设置建议只添加一种条件,并记录希望发生的行为。例如先确认某个 Wi-Fi 条件是否按预期触发,再增加其他网络条件,避免多条条件叠加后难以定位。

保存后,应实际完成一次网络切换,查看系统连接状态与 Shadowrocket 中的状态是否一致。测试前先确认手动连接能够正常工作;如果手动连接本来就失败,继续增加自动触发条件只会把问题混在一起。不同平台的后台行为和可用条件可能不同,应按本机显示的选项设置。

注意什么:手动断开后,仍满足触发条件的系统可能再次建立连接,这与开关失灵不是一回事。需要暂停时,先暂时关闭 On Demand,再关闭连接。公共 Wi-Fi 需要先完成登录认证时,也应先处理网络登录,再测试自动连接;不要同时修改路由模式、DNS 和触发条件。

05 / DATA

Data 流量统计用于观察,不替代请求记录

是什么:Data 展示客户端记录的流量读数,可用于观察上行、下行及累计变化。当前平台若提供按服务器或按应用的视图,可以分别检查出口使用情况和流量来源。这里的应用归类范围受系统能力影响,不能据此推断设备上的所有活动都被完整识别。

在哪、怎么设:打开 Data,先确认当前视图、统计范围和单位,再阅读数值。上行是设备发出的数据,下行是设备收到的数据;瞬时速率与累计流量是不同指标,不能直接比较。测试规则时先记录现有读数,只发起一次目标访问,再查看相关条目是否增长,并结合请求记录核对策略。

需要开始新的观察区间时,使用界面提供的重置入口前先保存必要读数,并确认重置对象和范围。不要默认所有统计都从安装当天开始,也不要默认每次连接都会清零;具体起点以当前界面与重置行为为准。订阅中显示的额度与有效期来自订阅返回的信息,也不等于 Data 的本地统计。

注意什么:协议封装、重试、统计口径与观察时间不同,都可能让 Data、系统设置和服务商读数不一致。流量增加只能说明存在数据传输,不能单独证明某条域名规则命中;缓存命中时,页面正常打开也可能几乎没有新增流量。详细读数方法可继续查看Data 流量统计说明。

06 / SETTINGS

Settings 常用项按用途逐项调整

初次使用先保留当前设置。只有出现明确需求时才改一项,并记录原值;不存在适合所有网络的一套固定取值。

DNS:先判断解析路径

是什么、在哪:DNS 将域名转换为 IP 地址。Settings 中的 DNS 相关设置与 Config 内的 DNS 内容需要一起检查,不能只凭其中一处推断最终解析路径。域名规则、IP 规则以及不同解析结果之间也可能相互影响。

怎么设:连接本来正常时,先保留当前解析方式作为基线。出现解析失败或地址异常时,记录目标域名、当前网络和错误表现,再核对 DNS 地址是否可达。使用 DNS over HTTPS 时,必须填写完整且有效的解析端点;该端点本身的访问也依赖网络与配置,不是填写后就必然改善。

注意什么:域名解析成功不代表目标服务可用。切换 DNS 后,已有连接和缓存可能使变化不会立即体现,应通过新的测试请求确认。具体解析方式的区别见DNS 设置说明。

Test Method:统一测试口径

是什么、在哪:Test Method 位于 Settings 的测试相关设置中,用于选择 Connectivity Test 所采用的方法。不同测试方法可能只验证不同层次的连通性,因此列表中的结果不能一概视作实际网页速度。

怎么设:按当前界面可用选项选择测试方式,保持同一种方法、同一目标和同一网络环境后再比较结果。测试目标需要是已知可访问、响应相对稳定的地址。先测试一个已知可用条目,再对照其他条目,避免测试目标自身故障造成误判。

注意什么:某种方法没有响应,不一定代表业务请求无法连接;测试有响应也不代表所有协议、所有目标都正常。最终仍需用实际访问与请求记录确认,不应只按一次测试结果频繁切换服务器。

Today Widget:查看快捷状态与入口

是什么、在哪:Today Widget 用于系统支持的组件入口与状态展示;相关选项可在 Settings 中查看。组件的添加位置、显示方式与刷新时机受系统版本影响,以设备实际提供的组件功能为准。

怎么设、注意什么:先在应用内完成连接验证,再到系统组件编辑入口添加相应组件。需要操作连接时,留意系统是否要求解锁或返回应用。组件显示可能有刷新延迟;若显示与应用不一致,回到 Home 与系统连接状态核对,不要把旧读数当成当前状态。

iCloud 同步:先确认范围,再处理冲突

是什么、在哪:在提供 iCloud 同步的 Apple 设备上,可通过 Settings 检查相应选项。同步不是设备备份的同义词,也不意味着每一项运行状态、日志和统计都会跨设备复制。

怎么设:先确认设备使用预期的 iCloud 账户,系统允许应用使用相关服务,再检查客户端列出的同步范围。多设备首次同步前,分别保留重要配置的可恢复副本;在一台设备上完成小范围修改,等待另一台确认后,再继续编辑。

注意什么:不要在多台设备上同时修改同一份内容,也不要在同步尚未完成时反复开关功能。导出文件可能含服务器认证信息,应按敏感文件保存。其他平台不应因存在同名设置就被假定具有相同的 iCloud 行为。更多选项见Settings 设置参考。

07 / DIAGNOSTICS

Diagnostics 与 Log按请求链路定位问题

是什么、在哪:Diagnostics 是诊断相关入口,Log 用于查看可用的运行与请求信息。可从 Settings 中查找当前平台提供的相关工具。诊断的目标是确认失败发生在哪一层,而不是看到错误就一次性修改所有选项。

怎么设:记录网络类型、Global Routing 模式、所选服务器和目标域名;如界面提供日志级别,仅在复现问题期间启用所需详细程度。随后发起一次新的目标请求,按“是否接管、命中什么规则、采用什么策略、是否完成解析与连接”的顺序阅读记录。

若所有目标都失败,先检查当前网络和服务器连通性;若只有一个目标失败,重点看匹配规则、目标地址和 DNS;若切到 Proxy 后恢复,则对照 Config 中的策略指向;若关闭连接后仍失败,应先排查本地网络或目标服务。每次调整后用同一目标重试,才能判断是哪项变更产生影响。

注意什么:日志缺少某条请求不一定意味着规则遗漏,也可能是连接未被接管、缓存未产生新请求,或当前记录范围不包含该事件。分享诊断材料前,应遮去订阅地址、密码、认证字段及个人访问内容。排查结束后恢复日常日志设置,并保留“原设置、变更项、复现结果”这三项记录,便于下一次对照。