外观
安装 omv-extras
完成后，系统 菜单下多出 omv-extras 页面，系统 → 插件（System → Plugins）里多出约 40 个社区维护的插件：Compose、内核、ZFS、mergerfs、SnapRAID、备份、Fail2ban、writecache 等。
适合谁
- 用 ISO 装的 amd64 OMV，只有官方的基础插件。要用上面这些，就得装 omv-extras。
- 用脚本方式装的系统（树莓派、Armbian 开发板、omv-extras 的 installScript 脚本）已经自带 omv-extras，不用再装，这是 wiki 的说明。
插件信息
| 项 | 内容 |
|---|---|
| 包名 | openmediavault-omvextrasorg |
| 来源 | omv-extras 社区，主要维护者 Aaron Murray |
| OMV 8 状态 | 截至 2026-10-22，omv-extras 的 synchrony 软件源为 8.0.4（amd64、arm64） |
| 菜单位置 | 系统 → omv-extras（System → omv-extras），官方中文界面里这个菜单名不翻译 |
| 依赖 | 只依赖 openmediavault 8 以上和 gnupg。Compose 插件依赖它，卸载它会连带卸载 Compose |
装它，等于把 root 权限交给 omv-extras 的维护者
安装做了两件有信任含义的事：以 root 执行从 GitHub 下载的脚本；给系统加一个 APT 软件源和签名公钥。此后所有 omv-extras 插件和它们的更新都来自这个源，包里的安装脚本也以 root 运行。你信任的是 omv-extras 的维护者和它的 GitHub 仓库。
- 只从 omv-extras 官方 wiki 或它的 GitHub 仓库（
packages）取命令。不要照抄论坛帖子或第三方教程里的地址，地址一旦被替换，你交出去的就是 root。 - 装之前做一次系统盘备份，虚拟机就先打快照。
开始之前
- OMV 8，能联网访问 GitHub。OMV 8 只支持 amd64 和 arm64，脚本在其他架构上会直接退出。
- 一个 root 的 shell：用 root 登录 SSH，或者用本机控制台。如果你日常用的是带 sudo 的普通用户，先
sudo -i变成 root，再执行下面的命令，不要在每条命令前单独加sudo。
方法一（推荐）：先下载、读一遍、再执行
官方给的是一行命令，下载后直接交给 bash，中间没有任何检查。更稳妥的是拆成三步：
sh
# 在 OMV 的 shell 里，以 root 身份
mkdir -p /root/omv-extras-install && cd /root/omv-extras-install
wget -O install.sh https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install
less install.sh用 less 通读一遍，按 q 退出。脚本不长，读它是为了确认它和下面说的一致。确认后再执行：
sh
# 在 OMV 的 shell 里，以 root 身份
bash install.sh按脚本源码，它依次做这些事（本站读过源码，没有执行它）：
- 必须是 root，否则报
This script must be executed as root or using sudo.并退出。 - 检查 CPU 架构，读出已装
openmediavault的主版本号，主版本小于 6 就退出。 - 删掉旧的
omvextras.list；如果系统缺 Debian 的main或updates软件源，在/etc/apt/sources.list末尾补上。 apt-get update，安装gnupg。- 从同一个 GitHub 仓库下载
openmediavault-omvextrasorg_latest_all8.deb，用dpkg -i安装，依赖不满足就apt-get -f install。 - 再
apt-get update，最后提示登录 Web 界面后按Ctrl+Shift+R。
脚本没有校验下载下来的 .deb，信任来自 HTTPS 和 GitHub 仓库本身。这个 .deb 安装时会生成 omv-extras 的软件源和密钥（调用 omv-aptclean repos）。
官方 wiki 和 packages 仓库 README 给的一行写法，等价于上面三步合成一步：
sh
# 在 OMV 的 shell 里，以 root 身份
wget -O - https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/install | bashREADME 还给了不切换 root、全程用 sudo 的写法，并提示第一次用 sudo 不会出现密码提示。有用户在论坛报告，OMV 8 上用 sudo 方式安装失败，换成 root 登录后成功（论坛说法，本站未核实），所以优先用 root。
方法二：用计划任务运行（wiki 的另一种方式）
没有 SSH 客户端时，可以用 OMV 的计划任务把同一条命令跑一次：
系统 → 计划任务（System → Scheduled Tasks）→ 创建。- 取消勾选已启动，这个任务只手动运行一次。用户保持
root，命令填上面那条官方一行命令。保存。 - 点黄色提示条上的应用。这一步不能省：任务脚本在应用时才生成，没应用就点运行，会报配置尚未应用的错误。wiki 没写这步。
- 选中这个任务，点运行（Run）。会弹出运行计划任务对话框并开始执行，等输出结束再点关闭。
- 删除这个任务，再应用一次。
这种方式看不到脚本内容，也就失去了「先读一遍」的机会，只在不得已时用。wiki 提醒：装完可能要重启一次，系统 菜单下才会出现 omv-extras。
安装之后
- 硬刷新浏览器（
Ctrl+Shift+R，macOS 用Cmd+Shift+R）。 - 进入
系统 → 插件，点检查是否有新插件...。列表里会多出许多插件，从openmediavault-anacron开始。 系统菜单下出现 omv-extras。没出现就再硬刷新，或者重启一次。
系统 → omv-extras 页面
这个页面只有一个复选框和一排按钮：
| 控件 | 做什么 |
|---|---|
| Docker 源（Docker repo），默认关 | 勾选并保存后，加入 Docker 官方 APT 源。保存时会同步执行 omv-aptclean repos，成功提示「已更新 omv-extras 设置」。Compose 插件需要它，装 Compose 时会自动启用，一般不用手动勾 |
| apt clean | 清除 apt 的缓存和软件包列表，重新下载列表并重建插件索引。软件源出现缓存问题时用，需要联网 |
| 清理源（apt clean repos） | 在 apt clean 的基础上，重写 omv-extras 和 Docker 的软件源与密钥文件 |
| 启用 backports / 停用 backports | 开关 Debian backports 的内核与固件源，见下文 |
| 维基（Wiki） | 打开 omv-extras wiki 的页面。截至 2026-10-23，它指向的 omv8:omv8_plugins:omv-extras 页面还不存在 |
| Docker 维基（Docker Wiki） | 打开 wiki 里的 Docker in OMV 8 |
backports 开关管什么
OMV 核心默认开着 Debian backports 的内核和固件源，环境变量是 OMV_APT_USE_KERNEL_BACKPORTS，默认开启，所以不用额外操作就能拿到较新的 Debian 内核。这两个按钮改的就是它：执行 omv-changebackports，删除 /etc/apt/sources.list 里含 trixie-backports 的行，改写这个环境变量，重新部署 apt 配置，再整理软件源。
开启时，omv-extras 还会让 zfs-linux、libvirt、qemu、seabios 优先用 backports 版本。这个开关只影响以后更新能看到哪些版本，不会立刻卸掉已装的包。用 ZFS 或 KVM 插件时没有特殊原因不要动它。装 Proxmox 内核是另一回事，见内核插件。
它管理的文件
保存或点按钮时，omv-extras 会重写这些文件，不要手改：
/etc/apt/sources.list.d/omvextras.sources：omv-extras 软件源，Suites是 OMV 的代号synchrony，地址是一个镜像列表（GitHub Pages 和 omv-extras.org 两个地址，前者优先）。/usr/share/keyrings/omvextras.gpg：签名公钥。/etc/apt/preferences.d/omvextras.pref：backports 开启时的优先级设置。- 勾选 Docker 源时的
omvdocker.sources和docker.gpg。
点「清理源」之前
按脚本源码，清理源（以及保存 omv-extras 页面、Compose 的 preinst）会删除 /etc/apt/sources.list.d/ 里内容含 docker 的文件，只有勾选了Docker 源才会重建。你自己手动加过 Docker 官方源的话，别点它。这是读源码得出的，本站未在实机验证。
卸载 omv-extras
卸载会删除 /etc/apt/ 下所有 omvextras*、omvdocker* 文件和两个密钥文件，purge 还会清除它在 OMV 数据库里的设置。更要紧的是：Compose 依赖它，卸载它会连带卸载 Compose 以及依赖 Compose 的插件，见安装、更新与卸载插件。没有明确理由，不要卸。
检查结果
系统菜单下有 omv-extras；系统 → 插件里能看到openmediavault-compose、openmediavault-kernel等 omv-extras 插件。- 在 OMV 的 shell 里确认软件源（只读）：
sh
# 在 OMV 的 shell 里，以 root 身份
cat /etc/apt/sources.list.d/omvextras.sources
apt-cache policy openmediavault-compose第一条应看到 Suites: synchrony 和 Signed-By: /usr/share/keyrings/omvextras.gpg，第二条的候选版本应来自 omv-extras 的软件源。
常见问题
脚本提示 This script must be executed as root or using sudo。 当前不是 root。先 sudo -i，或者直接用 root 登录。
提示 Unsupported architecture 或 Unsupported version of openmediavault。 架构不是 amd64、arm64 等被支持的类型，或者 OMV 主版本小于 6。OMV 8 只支持 amd64 和 arm64。
提示 Unable to install prerequisites，或者 apt-get update 报错。 这是软件源或网络问题：DNS、代理、Debian 镜像。先按软件源、国内镜像与第一次更新把系统的 apt 修好。
提示 There was a problem downloading the package。 访问不了 GitHub。在网络条件不稳定的地区，先在 shell 里设置好 https_proxy 环境变量再运行，或者先解决网络。
装完 系统 → 插件 里还是没有 omv-extras 的插件。 点检查是否有新插件...。仍然没有，就在 系统 → omv-extras 点清理源，再检查一次；注意上面关于 Docker 源的警告。
界面上没有 omv-extras 菜单。 硬刷新，或者重启一次。
参考资料
- omv-extras wiki：OMV-Extras 安装页（页面标题仍写 OMV5、6、7，命令通用）、新手指南 里的 OMV-Extras 一节。
packages仓库：安装脚本与 README。- omv-extras 插件源码：openmediavault-omvextrasorg（
omv-aptclean、omv-changebackports）。 - OMV 源码：
Cron::execute（计划任务必须先应用才能运行）、10default.sls（backports 默认开启）。