Shadowrocket 官方手册
Shadowrocket 功能与常用设置
按连接姿态、规则、服务器与自动触发条件理解设置。先确定要改变哪一层,再调整对应项目,避免同时修改多处后难以判断原因。
- Global Routing · 连接姿态
- Config · 请求策略
- On Demand · 连接触发
Global Routing:选择连接姿态
是什么:Global Routing 决定当前请求按什么方式选择路径。配置姿态对应 Config,代理姿态对应 Proxy,直连姿态对应 Direct。它与 Home 中的连接开关不是同一件事:开关控制连接是否启用,Global Routing 决定启用后如何处理进入客户端的请求。
在哪里、怎么设:在 Home 找到 Global Routing,进入后选择需要的姿态。日常需要按域名或目标地址区分路径时,选择 Config,并确认 Config 页面中已选中预期的配置文件。只想暂时检查当前服务器是否能够连接目标时,可以切换到 Proxy;需要对照本机网络表现时,可以临时使用 Direct。
| 姿态 | 处理方式 | 适用情况 | 需要注意 |
|---|---|---|---|
| 配置 · Config | 按当前配置的规则与策略处理请求。 | 日常规则分流,分别使用 PROXY、DIRECT 或 REJECT。 | 检查启用的配置、规则顺序与最终匹配项。 |
| 代理 · Proxy | 将进入代理处理范围的请求交由所选服务器处理。 | 临时核对服务器连接,或排除某条分流规则的影响。 | 不等于所有系统流量均必然经过服务器。 |
| 直连 · Direct | 以本机网络直接连接目标。 | 对照网络可达性,判断故障是否与代理路径相关。 | 不是关闭连接开关,也不会代替系统网络设置。 |
注意什么:改完姿态后,重新发起目标请求再观察结果。浏览器缓存、已有连接和应用后台任务可能保留此前状态,不能只看一次刷新便认定规则没有生效。排查完成后恢复原先姿态,尤其不要把临时使用的 Proxy 误当成仍在按 Config 分流。
规则分流:匹配条件与执行策略
是什么:规则由匹配类型、匹配内容和策略构成。例如 DOMAIN-SUFFIX,example.com,PROXY 表示按域名后缀匹配,再使用 PROXY 策略处理。匹配类型回答“识别什么请求”,策略回答“匹配后怎样连接”,两者应分别核对。
在哪里、怎么设:在 Config 中查看当前使用的配置,修改前先保存副本。需要为某个域名指定路径时,先确认是单个完整域名还是整个域名后缀,再选择 DOMAIN 或 DOMAIN-SUFFIX。较具体的规则通常放在较宽泛的规则之前;FINAL 作为未命中前序规则时的最终策略,应放在规则列表末尾。
| 类型 | 匹配对象 | 使用边界 |
|---|---|---|
DOMAIN | 完整域名。 | 适合只调整一个明确的主机名。 |
DOMAIN-SUFFIX | 域名及其子域名后缀。 | 范围比单个完整域名更大。 |
DOMAIN-KEYWORD | 域名中的关键词。 | 可能匹配到名称相近但用途不同的域名。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 地址段。 | 应核对地址段与实际目标,不能只看网页域名。 |
GEOIP | IP 地理归属信息。 | 结果受所用数据库与解析结果影响。 |
FINAL | 前序规则未匹配的请求。 | 用于确定最终去向,不应抢在具体规则前面。 |
以下片段只用于理解顺序,不是完整配置,也不包含可用服务器。示例域名 example.com 没有实际线路含义。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
注意什么:PROXY 表示交给代理策略,DIRECT 表示本机直连,REJECT 表示拒绝请求。选择 REJECT 后出现无法访问,可能正是规则预期结果。一个页面还可能请求多个域名,只为主域名添加规则未必覆盖全部资源;应结合连接记录定位具体请求,而不是不断扩大关键词范围。
Subscribe 与 Add Server:管理连接信息
是什么:服务器条目保存一次连接所需的地址、端口、协议与认证参数;Subscribe 用来维护一组可更新的服务器信息。订阅更新与 Config 更新属于不同操作:服务器列表刷新后,不代表规则文件也随之改变,导入配置也不代表已经选中了正确的服务器。
在哪里、怎么设:在 Home 使用 Add Server 手动录入已有服务器信息;录入时按实际协议核对字段,不要把其他协议的参数直接套入。通过 Subscribe 添加用户已有的订阅时,完整粘贴链接并保存,再检查条目是否归入预期分组。已有二维码或分享信息时,可使用 Scan QR Code 或相应导入入口,导入后仍要核对服务器类型与连接参数。
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 以及 HTTP、SOCKS5 等协议的字段并不相同。填写 TLS、传输方式或其他附加参数时,应以已有服务器的实际要求为准;仅修改显示名称不会改变连接目标。对不熟悉的字段,先保留原始信息,再逐项确认,避免凭名称猜测用途。
注意什么:更新订阅前记录当前选中的条目,更新后确认其是否仍然存在。多个订阅出现相同名称时,先按分组识别来源,再决定保留或删除,不能仅凭名称认定完全重复。Connectivity Test 适合初步筛选,但测试通过不代表所有目标均可访问。删除分组前先备份,配置与分享链接中的认证信息也不应公开展示。
本站不提供、不销售、不推荐节点或订阅。客户端一次性买断 ≠ 线路套餐,客户端获取与已有服务器的使用条件应分开理解。完整的导入、更新与整理方法见订阅与服务器管理手册。
On Demand:按条件触发连接
是什么:On Demand 用来根据网络等条件触发连接行为。它解决的是“何时连接”,而不是“某个请求走哪条策略”。触发连接后,请求仍由当时的 Global Routing 与配置决定去向,所以 On Demand 不能代替规则分流。
在哪里、怎么设:在 Settings 中找到 On Demand 相关设置。先明确希望发生的行为,例如在特定 Wi-Fi SSID 下采用不同连接状态,或在 Cellular 条件下启用连接,再按当前界面提供的条件建立规则。涉及 Domain 条件时,逐项阅读界面对域名触发的说明,不要将它当成 Config 中的 DOMAIN-SUFFIX 规则。
- 先手动连接,确认已有服务器与 Config 能正常工作。
- 一次只增加一个触发条件,记录对应的网络环境与预期动作。
- 切换到该条件,等待系统处理后检查连接状态,并实际发起一次请求。
- 确认行为符合预期后,再补充其他条件并检查是否重叠。
注意什么:系统调度、网络切换与已有连接都可能影响观察时机。手动断开后再次连接,不一定是开关失效,也可能是 On Demand 条件再次满足。排查这类问题时,先暂时停用 On Demand,再测试手动连接;确认基础连接正常后,逐条恢复条件。需要了解条件组合时,可阅读On Demand 设置说明。
Data:查看流量与连接记录
是什么:Data 用于查看客户端记录的流量信息,帮助理解上传、下载与连接活动。它反映客户端可观察到的使用情况,不应直接视为移动运营商账单,也不等同于已有服务器服务中的计费记录。
在哪里、怎么设:打开 Data,先查看当前界面提供的统计范围、时间范围与分类方式,再记录数值。需要观察某个操作产生的流量时,先记下操作前的统计状态,暂停不相关的后台下载,再执行一次目标操作并对照变化。若界面提供重置统计的操作,应在保存需要的数据后再使用。
注意什么:上传与下载方向、统计起点以及连接是否经过客户端,都会影响数值解释。切换网络或更换服务器前后,不宜直接把两个不同范围的累计值相减。规则命中情况需要结合实际连接记录核对,不能仅凭总流量增加就认定某个域名经过 PROXY。
向他人描述问题时,保留时间、网络类型、目标域名与所选策略等必要信息即可。日志或连接详情可能包含服务器地址、请求路径与认证信息,分享前先检查并遮去敏感内容。
Settings:常用设置的调整边界
Settings 中的项目涉及解析、测试、快捷入口、同步和诊断,影响范围各不相同。部分设置也可能由当前 Config 定义;判断实际行为时,应同时检查配置文件与应用设置,不要只看某一个页面。下面按常见任务说明调整方法,具体可用入口以当前应用显示为准。
DNS:确认域名怎样解析
是什么、在哪里:DNS 负责将域名解析为地址。可在 Settings 中检查 DNS 相关选项,并在 Config 中核对是否存在 dns-server 等配置。不同解析结果可能让同一域名连接到不同目标地址,进而影响基于 IP 的规则判断。
怎么设、注意什么:先保留当前设置并记录故障域名,确认是解析失败还是连接失败,再考虑调整解析方式。一次只修改一处,重新发起请求后对比。不要因为某个地址看起来常见就直接替换,也不要把所有访问失败都归因于 DNS;目标服务器不可用、规则拒绝或本机网络异常也会出现相似现象。
Test Method:保持测试条件一致
是什么、在哪里:Test Method 决定连接测试采用的方法,可在 Settings 中查看。它影响 Connectivity Test 的测试过程与结果含义,不会自动替用户修正服务器参数,也不是对实际业务速度的承诺。
怎么设、注意什么:整理服务器列表时,先选定一种适合当前检查目的的方法,再在相同网络条件下测试。更换 Test Method 后,原先的结果不宜直接与新结果混排比较。出现测试失败时,还应使用实际目标进行验证,区分测试目标不可达与服务器本身连接失败。
Today Widget:提供快捷操作入口
是什么、在哪里:Today Widget 是与系统小组件相关的快捷入口设置,可在 Settings 查找对应项目,再到系统支持的小组件区域进行添加。是否显示以及能够执行哪些操作,取决于当前系统与应用提供的能力。
怎么设、注意什么:先在应用内确认手动连接正常,再设置需要展示的快捷内容。使用后回到 Home 核对实际连接状态,不要把组件里的缓存显示当作最终结果。找不到入口时,先确认当前系统的小组件管理方式,不必为此删除已有配置。
iCloud 同步:区分同步与独立备份
是什么、在哪里:iCloud 同步用于在支持该功能的设备间同步应用所支持的数据,可在 Settings 的相关入口与系统 iCloud 设置中检查。它依赖当前账号、网络与系统状态,不等同于保留每个历史时刻的配置副本。
怎么设、注意什么:先在原设备确认需要的数据仍然完整,再启用相应同步设置;到另一台设备检查具体条目与 Config,而不是只看同步开关。大批删除或整理前仍应独立导出备份,避免删除操作随后同步到其他设备。恢复不完整时,先检查账号与同步范围,再考虑重复导入,减少重复条目。
Diagnostics:围绕可复现问题收集线索
是什么、在哪里:Diagnostics 提供诊断相关工具,用于协助定位网络与连接问题,可在 Settings 中查找。诊断结果需要结合当时网络、Global Routing、服务器与目标一起解读,单个结果通常不足以说明全部原因。
怎么设、注意什么:先记录复现步骤,再运行与问题相关的检查;每次只变更一个条件,并保留变更前后的结果。提交问题描述前,移除订阅链接、密码和其他认证信息。不要为生成更长的日志而随意开启不理解的设置,也不要将诊断输出中的目标地址误当成可用服务器信息。
设置检查顺序:从手动连接到自动触发
遇到“能够连接但某个页面打不开”或“断开后又自动连接”时,先按层次检查,通常比同时更换服务器、DNS 和规则更容易找到原因。建议保留一份能够复现问题的配置副本,让后续每次修改都有可对照的起点。
- 确认基础网络:检查当前 Wi-Fi 或 Cellular 是否具备正常网络连接,记录故障发生的网络环境。
- 确认服务器:核对 Home 中实际选中的条目、协议与参数,避免把显示名称相似的条目混淆。
- 确认姿态:检查 Global Routing。需要规则分流时使用 Config,并确认启用的是预期配置。
- 确认请求去向:结合连接记录检查目标域名、匹配条件与策略,随后再查看 DNS 和规则顺序。
- 确认自动条件:手动连接稳定后再恢复 On Demand,并逐项检查触发条件。
首次使用可按上手教程完成导入、选择姿态与连接验证;需要处理订阅更新、重复条目或备份时,转到节点管理。本页用于理解各项功能的作用,具体问题也可按常见问题逐项核对。