官方手册 · 功能与设置

Shadowrocket
常用设置与生效条件

先确认请求按什么方式处理,再修改规则、DNS 与连接条件。每次只调整一项,用相同请求验证结果。

Global Routing Config On Demand Diagnostics

本页按 iPhone / iPad 常见界面组织操作路径;Mac、Windows、安卓、Linux 版同属 Shadowrocket,不同系统的入口位置与可用设置可能不同,请以当前界面实际显示为准。已有订阅或服务器信息是建立代理连接的前提,配置文件本身不等于可用线路。

iPhone / iPad 版在 App Store $2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。获取渠道与设备说明见全平台下载页。

01 / GLOBAL ROUTING

Global Routing:配置、代理、直连

是什么:Global Routing 决定请求采用哪一种整体处理方式。日常按域名和 IP 分流通常使用 Config;临时判断故障来自规则还是代理服务器,可以分别使用 Proxy 与 Direct 做对照。这三个选项改变的是路由姿态,不会替换服务器密码,也不会让失效的订阅恢复。

在哪个界面:在 Home 找到 Global Routing,打开后核对当前选中项。此处讲解 Config / Proxy / Direct 三种常用姿态;若当前界面另有 Scene,应按其中具体场景配置理解,不能把它直接视为上述三项之一。

界面选项处理方式何时使用先检查什么
Config(配置)按当前启用配置中的规则决定策略。日常规则分流;验证自定义规则。启用文件、规则顺序及策略引用。
Proxy(代理)将通常可处理的请求交给当前代理路径。临时排除规则分流的影响。当前选中的服务器及其参数。
Direct(直连)请求按直连路径处理。与原始网络表现作对照。原始网络是否可用及 DNS 状态。

怎么设:先记下原选项,再选择需要的姿态,返回 Home 检查连接状态。使用同一个网站或应用重试;必要时结束旧连接后再测试,避免已有会话干扰判断。若 Proxy 可用而 Config 不可用,应优先核对规则和策略,而不是立即重填所有服务器参数。

注意什么:Direct 不等于断开系统中的 VPN 配置,Proxy 也不意味着所有应用、所有系统服务都必然走相同路径。测试结束应恢复原本需要的姿态;不要因为一次访问成功,就把临时排查设置长期保留。

02 / RULE MATCHING

规则类型、策略与匹配顺序

是什么:规则由匹配条件与执行策略组成。DOMAIN 用于精确域名,DOMAIN-SUFFIX 用于域名及其子域,DOMAIN-KEYWORD 按域名关键字匹配;IP-CIDR 与 IP-CIDR6 匹配地址段,GEOIP 依赖相应地址数据。USER-AGENT 的适用性与请求是否能取得相关字段有关,不能把它理解为所有加密流量都可读取的条件。

在哪个界面:在 Config 中确认当前启用文件,再进入该文件的规则编辑位置。Global Routing 应选择 Config,否则不能仅凭规则文本推断实际分流结果。先确认“启用的是哪个文件”,再检查“文件里面写了什么”。

[Rule]
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

怎么设:从上到下逐条检查,首条命中后执行对应策略。PROXY 表示交给代理路径,DIRECT 表示直连,REJECT 表示拒绝。以上示例先拒绝特定子域,再处理其上级域名;如果交换两行,较宽的域名规则可能提前命中。FINAL 放在末尾,为此前未匹配的请求指定兜底策略。示例域名仅用于说明语法。

注意什么:规则中的策略也可能引用配置内已定义的策略组,应核对名称与组内实际选择。域名命中、DNS 解析与 IP 命中不是同一环节;不要只看最终 IP 就认定域名规则失效。修改前保留原文件,先用一条范围明确的规则验证,再逐步扩展。详细示例见规则顺序与 FINAL 说明。

03 / SERVER MANAGEMENT

订阅与服务器分开管理

是什么:服务器条目保存协议、地址、端口和认证等连接信息;订阅用于批量取得、刷新这些条目;Config 中的配置文件则描述路由、DNS 等行为。三者互相关联,但更新其中一项不代表另外两项也已更新。订阅更新成功只表示取得了可识别内容,不保证每个服务器都能连接。

