Shadowrocket 官网 · 官方手册

Shadowrocket
代理模式与常用设置

先确定 Global Routing 的处理方式,再调整规则、DNS 与按需连接。本页按“是什么、在哪里、怎么设、注意什么”说明常用功能。

适用于已有订阅或服务器信息的用户。以下操作位置以 iPhone / iPad 界面为参照;其他平台的布局与可用项目请以实际界面为准。

Global Routing

模式与出口的关系

处理逻辑示意,非应用界面。

Config
当前配置 → 按顺序匹配规则 → 对应策略
Proxy
进入客户端处理的连接 → 当前代理策略
Direct
进入客户端处理的连接 → 直接连接

切换模式不会替换服务器信息,也不会修复失效的订阅。

Config / Proxy / Direct

Global Routing:配置、代理与直连

Global Routing 决定连接按哪一类逻辑处理,不是服务器列表。在 Home 找到 Global Routing,进入后选择 Config、Proxy 或 Direct。中文说明中的配置、代理、直连分别对应这三个界面词。选好服务器但模式仍为 Direct 时,切换服务器通常不会改变访问路径;模式为 Config 时,也不能只根据当前服务器名称判断某个网站是否经过代理。

界面选项处理方式适用情形使用前核对
Config(配置)按当前启用配置中的规则与策略处理连接。已准备好规则,需要区分不同目标的日常使用。Config 中启用的是哪份配置,策略是否能找到对应服务器。
Proxy(代理)让进入客户端处理的连接使用当前代理策略。临时验证服务器连通性,或对照规则匹配问题。当前服务器有效,协议参数完整。
Direct(直连)让进入客户端处理的连接直接连接目标。核对本地网络能否直接访问,建立排查对照。目标在当前网络是否可以直接访问。

日常使用与临时对照分开

已有经过核对的配置时,通常先使用 Config。遇到某个网站无法访问,可记录原模式,再临时改为 Proxy 测试同一目标;如果 Proxy 可用而 Config 不可用,重点检查规则命中与策略引用。若两个模式均失败,应继续检查服务器参数、本地网络和 DNS,而不是反复更换规则。测试结束后恢复原模式。

DOMAIN-SUFFIX

规则分流:匹配条件与出口策略

规则描述“什么连接交给什么策略”。在 Config 查看当前启用的配置,再进入编辑位置检查规则内容。Global Routing 选择 Config 后,规则才成为分流判断的主要依据。通常按配置顺序检查匹配条件,因此精确规则应放在较宽泛的条件之前,兜底规则放在末尾;新增规则前,先保留原配置副本。

先认识条件,再检查策略名

DOMAIN 匹配完整域名;DOMAIN-SUFFIX 匹配指定域名及其子域名;DOMAIN-KEYWORD 按域名中的关键字匹配。IP-CIDR 与 IP-CIDR6 分别用于 IPv4 和 IPv6 地址段;GEOIP 根据地址归属数据判断;USER-AGENT 的判断依赖可获得的请求信息,不应把它当作所有应用连接的通用识别办法。

规则最后的策略决定命中后的处理。DIRECT 表示直接连接,REJECT 表示拒绝连接,PROXY 用于代理策略;配置也可能引用自定义策略组名称。自定义名称必须与配置中实际定义保持一致,不能把示例名称直接当作已有策略使用。

# 规则语法示例;example.com 仅作说明
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

这段示例表示:先检查 example.com 及其子域名,再检查 GEOIP 条件,最后由 FINAL 处理剩余连接。它不是适合所有网络的完整配置。域名解析结果、规则顺序与策略是否有效都会影响最终路径;修改后应使用同一个目标发起新连接,再结合连接记录核对,而不是只看首页开关是否开启。

需要拒绝某个目标时,应先缩小匹配范围。过宽的 DOMAIN-KEYWORD 或地址段可能连带影响登录、图片和接口请求。对单一问题,每次只修改一条规则;已有连接可能继续沿用原来的处理结果,必要时重新打开目标应用进行对照。更完整的模式说明见 Global Routing 三种模式详解。

