官方手册 · 功能参考 Home → Config → Settings

Shadowrocket 功能与常用设置

先确定 Global Routing,再检查 Config 与服务器。按功能查找界面位置、设置顺序和适用条件,避免一次修改多个选项后无法定位原因。

Shadowrocket 适用于 iPhone / iPad / Mac / Windows / 安卓 / Linux。以下操作路径以 iPhone / iPad 为参照,其他平台的菜单位置与系统能力可能不同,请以当前应用实际显示的选项为准。

iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。

01 / ROUTING

先确定流量处理方式

Global Routing:配置、代理与直连

在 Home 打开 Global Routing。Config、Proxy、Direct 是三种常用姿态,决定是否依据规则处理连接。

是什么:Global Routing 是流量处理的总入口,不是服务器列表,也不是协议类型。选择 Config 时,客户端按当前配置文件中的规则决定策略;选择 Proxy 时,接入客户端的连接以代理方式处理;选择 Direct 时,以直连方式处理。系统自身限制及未接入客户端的流量不应仅凭此选项推断走向。

怎么设:首次使用先在 Home 选中已有且可用的服务器,再进入 Config 确认当前配置文件,最后回到 Global Routing 选择 Config。需要判断故障是否来自规则时,可以临时改成 Proxy,对同一目标重复测试;测试完恢复原来的设置。要比较当前本地网络的访问情况,可以暂时切换 Direct。

姿态与界面词处理方式适用情形需要核对
配置 · Config依据当前配置文件逐条匹配规则。日常按域名、地址范围等条件分流。启用的配置文件、规则顺序和最终策略。
代理 · Proxy以代理方式处理接入客户端的连接。临时判断代理服务器与目标是否可达。当前选中的服务器及其连接参数。
直连 · Direct以直连方式处理接入客户端的连接。比较本地网络访问,或排查代理相关影响。本地网络、DNS 与目标服务本身。

注意什么:Proxy 不能修复失效的服务器,Direct 也不等于关闭系统 VPN 配置。若要完全停止客户端接管连接,应操作 Home 的连接开关。部分界面还会显示 Scene,这不改变本节三种基本姿态的判断方法;不需要场景切换时,先使用明确的 Config、Proxy 或 Direct 排查。

02 / RULES

条件决定命中,策略决定去向

规则分流:类型、策略与顺序

在 Config 查看当前配置文件。Global Routing 采用 Config 时,才应结合这份文件理解分流结果。

是什么:一条规则由匹配条件和处理策略构成。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀,DOMAIN-KEYWORD 匹配域名中的关键词;IP-CIDR 与 IP-CIDR6 分别描述 IPv4、IPv6 地址范围,GEOIP 按地址归属信息匹配。USER-AGENT 涉及请求特征,是否能取得所需信息取决于具体连接,不能把它当作所有流量通用的应用识别条件。

在哪与怎么设:从 Config 进入当前配置文件,检查 [Rule] 段。按从具体到宽泛的顺序排列规则,将精确域名或局域网范围放在合适位置,再由 FINAL 为未命中前面条件的连接指定策略。修改前先保留一份原配置,每次只改一个条件,保存后确认实际启用的仍是这份文件。

[Rule] 结构示意

示意 · 不代表当前配置
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT

example.com 为教学域名。正式规则应依据自己的访问需求与现有配置编写。

策略怎么理解:PROXY 表示使用代理策略,DIRECT 表示直连,REJECT 表示拒绝连接;如果文件引用了自定义策略名,还需确认它指向的服务器或分组存在。规则通常按顺序匹配,前面较宽泛的条件可能使后面的精确条件没有机会命中。

注意什么:不要只看配置文件里出现了某个域名,就断定它已经生效。还要检查 Global Routing、当前启用文件,以及连接记录中的实际目标。有些请求直接使用 IP 地址,或后续访问了其他域名,此时应根据记录补充判断,而不是反复扩大关键词范围。文件各段作用可继续查阅.conf 结构说明。

03 / SERVERS

把导入、更新与选择分开处理

订阅与服务器管理

Home 用于查看和选择服务器,Add Server 用于添加信息,Subscribe 用于订阅相关管理。

