内置插件
Motrix 自带三个官方插件，装好就已经启用。它们负责给下载好的文件改名、在「下载链接」其实是一个网页时找出真正的文件链接，以及为其他插件提供一套通用的媒体链接解析能力。每个插件都可以在左侧边栏的 「插件」 页里调整设置或关掉。
内置插件可以关闭，但不能卸载——它们没有 「卸载」 按钮。
快速了解
| 插件 | 作用 | 你可以改什么 |
|---|---|---|
| Motrix 文件名模板 | 下载完成时按你写的模板给文件改名 | 模板本身 |
| Motrix 页面抓取 | 发现链接打开的是网页而不是文件时，改为下载页面里指向的那个文件 | 开关，以及允许读取的页面大小上限 |
| Motrix URL 解析器 | 供其他插件复用的底层能力，用来把媒体页面链接换成文件链接 | 首选清晰度 |
打开 「插件」，点进某个插件，会看到四处地方：「概览」、「设置」、「权限」，以及右侧那个小卷轴图标背后的 「日志」。在 「设置」 里改的内容，点 「应用」 才会保存；点 「重置」 可以恢复默认值。
Note
三个插件里有两个——文件名模板和页面抓取——会被标为 「需要确认」，「权限」 页里还有一条红色的 「广泛主机访问」 提示。这是正常的：下载可能来自任何网站，所以这两个插件没法只绑定固定几个站点。它们都由 Motrix 团队开发，随应用一起发布。
Motrix 文件名模板
下载回来的文件常常叫 dl_38fa20b.zip 或者 download.php。这个插件会在下载完成的那一刻，按你写好的模板给文件改名。改名发生在文件放入下载目录之前，所以那串乱名字你根本不会看到。
模板只负责文件名主体，扩展名会自动帮你接回去——这也是默认模板 {{title}} 的效果等于「保持原样」的原因。
占位符
{{ }} 里的内容会被替换成这个下载任务的实际值。
| 占位符 | 替换为 |
|---|---|
{{title}} | 不含扩展名的原文件名 |
{{original}} | 包含扩展名的完整原文件名 |
{{ext}} | 不含开头点号的原扩展名 |
{{date}} | 任务创建日期，格式为 YYYY-MM-DD |
{{time}} | 任务创建时间，格式为 HH-mm-ss |
{{id}} | 下载任务 ID |
{{host}} | 文件来源的主机名，例如 www.example.com |
{{domain}} | 去掉开头 www. 的同一个主机名 |
{{urlPath}} | 解码后的来源链接路径 |
{{createdBy}} | 任务的创建方式：user、protocol 或 api |
{{meta.key}} | 其他插件写入任务的元数据值，支持 {{meta.show.season}} 这样的嵌套键 |
自定义日期和时间
{{date}} 和 {{time}} 支持在冒号后写格式，例如 {{date:YYYYMMDD}}、{{time:HH-mm}}，也可以混搭成 {{date:YYYY/MM}}。可用的格式标记有：
| 标记 | 含义 |
|---|---|
YYYY | 四位年份 |
MM | 两位月份 |
DD | 两位日期 |
HH | 两位小时，24 小时制 |
mm | 两位分钟 |
ss | 两位秒 |
过滤器
在占位符后面加 |，就能对取到的值做进一步处理。过滤器可以从左到右串联使用。
| 过滤器 | 作用 |
|---|---|
trim | 删除首尾空白 |
lower | 全部转为小写 |
upper | 全部转为大写 |
slug | 生成小写、连字符分隔的名称 |
truncate:N | 最多保留 N 个字符 |
replace:"旧值":"新值" | 把所有匹配到的文本替换掉 |
default:"默认值" | 占位符取到的是空值时，用默认值填上 |
pad:N | 在左侧补零，直到长度为 N |
示例
以下每一行都以 2026 年 8 月 18 日从 www.example.com 下载的 Vacation Photos.zip 为例：
| 模板 | 保存为 |
|---|---|
{{date}} {{title}} | 2026-08-18 Vacation Photos.zip |
{{date:YYYYMMDD}}-{{domain}}-{{title|slug}} | 20260818-example.com-vacation-photos.zip |
{{meta.artist|default:"Unknown"|slug}}-{{title|slug}} | unknown-vacation-photos.zip |
最后一行是使用其他插件元数据的安全写法：元数据可能存在也可能不存在，default 会把空缺填上，而不是留下一个孤零零的连字符。
设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 「文件名模板」 | {{title}} | 文件名主体的模板，原扩展名会自动保留 |
一些细节
- 对 HTTP、FTP 和 BitTorrent 下载都生效。
- 复合扩展名会完整保留：
.tar.gz、.tar.bz2、.tar.xz、.tar.zst、.tar.lz、.tar.lzma、.user.js、.min.js、.min.css、.d.ts、.d.mts和.d.cts。 - 文件系统不接受的字符——
/ \ < > : " | ? *、控制字符，以及不可见的文字方向控制字符——都会替换成_。CON、COM1这类 Windows 保留名会在前面加一个下划线，末尾的空格和点号会被去掉。整个文件名最长 240 个 UTF-8 字节，而且被截断的永远不会是扩展名。 - 正因为
/属于上述字符，{{urlPath}}里的斜杠最终都会变成下划线。 - 模板写错时——用了不存在的占位符或过滤器、
{{没有闭合、过滤器少了参数——插件不会改名，而是保留原文件名，并把原因写进 「日志」。改名没生效时，先去那里看一眼。 - 模板最长 512 个字符。
Motrix 页面抓取
有些「下载」按钮指向的其实是一个网页，而不是文件本身。不加干预的话，Motrix 会老老实实把这个网页存成一个没用的 .html 文件。
新建 HTTP 下载时，这个插件会先向服务器确认链接另一端是什么。如果确认是 HTML 页面，它就读取这个页面，找出第一个以 .zip、.tar.gz、.tgz、.rar、.7z、.exe、.dmg、.iso 或 .pkg 结尾的链接。找到了，Motrix 就改为下载它：
你添加的链接: https://example.com/downloads.html
实际下载的链接: https://example.com/files/app-2.3.1.dmg设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 「启用」 | 开 | 是否扫描下载页面 |
| 「最大页面体积」 | 524288 字节（512 KiB） | 页面超过这个体积就不再读取。可填 4096 到 2097152 之间的任意值。 |
一些细节
- 直接指向文件的链接完全不受影响。只有服务器自己表明链接是 HTML 页面时，插件才会去读。
- 它只取页面上第一个匹配的链接，而且只处理任务的第一条链接。
- 如果页面打不开，或者页面里没有受支持类型的链接，Motrix 会照原链接下载。
- 每次链接替换都会记录进 「日志」，新旧链接并列显示——下载跑到意料之外的地方时，先看这里。
Important
这就是 「权限」 页里提示 「广泛主机访问」 的那个插件，而这条提示是实话：下载页面可能在任何网站上，所以它的权限范围无法收窄。它实际做的事，只是去取你添加的那一条链接。如果你不接受这个取舍，把插件关掉即可——之后 Motrix 会按原链接直接下载这类地址。
Motrix URL 解析器
这个插件更像是底层能力，而不是一个你会直接用到的功能。它为各网站的解析插件提供一套通用机制，把媒体页面链接换成 Motrix 真正该下载的文件链接，并提供一个所有解析插件都能读取的清晰度偏好。
开箱状态下它只认识一个网站：Wikimedia Commons。粘贴 https://commons.wikimedia.org/wiki/File:… 这样的链接，Motrix 会向 Commons 查询原始文件的地址，然后下载文件本身，而不是保存网页。这个解析器的作用是演示整套机制确实能跑通。
Important
其他网站的支持来自你自行安装的 site-resolver 插件。Motrix 不内置任何视频网站的解析器，启用这个插件也不会带来这类能力。当已安装的解析器都不认识某条链接时，Motrix 会完全按你输入的地址下载。
设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 「首选清晰度」 | 720p | site-resolver 插件优先请求的清晰度：1080p、720p 或 480p |
这只是一个转达给 site-resolver 插件的偏好，不是保证。内置的 Wikimedia Commons 解析器始终取原始文件，所以在你安装会读取这个偏好的解析器之前，这项设置不起作用。
内置插件如何更新
内置插件各自带版本号，不必等 Motrix 发新版就能更新。每次更新都是一个由 Motrix 团队签名的插件包，Motrix 会先验证签名再安装。
在桌面版里打开某个插件，看它标签栏右侧的按钮：
- 那个环形箭头按钮是 「检查更新」。
- 有更新等着时，这个按钮会变成 「更新到 v…」，同时列表里该插件的卡片上会出现 「可更新」 标记。
点下去，Motrix 就开始安装。如果新版本申请了旧版本没有的权限，会弹出 「更新内置插件」 对话框，在 「此更新请求了新的访问权限：」 下逐条列出变化，等你选择 「安装」 还是 「取消」——更新永远不会在你不知情的情况下扩大插件的权限范围。安装完成后，你可能会看到 「更新已安装，重启 Motrix 后完全生效。」
改主意了？当某个插件正运行着它自己拉取的更新时，旁边会出现一个撤销按钮：「还原为内置版本」 会把 Motrix 安装包里自带的那一份换回来。
Note
这些更新控件属于桌面版。Docker 和服务器版的内置插件来自镜像，要更新它们就得更新镜像。