Shadowrocket 官方手册 / 功能与设置

Shadowrocket 常用设置

先确认分流姿态,再检查配置、服务器与连接状态。

本页按功能解释“是什么、在哪里、怎么设、注意什么”。界面位置以 iPhone / iPad 常见布局为参照;Mac、Windows、安卓、Linux 同属 Shadowrocket,菜单排列及可用的系统集成项目可能随平台不同,应以当前设备实际显示为准。

连接方式

Global Routing 三种姿态

是什么:Global Routing 决定连接采用哪一类转发逻辑。配置、代理、直连分别对应界面中的 Config、Proxy、Direct。它不是协议选择器,也不负责把订阅中的服务器自动改成可用状态。更换姿态前,应先确认当前选中的服务器与配置文件。

在哪里、怎么设:在 Home 打开 Global Routing,选择需要的项目后返回。日常使用已有分流规则时选 Config;需要判断问题是否来自规则时,可暂时用 Proxy 做对照;检查本地网络本身能否访问目标时,可用 Direct 对照。对照完成后恢复原来的姿态,避免把临时测试状态留作日常设置。

界面项目处理方式适用时机检查重点
Config · 配置按当前启用配置中的规则与策略处理请求。需要区分不同域名或地址的访问路径。配置是否启用、规则顺序和策略引用是否正确。
Proxy · 代理对进入客户端处理范围的流量采用代理路径。临时排除分流规则造成的差异。当前服务器是否可达、协议参数是否一致。
Direct · 直连采用直接连接路径,不经所选代理服务器转发。对照基础网络、检查本地资源访问。本地网络和目标服务本身是否正常。

注意什么:Proxy 不代表目标一定能访问,Direct 也不等同于关闭系统连接开关。连接是否建立、请求是否进入客户端、最终走哪条策略,是三个不同问题。系统排除项或应用自身的特殊连接方式,也可能影响实际处理范围,应结合请求记录判断。

匹配与处理

规则类型与策略

是什么:规则负责识别目标,策略负责决定处理方式。例如 DOMAIN-SUFFIX 描述域名后缀条件,PROXY 描述交给代理路径处理。不要把 Proxy 姿态与规则中的 PROXY 策略混为一谈:前者选择整体工作方式,后者是配置中某条规则的动作。

在哪里、怎么设:在 Config 中找到当前启用的配置,进入该文件的编辑或规则列表。先备份,再把范围较小、例外性较强的规则放到前面,范围较宽的规则放在后面,最后用 FINAL 处理此前未命中的请求。以下仅用示例域名说明语法,不是线路信息。

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

在此顺序下,api.example.com 先命中第一条,不再按后面的后缀规则处理;其他匹配 example.com 后缀的域名走第二条。这说明仅仅“写了某条规则”并不代表请求一定会到达它。

关键字匹配对象使用注意
DOMAIN完整域名。用于指定主机的精确例外。
DOMAIN-SUFFIX域名后缀及其子域名。范围比完整域名更宽,检查是否覆盖前面的需求。
DOMAIN-KEYWORD域名中包含的关键词。可能匹配到不相关域名,设置前应缩小条件。
IP-CIDR / IP-CIDR6IPv4 / IPv6 地址范围。留意地址族、掩码以及域名解析对匹配的影响。
GEOIP地址数据库中的区域归属。数据库归属不等于服务运营者所在地。
USER-AGENT可供规则识别的 User-Agent 内容。只有能够取得相关字段时才有匹配依据。
FINAL此前未命中的请求。放在规则末尾作为兜底。

注意什么:PROXY 使用代理路径,DIRECT 使用直接连接,REJECT 拒绝匹配请求。拒绝规则可能同时影响页面依赖的资源;出现页面内容缺失时,应检查命中记录,而不是立即更换服务器。引用自定义策略时,名称还必须与配置中实际定义的名称一致。更完整的顺序说明见自定义规则与 FINAL 说明。

服务器类型

多协议与参数对应

是什么:协议决定客户端与服务器如何建立通信。Shadowrocket 中的 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 对应不同的服务端配置,不能仅凭名称判断某一种在所有网络中都更快或更省电。

在哪里、怎么设:在 Home 进入 Add Server,按已有服务器信息选择类型;编辑已有条目时,先核对类型,再逐项核对地址、端口、认证字段,以及服务信息要求的传输与 TLS 选项。订阅导入通常会带入这些字段,但仍应确认客户端识别的类型与原始信息一致。不同类型出现不同字段是正常现象,不要把一种协议的参数机械填入另一种。

