官方手册 · 功能与设置
Shadowrocket
功能与设置
先确认流量走向,再调整规则与连接条件。
本页按 Home、Config、Data 与 Settings 的使用关系说明常用功能。操作以用户已有自己的订阅或服务器信息为前提;界面入口如有调整,请按当前应用内的英文名称核对。
- 获取入口 App Store
- 配置前提 已有订阅或服务器信息
- 检查依据 当前应用内设置
Global Routing:配置、代理与直连
三种模式决定总体处理方式,不是三组服务器,也不是连接质量等级。
是什么:Global Routing 是流量处理方式的总入口。在 Home 中打开 Global Routing,可以核对 Config、Proxy、Direct。配置、代理、直连是这三种模式的中文说明,实际界面名称仍以英文为准。更换模式不会修复错误的服务器地址或认证信息,也不代表已经建立了有效连接。
怎么设:日常需要按规则处理不同请求时,通常先选 Config,并确认 Config 页面中当前生效的配置。需要暂时排除规则干扰、检查所选服务器是否能处理某个请求时,可以切到 Proxy 做对照。需要观察当前网络直接访问的表现时,可以切到 Direct。每次对照都使用同一目标、同一网络,结束后恢复原来的模式。
| 界面模式 | 处理方式 | 适用场景 | 需要注意 |
|---|---|---|---|
| Config · 配置 | 按当前配置中的规则与策略处理请求。 | 需要域名、地址等条件分流的日常使用。 | 先确认当前配置,再检查规则顺序与策略目标。 |
| Proxy · 代理 | 以代理模式处理流量,便于对照所选服务器的表现。 | 临时检查规则是否影响目标请求。 | 并不保证所有类型的流量都可用;仍受服务器能力与相关设置影响。 |
| Direct · 直连 | 以直接连接方式处理流量。 | 对照当前网络的直接访问表现。 | 不是停止全部网络活动,也不能替代对连接开关的检查。 |
注意什么:Global Routing 与 Home 的连接开关是两个层次。前者决定处理方式,后者决定是否启用相应连接。若 Config 与 Proxy 的结果不同,应优先检查规则、策略指向与解析;若两者都失败,则先核对服务器信息和网络条件,不要直接把问题归结为规则错误。
规则分流:先匹配条件,再执行策略
规则类型描述“匹配什么”,策略描述“匹配后怎么处理”。
是什么、在哪里:规则分流主要在 Config 中管理,并在 Global Routing 使用 Config 时参与处理。DOMAIN 用于匹配指定域名,DOMAIN-SUFFIX 用于匹配域名后缀,DOMAIN-KEYWORD 用于匹配域名中的关键词。IP-CIDR 与 IP-CIDR6 描述地址网段,GEOIP 依据地址归属数据进行匹配。域名条件和地址条件依赖的信息不同,不能仅凭网页名称判断实际命中了哪一条。
怎么设:先保存一份可恢复的当前配置,再添加范围明确的规则。规则通常从上向下检查,前面的匹配可能使后面的规则不再有机会处理同一请求。因此,应把需要优先处理的具体条件放在合适位置,再检查较宽泛条件与 FINAL。PROXY、DIRECT、REJECT 分别表示代理、直接连接与拒绝处理;若规则引用了命名策略,还要确认对应策略存在且目标有效。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,PROXY
注意什么:以上仅用于说明语法与顺序,不是适合所有网络的完整配置。DOMAIN-KEYWORD 的覆盖范围可能比预期更大;地址规则的结果还可能受到 DNS 解析、IPv4 与 IPv6 选择的影响。FINAL 是未被前面规则接住时的最终处理,不应当用它掩盖前面策略名称错误的问题。排查时应同时核对请求域名、目标地址和最终策略,而不是只看编辑器中的某一行。
Subscribe 与 Add Server:管理已有连接信息
把批量更新的订阅与单条手动配置区分开,避免重复导入和误删。
是什么、在哪里:Home 中的服务器列表用于选择连接目标。Add Server 用于录入单条服务器信息,Subscribe 相关入口用于管理已有订阅。用户应先从自己的服务商处取得订阅或服务器参数,再选择对应方式;导入订阅并不等于导入了一套适合当前网络的完整分流规则。
怎么设:手动添加时,按提供的协议选择类型,再核对地址、端口、认证以及传输层相关字段。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等协议的字段并不相同,不要把一组信息机械地填入另一种协议。通过已有订阅导入时,先核对链接完整性,再保存并更新;更新后检查条目是否出现、名称是否便于辨认,以及当前选中的目标是否仍然存在。
如何整理:有多个已有订阅时,用可识别的名称区分来源与用途,先查看各组更新结果,再删除确认不再使用的条目。批量更新可能改变列表内容,手动改过的订阅条目也可能随更新被覆盖。需要长期保留的个人调整,应先确认它属于订阅条目还是独立手动条目,并保留必要记录。删除一组订阅之前,核对当前连接和策略是否还引用其中的服务器。
On Demand:按条件触发连接
先完成一次稳定的手动连接,再设置自动触发条件。
是什么、在哪里:On Demand 用于按已设置的网络条件触发连接行为,可在 Settings 中查找相关入口。它关注“何时需要连接”,与规则分流关注“请求如何处理”不同。启用 On Demand 不会自动补齐服务器参数,也不会替代 Global Routing 的模式选择。
怎么设:先关闭自动触发,确认手动启用连接、访问目标、停止连接这一过程正常。随后进入 On Demand,逐项阅读当前界面提供的网络条件与动作,只启用能够解释清楚的条件。涉及特定 Wi-Fi 网络时,要核对网络名称与实际环境。保存后实际切换一次相关网络,观察连接状态是否符合预期,再决定是否增加其他条件。
注意什么:如果手动停止后连接又出现,应先查看 On Demand 是否仍有触发条件,而不是反复切换 Home 开关。更换服务器、配置或网络后,也应重新核对自动连接结果。设备休眠、网络切换与系统权限会影响观察过程;判断是否正常,应以真实连接状态和请求结果为依据,不能只看开关位置。
Data:读取流量记录与统计口径
统计用于定位活动与对照变化,不等同于线路账户的计费记录。
是什么、在哪里:Data 页面用于查看应用记录的流量活动与统计信息。先确认当前页面显示的时间范围、分组方式和计数含义,再比较上传、下载等数据。不同视图可能回答不同问题:总量反映累计活动,具体条目则有助于定位某次请求或某个目标。
怎么用:排查时先记下当前统计状态,再执行一个容易重复的操作,例如打开同一个页面,然后回到 Data 查看变化。如果界面提供重置或清除功能,应先确认清除范围并保存必要记录。需要比较两次测试时,保持网络、服务器和观察时段尽量一致;后台应用的活动也会影响总量,不能把所有增量都归给刚打开的页面。
注意什么:Data 的数字来自客户端的观察范围,不应直接当作服务商剩余额度或账单。连接状态、统计周期、协议开销与服务侧计量口径都可能造成差异。分享诊断材料前,检查其中是否包含访问域名、地址或其他个人活动信息;只保留与当前故障相关的部分。
Settings:DNS、测速、组件与同步
常用设置按作用分开调整,不把所有问题都归到同一个开关。
DNS:核对解析来源与当前配置
是什么、在哪里:DNS 负责把域名解析为地址,是打开网站前的一个环节。先在 Settings 中查找 DNS 相关项,再核对 Config 中是否也有解析设置。页面打不开但服务器测试有响应,只能说明测试目标在测试方式下有响应,不能据此断定 DNS 正常。
怎么设、注意什么:先记录当前值,核对解析服务器是否可达、配置中的解析选项是否与预期一致,再一次调整一项。修改后使用同一个域名重新验证,并留意缓存和已有连接对结果的影响。不要随意叠加多套解析设置;若问题只出现在某个域名,还应检查它的规则匹配和地址选择。具体排查顺序见 DNS 设置与网页打不开排查说明。
Test Method:理解 Connectivity Test 的含义
是什么、在哪里:Settings 中的 Test Method 决定 Connectivity Test 使用的测试方式。不同方式检查的环节不同,返回的时间也不能脱离测试条件直接比较。测试结果并不是下载速度,也不能代表所有网站的访问表现。
怎么设、注意什么:先查看当前选项的说明,再固定一种方式测试同一批服务器。如果需要更换方式或测试目标,应把它当作一次新的对照,避免把前后的数字混在一起排序。单次超时应复测;测试有响应后仍需打开实际目标,确认域名解析、连接建立与内容传输都能完成。
Today Widget:快捷操作与状态核对
是什么、在哪里:Today Widget 用于系统组件中的快捷入口或状态展示,可在 Settings 中查找对应设置。组件的添加位置与可用操作取决于设备系统及当前应用支持情况,应以设备上实际显示的内容为准。
怎么设、注意什么:先在应用内确认连接可正常启停,再按系统组件编辑入口添加可用组件。使用快捷入口后,回到 Home 核对连接和所选服务器;不要把组件上的一次状态显示当作持续连接的证明。若快捷操作后行为与预期不同,同时检查 On Demand 是否重新触发了连接。
iCloud:同步范围与本地恢复
是什么、在哪里:iCloud 相关选项用于同步应用所支持的数据,可在 Settings 中核对。它与 App Store 的已购恢复不是同一件事:恢复应用购买解决获取资格,同步数据解决部分配置在设备间的流转。
怎么设、注意什么:先检查系统已登录自己的 iCloud 账户、相关权限与可用空间,再查看应用内当前支持的同步项目。不要假定所有服务器、规则、历史记录和敏感字段都会一起迁移。另一台设备首次同步后,应逐项核对配置、服务器与当前模式,再启用连接。重要修改前保留可恢复记录,遇到内容不一致时先确认同步状态,不要在多台设备上同时反复覆盖。
Diagnostics:按故障环节收集证据
诊断结果应能回答一个具体问题,而不是把所有工具连续运行一遍。
是什么、在哪里:Diagnostics 是辅助核对网络与连接情况的工具入口,可在 Settings 中查找。具体工具与可观察项目以当前应用界面为准。它提供的是某个时刻、某种测试条件下的结果,不是对服务器或网络长期可用性的保证。
怎么用:先写清故障范围:是所有目标都失败,还是只有单个域名;是更新订阅失败,还是连接后访问失败;是手动正常,还是仅自动连接异常。然后按顺序核对基础网络、服务器字段、Connectivity Test、Global Routing、规则匹配与 DNS。只改变一个条件后复测,并记录结果是否变化。这样可以把问题逐步缩小到连接信息、解析、策略或触发条件,而不是同时改动多处后失去对照。
注意什么:诊断记录可能包含服务器地址、请求域名和认证相关信息。提交给自己的服务商或用于进一步排查前,应隐藏订阅链接、认证字段与不相关的访问记录,同时保留协议类型、故障表现和复现步骤。与其只提供一句“不能用”,更有用的描述是说明网络环境、当前模式、哪个测试失败,以及改动哪一项后结果发生了变化。
设置完成后的核对清单
把“已导入”“已连接”“访问正常”作为三个独立结果确认。
- 服务器信息:Home 中已出现预期条目,协议与字段对应用户已有的信息,当前选中目标有效。
- 处理模式:Global Routing 符合用途;使用 Config 时,当前配置和命名策略都已核对。
- 真实访问:除 Connectivity Test 外,已用实际目标验证解析和内容传输;需要分流时也检查了不同规则的结果。
- 自动触发:On Demand 只保留确实需要的条件,网络切换后的行为已实际测试。
- 恢复与隐私:关键设置有可恢复记录,同步结果已核对,分享材料中未包含订阅凭据或不相关活动。
Shadowrocket 是 Apple 平台付费客户端,唯一获取入口是 App Store。系统要求、设备兼容性与购买适用范围,以 App Store 页面标注为准。准备购买或换机时,可先阅读 App Store 正版核对与恢复说明;需要从导入到首次连接的连续操作步骤,请阅读 Shadowrocket 使用说明;遇到特定现象时,可转到 疑难解答 查找对应分类。