Surge / Quantumult X / Loon 规则转换通用方案：iOS 代理三巨头跨客户端迁移完全指南

在 iOS 平台上，Surge、Quantumult X（圈 X）、Loon 是三款最主流的高级代理客户端。它们各自拥有强大的规则分流能力，但规则格式互不兼容——你在 Surge 上精心调教的数百条分流规则，直接导入 Quantumult X 会报错；Loon 的策略组语法和 Surge 的又不一样。

更头疼的是：网上分享的规则仓库往往只提供某一种客户端的格式。你看到一套完美的 Netflix 分流规则，结果它是 Surge 格式的，而你用的是 Loon。

本文将系统解决这个问题：从四款工具的规则语法差异入手，提供完整的映射表和转换方案，让你无论用哪款客户端，都能复用同一套规则体系。

一、为什么需要规则转换？#

1.1 四款 iOS 代理工具的定位差异#

工具	定位	规则格式	价格	学习曲线
Surge	专业网络调试工具箱	INI 风格，最复杂	$49.99 起	⭐⭐⭐⭐⭐
Quantumult X	轻量代理 + 轻量调试	自定义格式	$7.99/月或$ 49.99 终身	⭐⭐⭐
Loon	介于 Surge 和 QX 之间	类 Surge INI 风格	$7.99/月或$ 39.99 终身	⭐⭐⭐⭐
Shadowrocket	入门级代理工具	类 Surge 格式	$2.99 一次性	⭐⭐

1.2 规则不兼容的根源#

虽然四款工具都支持”基于域名/IP分流”这个核心概念，但它们在以下方面存在差异：

关键字命名：同样是”域名后缀匹配”，Surge 叫 DOMAIN-SUFFIX，QX 叫 host-suffix，Loon 和 Shadowrocket 叫 DOMAIN-SUFFIX（但大小写规则不同）
出站动作命名：Surge 用 Proxy，QX 用 PROXY，Shadowrocket 要求全大写 PROXY
策略组语法：Surge 用 policy-group，QX 用 [policy]，Loon 用 [Proxy Group]
配置文件结构：Surge 是 INI 格式，QX 是自定义分段格式，Loon 是类 INI 但段名不同
高级特性：Surge 的脚本/MITM、QX 的 rewrite、Loon 的 plugin 都是各自独有，无法跨客户端转换

1.3 什么时候需要转换？#

场景	需要转换的内容	难度
从网上下载的规则只支持某一种客户端	规则集格式	简单
从 Surge 迁移到 QX/Loon	全部配置	中等
多客户端同时使用（iPhone 用 Surge，iPad 用 QX）	规则 + 策略组	中等
共享规则给朋友（对方用不同客户端）	规则集格式	简单
机场订阅只提供 Clash 格式	订阅转换	需要 Sub-Store

二、四客户端规则语法全景对比#

2.1 配置文件结构对比#

Surge 配置结构（INI 风格）：

1
[General]
2
bypass-system = true
3
skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8
4
dns-server = 223.5.5.5, 119.29.29.29
5

6
[Proxy]
7
Direct = direct
8
Reject = reject
9
HK = https://hk.example.com:443, username, password
10

11
[Proxy Group]
12
Proxy = select, HK, US, JP
13
Auto = url-test, HK, US, JP, url=http://www.gstatic.com/generate_204, interval=300
14

15
[Rule]
16
DOMAIN-SUFFIX,google.com,Proxy
17
DOMAIN-KEYWORD,facebook,Proxy
18
GEOIP,CN,DIRECT
19
FINAL,Proxy

Quantumult X 配置结构（自定义分段）：

1
[general]
2
server_check_url=http://www.gstatic.com/generate_204
3
resource_parser_url=https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js
4

5
[policy]
6
available=HK, server-check-tag=Check, img-path=available.png
7
static=Proxy, HK, US, JP
8
round-robin=Balance, HK, US, JP
9

10
[server_remote]
11
https://example.com/sub, tag=机场A
12

13
[filter_remote]
14
https://raw.githubusercontent.com/.../proxy.list, tag=代理, force-policy=Proxy
15
https://raw.githubusercontent.com/.../direct.list, tag=直连
16