注意什么:端口相同不代表协议相同,启用 TLS 也不代表所有证书与主机名要求已经满足。不要为了让测试通过而随意放宽证书检查;应先核对服务器名、系统时间和服务端提供的参数。具体字段含义与设计取舍见协议参考。涉及认证信息的截图或日志,在分享前应先去除敏感内容。

服务信息管理

Subscribe 与服务器列表

是什么:Subscribe 用于读取用户已有订阅中的服务器信息;Add Server 用于单独填写服务器。服务器列表解决“使用哪个连接对象”,不自动等同于一份完整的规则配置。订阅刷新成功,也只说明本次获取与解析完成,并不能保证列表里每个条目都能建立连接。

在哪里、怎么设:在 Config 中进入 Subscribe 相关入口,填入从自己的服务商处取得的订阅地址,确认名称后执行更新,再回到 Home 检查列表。手动添加则使用 Add Server;已有二维码时使用 Scan QR Code。剪贴板导入前先确认内容来自自己的服务信息,保存后核对条目类型和数量是否符合预期。

管理已有列表时,建议用能辨认用途的名称区分手动条目和订阅分组。先测试新条目,再决定是否删除旧条目。对于订阅生成的服务器,直接修改其参数可能在下次更新时被覆盖;确需保留个别调整时,应先了解该条目的来源与更新行为,避免把临时改动误认为永久保存。

注意什么:订阅地址往往带有认证参数,应当作私密信息保存,不要贴到公开问答或日志中。更新失败时,依次检查当前网络、地址是否完整、服务是否仍有效和返回内容格式,不要反复删除全部列表。相关入口的操作顺序见订阅导入方法。

配置文件

Config 保存与启用

是什么:Config 管理配置文件,文件可以包含规则、DNS 行为、本地映射等项目。保存文件、选中启用文件和切换到 Config 分流姿态是相互关联但并不相同的操作。排查“改了设置没有效果”时,应分别检查这三处。

在哪里、怎么设:进入 Config,先确认当前启用标记对应哪个文件,再编辑它。修改前保留副本,一次只调整一种行为,例如先修改某条域名规则,保存并确认启用后再测试同一个目标。需要导入配置时,先分清导入内容是服务器订阅还是配置文件,不要仅凭链接外观判断用途。

注意什么:远程配置可能随更新替换本地内容,长期自定义前应确认覆盖范围。配置中的 General、Rule、Host、URL Rewrite 各有职责,规则文件并非只包含服务器地址。不要把来源不明的整份配置直接覆盖当前文件,尤其应阅读影响 DNS、映射与地址改写的部分。可参阅配置文件各段作用。

自动连接条件

On Demand 按需连接

是什么:On Demand 按系统支持的网络条件触发连接行为,用于减少在不同网络间切换时重复操作开关。它处理的是“何时尝试连接”,并不替代 Global Routing 对“连接后如何分流”的选择,也不负责判断所有远端服务是否健康。

在哪里、怎么设:在应用的 Settings 中查找 On Demand,以当前平台实际列出的条件为准,逐项配置 Wi-Fi、蜂窝网络或指定网络相关行为。先在手动连接正常的前提下启用,并分别测试进入目标网络、离开目标网络和锁屏后重新使用这几种场景。需要系统确认连接配置时,应阅读提示后完成确认。

注意什么:不要同时修改多条条件后只测试一次。出现关闭连接后再次连接的现象,先检查 On Demand 是否仍在触发,再检查其他系统自动化设置。不同系统的后台调度、网络权限与省电策略不同,不能把某台设备的触发时机直接当作所有平台的固定行为。

流量记录

Data 统计与观察范围

是什么:Data 用于观察客户端记录的流量情况,帮助判断一次操作是否产生传输,以及连接前后是否有明显变化。它反映的是客户端统计口径,不是线路服务账户的结算记录,也不能直接代替系统的蜂窝网络用量。

在哪里、怎么设:打开 Data,先阅读当前显示的统计范围和分类,再观察上传与下载变化。为了排查单次操作,可以先记下原有读数,关闭不必要的后台传输,再只打开一个测试目标,对照操作前后的变化。若界面提供重置统计的操作,先保存需要的记录,再重置,不要把清零当作修复连接的方法。

