官方手册 · 功能与设置

Shadowrocket 设置详解

先在 Home 确认服务器,再在 Global Routing 选择 Config;连接可用后,再调整 DNS 与 On Demand。本页按“是什么、在哪里、怎么设、注意什么”说明常用功能,便于逐项检查,而不是一次改动全部选项。

日常分流:Config 服务器入口:Home 排查顺序:服务器 → 规则 → DNS

Global Routing 三种姿态

Global Routing 决定流量选择策略的总体方式,不负责补齐服务器参数。在 Home 打开 Global Routing,可以看到 Config、Proxy 与 Direct。中文说明分别称为配置、代理与直连,实际操作时仍按英文界面词选择。初次使用先选定用户已有且参数完整的服务器,再决定运行姿态;切换姿态不能修复错误密码、失效订阅或不可达的服务器。

日常使用通常选择 Config,让当前配置文件里的规则决定去路。遇到“部分网站可用、部分不可用”时,可以临时用 Proxy 与 Direct 做对照:Proxy 可帮助判断选中服务器能否承载请求,Direct 可帮助判断当前网络直接访问目标的情况。每次只切换一项并重新发起请求,测试结束后恢复 Config。

界面选项流量处理方式何时使用注意事项
Config(配置)按当前 Config 中的规则选择 PROXY、DIRECT 或其他已定义策略。日常按域名、地址或地区进行规则分流。先确认实际启用的配置文件及其规则顺序。
Proxy(代理)让接管的流量使用代理路径。临时对照服务器连通性,区分规则问题与服务器问题。仍依赖所选服务器;系统或应用未交给客户端的流量不在此判断范围内。
Direct(直连)让接管的流量使用直接连接路径。对照当前网络是否能够直接访问目标。Direct 不等于关闭客户端连接开关,也不等于停止 On Demand。

阅读 Global Routing 三种姿态的使用说明 →

规则分流:匹配条件与执行策略

规则类型回答“匹配什么”

在 Config 中打开当前配置文件,检查规则条目。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀及其子域名,DOMAIN-KEYWORD 匹配域名中的关键词。IP-CIDR 与 IP-CIDR6 按地址网段匹配,GEOIP 根据地址所属地区匹配。

优先使用范围明确的条件。DOMAIN-KEYWORD 可能匹配到预期之外的域名;USER-AGENT 依赖能够获取相应请求信息,不应将它当成适用于全部加密流量的通用识别条件。

策略回答“匹配后怎么走”

PROXY 表示使用代理路径,DIRECT 表示直接连接,REJECT 表示拒绝相应请求。配置还可能引用自定义策略名称;这些名称必须在配置中有对应定义,不能只改一条规则的末尾文字。

规则一般按顺序匹配,具体条件应排在宽泛条件之前,FINAL 用于前面规则都没有命中时的最终处理。排查时先查命中的条目,不要只看文件中是否存在某个关键词。

在 Config 中修改与验证

先保留当前配置副本,再修改单条规则并保存;回到 Config 确认启用的是刚刚编辑的文件,随后在 Global Routing 选择 Config。以下片段只展示规则语法,example.com 是教学示例域名,并非可直接覆盖所有访问需求的完整配置。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

第一条把示例域名及其子域名交给 PROXY,第二条让匹配相应地区地址的请求走 DIRECT,最后一条处理其余请求。域名规则和地址规则的判断依据不同,DNS 返回的地址也可能影响后续地址规则的结果。因此,“同一网站换网络后命中不同规则”不一定是规则没有保存,应结合解析结果与连接记录检查。

ConfigGlobal RoutingPROXYDIRECT

Subscribe 与 Add Server

管理对象分为服务器、订阅与配置文件:服务器保存连接参数,订阅保存服务器列表的更新地址,Config 保存分流规则。三者用途不同,不应把订阅地址当作服务器域名填写。

Subscribe:导入已有订阅

在 Home 使用添加入口,选择 Subscribe 对应类型,填入用户已有的订阅地址与便于辨认的名称,保存后执行更新。导入完成后返回 Home,检查服务器列表是否出现,再选择其中一个进行 Connectivity Test。

订阅更新用于刷新远端列表,不等于自动修复连接。更新失败时先检查地址是否完整、是否仍然有效,以及当前网络能否访问订阅地址。不要反复删除重建,否则容易丢失原有分组与备注。