17
[rewrite_remote]
18
https://raw.githubusercontent.com/.../rewrite.conf, tag=重写

Loon 配置结构（类 INI 但段名不同）：

1
[General]
2
skip-proxy = 127.0.0.1, 192.168.0.0/16
3
dns-server = 223.5.5.5, 119.29.29.29
4

5
[Proxy]
6
Direct = DIRECT
7
Reject = REJECT
8
HK = hysteria2, hk.example.com, 443, password=xxx
9

10
[Proxy Group]
11
Proxy = select, HK, US, JP
12
Auto = url-test, HK, US, JP, url=http://www.gstatic.com/generate_204, interval=300
13

14
[Remote Rule]
15
https://raw.githubusercontent.com/.../proxy.list, policy=Proxy
16
https://raw.githubusercontent.com/.../direct.list, policy=DIRECT
17

18
[Rule]
19
DOMAIN-SUFFIX,google.com,Proxy
20
DOMAIN-KEYWORD,facebook,Proxy
21
GEOIP,CN,DIRECT
22
FINAL,Proxy

Shadowrocket 配置结构（类 Surge 但更简）：

1
[General]
2
bypass-system = true
3
dns-server = 223.5.5.5, 119.29.29.29
4

5
[Proxy]
6
Direct = DIRECT
7
Reject = REJECT
8
HK = https, hk.example.com, 443, username, password
9

10
[Proxy Group]
11
Proxy = select, HK, US, JP
12

13
[Rule]
14
DOMAIN-SUFFIX,google.com,PROXY
15
DOMAIN-KEYWORD,facebook,PROXY
16
GEOIP,CN,DIRECT
17
FINAL,PROXY

2.2 核心规则元素映射表#

这是最关键的转换参考——同一个匹配规则在四款客户端中的不同写法：

规则类型	Surge	Quantumult X	Loon	Shadowrocket	说明
域名后缀匹配	`DOMAIN-SUFFIX,google.com,Proxy`	`host-suffix,google.com,Proxy`	`DOMAIN-SUFFIX,google.com,Proxy`	`DOMAIN-SUFFIX,google.com,PROXY`	匹配域名及所有子域名
完整域名匹配	`DOMAIN,www.apple.com,Direct`	`host,www.apple.com,Direct`	`DOMAIN,www.apple.com,Direct`	`DOMAIN,www.apple.com,DIRECT`	精确匹配完整域名
域名关键字	`DOMAIN-KEYWORD,netflix,Proxy`	`host-keyword,netflix,Proxy`	`DOMAIN-KEYWORD,netflix,Proxy`	`DOMAIN-KEYWORD,netflix,PROXY`	域名包含关键字即匹配
IP-CIDR	`IP-CIDR,192.168.1.0/24,DIRECT`	`ip-cidr,192.168.1.0/24,DIRECT`	`IP-CIDR,192.168.1.0/24,DIRECT`	`IP-CIDR,192.168.1.0/24,DIRECT`	IP 段匹配
IP-CIDR6	`IP-CIDR6,fe80::/10,DIRECT`	`ip6-cidr,fe80::/10,DIRECT`	`IP-CIDR6,fe80::/10,DIRECT`	`IP-CIDR6,fe80::/10,DIRECT`	IPv6 段匹配
GeoIP	`GEOIP,CN,DIRECT`	`geoip,cn,DIRECT`	`GEOIP,CN,DIRECT`	`GEOIP,CN,DIRECT`	基于国家代码匹配
用户代理	`USER-AGENT,Netflix*,Proxy`	`user-agent,Netflix*,Proxy`	`USER-AGENT,Netflix*,Proxy`	`USER-AGENT,Netflix*,PROXY`	匹配 HTTP User-Agent
进程名 (仅Surge)	`PROCESS-NAME,Telegram,Proxy`	❌ 不支持	`PROCESS-NAME,Telegram,Proxy`	❌ 不支持	按进程名分流
最终规则	`FINAL,Proxy`	`final,Proxy`	`FINAL,Proxy`	`FINAL,PROXY`	兜底规则
规则集	`RULE-SET,SYSTEM,DIRECT`	❌ 使用 filter_remote	`RULE-SET,https://...list,Proxy`	`RULE-SET,https://...list,PROXY`	引用外部规则集