在哪个界面:已有服务器通常在 Home 的列表中查看和选择;手动输入使用 Add Server,二维码入口为 Scan QR Code。导入已有链接时先确认内容究竟是服务器订阅还是配置文件,按当前界面提供的对应入口操作;Config 中的 Subscribe 用于相应配置内容,不应把不同用途的 URL 混放。

怎么设:从用户已有服务商取得原始信息,导入前检查链接完整性及前后空格。手动填写时选择正确协议,再逐项核对地址、端口、密码或标识、传输方式和 TLS 参数。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 各有参数要求,不能只改协议名称便复用同一组字段。编辑后先保存,再选中该条目测试。

注意什么:订阅刷新可能重建服务器条目,直接修改订阅下发的条目可能被后续更新覆盖。需要保留个别调整时,先确认当前版本提供的独立保存方式,并记录改动。删除整个订阅前核对所属分组,避免误删其他信息。链接、二维码和连接日志可能包含凭据,分享截图或求助前应遮盖;本站不提供、不销售、不推荐节点或订阅。

04 / ON DEMAND

On Demand:按条件发起连接

是什么:On Demand 利用系统的按需机制,根据已配置的网络条件触发连接。它解决“什么时候建立连接”,Global Routing 解决“建立连接后怎样处理请求”,两者不能互相替代。开启 On Demand 不会自动补齐缺失的服务器参数,也不会修复当前不可用的网络。

在哪个界面:在 Settings 或当前版本显示的 On Demand 设置入口中查看条件,并核对系统保存的 VPN 配置。具体可配置条件依系统与当前界面而定,不要仅凭其他设备的截图寻找完全相同的开关。

怎么设:先关闭 On Demand,手动连接并验证已有服务器可用,再开启按需机制。若设置界面提供 Wi-Fi、蜂窝网络或网络名称条件,从一种网络开始配置;保存后切换到目标网络,观察系统连接状态和实际访问结果。每次只增加一个条件,并记录哪些网络应该连接、哪些网络应保持原状。

注意什么:手动关闭连接后又自动恢复,可能是按需条件再次满足,不一定是开关失灵。需要暂停时先关闭 On Demand,再关闭连接;排查多套 VPN 配置冲突时,也要检查系统端是否留有按需规则。网络切换、休眠和恢复连接受系统调度影响,不能把按需机制当作持续连接的保证。

05 / DATA

Data:查看流量而非判断资费

是什么:Data 用于观察客户端处理的流量情况。上行、下行、累计量和当前速率描述不同维度,应先读清字段名称与统计范围。客户端统计、系统网络统计和服务商账单的计量口径可能不同,不能用其中一个数字直接推算另一个数字。

在哪个界面:进入 Data 查看当前版本提供的统计项目,并留意计数从何时开始、是否按会话或其他范围累计。若需要核对蜂窝网络实际使用量,应同时查看系统设置;需要核对已有服务的额度,则以相应服务的记录为准。

怎么设:诊断异常消耗前,先记下当前计数、连接时间和网络类型,再暂时停止系统更新、云同步等已知后台任务,用同一个操作进行对照。如果界面提供重置功能,重置前保留必要记录。比较两次数据时应保持观察时长和操作内容接近,避免把不同时间窗口的结果放在一起。

注意什么:请求、响应、重传以及连接维护均可能影响流量。Data 中有流量不等于目标页面已完整加载,速率较低也不等于协议设置错误。流量统计不是线路延迟测试;判断可达性仍需结合 Connectivity Test、目标请求与日志。

06 / SETTINGS

Settings 常用项的调整顺序

Settings 中的项目涉及解析、测试、快捷操作与数据同步。修改前先区分全局设置与当前 Config 文件内的设置;相同主题在两处出现时,应结合实际启用配置及日志确认生效结果,不能只凭某个输入框仍保留旧值判断优先级。

DNS:先确认解析问题

是什么、在哪:DNS 将域名解析为地址,相关选项可出现在 Settings 及 Config 的 DNS 设置中。域名访问失败而已知地址可达时,DNS 是需要检查的一环,但证书、目标服务与规则也可能造成相似表现。

