官方手册 · 规则参考
Shadowrocket 规则与配置参考大全
先确认当前配置和 Global Routing,再判断请求命中了哪条规则。配置文件决定匹配条件,策略决定后续处理;两者需要分开核对。
本页是系统查阅手册,适合已经持有自己的订阅或服务器信息、需要调整规则的用户。首次使用请先按快速上手教程完成导入、连接和基本验证,再回到对应章节查语法;下文也会在涉及导入和连接时返回教程,不重复安装主线。
Shadowrocket 提供 iPhone、iPad、Mac(Apple 芯片与 Intel)、Windows、安卓及 Linux 版本;各平台界面位置可能不同,以下以配置关键字和实际匹配行为为核对依据。获取方式与系统安装放行步骤见全平台下载说明。
配置文件结构与安全编辑流程
配置文件是设置与规则的集合,不等于订阅链接,也不等于服务器列表。订阅通常用于取得服务商维护的服务器信息;配置文件则描述请求怎样解析、匹配和处理。两者可以协同工作,但更新订阅不会自动证明当前规则正确,修改规则也不会修复服务器参数。开始编辑之前,应先在 Config 中确认正在使用的文件,而不是只查看刚刚下载到本地的同名副本。
四个段落分别负责什么
[General] 保存通用设置,常见内容包括 DNS 与系统流量处理选项;[Rule] 按行写匹配条件及策略;[Host] 为指定主机名提供静态解析关系;[URL Rewrite] 使用正则表达式描述 URL 的改写或重定向。段名属于语法,不要换成中文标题,也不要把某段的内容直接接到另一段末尾而省略段名。
下面是用于阅读结构的示例,不是可直接替换个人配置的完整方案。示例中的域名只承担教学用途,PROXY 仍需要可用的服务器选择。实际配置还可能包含其他段落,不能因为本页没有展开就删掉它们。遇到不理解的内容,应先确认来源和用途,再决定是否修改。
[General]
bypass-system = true
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
[Host]
localhost = 127.0.0.1
[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302
键值、字段与换行的区别
通用设置和 Host 映射常使用等号分隔左右两侧,规则行则通常使用英文逗号分隔类型、条件与策略。中文逗号、全角空格、复制时带入的引号都可能改变解析结果。每条规则应独占一行,避免编辑器视觉折行造成误判:屏幕上显示两行,不一定代表文件中真的存在两个换行符。
空行可以帮助分组,但不会建立新的优先级。真正决定规则归属的是段名,决定先后的是 Rule 内的位置。解释性文字建议独立写成以 # 开头的注释行,不要随意接在规则字段后面。尤其不要给条件加自然语言说明,再期待客户端自动把多余文字忽略。
先复制,再改动,再选择生效文件
建议把当前可用文件复制一份,保留原始内容与服务商提供的信息。先在副本中完成一项修改,保存后重新确认选中的配置,再发起新的测试请求。若编辑的是远程维护文件的本地副本,还要分清远程来源与本地修改的关系,避免下次更新把临时调整覆盖。
文件名相同不代表内容相同,文件已保存也不代表已经成为当前使用项。排错时可以在副本里增加一条容易识别的测试规则,再从请求记录核对命中结果。如果记录仍显示旧规则,先检查活动文件与 Global Routing,不要继续叠加修改。恢复时直接切回原文件,比凭记忆逐条撤销更可靠。
示例不是通用整套配置合并规则时保留现有必要段落与服务器信息,只移动或增加已理解的行。不要把不同来源的整份文件首尾拼接。
订阅应从你的服务商处获取,导入路径见教程中的导入与首次连接步骤。如果导入后没有可选服务器,先解决输入信息与导入结果,再研究规则;否则即使命中了 PROXY,也没有可用的后续连接对象。配置结构正确只是第一层检查,不代表每条网络路径都已经验证通过。
Global Routing 三姿态与三种基本策略
Global Routing 控制总体路由姿态,规则中的策略控制一次匹配后的处理方式。界面里的 Config、Proxy、Direct,与规则里的 PROXY、DIRECT、REJECT 不处在同一层。排查“规则为什么没有生效”时,首先确认是否处于配置姿态 Config;如果正在使用 Proxy 或 Direct,不能用此时的连接结果证明某条 Rule 的匹配逻辑正确。
Config、Proxy、Direct 怎么分工
Config 按当前配置进行分流,适合验证自定义规则;Proxy 让可被客户端接管的请求按代理方向处理,可用于隔离规则分流因素;Direct 则用于观察直连路径。这里说的是客户端接管范围内的总体行为,不代表系统中的每个数据包都必然经过相同流程,也不意味着切换姿态会把所有现有连接立即重建。
| 界面姿态 | 主要用途 | 核对重点 |
|---|---|---|
| Config(配置) | 依照当前配置分流 | 规则顺序、命中条件与最终策略 |
| Proxy(代理) | 检查代理方向的基本可达性 | 选中服务器及连接参数 |
| Direct(直连) | 检查当前网络的直连表现 | 本地网络、解析与目标服务 |
例如某域名在 Proxy 下能打开、Config 下失败,只能说明两种姿态的结果不同,还不能直接判定是 DNS 出错。应继续查看 Config 下实际选择了哪个策略,是否被更靠前的 DIRECT 或 REJECT 截获,以及目标请求是否与最初输入的域名一致。浏览器跳转后的域名可能已经发生变化。
PROXY、DIRECT、REJECT 的含义
PROXY 将匹配请求交给当前代理选择处理;DIRECT 让匹配请求走直连路径;REJECT 拒绝匹配请求。策略不是连通性承诺:PROXY 仍依赖有效的服务器信息和目标可达性,DIRECT 仍受当前网络影响,REJECT 的作用范围则受匹配条件约束。把三者理解为处理决定,比理解为“快”“慢”或“修复按钮”更准确。
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
这里精确拒绝一台主机,精确直连另一台主机,其余属于该域名后缀的请求才交给 PROXY。若把后缀规则移到最上方,后面两条精确例外就可能不再有机会匹配。策略本身没有固定的高低优先级,并不是 REJECT 总能覆盖 PROXY;决定覆盖关系的是条件与顺序。
代理选择与协议参数仍需单独确认
规则写 PROXY,并没有同时写入服务器地址、端口或认证信息。使用 Shadowsocks、VMess、VLESS、Trojan 等协议时,仍要按服务商提供的信息保留相应参数,不能把另一种协议的字段凭名称相似移过来。协议属于连接层,规则属于选择层,规则正确不能弥补连接参数缺失。
On Demand 用来管理满足条件时的连接行为,不是 Rule 中的一种策略。测试期间如果连接状态不断变化,应同时检查触发条件,避免把断开或重新连接误认成规则不稳定。Connectivity Test 主要帮助观察所测试连接的状态,它的成功也不能代替具体业务请求的分流验证。
姿态切换建议一次只作为一个变量:先记下原设置,切换后新建请求并记录结果,再切回日常使用的 Config。更完整的场景对照见Global Routing 的 Config / Proxy / Direct 对照。不要在同一轮里同时更换服务器、DNS 与规则,否则成功或失败都很难归因。
DOMAIN、DOMAIN-SUFFIX 与 DOMAIN-KEYWORD
域名规则适合表达“这台主机”“这个域及其子域”或“名称中含有某段文字”的处理需求。选择规则类型时,应从最小的必要范围开始,而不是先写一条很宽的关键词规则。范围越宽,越容易把登录、支付、内容分发或其他无关请求一起改变,后续也越难解释为什么一个看似无关的网站受到影响。
DOMAIN:只描述一个完整主机名
DOMAIN 用于精确匹配主机名。条件写 example.com 时,不应把它当作自动包含 www.example.com 的规则。适合只调整某个接口或某台主机的情况。条件中写域名本身,不写协议前缀、端口、路径、查询参数,也不要把从地址栏复制的完整 URL 直接放进去。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN,static.example.com,DIRECT
FINAL,PROXY
同一网页往往访问多台主机:页面文档可能来自一个域名,图片、接口和认证又分别来自其他域名。如果页面只加载了一部分,不要立即扩大为关键词匹配。先从请求记录找出失败主机,再决定是否增加精确规则。一个域名连接成功,并不能证明整个网页涉及的所有请求都采用了同一策略。
DOMAIN-SUFFIX:按域名层级覆盖
DOMAIN-SUFFIX,example.com,PROXY 用于匹配该域及其子域,例如 www.example.com 与更深层级的主机名。它按域名后缀边界理解,不是简单查找任意包含文字;notexample.com 不应因为末尾字符相似就被视为该域的子域。通常不需要给条件额外加星号或协议前缀。
如果同一域下大多数服务使用 PROXY,只有内部接口使用 DIRECT,可以先写内部接口的 DOMAIN 例外,再写 DOMAIN-SUFFIX 总规则。这样的结构让意图清楚:第一条负责例外,第二条负责域范围。若服务后来迁移到另一个域名,旧后缀规则不会自动追踪新域,仍需根据真实请求更新。
| 类型 | 条件示例 | 适用范围 |
|---|---|---|
| DOMAIN | api.example.com | 指定的完整主机名 |
| DOMAIN-SUFFIX | example.com | 该域及其子域 |
| DOMAIN-KEYWORD | example | 域名中出现指定文字 |
DOMAIN-KEYWORD:方便,但更容易扩大影响
DOMAIN-KEYWORD 对域名中的文字片段进行匹配,不表示网页内容搜索,也不表示扫描 URL 路径。条件写 example 时,可能命中多个彼此不相关的域名。它适合确实需要宽范围文字条件且已经确认边界的情况,不适合作为对陌生服务的第一条规则,更不应把极短的常见字母组合用于拒绝策略。
对 REJECT 尤其应坚持先窄后宽。拒绝一个共享域名,可能同时中断图片、验证码或账户功能;拒绝承载业务内容的主机,也不一定只影响期望屏蔽的资源。域名规则不能根据同一加密连接内的页面元素做精细判断。相关原理可继续阅读REJECT 规则的作用与边界。
怎样验证域名条件确实命中
先把测试条件限定为一台已知主机,确认请求记录中出现的名称与条件一致,再查看命中规则和策略。不要只看浏览器地址栏,因为重定向、缓存和后台接口都可能改变实际请求集合。若记录只显示目标 IP,需要继续判断域名信息是否可用,而不是反复增加同名规则。
域名别名与资源迁移也需要区分。目标在解析过程中引用其他名称,不意味着你必须把整个解析链中的所有域都加入规则;应以客户端实际记录和业务新请求为依据。修改后用同一入口重测,保留修改前后记录,确认影响范围只覆盖预期主机,再决定是否扩展到整个后缀。
IP-CIDR、GEOIP 与 USER-AGENT 的使用边界
域名之外,规则还可以根据目标地址或请求中可获得的信息作决定。这类条件并不与域名规则互相替代:域名描述服务名称,IP 描述连接目的地址,USER-AGENT 描述特定请求字段。选择条件前,要先确认客户端在该请求阶段能够看到什么信息,否则语法正确的规则也可能始终没有命中机会。
IP-CIDR:用网段表达地址范围
IP-CIDR 使用地址与前缀长度描述 IPv4 网段。前缀越长,覆盖范围越小;单个 IPv4 地址可以使用 /32。例如 192.168.0.0/16 覆盖该前缀下的地址,而 192.168.10.0/24 范围更窄。写规则时应使用与目标网段对应的网络地址,不能把斜杠后面的数字当作端口。
[Rule]
IP-CIDR,192.168.10.0/24,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
这些行演示局域网地址、IPv6 本地地址范围与地域判断的写法,不是要求每份配置照搬。企业网络或远程网络可能使用同样的私有地址范围;如果你的真实需求是通过指定远程路径访问某个私有网段,宽泛的 DIRECT 规则反而可能把连接发向错误位置。应结合当前网络和目标归属决定策略。
no-resolve 不是关闭 DNS
附加参数 no-resolve 用于避免仅为判断该条 IP 规则而主动解析域名,不代表应用完全停止 DNS,也不代表此后所有规则都不能解析。请求本身已经是 IP,或已有可用地址信息时,地址条件仍可能被判断。对需要依赖域名解析结果才能命中的场景,贸然加上它可能改变预期结果。
因此,看到域名请求没有命中某个网段时,要检查规则是否允许为地址匹配进行解析,也要检查后续规则如何处理。不要把 no-resolve 当成通用性能开关加到所有地址规则上。先明确希望减少哪一次解析,再用记录核对行为;减少解析动作与得到正确的策略并不是同一件事。
GEOIP:地址数据库判断,不是网站身份判断
GEOIP,CN,DIRECT 根据目标 IP 在所用数据库中的归属进行判断。它不识别网站使用哪种语言、经营主体在哪,也不能保证同一域名在不同网络、时间和解析结果下始终命中同一地域。内容分发服务可能返回不同地址,数据库的分类也不等于实际业务的全部部署位置。
有明确业务要求的域名,通常应先用域名规则表达意图,再把 GEOIP 放在后面作为较宽的分类条件。若某网站偶尔改变路径,先核对当时的解析地址和命中记录,区分“地址变了”与“规则失效”。不要通过不断移动 GEOIP 的位置掩盖具体域名需求,那会同时改变更多请求。
USER-AGENT:只对可获取的请求字段有意义
USER-AGENT,Example*,DIRECT 展示按 User-Agent 模式匹配的写法,其中星号用于模式匹配。它不等于按应用名称、进程名称或图标识别软件。应用可能共享同一个请求库,也可能更改字段;某些请求中则根本无法取得可供该规则判断的 User-Agent。
对加密请求,不能假定客户端天然可见其中的所有 HTTP 字段,因此不要把 USER-AGENT 作为所有应用流量分类的通用依据。本页不要求为使用这条规则额外启用解密设置。若实际目标是指定服务优先走某条路径,先评估能否用清晰的域名或地址条件表达,测试时同时检查字段可见性与策略结果。
IPv4 与 IPv6 也应分别核对。只写 IP-CIDR 不会自动覆盖对应的 IPv6 地址,目标服务换用另一地址族时可能落入不同规则。出现同一域名在不同网络表现不一致时,把地址族作为检查项之一,而不是立即关闭某类网络能力;先找到实际连接目的地址,才能判断缺失的是哪一条条件。
自上而下匹配、例外规则与 FINAL
Rule 的基本阅读方式是从上到下检查,先命中的规则决定该次请求的策略。更具体的类型不会自动获得更高优先级,文件末尾也不会天然覆盖文件开头。理解这一点后,很多“规则写了却没有效果”的情况都可以转化为一个可验证的问题:在到达这条规则之前,请求是否已经命中了另一条条件。
具体例外放在宽范围规则之前
假设同一域下只有一台主机需要直连,其他主机需要代理。应先写该主机的 DOMAIN,再写覆盖整个域的 DOMAIN-SUFFIX。若反过来排列,精确规则虽然仍能保存,却可能永远等不到匹配。规则类型表达范围,位置表达先后,两者需要同时正确,不能只检查其中一项。
[Rule]
# 精确例外先判断
DOMAIN,intranet.example.com,DIRECT
DOMAIN,blocked.example.com,REJECT
# 再判断较大的域范围
DOMAIN-SUFFIX,example.com,PROXY
# 地址分类与最终策略放在后面
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
这里把域名规则放在 GEOIP 之前,是为了让明确的服务意图先于较宽的地址分类。它不是适用于所有配置的固定排序公式:如果你明确要求某个地址范围优先处理,也可以把经过审查的地址例外放在更前面。关键是解释清楚覆盖关系,并为有交集的条件准备测试请求。
FINAL 是兜底,不是补充覆盖
FINAL,PROXY 表示前面的规则都没有匹配时采用 PROXY。它不再携带域名或网段条件。通常把 FINAL 保留为规则段最后的有效规则,避免后续条件失去作用。把 FINAL 移到中间,不会产生“先尝试代理,失败后再继续查规则”的效果;匹配流程不是按连通性逐行重试。
FINAL 选择 DIRECT 还是 PROXY,要由你的整体分流目标决定,没有脱离场景的统一答案。选 PROXY 时,未分类请求依赖代理选择可用;选 DIRECT 时,未分类请求依赖当前网络直连。应把兜底决定写入维护说明,并测试一个没有被前面条件覆盖的请求,确认实际落点符合预期。
重复规则、冲突规则与不可达规则
完全重复的规则通常只增加阅读负担;同一条件对应不同策略时,靠前的那条会遮住后面的决定。更隐蔽的冲突来自范围包含,例如关键词条件覆盖后缀条件,后缀条件覆盖精确主机。排查时不能只搜索完全相同的一行,还要寻找能够提前匹配目标的更大范围。
合并不同来源时,建议先按业务意图整理,再检查条件交集,而不是简单按字母排序。排序工具可能让原本位于顶部的例外掉到后面。每组规则前可以写注释说明用途,但注释只帮助阅读,不改变匹配优先级;即使写着“最高优先级”,放在 FINAL 后面也不会因此生效。
用一组对照请求检查范围
验证后缀规则时,至少检查域本身、一个子域和一个不属于该域的名称;验证精确例外时,再检查同域另一台主机。目标不是证明“某一页能打开”,而是确认需要覆盖的请求被覆盖、不需要覆盖的请求没有被误伤。拒绝策略尤其需要检查正常功能是否仍能完成。
如果多条规则都可能匹配同一请求,可以在副本中暂时缩小测试范围,逐步排除更靠前的候选行。每次只改顺序或只改条件,不要同时改变策略。保留当前命中规则、预期命中规则与目标主机这三项记录,往往比反复截图整个配置更能说明问题。
规则匹配不是连接失败后的候选队列命中 PROXY 后连接失败,不代表会继续执行下一行 DIRECT。应检查所选路径,或明确修改分流决定,而不是在后面追加一条相同条件。
General、DNS 与 Host 如何影响规则判断
DNS 把名称转换为地址,规则决定请求采用什么策略。两者相互关联,但不能画等号。域名规则可能在地址产生之前就表达明确意图,地址规则则需要目标地址信息。排查时要把“没有取得地址”“取得了不适合的地址”“取得地址后选择了错误路径”分开,否则更换 DNS 可能暂时改变现象,却没有解释真正原因。
General 中的设置先保留已知可用值
dns-server = system 表示采用系统 DNS 设置。它适合建立一个容易理解的基础状态,但不保证所有网络环境下得到同样结果。bypass-system = true 涉及系统相关流量的绕过处理,不是域名白名单,也不应该被解释为“所有本地流量一定直连”。具体接管范围还受系统与当前设置影响。
[General]
bypass-system = true
dns-server = system
[Host]
localhost = 127.0.0.1
printer.example.com = 192.168.10.20
如果现有配置已经能正常工作,不要为了让文件看起来更完整而复制陌生的 General 参数。通用设置可能影响整个配置,不像一条精确域名规则那样容易限制范围。修改之前记录原值,并确认是在调整解析来源、系统接管行为还是其他选项,避免同时引入多个全局变量。
系统 DNS、自定义 DNS 与 DNS over HTTPS
系统 DNS 继承当前网络环境的解析设置,自定义 DNS 则需要填写你确实能够使用且了解来源的解析服务。DNS over HTTPS 把解析请求封装在 HTTPS 中,但它仍然需要可达的服务地址、有效的连接以及合理的路径。采用某种传输形式,不代表解析结果必然更适合当前业务,也不等于业务请求本身已经走代理。
本页不提供外部解析服务推荐。需要更换时,先在单独副本中只改变解析设置,再使用相同域名与相同路由姿态测试。对需要域名才能访问的解析端点,还应注意初始名称如何被解析,避免配置依赖自身形成循环。具体选择思路见系统 DNS、自定义 DNS 与 DNS over HTTPS 对照。
Host 只建立映射,不直接指定策略
Host 中的 printer.example.com = 192.168.10.20 把指定名称映射到一个地址,不表示它自动采用 DIRECT。若业务要求直连,应同时通过明确的规则表达路径,再检查目标地址是否确实属于当前可访问网络。将名称映射到私有地址,也不会让设备凭空获得到远程私有网络的连通性。
静态映射适合地址确定、由你掌握的主机,不适合未经确认地固定大型服务的解析结果。服务可能因区域、负载和故障迁移改变地址,长期保留旧映射会绕过正常解析调整。遇到连接突然失败时,应把 Host 中的手动条目作为检查项,而不是只检查 Rule。
映射地址不等于改变加密服务身份
把一个域名指向另一台服务器,浏览器仍可能按照原域名进行加密连接和证书验证。如果目标服务器并不为该名称提供服务,连接就可能失败。Host 不是修复证书错误的通用办法,也不是 URL 跳转;不要通过忽略身份验证来掩盖映射错误,应先核对域名、地址与目标服务是否匹配。
解析缓存和连接复用会让修改后的表现延迟出现。保存配置后,应发起新请求,并注意应用是否还复用旧连接;必要时结束相关应用的现有会话再测试。不要把某一次仍使用旧地址的请求直接解释为 Host 无效,也不要在没有记录的情况下连续切换多个 DNS 设置。
对于“域名失败但直接访问 IP 成功”的现象,也不能立即认定 DNS 有问题。直接访问 IP 可能触发不同的虚拟主机、不同证书或不同规则,二者并不是严格等价的测试。更可靠的比较是保留同一个域名,只核对解析结果、命中规则与实际目的地址,让每轮测试的差别保持可解释。
URL Rewrite 的匹配、重定向与风险边界
URL Rewrite 处理 URL 形式的匹配与改写,不是 Rule 的另一种写法。Rule 关心请求选择哪种策略,重定向则可能让应用重新请求另一个地址,两者可以先后影响同一次访问流程。新增重写规则前,应先确定实际需求是“改变连接路径”还是“改变请求地址”;只想让一个域名走代理时,通常不需要使用重写。
先读懂正则、替换目标和状态码
下面示例把指定主机的 HTTP 地址引导到同名 HTTPS 地址,目标服务器必须实际支持 HTTPS。匹配表达式、替换目标与状态码各自承担不同职责,不能把逗号分隔的域名规则语法搬进这一段。示例只用于解释单条规则,不建议在未检查现有内容时直接加入所有配置。
[URL Rewrite]
^http://example\.com(?=/|$) https://example.com 302
开头的 ^ 把匹配限制在 URL 起始位置;\. 表示字面意义的点,避免正则中的点被当作任意字符;(?=/|$) 要求主机名之后是斜杠或字符串结束,防止把带相似前缀的其他主机也当作目标。替换内容改变匹配到的前缀,后续路径应通过实际测试确认保留情况。
302 表示临时重定向,客户端收到响应后可能再发起请求。它不是代理策略,也不表示连接失败时回退。测试时要关注新的目标地址、跳转次数和最终命中规则,而不只是第一页是否出现。如果目标地址再次匹配到反向重写,访问可能不断往返并最终失败。
路径、查询参数与请求方法都要检查
替换一个地址前缀,可能同时影响该主机下的多个路径。需要保留的路径与查询参数应纳入测试集合,不要只测试站点首页。登录回调或带签名的请求对 URL 很敏感,改写后即使页面能打开,也可能因为参数含义变化而被服务端拒绝。复杂捕获组应逐个说明用途,避免依赖难以复查的表达式。
浏览器导航与应用接口请求也不是同一种场景。某些请求包含请求体,应用对重定向的处理方式可能与浏览器不同;不能仅凭一次浏览器测试就把同一条规则推广到所有接口。对于账户、认证或写入操作,优先保留原始行为,只有在明确理解目标服务要求时才进行限定范围的实验。
加密流量中的可见性限制
HTTPS 请求的完整路径通常处在加密保护之内,不能假设客户端在普通转发时可以任意读取和改写。是否能应用某类重写,取决于流量可见性与实际配置。不要因为域名规则可以匹配主机名,就推导出路径重写一定可用;主机信息与完整 HTTP 内容属于不同层次。
本页不要求为重写额外配置解密,也不把安装证书当作常规排错步骤。如果业务目标能够用域名分流解决,应优先使用范围清楚的 Rule。涉及账户和敏感数据时,尤其要理解每项设置改变的处理范围;无法解释的重写规则应留在副本里验证,而不是直接用于日常配置。
检查重写与后续规则的共同作用
假设原地址跳转到另一域名,新请求需要再次接受相应的路由判断。原域名走 DIRECT,不代表重定向后的域名也会直连。网页出现“第一跳成功,之后失败”时,应把整个跳转链列出来,逐一核对每个主机的解析、命中规则和策略,而不是持续修改第一条域名规则。
维护重写时,应记录原地址模式、目标地址、预期状态码以及反例。反例至少包含一个相似但不应匹配的主机和一个需要保留的路径。发现异常后先停用新增重写,保持其他设置不变;若问题随之消失,再逐项缩小表达式,而不是同时调整 DNS、服务器与所有规则。
域名分流与地址改写分别验证PROXY 不改变 URL,重定向也不自动指定 PROXY。记录每一跳的主机和策略,才能判断故障发生在哪个环节。
规则验证、常见故障与长期维护
验证规则应形成闭环:明确预期、保存副本、单项修改、新建请求、查看记录、保留或回滚。不要把“能打开一个网页”作为全部验收标准,也不要把一次失败等同于整个配置失效。规则只是完整连接过程的一部分,解析、所选服务器、目标服务和本地网络都需要按层次区分。
建立一组能重复的测试
为每组改动准备预期命中的主机、应该采用的策略以及一个不应受影响的对照主机。测试前确认 Global Routing 为 Config,活动文件是刚保存的副本,服务器选择也与上一轮一致。测试时主动发起新请求,避免仅查看已缓存页面;记录实际主机、目的地址与策略,必要时补充当时网络环境。
如果 Connectivity Test 正常但业务失败,继续检查该业务的具体请求,不要只重复测试服务器。反过来,业务页面能够打开也不能证明全部规则命中正确,因为内容可能来自缓存或其他主机。有效证据应能对应到本轮新请求,并说明它经过了哪条规则,而不是只有“感觉变快了”的结论。
按现象缩小排查范围
| 现象 | 优先核对 | 下一步 |
|---|---|---|
| 新规则没有命中 | 活动配置、Config、前置条件 | 查看实际主机与更早命中的规则 |
| 命中 PROXY 但失败 | 服务器选择与连接参数 | 隔离验证代理路径和目标服务 |
| 只有部分资源失败 | 接口、静态资源与跳转域名 | 逐台主机核对策略 |
| 更新后本地改动消失 | 远程来源与本地副本 | 比较更新前后的相关段落 |
保存后报语法问题时,先检查最近改动的段名、英文逗号、等号与行尾内容,再缩小到最少几行验证。连接后所有业务都失败时,先恢复上一个可用文件,区分全局设置变化与局部规则变化。只有单个域名失败时,则优先检查该域名的解析、前置匹配和重写,不必先重建全部服务器信息。
订阅更新与规则维护分开记录
订阅从你的服务商处获取,更新订阅与更新配置应视为两个不同事件。一次更新可能改变服务器条目或选择状态,远程配置更新也可能替换本地规则。更新后先确认发生变化的是哪一类内容,再重跑相关测试。导入入口的区别见Subscribe、Add Server、扫码与剪贴板导入说明。
建议为本地例外保留一份简短说明,写清用途、条件范围、预期策略和验证方式。定期检查已经停用的主机、重复行与被覆盖的例外,不要只追加不清理。规则数量变多并不代表覆盖更准确;一份能够解释每组条件、能够快速回滚的文件,更容易在业务变化时保持可维护。
保存记录时保护个人信息
请求记录可能包含访问域名、路径和查询参数,订阅链接也可能带有访问凭据。向他人描述问题时,只保留必要的规则类型、匿名化主机与命中策略,不要直接发送完整订阅链接、认证字段或整份未经检查的配置。示例可以改用 example.com,但应保留能复现问题的条件关系和规则顺序。
获取客户端与获取线路是两件事:iPhone / iPad 版在 App Store $2.99 一次性付费,Mac / Windows / 安卓 / Linux 版免费;客户端一次性买断 ≠ 线路套餐。Shadowrocket 是闭源商业应用,本手册以用户已有服务信息为前提讲解配置,不提供节点服务。iPhone / iPad 系统要求以 App Store 页面标注为准。
需要重新获取客户端时,使用下载页查看规定渠道:iPhone / iPad 核对开发者 Shadow Launch Technology Limited 与应用 ID 932747118,其他平台安装包由本站 /dl/ 提供。安装拦截处理集中在安装放行说明,规则异常则返回本页对应章节逐层检查,不把安装问题与分流问题混在一起。
若只是要完成首次连接,回到快速上手教程按顺序操作;若需要解释某一次异常,就从实际请求出发,依次核对活动文件、Global Routing、命中条件、最终策略、解析结果和连接路径。每次只解决一个可观察的问题,才能让改动与结果对应,并保留明确的恢复办法。