注意什么:协议开销、统计起点、后台活动以及处理范围都会造成客户端与系统记录不同。连接开关显示已启用但暂时没有数据增长,可能只是没有请求进入处理范围;有数据增长也不意味着所有页面资源都加载成功。应结合目标访问结果和请求记录一起判断。

常用选项

Settings 常用项目

Settings 汇集应用行为与部分系统集成选项。下列项目以实际界面存在为前提;如果当前平台未显示某项,不要照着其他设备的截图寻找同一位置。修改前记录原值,出现变化后才有可靠的回退依据。

DNS:解析与连接分开检查

是什么、在哪里:DNS 把域名解析成地址,相关选项可在 Settings 的 DNS 项目以及配置文件的相关设置中检查。解析成功并不保证目标端口可达,服务器可达也不保证所有域名解析正常。

怎么设、注意什么:先确认当前启用配置是否规定了 DNS 行为,再查看全局选项,避免同时更改两处后无法判断生效来源。使用已有网络或服务配置要求的解析方式,修改后重新发起目标请求。仅部分域名失败时,先区分解析错误、规则命中错误和连接错误,不要直接把所有故障归因于 DNS。IPv6 相关选项还应与本地网络实际能力配合检查。

Test Method:选择测试依据

是什么、在哪里:Test Method 是 Settings 中与连通性测试相关的选项,用来决定测试采用的方式。不同方式观察的链路环节不同,显示的结果不宜混合比较。

怎么设、注意什么:按当前界面支持的项目选定一种方式,再回到列表执行 Connectivity Test。比较多个服务器时保持测试方式、网络和测试目标一致。测试结果是当时条件下的一次观察,不是持续带宽保证;测试成功后仍应访问实际需要的目标。

Today Widget:系统快捷入口

是什么、在哪里:Today Widget 是与系统组件相关的快捷操作设置,在提供该项目的设备上可从 Settings 检查。它的作用是提供入口,不负责重新生成服务器或规则。

怎么设、注意什么:先在应用内完成正常连接,再按系统提供的组件管理方式添加可用组件。操作后若状态显示不同步,先打开应用核对实际连接,而不是连续反复点击。系统组件支持范围和刷新时机可能不同,以当前系统显示为准。

iCloud:同步范围与本地副本

是什么、在哪里:在提供 iCloud 选项的 Apple 设备上,可于 Settings 中检查同步设置,同时确认系统已允许应用使用 iCloud。此项依赖系统账户与权限,不是所有平台通用的同步渠道。

怎么设、注意什么:启用前先保留本地配置副本,再确认界面说明的同步范围。不要假定服务器、配置、系统连接权限和即时连接状态都会一起迁移。换机后分别核对列表、启用配置与连接授权;两台设备同时编辑前,应先确认同步已经完成,避免用旧副本覆盖新内容。

故障定位

Diagnostics 与排查顺序

是什么、在哪里:Diagnostics 用于辅助观察网络与连接问题,可在 Settings 中查找当前平台提供的诊断入口;服务器列表中的 Connectivity Test 用于进行连通性测试。诊断记录是定位依据,不会自动修正错误的协议参数或失效的服务信息。

怎么设:不必先改大量设置。固定一个服务器和一个测试目标,按下面的顺序操作,每完成一步记下结果,再决定是否进入下一步。这样可以避免把同时发生的多个变化误认为同一个原因。

  1. 确认基础网络。检查设备当前网络是否需要先完成认证,系统时间是否准确;必要时在另一种已有网络下对照。
  2. 测试服务器。保持 Test Method 一致,执行 Connectivity Test。若全部失败,先检查网络与订阅有效性;若仅个别失败,优先核对对应条目。
  3. 核对协议字段。逐项检查地址、端口、认证信息、传输与 TLS 参数,避免只看服务器名称。
  4. 区分分流影响。记录当前姿态,在 Config 与 Proxy 之间做短时对照,再恢复原设置;结果不同就继续检查规则和策略引用。
  5. 查看具体请求。检查诊断或请求记录中可用的目标、解析、策略和错误信息。只有部分页面资源失败时,应单独分析对应域名。
  6. 回退最近改动。恢复最近修改的 DNS、规则或配置副本,再测试同一目标,不要用清空全部设置代替定位。

注意什么:日志可能包含服务器地址、访问目标和认证相关内容,对外分享前应逐项去除敏感信息。某次延迟较低只说明该测试条件下的结果,不等于实际下载速度或所有应用体验。详细连接失败检查可继续阅读节点超时排查顺序。