怎么设、注意什么:先记录当前解析方式,确认当前网络是否需要特定的本地解析服务,再根据实际需求调整。企业内网或局域网名称可能依赖网络提供的 DNS,直接替换可能使其失效。加密 DNS 同样需要可达的传输路径;若解析请求自身依赖尚未建立的代理路径,可能形成连接前置条件问题。改动后重新发起请求,并结合解析记录核对结果。

Test Method 与 Connectivity Test

是什么、在哪:在 Settings 的 Test Method 选择当前版本提供的测试方式,再在 Home 对服务器执行 Connectivity Test。不同方法可能测试不同层次:端口可达只说明连接链路的一部分,以目标 URL 测试则还可能涉及 TLS、目标响应和超时设置。

怎么设、注意什么:比较服务器时统一测试方式、目标与当前网络,连续观察而不是只看一次结果。测试失败先核对方法是否适用于对应协议,尤其是依赖 UDP 的传输;测试成功也不能代替实际业务验证。不要为得到较小数值而频繁切换测试目标,这会使前后结果失去可比性。

Today Widget:快捷入口的系统条件

是什么、在哪:Today Widget 是系统允许时提供的快捷查看或操作入口,相关选项以 Settings 和系统组件添加界面实际显示为准。它不是独立的代理配置,也不替代 Home 中的服务器选择。

怎么设、注意什么:先在应用内完成一次正常连接,再到系统支持的组件位置添加并测试操作。若系统没有显示该组件,不应假定每个设备或系统版本都具备相同入口;组件刷新还可能受后台调度影响。状态显示不一致时返回应用核对,再查看系统 VPN 状态,不要连续快速点击多个连接入口。

iCloud:同步前先备份

是什么、在哪:Settings 中与 iCloud 相关的选项用于当前版本支持的数据同步或导入操作。同步范围应以界面说明为准,不应默认服务器、订阅、日志和全部开关都会逐项复制。

怎么设、注意什么:先确认设备使用预期的 iCloud 账号,并在系统中允许相应访问。首次启用、合并或恢复前保留当前可用配置,待一台设备完成后再检查另一台,避免同时编辑造成冲突。应用购买所用账号与 iCloud 同步账号承担不同用途;恢复购买不能代替配置恢复。配置可能含认证信息,应按敏感数据管理。

07 / DIAGNOSTICS

Diagnostics 与设置复原

是什么:Diagnostics 用于收集、查看当前版本提供的连接诊断信息。日志可以辅助定位解析、连接、认证或规则命中的环节,但单条错误通常不足以解释整个问题,需要与故障发生时间和实际操作对应。

在哪个界面:从 Settings 的 Diagnostics 或当前界面所列的诊断入口进入。若提供临时详细记录选项,只在复现问题时启用;不同系统与版本可见的诊断项目可能不同。

怎么设:先记录 Global Routing、当前服务器、启用的 Config 与网络类型,再开启必要记录。只复现一次明确操作,记下发生顺序,然后查看对应时间附近的信息。排查时按照下面的顺序推进,前一步通过后再调整下一步:

  1. 暂时断开连接,确认当前 Wi-Fi 或蜂窝网络自身可用;需要时先完成网络登录。
  2. 关闭 On Demand 的自动触发影响,手动选择一个已有服务器,核对协议及认证参数。
  3. 统一 Test Method 执行 Connectivity Test,再用真实目标请求确认访问结果。
  4. 临时对照 Proxy 与 Config;若仅 Config 异常,检查启用文件、规则顺序与策略组。
  5. 若表现指向解析环节,再检查 DNS;同时确认设备系统时间自动设置,避免 TLS 判断受到影响。
  6. 撤回本轮没有改善结果的改动,恢复原定 Global Routing 与 On Demand 条件。

注意什么:诊断内容可能含服务器地址、订阅 URL、认证字段、访问域名及局域网信息。导出前逐项检查,只保留定位所需片段,遮盖敏感内容。复现完成后恢复通常的日志级别,避免长时间收集不必要记录。不要在未备份时直接删除全部配置或重装;这样可能丢失线索,却没有解决网络或服务器端问题。

免费下载 Shadowrocket