> For the complete documentation index, see [llms.txt](https://qx.atlucky.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qx.atlucky.me/shi-yong-fang-fa/pei-zhi-wen-jian-xiang-jie/zhong-xie-rewrite/rewrite_remote.md).

# rewrite\_remote

### 文本格式

通过重写中的规则资源添加的引用资源，保存在配置文件的\[rewrite\_remote]字段下，在配置文件中的格式为：

#### 配置文件`⁠rewrite_remote⁠`(远程重写)的写法

以下为配置文件`⁠rewrite_remote`⁠(即远程重写部分)的写法

```
[rewrite_remote]
https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-import-rewrite.txt, tag=Sample, enabled=true, update-interval=86400, opt-parser=true
```

配置文件中一条完整的远程重写配置是这么组成的：

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

* **`tag`** 资源标签：相当于名称，标识这条远程重写文件的作用；
* **`update-interval`** 自动更新的时间间隔，单位为秒；
* **`opt-parser`** 是否使用资源解析器，若关闭则改为 `false`；
* **`enabled`** 是否启用该分流文件，若不使用可改为 `false`；

### 添加方式

* 找到重写文件的`RAW格式`链接，复制链接→设置里面的重写下的规则资源里面的资源路径，写好标签，必要时开启资源解析器，保存。<br>
* 受益于[@KOP-XIAO](https://github.com/KOP-XIAO/QuantumultX/blob/master/Scripts/resource-parser.js)的资源解析器，使用非标准QuantumultX的重写时(例如一些脚本`.js`、其他软件的模块`.sgmodule`、插件`.plugin`⁠等，这些里面都包含有重写规则)，可开启解析器使其变为QX支持的格式，但这并不意味着上述格式的文件在开启解析器后一定可用。
* 只要用到QX的重写，[@KOP-XIAO](https://github.com/KOP-XIAO/QuantumultX/blob/master/Scripts/resource-parser.js) 的资源解析器是避不开的一环，后面有对应的章节进行详解用法。见[资源解析器的作用与详解](/shi-yong-fang-fa/jie-xi-qi-de-zuo-yong-yu-xiang-jie.md)

<figure><img src="/files/buZABodRvyqwtclEiTRS" alt=""><figcaption></figcaption></figure>

### 重写远程资源路径中添加的一般为以下几种格式：

* xxxxx.snippet（本地的配置片段）
* <https://raw.githubusercontent.com/xxxxxx/xxxxx/main/xxxxxx.snippet(远程配置片段)>
* <https://raw.githubusercontent.com/xxxxxx/xxxxx/main/xxxxxx.conf(远程重写配置)>
* <https://raw.githubusercontent.com/xxxx/master/xxxxx.qxrewrite(远程重写配置)>
* <https://raw.githubusercontent.com/xxxx/xxxx/master/xxxxx.js(远程脚本，这种是**必须**搭配**对应本地重写**URL和hostname)----（**⚠️注意，这个其实是本地重写，只是引用的脚本在远程**）>
* <https://raw.githubusercontent.com/xxxx/xxxx/main/xxxx.sgmodule（Surge模块，需搭配解析器>)

{% hint style="warning" %}
千万别 直接把js脚本链接直接丢进rewrite引用，然后还跑来问“怎么报错？”&#x20;

同时，放对位置后，需要去 rewrite\_local里添加引用
{% endhint %}

见下图示例：

<figure><img src="/files/GCJx7hFNEh28OeLlMiQi" alt=""><figcaption><p>常见的重写格式</p></figcaption></figure>

###

{% hint style="warning" %}
虽然有资源解析器，可以往重写资源中添加很多类型的链接，但并不是什么都能加进去并起作用的！

建议添加前仔细阅读相关说明和添加方法！
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://qx.atlucky.me/shi-yong-fang-fa/pei-zhi-wen-jian-xiang-jie/zhong-xie-rewrite/rewrite_remote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.