Add Server:填写单个服务器

打开 Add Server,先选择与已有信息一致的协议,再填写地址、端口和认证字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等协议的字段并不相同;只有用户提供的参数中明确包含某项时,才按对应要求填写。

TLS、传输方式与服务器名称等字段需要彼此对应。不要因某个选项看起来更常见就自行替换。支持的类型以当前客户端的类型列表为准,完成后先保存,再回到 Home 选择该条目。

单条分享链接可通过剪贴板导入或 Scan QR Code 处理,但应先确认内容是服务器分享信息还是订阅更新地址。不要把账号页面的网址、带登录状态的网页地址或不完整的二维码文本直接当作 Subscribe 内容。

查看订阅更新、多订阅整理、排序与备份手册 →

多协议与服务器选择

协议描述客户端与服务器如何通信,不代表连接一定更快。HTTP、SOCKS5 与其他协议也应按已有服务器信息选择;协议不匹配时,即使地址和端口能连通,也可能无法完成认证或传输。整理列表时,可用用途、协议或分组备注区分服务器,避免把测试结果相近误认为参数相同。

Connectivity Test 测试的是当前测试方法下的响应结果。一次超时不能单独证明服务器失效,一次成功也不能证明所有目标都可访问。先对同一个服务器重复测试,再实际打开目标页面,最后结合规则和 DNS 判断问题所在。

On Demand 按需连接

On Demand 用于按系统网络条件触发连接,不是服务器可用性的检测开关。在客户端显示的 On Demand 入口查看条件与总开关;具体位置及支持条件以当前平台界面为准。设置前应先用手动连接确认服务器、Config 和 DNS 都能正常工作,再启用按需连接,避免把基础连接故障与自动触发行为混在一起。

  1. 记录当前手动连接状态与所选服务器,确认一次实际访问成功。
  2. 进入 On Demand,检查已有条件。若界面提供网络类型或 Wi-Fi 条件,按实际需求逐条设置,不同时新增多组相互重叠的条件。
  3. 启用后切换到需要验证的网络,观察系统连接状态,并重新打开目标应用进行访问。
  4. 需要保持断开时,先停用 On Demand,再断开当前连接;只关闭 Home 的连接开关,可能随后再次被条件触发。

如果出现“刚关闭又连接”,应先检查 On Demand,而不是重复删除系统连接配置。若网络切换后没有触发,则确认条件是否匹配、系统是否允许建立连接,以及客户端中保存的服务器是否仍然可用。不同系统对后台行为的管理不同,不应把手动打开应用后的结果等同于后台触发结果。

Data 流量统计与连接观察

Data 用来观察客户端记录的流量,帮助判断请求是否经过当前连接,以及操作前后是否产生数据。在 Data 或当前平台对应的统计入口查看上传、下载与连接记录;具体分类和统计范围以界面标注为准。排查时先记下当前数值,再只执行一次目标操作,随后返回查看变化,比同时打开多个应用更容易判断。

Data 的统计不等于服务商的计费记录,也不等于系统全部网络用量。后台应用、重试请求、连接开销及不同的计量范围,都可能造成数值差异。若用户需要核对远端用量,应使用自己已有服务的用量记录,不能只根据客户端累计数值推算。

需要重置统计时,先确认界面显示的是哪个统计周期,并保存排查所需的记录;若当前界面提供重置操作,再按提示执行。重置只适合重新观察本地变化,不会重置远端用量。分享 Data 或连接记录前,应遮盖服务器地址、订阅地址、认证字段以及可能暴露个人访问内容的信息。

Settings 常用项

Settings 包含运行偏好与系统集成选项。先保留可用状态,再一次调整一项;修改后用相同服务器、相同目标和相同网络复测。部分 DNS 或连接参数也可能由当前 Config 控制,应先确认实际生效来源,而不是同时修改配置文件与 Settings。

DNS:域名解析

是什么:DNS 把域名转换成连接所需的地址;解析失败时,服务器本身可连接,目标网站仍可能打不开。

在哪里、怎么设:在 Settings 的 DNS 相关入口及当前 Config 中检查已有配置。先确认是否存在手动指定的解析服务器、是否能从当前网络访问,再按现有配置的要求调整。不要同时填入多组来源不明且用途不同的地址。