Subscribe

订阅与服务器管理:区分来源和配置

订阅用于维护服务器列表,Config 用于规定连接处理方式,两者不是同一项内容。在 Home 查看服务器及订阅分组;添加用户已有的信息时,从 Add Server 进入,按实际类型选择对应协议或 Subscribe。二维码可通过 Scan QR Code 导入,但扫描前仍应确认内容来自用户已有的可信来源。

Subscribe 的添加与更新

将已有订阅地址填入 Subscribe 对应位置,设置便于辨认的备注后保存,再更新该订阅获取服务器列表。导入完成不代表已经连接:还需在 Home 选择服务器,核对 Global Routing,再打开连接开关。如果更新后列表为空,先确认地址是否完整、是否过期以及当前网络能否访问订阅地址,不要把订阅地址当作服务器地址填写。

订阅更新可能替换由该订阅生成的条目。需要临时调整参数时,先记录原值或保留独立副本,避免下一次更新后丢失修改。删除前确认操作针对的是单个服务器还是整个订阅分组;不确定时先保留原条目,通过备注区分测试项。

Add Server 的手动参数核对

手动添加时,按已有服务器信息选择 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 或其他实际支持的协议。服务器地址、端口、认证信息以及 TLS、传输相关字段必须成套对应。协议名称相近并不表示字段可以互换;也不要为了消除报错随意关闭证书验证。保存后先测试单个条目,再判断是否需要更改规则。

On Demand

On Demand:按网络条件触发连接

On Demand 管理何时尝试建立连接,不替代 Global Routing 的分流规则。在 Settings 查找 On Demand;如果当前界面将该项目单独列出,则从同名入口进入。设置前先手动连接一次,确认服务器和配置可用,再逐项启用所需的 Wi-Fi 或 Cellular 条件。具体可选条件以当前平台界面为准。

配置时先明确使用场景,例如在指定 Wi-Fi 环境采用不同的连接行为,再检查条件之间是否重叠。若按 Wi-Fi 名称设置条件,应核对名称拼写、空格以及同名网络的情况。不要同时建立多条含义相反的宽泛条件,否则从 Wi-Fi 切换到 Cellular 时,很难判断是哪条条件触发了连接。

需要暂停自动连接时,应检查 On Demand 的启用状态,而不只是关闭 Home 开关。按需条件仍满足时,系统可能再次尝试建立连接。排查反复重连时,先记录条件并暂时停用 On Demand,手动连接验证稳定性,再逐条恢复。按需触发也不保证切换网络时所有既有连接都能保持,应用可能需要重新发起请求。

Data

Data:查看流量记录与测试变化

Data 用于查看客户端可记录的流量信息,不是运营商账单。进入 Data,先阅读当前页面的时间范围、方向和分类标签,再查看上传与下载记录。若当前版本提供连接详情,可将异常时间段与访问目标对应起来;不要仅凭某个累计数字推断某条规则一定生效。

做单次测试时,先记下当前统计值与时间,暂停其他持续传输,再打开一个确定的目标观察变化。如果使用了页面提供的重置功能,应先保存需要保留的记录,并确认重置范围。累计流量、当前会话以及某个统计周期的数字含义不同,比较前必须保持时间范围一致。

Data 与系统蜂窝数据用量出现差异并不必然表示故障。统计起止时间、协议传输开销、后台连接和客户端可见范围都可能不同。判断是否走代理,应结合 Global Routing、规则命中和连接记录;判断套餐余量,则应查看用户已有服务对应的账户记录,而不是用 Data 代替计费依据。

Settings

Settings:DNS、测试与快捷操作

Settings 集中管理客户端的通用行为,但某些同类项目也可能由当前 Config 指定。调整前先检查配置内容,避免只改全局设置却忽略当前配置的影响。不同平台、系统权限与版本的项目位置可能不同;找不到某一入口时,以实际界面为准,不需要为了对齐本文而重复导入配置。

DNS:域名解析与访问路径分别核对