2.3 出站动作命名对比#

动作	Surge	Quantumult X	Loon	Shadowrocket
代理	`Proxy`（策略组名）	`PROXY`（需大写）	`Proxy`（策略组名）	`PROXY`（必须大写）
直连	`DIRECT`	`DIRECT`	`DIRECT`	`DIRECT`
拒绝	`REJECT`	`REJECT`	`REJECT`	`REJECT`
拒绝+丢弃	`REJECT-DROP`	`REJECT-DROP`	`REJECT-DROP`	`REJECT-DROP`
拒绝+图片	`REJECT-IMG`	`REJECT-IMG`	`REJECT-IMG`	`REJECT-IMG`
拒绝+空响应	`REJECT-NO-DROP`	`REJECT-NO-DROP`	`REJECT-NO-DROP`	❌ 不支持

⚠️ 大小写陷阱：Shadowrocket 的出站动作（PROXY、DIRECT、REJECT）必须全大写。Surge 和 Loon 对策略组名大小写不敏感但约定首字母大写。QX 要求 DIRECT 和 REJECT 大写，但自定义策略组名可混合大小写。

三、Surge → Quantumult X 转换#

3.1 手动转换步骤#

从 Surge 迁移到 QX 是最常见的转换场景。核心步骤：

Step 1：规则语法替换

将 Surge 规则中的关键字替换为 QX 格式：

1
# Surge 原始规则
2
DOMAIN-SUFFIX,google.com,Proxy
3
DOMAIN-KEYWORD,netflix,Proxy
4
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
5
GEOIP,CN,DIRECT
6
FINAL,Proxy
7

8
# 转换后 QX 规则
9
host-suffix,google.com,Proxy
10
host-keyword,netflix,Proxy
11
ip-cidr,10.0.0.0/8,DIRECT,no-resolve
12
geoip,cn,DIRECT
13
final,Proxy

Step 2：策略组转换

Surge 的 [Proxy Group] 对应 QX 的 [policy]：

1
# Surge 策略组
2
[Proxy Group]
3
Proxy = select, HK, US, JP
4
Auto = url-test, HK, US, JP, url=http://www.gstatic.com/generate_204, interval=300
5
Fallback = fallback, HK, US, JP, url=http://www.gstatic.com/generate_204, interval=300
6

7
# 转换后 QX 策略组
8
[policy]
9
static=Proxy, HK, US, JP
10
available=Auto, HK, US, JP, check-url=http://www.gstatic.com/generate_204, check-interval=300
11
round-robin=Fallback, HK, US, JP

策略组类型映射：

Surge 类型	QX 类型	说明
`select`	`static`	手动选择
`url-test`	`available`	自动测速选最快
`fallback`	`round-robin`	轮询（注意：QX 的 fallback 需要用 `available` + 重试逻辑模拟）
`load-balance`	`round-robin`	负载均衡

⚠️ 重要差异：Surge 的 fallback 是”故障转移”（主节点失败才切备用），而 QX 的 round-robin 是”轮询”（依次使用）。如果你需要 Surge 的 fallback 行为，在 QX 中应使用 available 类型。

Step 3：MITM/Rewrite 转换

Surge 的 [MITM] 和 [Script] 在 QX 中对应 [mitm] 和 [rewrite]：

1
# Surge MITM
2
[MITM]
3
hostname = *.google.com, api.netflix.com
4
ca-passthrough = true
5

6
# QX mitm
7
[mitm]
8
hostname = *.google.com, api.netflix.com

1
# Surge 脚本
2
[Script]
3
http-request ^https://api\.example\.com/script script-path=example.js, requires-body=true
4

5
# QX rewrite
6
[rewrite_local]
7
^https://api\.example\.com/script url script-request-header example.js

3.2 注意事项#