注意什么:DNS 设置不是通用加速开关。修改后重新发起请求,必要时重建连接以排除旧缓存影响。只有部分域名异常时,应同时检查规则命中、解析地址与目标服务状态。

Test Method:测试方法

是什么:Test Method 决定 Connectivity Test 使用的检测方式,不直接代表实际浏览体验。

在哪里、怎么设:进入 Settings,找到 Test Method,在当前客户端提供的选项中选择测试方式;若界面允许设置测试目标,使用自己能够确认可访问且适合检测的目标。回到 Home,对同一批服务器重新测试。

注意什么:不同测试方式检测的层次不同。仅能建立底层连接,不代表认证、DNS 与目标页面访问全部成功。比较服务器前应统一方法与网络条件,不混用不同时间、不同目标的结果。

Today Widget:快捷操作

是什么:Today Widget 提供系统支持范围内的快捷查看或操作入口,便于减少进入客户端的步骤。

在哪里、怎么设:若当前 iPhone / iPad 版本提供 Today Widget,在 Settings 检查相关选项,再到系统组件编辑入口添加客户端实际提供的组件。可执行的动作以组件显示内容为准。

注意什么:组件的显示内容可能需要刷新。没有看到预期入口时,先确认当前系统和客户端是否仍提供该组件类型,不照搬其他版本的位置。快捷操作也不能绕过系统连接授权。

iCloud 同步:跨设备配置

是什么:iCloud 同步用于在支持此功能的设备间同步客户端所列出的数据,不等同于完整系统备份。

在哪里、怎么设:先确认系统已登录自己的 iCloud 账号并允许相关访问,再在 Settings 检查 iCloud 同步选项。启用前保留本地配置副本,逐项核对当前界面注明的同步范围。

注意什么:不要同时在两台设备编辑同一份内容。先在一台保存并等待同步,再到另一台确认;订阅认证信息属于敏感数据,备份与同步前应了解其保存位置和账号访问权限。

Diagnostics 与故障定位顺序

Diagnostics 用于收集连接与运行线索。在 Settings 中查找 Diagnostics 或当前版本对应的诊断入口,先记录问题发生的网络、所选服务器、Global Routing 姿态和目标操作,再按界面提供的工具检查。诊断结果应与实际请求对应起来;一份没有发生时间和操作上下文的记录,很难说明是哪一层出了问题。

  1. 先查服务器:在 Home 确认选中条目,核对地址、端口、协议及认证字段,再执行 Connectivity Test。订阅导入成功只说明列表获取成功,不代表每个服务器都可连接。
  2. 再查姿态:用 Proxy 与 Config 对照同一个目标。Proxy 可用而 Config 不可用时,优先检查规则命中与自定义策略引用;两者都不可用时,再查服务器与解析。
  3. 单独查 DNS:确认失败是否集中在特定域名,观察解析错误。不要同时更换服务器、DNS 和规则,否则无法判断是哪次修改起作用。
  4. 最后查系统条件:检查连接授权、On Demand 条件及网络切换行为。必要时停用自动触发,先恢复手动连接的可重复结果。

在 Diagnostics 中导出或复制信息前,先检查是否包含订阅凭据、服务器认证信息和个人访问记录。排查所需的通常是错误类型、操作顺序与相关设置,而不是完整的敏感链接。问题消失后,恢复为日常使用的 Config,并把临时测试改动逐项还原。

连接开关已经打开,为什么页面仍然打不开?

开关打开表示客户端尝试建立或维持连接,不等于目标请求必然成功。先核对服务器与 Connectivity Test,再用同一目标对照 Proxy 和 Config,最后检查 DNS。若只有一个应用异常,还应重新启动该应用的连接并检查其自身网络状态。

修改了规则,为什么 Data 中看起来还是旧路径?

先确认 Global Routing 为 Config,且刚编辑的配置已被选中。已有连接可能沿用先前路径;重新发起请求后,再查看对应的新连接记录。不要用累计流量的变化直接推断某一条新规则是否命中。

获取客户端后,是否会自动出现可用服务器?

需要导入用户已有的订阅或服务器信息。客户端一次性买断 ≠ 线路套餐。iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;客户端获取与用户已有服务的连接资料分别管理。

按首次连接顺序查看使用教程 →