跳转至

7. 重写[rewrite]

注意

以下主要讲的是 [rewrite_local]、[rewrite_remote] 或 [mitm] 区块下的内容，所以示例都以 [rewrite_local]、[rewrite_remote] 或 [mitm] 开头表明在其之下，并不是让你每个参数字段前都加上 [rewrite_local]、[rewrite_remote] 或 [mitm]。

以 ; 或 # 或 // 开头的行为注释行。

7.1 添加本地重写

警告

所有的HTTPS解密、重写(rewrite)和中间人攻击(MitM)，均需安装&信任根证书。

7.1.1 重写类型

以下内容搬运至QX示例配置文件

  • reject返回 HTTP 状态代码 404，没有任何内容。
  • reject-200 返回 HTTP 状态代码 200，没有内容。
  • reject-img 返回 HTTP 状态代码 200，内容为 1px gif。
  • reject-dict 返回 HTTP 状态代码 200，内容为空 json 对象。
  • reject-array 返回 HTTP 状态代码 200，内容为空 json 数组。
  • request-header 适用于所有 http 标头，而不仅仅是一个标头，因此您可以在一个正则表达式中匹配两个或多个标头（包括 CRLF）。
  • 如果 rewrite 与正文相关，则与长度和编码相关的 HTTP 标头字段将由 Quantumult 自动处理，因此您不应自行处理它们。 响应正文和脚本响应正文支持的最大响应大小为 1024kB（解压缩）。
  • 如果body为空，则不会执行body相关的重写。
  • 在重写中使用 javascript 时，可以使用以下对象：$request、$response、$notify(title, subtitle, message)、console.log(message) 和 Quantumult 的内置对象都有前缀$。
  • 支持：$request.scheme、$request.method、$request.url、$request.path、$request.headers、$response.statusCode、$response.headers、$response.body
  • 如果启用了 Quantumult 通知，$notify(title, subtitle, message) 将发布 iOS 通知。
  • $prefs 用于持久存储：$prefs.valueForKey(key)、$prefs.setValueForKey(value, key)、$prefs.removeValueForKey(key)、$prefs.removeAllValues()。
  • 如果日志级别为debug，console.log(message) 会将日志输出到 Quantumult 日志文件。
  • setTimeout(function() { }, Interval) 将在interval(ms)后运行函数。
  • script-request-header、script-request-body、script-response-header、script-response-body 和 script-echo-response 的脚本应保存在本地我的iPhone - Quantumult X - Scripts或iCloud Drive - Quantumult X - 脚本。
  • 示例可以在 crossutility/Quantumult-X 找到。

7.1.2 配置文件添加

以下为重写在配置文件中的写法

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
[rewrite_local]
;^http://example\.com/resource1/1/ url reject
;^http://example\.com/resource1/2/ url reject-img
;^http://example\.com/resource1/3/ url reject-200
;^http://example\.com/resource1/4/ url reject-dict
;^http://example\.com/resource1/5/ url reject-array
;^http://example\.com/resource2/ url 302 http://example.com/new-resource2/
;^http://example\.com/resource3/ url 307 http://example.com/new-resource3/
;^http://example\.com/resource4/ url request-header ^GET /resource4/ HTTP/1\.1(\r\n) request-header GET /api/ HTTP/1.1$1
;^http://example\.com/resource4/ url request-header (\r\n)User-Agent:.+(\r\n) request-header $1User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36$2
;^http://example\.com/resource5/ url request-body "info":\[.+\],"others" request-body "info":[],"others"
;^http://example\.com/resource5/ url response-body "info":\[.+\],"others" response-body "info":[],"others"
;^http://example\.com/resource6/ url script-response-body response-body.js
;^http://example\.com/resource7/ url script-echo-response script-echo.js
;^http://example\.com/resource8/ url script-response-header response-header.js
;^http://example\.com/resource9/ url script-request-header request-header.js
;^http://example\.com/resource10/ url script-request-body request-body.js

[mitm]
hostname = example.com

以和风天气去广告为例子: 

1
2
3
4
5
6
[rewrite_local]
# 和风天气
^https:\/\/hfapp-service\.qweather\.net\/v2\.0\/app\/ad\/list\? url reject-dict

[mitm]
hostname = hfapp-service.qweather.net

可以将对应的规则复制粘贴到配置文件对应的部分：

注意主机名hostname的部分不要重复出现：

当然也可以通过UI添加：

注意：URL部分只需要填写以下部分，无需填写url

1
^https:\/\/hfapp-service\.qweather\.net\/v2\.0\/app\/ad\/list\?

7.1.3 配置片段添加

以和风天气为例，配置片段添加内容无需带有 [rewrite_local] [mitm]等字段

此方法即可将本地内容作为远程资源添加，只不过资源路径是在本地的文件

1
2
3
4
# 和风天气
^https:\/\/hfapp-service\.qweather\.net\/v2\.0\/app\/ad\/list\? url reject-dict

hostname = hfapp-service.qweather.net

Tips:本地重写需配置脚本

有部分重写资源，需要自行配置重写规则所使用的脚本文件(.js)