no-resolve 参数：Surge 和 QX 都支持 no-resolve 参数（用于 IP 规则跳过 DNS 解析），但位置不同。Surge 放在规则末尾，QX 也放在末尾，语法一致
USER-AGENT 通配符：Surge 使用 * 通配符，QX 也支持 *，但 QX 对正则表达式的支持更有限
RULE-SET 差异：Surge 使用 RULE-SET 引用本地或远程规则集，QX 使用 [filter_remote] 引用远程规则、[filter_local] 引用本地规则
PROCESS-NAME：QX 不支持进程名规则，如果你的 Surge 配置中有 PROCESS-NAME 规则，迁移到 QX 时需要删除或替换为域名规则

四、Surge → Loon 转换#

4.1 为什么 Surge → Loon 相对简单？#

Loon 的配置格式刻意设计为与 Surge 高度相似，降低迁移门槛。两者的 [General]、[Proxy]、[Proxy Group]、[Rule] 段名和语法几乎一致。

4.2 关键差异与转换#

差异 1：节点协议语法

1
# Surge 节点（Shadowsocks）
2
[Proxy]
3
HK = custom, hk.example.com, 443, aes-128-gcm, password, https://raw.githubusercontent.com/.../SSEncrypt.module
4

5
# Loon 节点（Shadowsocks）
6
[Proxy]
7
HK = shadowsocks, hk.example.com, 443, aes-128-gcm, password

1
# Surge 节点（VMess）
2
[Proxy]
3
US = vmess, us.example.com, 443, username=uuid, tls=true
4

5
# Loon 节点（VMess）
6
[Proxy]
7
US = vmess, us.example.com, 443, username=uuid, tls=true

1
# Surge 节点（Hysteria2）
2
[Proxy]
3
JP = hysteria2, jp.example.com, 443, password=xxx, sni=jp.example.com
4

5
# Loon 节点（Hysteria2）
6
[Proxy]
7
JP = hysteria2, jp.example.com, 443, password=xxx, sni=jp.example.com

差异 2：远程规则引用

1
# Surge 远程规则集
2
[Rule]
3
RULE-SET,https://raw.githubusercontent.com/.../proxy.list,Proxy
4

5
# Loon 远程规则
6
[Remote Rule]
7
https://raw.githubusercontent.com/.../proxy.list, policy=Proxy
8

9
# Loon 本地规则
10
[Rule]
11
DOMAIN-SUFFIX,google.com,Proxy

差异 3：插件系统

Loon 有独特的 [Plugin] 概念，类似于将一组规则、重写、脚本打包成一个可复用的模块：

1
# Loon Plugin 示例
2
[Plugin]
3
https://raw.githubusercontent.com/.../BlockAA.plugin, tag=去广告
4
https://raw.githubusercontent.com/.../Streaming.plugin, tag=流媒体分流

Surge 没有等价的 Plugin 系统，最接近的是 [Rule] 中的 RULE-SET。

4.3 转换清单#

Surge 元素	Loon 对应	转换难度
`[General]`	`[General]`	⭐ 几乎相同
`[Proxy]`	`[Proxy]`	⭐⭐ 协议关键字略有不同
`[Proxy Group]`	`[Proxy Group]`	⭐ 语法一致
`[Rule]` 本地规则	`[Rule]`	⭐ 语法一致
`[Rule]` RULE-SET	`[Remote Rule]`	⭐⭐ 需改格式
`[MITM]`	`[MITM]`	⭐ 语法一致
`[Script]`	`[Plugin]` 或 `[Rewrite]`	⭐⭐⭐ 需重新编写
`[URL Rewrite]`	`[Rewrite]`	⭐⭐ 语法略有不同

五、Quantumult X / Loon → Surge 反向转换#

5.1 QX → Surge#

从 QX 迁移回 Surge 时，需要注意：

1
# QX 规则
2
host-suffix,google.com,Proxy
3
host-keyword,netflix,Proxy
4
ip-cidr,10.0.0.0/8,DIRECT
5
geoip,cn,DIRECT
6
final,Proxy
7

8
# 转换为 Surge 规则
9
DOMAIN-SUFFIX,google.com,Proxy
10
DOMAIN-KEYWORD,netflix,Proxy
11
IP-CIDR,10.0.0.0/8,DIRECT
12
GEOIP,CN,DIRECT
13
FINAL,Proxy