是什么:单个服务器保存一组连接参数,订阅则用于取得并更新一组服务器条目。订阅更新与 Config 文件更新不是同一件事:前者可能改变服务器列表,后者改变规则及其他配置内容。导入服务器后,仍需要选择正确的 Global Routing 和配置文件。

怎么设:已有订阅链接时,在 Home 的 Add Server 中选择 Subscribe,填写地址与便于辨认的备注,保存后执行更新并确认列表生成。已有单个服务器信息时,按照实际协议填写地址、端口及认证字段。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段不同,不应只改协议名称而保留不相符的参数。

Scan QR Code 与剪贴板导入适合已有分享内容的情况。导入后先检查协议、地址及必要参数,再运行 Connectivity Test。测试结果可以帮助筛查,但不能替代实际访问验证;列表排序也不会自动保证当前选中的条目可用。多个订阅应分别命名,更新后确认原来选中的服务器是否仍存在。

注意什么:订阅链接可能包含访问凭据,排查时不要公开完整地址或二维码。编辑订阅生成的条目前先了解下一次更新是否会覆盖手动改动。删除订阅前保留必要信息,删除列表与停止连接是不同操作。导入、更新、排序、删除与备份的完整步骤见订阅与服务器管理手册。

04 / ON DEMAND

先手动连通,再设置触发条件

On Demand:按条件连接

在 Settings 查找 On Demand,并以当前界面提供的 Wi-Fi、Cellular 等条件为准。

是什么:On Demand 通过系统允许的条件触发连接,适合需要在特定网络环境下自动接入的场景。它决定连接何时建立,不负责选择域名应该直连还是代理;后者仍由 Global Routing 与规则决定。

怎么设:先关闭按需条件,手动完成一次连接与实际访问,确认服务器、Config 和 DNS 都能正常工作。然后进入 On Demand,按需求设置 Wi-Fi 或 Cellular 条件;若界面提供 Wi-Fi 名称条件,应逐项核对网络名称,避免相似名称导致判断错误。保存后分别在目标网络和非目标网络观察连接状态,再验证锁屏、解锁与网络切换后的表现。

注意什么:系统触发连接存在条件,不应把按需连接理解为所有应用始终保持同一条会话。手动断开后又连接,先检查 On Demand 是否仍启用,而不是重复删除 VPN 配置。需要排查时暂时关闭按需条件,改用手动开关,避免自动重连干扰测试。不同平台的后台机制并不相同,不应照搬移动端条件。

05 / DATA

统计是观察依据,不是账单

Data:流量与连接记录

从 Data 查看当前界面提供的流量统计与连接信息,先确认统计范围,再解释数值。

是什么:Data 用于观察经客户端处理的流量及相关记录,可辅助判断请求是否出现、目标是什么,以及规则处理是否符合预期。页面显示的统计受记录范围、清理操作及连接方式影响,不等于设备所有网络流量,也不能替代服务端的用量记录。

怎么用:排查某个网页时先记下现有状态,再只访问一个目标,然后回到 Data 查找相应记录。若可查看规则或策略信息,应将目标域名、命中条件与处理策略一起核对;若没有新记录,先检查连接开关、页面是否实际发起新请求,以及请求是否使用了缓存。

注意什么:清空记录之前先保留需要对照的证据。上传和下载统计与应用显示的文件大小可能因协议开销、缓存和统计时间范围而不同,不宜据此判断服务器计费是否准确。连接记录可能包含访问域名及其他个人信息,分享截图或日志前应先检查内容。

06 / SETTINGS

保留原值,一次只调整一项

Settings:DNS、测试与同步

以下项目在 Settings 查找;具体是否显示及所在层级,以当前平台和应用界面为准。

DNS:先辨认解析问题

是什么与在哪:DNS 将域名解析为地址,相关设置可在 Settings 的 DNS 项及配置文件 [General] 参数中查找。DNS 的配置来源、请求路径和缓存都会影响观察结果,因此不能只改一个地址就认定解析方式已经完全切换。