以Spotify翻译@app2smile为例(仅做演示，Spotify翻译有跟简单的方法)：

注册百度翻译个人开发者: http://api.fanyi.baidu.com/register

注册后如果需要认证可自行选择是否实人认证(高级版需要验证)

开通(通用翻译)API服务: https://fanyi-api.baidu.com/choose

成功后即可看到自己的appid和密钥(不要泄露给任何人): http://api.fanyi.baidu.com/manage/developer

1.Quantumult X其他设置中，打开 iCloud云盘 ；确保已开启 mitm 重写 并 信任安装了证书

2.打开歌词翻译脚本(.js)地址，并一键复制

当然，你也可以将脚本下载到iCloud云盘 ▸ Quantumult X ▸ Scripts文件目录，点击脚本即可在跳转 Quantumult X 编辑

注意：建议打开「文件」的「显示所有拓展名」，防止出现 Spotify-lyric.js.js 这种问题

3.打开 HTTP 请求，点击右下角的脚本编辑器，将复制到的脚本内容「覆盖」

4.配置重写

注意：Spotify-lyric.js的名称要与上面填写的一致 

1
2
3
4
[rewrite_local]
^https:\/\/spclient\.wg\.spotify\.com\/color-lyrics\/v2\/track\/ url script-response-body Spotify-lyric.js
[mitm]
hostname = spclient.wg.spotify.com

7.2 添加远程重写

警告

所有的HTTPS解密、重写(rewrite)和中间人攻击(MitM)，均需安装&信任根证书。

7.2.1 配置文件添加

远程重写在 配置文件[rewrite_remote] 下添加：

1
2
[rewrite_remote]
https://example.com/rewrite.conf, tag=🛡️ Block Ads, update-interval=172800, opt-parser=true, inserted-resource=true, enabled=true
也就是说一条完整的远程重写配置是这么组成的：

<资源路径>, <资源标签>, <自动更新时间间隔>, <是否使用资源解析器>, <插入资源>, <是否启用>

  • tag 资源标签：相当于名称，标识这条远程分流文件的作用；

  • update-interval 自动更新的时间间隔，单位为秒；

  • opt-parser 是否使用资源解析器，若关闭则改为 false；

  • inserted-resource 插入资源，将重写文件中的规则放置于本地规则之前；

  • enabled 是否启用该重写资源文件，若不使用可改为 false；

远程重写通常配置好了主机名hostname，因此大多数是无需自行填写

7.2.2 UI添加

资源路径需填写引用的远程重写规则地址（需使用 raw 格式地址）。

资源路径需要使用raw地址，点击查看获取方法

以下方的链接举例(这是个网页，不是真正能使用的资源链接)：

https://github.com/blackmatrix7/ios_rule_script/blob/master/rule/QuantumultX/12306/12306.list

例如在末尾添加?raw=ture：

https://github.com/blackmatrix7/ios_rule_script/blob/master/rule/QuantumultX/12306/12306.list?raw=ture

或者直接点击raw或者view，⁠使用跳转后的链接：

https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/rule/QuantumultX/12306/12306.list

或者将链接里的blob⁠修改为raw：

https://github.com/blackmatrix7/ios_rule_script/raw/master/rule/QuantumultX/12306/12306.list

「资源解析器」：是对引用的资源文件内容(远程or配置片段)，进行解析/转换/修改，变成 Quantumult X 支持的内容，可用在Quantumult X 的三个主要模块：①节点 ②分流 ③重写，具体使用说明见解析器下方教程；

如果你的资源解析器是空的，点击查看添加方法

如果你的解析器是空的，「节点页」点击左下角的编辑按钮，需要在 [general] 区块下添加：

1
resource_parser_url=https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js

当使用非标准 Quantumult X 的重写时，例如一些脚本.js、其他软件的模块.sgmodule、插件.plugin⁠等，这些里面都包含有重写规则，可开启解析器使其变为 Quantumult X 支持的格式；但这并不意味着上述格式的文件在开启解析器后一定可用。需要自行鉴别。

✅ Surge模块(主要内容为重写规则)：https://raw.githubusercontent.com/Keywos/rule/main/module/weibous.sgmodule

✅ 包含重写规则的脚本(.js)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
/* 

Lento  

# 带有重写规则和主机名
[rewrite_local]
https://lentoapp.com:8081/getUserMemberShipInfo url script-response-body https://raw.githubusercontent.com/Yu9191/Rewrite/main/Lento.js

[MITM]

hostname = lentoapp.com:8081

*/

let obj = {
  "meta" : {
    "message" : "获取作者信息成功",
    "code" : 200
  },
  "data" : {
    "paytype" : 1,
    "expiretime" : "null"
  }
}

$done({ body: JSON.stringify(obj), status: 200 });

❌ 重写使用的脚本，不包含重写规则：https://raw.githubusercontent.com/RuCu6/QuanX/main/Scripts/12306.js

7.2.3 远程重写资源更新与重写细则查看

  • 默认自动更新时间为48小时，需打开QX才可自动更新；

  • 可以更改配置文件中的update-interval参数，单位为秒(S)，修改为-1即为不更新

  • 左滑重写资源可以单独更新，并查看其细则