QX 策略组 → Surge 策略组：

1
# QX 策略组
2
[policy]
3
static=Proxy, HK, US, JP
4
available=Auto, HK, US, JP, check-url=http://www.gstatic.com/generate_204, check-interval=300
5

6
# Surge 策略组
7
[Proxy Group]
8
Proxy = select, HK, US, JP
9
Auto = url-test, HK, US, JP, url=http://www.gstatic.com/generate_204, interval=300

5.2 Loon → Surge#

由于 Loon 和 Surge 格式高度相似，反向转换主要是：

将 [Remote Rule] 改回 [Rule] 中的 RULE-SET
将 [Plugin] 拆解为 [Rule] + [Rewrite] + [Script]
检查协议关键字是否兼容

1
# Loon 远程规则
2
[Remote Rule]
3
https://raw.githubusercontent.com/.../proxy.list, policy=Proxy
4

5
# 转换为 Surge 规则
6
[Rule]
7
RULE-SET,https://raw.githubusercontent.com/.../proxy.list,Proxy

六、策略组与分流规则转换注意事项#

6.1 策略组嵌套差异#

Surge 支持策略组嵌套（一个策略组引用另一个策略组），QX 和 Loon 也支持但语法不同：

1
# Surge 策略组嵌套
2
[Proxy Group]
3
Proxy = select, HK, US, JP
4
Streaming = select, Proxy, DIRECT
5
All = select, Proxy, Streaming, DIRECT
6

7
# QX 策略组嵌套
8
[policy]
9
static=Proxy, HK, US, JP
10
static=Streaming, Proxy, DIRECT
11
static=All, Proxy, Streaming, DIRECT
12

13
# Loon 策略组嵌套（与 Surge 一致）
14
[Proxy Group]
15
Proxy = select, HK, US, JP
16
Streaming = select, Proxy, DIRECT
17
All = select, Proxy, Streaming, DIRECT

6.2 正则表达式差异#

四款工具对正则表达式的支持程度不同：

特性	Surge	QX	Loon	Shadowrocket
URL 重写正则	✅ PCRE	✅ 有限	✅ PCRE	✅ 有限
域名正则匹配	❌ 不支持	✅ `host,regex,...`	❌ 不支持	❌ 不支持
User-Agent 正则	✅	✅	✅	✅
Rewrite 正则引擎	PCRE	JavaScript	PCRE	PCRE

⚠️ QX 的正则使用 JavaScript 引擎，与 Surge/Loon 的 PCRE 引擎在语法上有细微差异（如 lookahead/lookbehind 支持程度不同）。

6.3 规则优先级差异#

客户端	规则匹配顺序	注意事项
Surge	从上到下，先匹配先生效	`FINAL` 必须在最后
QX	从上到下，先匹配先生效	`final` 必须在最后；`filter_local` 优先于 `filter_remote`
Loon	`[Rule]` > `[Remote Rule]`	本地规则总是优先于远程规则
Shadowrocket	从上到下，先匹配先生效	`FINAL` 必须在最后

⚠️ Loon 特殊行为：Loon 的 [Remote Rule] 优先级低于 [Rule]。如果你在 [Rule] 中有一条 DOMAIN-SUFFIX,google.com,DIRECT，那么 [Remote Rule] 中任何匹配 google.com 的代理规则都不会生效。

七、Sub-Store：跨客户端规则统一管理方案#

7.1 Sub-Store 是什么？#

Sub-Store 是一款开源的高级订阅管理工具，支持 Quantumult X、Loon、Surge、Stash、Egern 和 Shadowrocket 六大客户端。它的核心价值是：一次配置，多端输出。

你只需要维护一份订阅源和规则集，Sub-Store 会自动转换为你需要的客户端格式。

7.2 部署方式#

方式	适用场景	难度
Loon/QX 内置运行	iOS 本地运行，无需服务器	⭐
Docker 部署	有 NAS/VPS 的用户	⭐⭐
Cloudflare Workers	免费 Serverless 部署	⭐⭐
Vercel 部署	免费 Serverless 部署	⭐⭐

Loon 内置运行配置：