怎么设与注意什么:先记录原有设置,核对当前配置是否另有 DNS 参数。只有出现域名解析失败、解析结果异常等明确线索时,再按网络环境调整。修改后重新建立连接并重复访问同一目标;若界面提供清理 DNS 缓存的选项,可在需要时使用。不要同时修改 DNS、服务器和规则,否则无法判断哪一项造成变化。连接建立但网页打不开,也可能是服务器或目标服务问题。

Test Method:让测试结果可比较

是什么与在哪:Settings 中的 Test Method 决定 Connectivity Test 使用的测试方式。不同方式检查的环节不同,数值不能跨方式直接比较;某个测试成功,只能说明该测试覆盖的路径有响应。

怎么设与注意什么:按界面提供的方式选择,并在比较同组服务器时保持测试方式与测试目标一致。切换 Wi-Fi 与 Cellular 后应重新测试,不要沿用上一种网络下的结果。若所有条目同时失败,先检查本地网络和测试目标;若只有一个条目异常,再核对该服务器参数。最终仍需用实际业务请求验证,不能仅凭列表中的结果认定所有网站均可访问。

Today Widget:快捷查看与操作

是什么与在哪:Today Widget 属于受系统支持情况影响的快捷入口,可在 Settings 查看相关选项,并在系统提供的组件添加界面进行配置。它不替代 Home、Config 中的完整设置。

怎么设与注意什么:先在应用内配置好服务器和 Global Routing,再添加系统可用的组件。核对组件显示内容与应用内当前状态是否一致;若显示没有及时变化,先回到应用确认实际连接。组件类型、添加位置和可操作范围取决于系统,当前设备未显示相应入口时,不要照搬其他系统的界面路径。

iCloud 同步:区分同步与备份

是什么与在哪:iCloud 相关选项位于 Settings 中,是否可用取决于平台、系统账号和云端权限。应先阅读当前界面列出的同步范围,不要假定所有服务器、规则和运行状态都会一起同步。

怎么设与注意什么:确认系统已登录自己的 iCloud 账号并允许相关访问,在启用前保存本地重要配置。另一台设备首次使用时,先比较本地与云端内容,再决定后续操作,避免在尚未确认同步方向时批量删除条目。同步不等于独立历史备份;订阅链接及服务器认证信息属于敏感内容,导出文件也应妥善保管。其他平台的数据迁移应按其实际提供的功能操作。

07 / DIAGNOSTICS

用相同条件复现问题

Diagnostics:从现象到定位

在 Settings 查找 Diagnostics。结合 Home 的服务器测试与 Data 记录判断,不把单项检查当作完整结论。

是什么:Diagnostics 汇集当前平台提供的诊断能力,帮助检查网络、解析或连接环节。执行前先确定要回答的问题:本地网络是否可用、服务器是否响应、域名能否解析,还是某条规则是否生效。不同问题需要不同证据。

怎么用:先记录当前网络类型、Global Routing 和配置文件名称,再对同一个目标复现一次异常。按下列顺序逐项验证,每改一项就重新测试,保留结果后再进入下一步。

  1. 确认本地网络。临时停止客户端连接,检查网络本身是否能完成正常访问;涉及登录认证的 Wi-Fi,先完成其认证流程。
  2. 确认服务器。回到 Home 核对选中条目及参数,运行 Connectivity Test,再通过实际请求验证。
  3. 比较 Global Routing。临时使用 Proxy 与原 Config 结果对照;若结果不同,重点检查配置文件与命中策略。
  4. 检查 DNS 与记录。结合 Diagnostics 和 Data 核对目标域名、解析情况及请求是否出现,再决定是否调整 DNS。
  5. 恢复日常设置。移除仅用于测试的改动,重新确认 Config、On Demand 与连接开关的最终状态。

注意什么:开启更多日志之前先确认保存范围,完成排查后及时结束不再需要的记录。向他人描述问题时提供可复现的操作、错误提示与已做过的检查,不公开完整订阅地址、密码或认证字段。若需要逐项判断,可继续阅读已连接但打不开网页的检查清单。

需要查找某个界面词或规则关键字时,可使用术语表;需要从添加订阅开始操作时,查看首次使用教程。