DNS 将域名解析为地址。先在 Settings 的 DNS 相关入口查看现有设置,再检查 Config 中是否包含 DNS 配置。网页打不开而 Connectivity Test 有结果时,应先区分“服务器可达”和“目标域名能正确解析”。保留原设置后,一次只调整一个解析相关项目,用同一域名重新测试。

解析器可达不代表访问目标一定可达;更换 DNS 也不能修复错误的服务器密码或传输参数。填写地址和选择解析方式时,按界面要求输入,避免把带路径的地址误填到只接受服务器地址的字段。若出现仅部分域名失败,继续核对规则与 IPv4、IPv6 路径。详细步骤见 DNS 解析失败排查。

Test Method:统一 Connectivity Test 的比较条件

Test Method 决定 Connectivity Test 采用的测试方法。在 Settings 查找 Test Method,先确认当前方法以及界面是否提供测试目标配置,再进行测试。比较多个服务器时,应保持本地网络、测试方法和目标一致,并在相近时间内测试,避免把不同条件下的结果放在一起判断。

测试结果只反映对应测试过程。能够返回结果,不等于所有网站、协议或持续传输都正常;一次超时也不足以判断服务器长期失效。遇到测试与实际访问不一致时,使用真实目标复现问题,再转到 DNS 与连接记录查找原因。

Today Widget:快捷入口与系统权限

Today Widget 用于系统支持范围内的快捷查看或操作。在 Settings 中查看对应设置,再到系统提供的小组件管理位置添加。是否可以显示、可以进行哪些操作,取决于系统版本和当前应用提供的组件类型;没有显示时,先确认应用已经打开过,并检查系统是否允许该组件运行。

快捷入口与主应用使用同一套连接状态。执行快捷操作后,应回到 Home 核对服务器、模式和连接开关,不要只依据组件短暂显示的内容判断最终状态。自动连接相关问题仍需回到 On Demand 检查。

iCloud:确认同步范围再换设备

若当前版本提供 iCloud 同步,在 Settings 找到对应项目,并确认系统已登录预期的账户且允许 Shadowrocket 使用 iCloud。启用前先查看页面列出的同步范围,不能假定服务器信息、配置、统计和连接状态都会一起同步。

换设备时先等待同步完成,再在新设备逐项核对配置内容;避免两台设备同时修改同一份内容。同步不能代替独立备份,也不代表服务器凭据失效后仍能使用。包含订阅地址或认证信息的内容应按敏感数据管理,设备转交前按系统与应用提供的功能清理。

Diagnostics

Diagnostics:按层定位,而非连续改设置

Diagnostics 用于收集故障线索,不能自动证明某个服务器或规则正确。从 Settings 查找 Diagnostics,按当前界面提供的项目执行检查。复现之前先记下本地网络、所选服务器、Global Routing 与启用配置;如果需要临时开启记录,应在测试结束后恢复原来的记录级别。

  1. 先检查本地网络。确认设备本身可以访问已知可用的目标;必要时在 Wi-Fi 与 Cellular 之间做一次对照,不同时修改客户端参数。
  2. 再检查服务器。对同一个条目执行 Connectivity Test,核对协议、地址、端口与认证信息。若多个条目同时异常,优先排查共同的网络条件。
  3. 然后对照模式。记录 Config 与 Proxy 访问同一目标的差异。只有 Config 异常时,重点检查规则顺序、策略引用及 DNS 相关配置。
  4. 最后查看记录。按问题发生的时间定位目标域名、错误信息和实际处理策略;修改一项后重新建立连接,确认变化能否稳定复现。

诊断资料可能包含访问域名、服务器地址、订阅链接和认证相关内容。需要保存或提交排查资料时,先删除完整订阅地址、密码与可识别个人的信息;不要直接公开整份配置或全部日志。完成排查后整理最终生效的修改,删除临时测试条目,恢复日常 Global Routing 和 On Demand 条件。

需要从导入开始按顺序操作,转到入门指南;已经定位到具体报错,查看疑难解答。iPhone / iPad 的系统要求以 App Store 页面标注为准。