1
# 在 Loon 的 [Plugin] 中添加
2
[Plugin]
3
https://raw.githubusercontent.com/sub-store-org/Sub-Store/master/config/Loon.plugin, tag=Sub-Store, enabled=true

QX 内置运行配置：

1
# 在 QX 的 [filter_local] 中添加
2
hostname *, sub.store
3

4
# 在 [general] 中添加
5
;Sub-Store 前端地址
6
sub_store_url = http://sub.store

7.3 核心使用流程#

1
┌─────────────────────────────────────┐
2
│           Sub-Store 工作流           │
3
├─────────────────────────────────────┤
4
│                                     │
5
│  1. 添加订阅源                       │
6
│     └─ 机场订阅链接 / 自建节点       │
7
│                                     │
8
│  2. 配置规则集                       │
9
│     ├─ 代理规则（Google/Netflix/...）│
10
│     ├─ 直连规则（国内域名/IP）       │
11
│     └─ 广告拦截规则                  │
12
│                                     │
13
│  3. 设置策略组                       │
14
│     ├─ 手动选择组                    │
15
│     ├─ 自动测速组                    │
16
│     └─ 故障转移组                    │
17
│                                     │
18
│  4. 生成输出                         │
19
│     ├─ Surge 格式 → Surge/Mac       │
20
│     ├─ QX 格式 → Quantumult X       │
21
│     ├─ Loon 格式 → Loon             │
22
│     └─ Shadowrocket 格式 → 小火箭    │
23
│                                     │
24
│  5. 在客户端中订阅 Sub-Store 输出链接 │
25
│                                     │
26
└─────────────────────────────────────┘

7.4 Sub-Store 规则集配置示例#

在 Sub-Store 后台中，你可以为每个输出配置不同的规则组合：

1
{
2
  "name": "我的Surge配置",
3
  "target": "Surge",
4
  "rules": [
5
    {
6
      "type": "remote",
7
      "url": "https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/rule/Surge/Google/Google.list",
8
      "tag": "Google",
9
      "policy": "Proxy"
10
    },
11
    {
12
      "type": "remote",
13
      "url": "https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/rule/Surge/Netflix/Netflix.list",
14
      "tag": "Netflix",
15
      "policy": "Streaming"
16
    },
17
    {
18
      "type": "remote",
19
      "url": "https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/rule/Surge/China/China.list",
20
      "tag": "China",
21
      "policy": "DIRECT"
22
    }
23
  ],
24
  "proxy_groups": [
25
    {
26
      "name": "Proxy",
27
      "type": "select",
28
      "proxies": ["HK", "US", "JP"]
29
    },
30
    {
31
      "name": "Streaming",
32
      "type": "select",
33
      "proxies": ["Proxy", "US", "JP"]
34
    },
35
    {
36
      "name": "Auto",
37
      "type": "url-test",
38
      "proxies": ["HK", "US", "JP"],
39
      "url": "http://www.gstatic.com/generate_204",
40
      "interval": 300
41
    }
42
  ]
43
}

7.5 Sub-Store 的优势#

优势	说明
一次配置多端输出	维护一套规则，自动生成 Surge/QX/Loon/Shadowrocket 格式
规则集远程同步	规则更新后所有客户端自动同步
策略组自动生成	根据订阅节点自动创建策略组
节点筛选与重命名	按关键词筛选节点，自动重命名
同步到 Gist	配置备份到 GitHub Gist，跨设备同步

八、在线转换工具#

除了 Sub-Store，还有一些在线工具可以实现快速格式转换：

8.1 subconverter（订阅转换器）#

subconverter 是最老牌的开源订阅转换工具，支持 Clash/Surge/QX/Loon/Shadowrocket 等多种格式互转。

在线使用：

1
# 将 Clash 订阅转换为 Surge 格式
2
https://sub.example.com/sub?target=surge&url=YOUR_SUBSCRIPTION_URL
3

4
# 将 Clash 订阅转换为 QX 格式
5
https://sub.example.com/sub?target=quanx&url=YOUR_SUBSCRIPTION_URL
6

7
# 将 Clash 订阅转换为 Loon 格式
8
https://sub.example.com/sub?target=loon&url=YOUR_SUBSCRIPTION_URL

常用公共前端：

前端	地址	说明
sub.tsutsu.one	`https://sub.tsutsu.one`	稳定，支持多格式
acl45c	`https://acl45c.vercel.app`	Vercel 部署
自建	Docker 部署 subconverter	最安全，推荐

⚠️ 安全提示：公共 subconverter 前端会获取你的订阅链接并解析，存在订阅泄露风险。建议自建或使用 Sub-Store 替代。

8.2 规则集格式转换#

如果只需要转换规则集（不含节点信息），可以使用以下方法：

方法 1：手动批量替换（VS Code）

在 VS Code 中打开规则文件，使用正则替换：

1
# 将 QX 格式转换为 Surge 格式
2
查找: ^host-suffix,
3
替换: DOMAIN-SUFFIX,
4

5
查找: ^host-keyword,
6
替换: DOMAIN-KEYWORD,
7

8
查找: ^host,
9
替换: DOMAIN,
10

11
查找: ^ip-cidr,
12
替换: IP-CIDR,
13

14
查找: ^geoip,
15
替换: GEOIP,
16

17
查找: ^final,
18
替换: FINAL,

方法 2：Python 转换脚本

1
#!/usr/bin/env python3
2
"""规则格式转换脚本：QX → Surge/Loon/Shadowrocket"""
3

4
import re
5
import sys
6

7
# QX → Surge 关键字映射
8
MAPPING = {
9
    r'^host-suffix,': 'DOMAIN-SUFFIX,',
10
    r'^host-keyword,': 'DOMAIN-KEYWORD,',
11
    r'^host,': 'DOMAIN,',
12
    r'^ip-cidr,': 'IP-CIDR,',
13
    r'^ip6-cidr,': 'IP-CIDR6,',
14
    r'^geoip,': 'GEOIP,',
15
    r'^user-agent,': 'USER-AGENT,',
16
    r'^final,': 'FINAL,',
17
}
18

19
def convert_qx_to_surge(input_file, output_file, action_case='upper'):
20
    """将 QX 规则转换为 Surge 格式
21

22
    action_case: 'upper' 将动作转为大写（Shadowrocket 用），'keep' 保持原样（Surge 用）
23
    """
24
    with open(input_file, 'r', encoding='utf-8') as f:
25
        content = f.read()
26

27
    for qx_pattern, surge_replacement in MAPPING.items():
28
        content = re.sub(qx_pattern, surge_replacement, content, flags=re.MULTILINE)
29

30
    if action_case == 'upper':
31
        # Shadowrocket 需要大写出站动作
32
        for action in ['proxy', 'direct', 'reject']:
33
            content = re.sub(
34
                rf',{action}\b',
35
                f',{action.upper()}',
36
                content,
37
                flags=re.IGNORECASE
38
            )
39

40
    with open(output_file, 'w', encoding='utf-8') as f:
41
        f.write(content)
42

43
    print(f"转换完成: {input_file} → {output_file}")
44

45
if __name__ == '__main__':
46
    if len(sys.argv) < 3:
47
        print("用法: python convert_rules.py <input.list> <output.list> [upper|keep]")
48
        sys.exit(1)
49

50
    case = sys.argv[3] if len(sys.argv) > 3 else 'keep'
51
    convert_qx_to_surge(sys.argv[1], sys.argv[2], case)

九、常见转换陷阱与 Debug 方法#

9.1 陷阱清单#

#	陷阱	影响	解决方案
1	大小写不一致	Shadowrocket 动作必须全大写，QX 部分大小写敏感	统一转换为对应客户端要求的大小写
2	逗号后空格	部分客户端对逗号后空格敏感	统一不加空格：`DOMAIN-SUFFIX,google.com,Proxy`
3	注释格式不同	Surge 用 `#`，QX 部分场景用 `;` 或 `//`	转换时检查注释符号
4	规则集 URL 格式	Surge/Loon 的远程规则引用格式不同	按目标客户端格式重写
5	策略组引用顺序	策略组必须在被引用之前定义	检查定义顺序，被引用的组放前面
6	正则引擎差异	QX 用 JS 引擎，Surge 用 PCRE	测试正则是否在目标客户端中正常工作
7	`no-resolve` 参数丢失	IP 规则未加 `no-resolve` 导致 DNS 泄露	转换时检查所有 IP-CIDR 规则
8	`PROCESS-NAME` 不兼容	QX/Shadowrocket 不支持进程名规则	删除或替换为域名规则
9	`USER-AGENT` 通配符	各客户端对 `*` 和 `?` 的支持不同	测试 User-Agent 规则是否正常匹配
10	FINAL 规则缺失	忘记添加兜底规则导致未匹配流量直接断开	确保转换后末尾有 FINAL/final 规则

9.2 Debug 方法#

方法 1：逐步排查法

当转换后规则不生效时，按以下步骤排查：

1
Step 1: 检查配置是否被客户端正确加载
2
  └─ 在客户端中查看规则列表是否完整
3

4
Step 2: 检查规则格式是否正确
5
  └─ 逐行检查关键字、大小写、逗号格式
6

7
Step 3: 检查规则顺序
8
  └─ 确保高优先级规则在前，FINAL 在最后
9

10
Step 4: 检查策略组是否正确定义
11
  └─ 确保规则中引用的策略组名与定义一致
12

13
Step 5: 使用客户端的调试工具
14
  ├─ Surge: Dashboard → 请求查看器
15
  ├─ QX: 网络活动 → 请求详情
16
  ├─ Loon: 日志 → 测试请求
17
  └─ Shadowrocket: 当前连接 → 查看匹配规则

方法 2：在线规则测试

在 browserling.com 或本地使用正则测试工具验证规则匹配逻辑。

方法 3：最小化测试

创建一个只包含 3-5 条规则的测试配置，验证基本功能后再逐步添加完整规则集。

9.3 常见错误对照表#

错误现象	可能原因	修复方法
导入后所有流量走直连	FINAL 规则指向了 DIRECT 或策略组名为空	检查 FINAL 规则和策略组名
导入后所有流量走代理	直连规则未正确转换或缺失	检查 GEOIP,CN,DIRECT 等直连规则
特定网站无法访问	规则匹配冲突或正则错误	用客户端调试工具查看该网站的匹配规则
部分规则不生效	大小写不一致或格式错误	逐行检查不生效的规则格式
策略组无法切换节点	策略组定义语法错误	检查策略组定义是否符合目标客户端语法
配置导入报错	配置文件结构不完整	检查必需的配置段是否存在

十、推荐规则集仓库#

以下仓库提供多格式规则集，可直接引用或转换使用：

仓库	格式支持	说明
blackmatrix7/ios_rule_script	Surge/QX/Loon/Shadowrocket	最全的多格式规则集，按平台分类
Hackl0us/SS-Rule-Snippet	Surge/QX/Loon	经典规则集，定期更新
Loon0x00/Loon-Plugin	Loon 专属	Loon 官方插件仓库
chavyleung/scripts	QX/Surge/Loon	签到脚本 + 规则
NobyDa/Script	QX/Surge/Loon	去广告 + 重写规则

总结：选择适合你的方案#

你的情况	推荐方案
只需要转换一次，从 Surge 迁到 QX/Loon	手动转换 + 在线 subconverter
多设备多客户端长期使用	Sub-Store（最佳方案）
只需要共享规则给朋友	手动转换或 Python 脚本
需要频繁更新规则集	Sub-Store + GitHub Gist 同步
不想折腾，开箱即用	使用 blackmatrix7 仓库的对应格式规则集

核心建议：

优先使用 Sub-Store：如果你同时使用多款 iOS 代理工具，或者频繁切换客户端，Sub-Store 是唯一的一劳永逸方案
统一规则源：无论用哪种方案，始终从同一个规则仓库（如 blackmatrix7）获取规则，避免格式混乱
转换后必须测试：每次转换后，用客户端的调试工具验证关键规则是否正常匹配
保留原始配置备份：转换前务必备份原始配置文件，以便回滚

📌 本文基于 Surge 6 / Quantumult X 1.2.x / Loon 3.x / Shadowrocket 2.2.x 版本编写。各工具持续更新，具体语法请以最新版官方文档为准。