跳转到内容

插件体系:官方插件、omv-extras 与容器 ​

完成后,你清楚 OMV 里「加功能」有哪三种方式、各由谁维护,遇到一个想装的东西,能判断它的来源、在 OMV 8 上能不能装、出了问题该找谁。

三种来源 ​

官方插件omv-extras 插件容器应用
谁维护OMV 项目,和核心在同一个 GitHub 仓库,包名 openmediavault-*omv-extras 社区(GitHub 组织 OpenMediaVault Plugin Developers),主要维护者是 Aaron Murray各应用自己的作者,OMV 只提供运行环境
在哪里装系统 → 插件(System → Plugins),装好 OMV 就能看到先安装 omv-extras,再到 系统 → 插件用 omv-extras 的 Compose 插件跑 Docker 容器,或用官方的 Podman 插件
软件源packages.openmediavault.orgomv-extras 自己的 apt 软件源镜像仓库,如 Docker Hub
怎么更新随系统一起更新随系统一起更新,多数插件几乎每月都有新版本自己拉新镜像、重建容器,Compose 插件有计划任务
数量(截至 2026-10-22)25 个插件包约 40 个插件包(amd64)不限;Compose 插件内置 197 个示例
反馈渠道OMV 的 GitHub 仓库和论坛各插件在 GitHub 上的独立仓库和论坛应用自己的社区

官方插件和 omv-extras 插件都是 Debian 软件包,在界面里点安装,背后就是 apt-get install。容器不是插件,它不改 OMV 本身的软件包。

官方对插件的态度 ​

官方文档说得很明确:插件只是为了方便而存在。额外软件强烈推荐用 Podman 或 Docker 容器装,因为后续版本更新引入的依赖冲突,曾经让 OMV 或其他软件无法使用。

插件的好处也是实打实的:装起来只要点一下,通常已经预配置好,随系统自动更新,并且会在界面里加上对应的页面。所以取舍的办法是:

  • 扩展 OMV 自己的能力(存储、网络、系统、认证):用插件。
  • 装一个应用(影音、相册、下载、网盘):用容器。

怎么选的细节见插件还是容器。

官方插件里的两类 ​

  • 普通插件:软件 RAID(md)、LVM(lvm2)、bcache、sharerootfs、USB 备份、FTP、UPS(nut)、ClamAV、两步验证等,直接装在系统里。
  • 基于 Podman 容器的插件:filebrowser、photoprism、owntone、wetty,以及管理界面 podman 和单节点 Kubernetes(k8s)。它们跑在 Podman 里,和 Compose 插件用的 Docker 是两套互相独立的容器环境,镜像、容器互不可见。

在 OMV 8 上能不能装 ​

最容易踩的坑是:GitHub 上有这个插件,教程里也写了,但软件源里没有。判断要看软件源现在有什么,不要看文档。

可靠的信号

  1. 系统 → 插件 的列表里有它。先点工具栏的检查是否有新插件...(放大镜图标),列表才是最新的。
  2. 版本号是 8.x,架构列包含你的 CPU。OMV 8 只支持 amd64 和 arm64;内核插件只有 amd64。
  3. 每一行的详情里有维护者和软件源:官方插件的维护者是 Volker Theile,omv-extras 的是 OpenMediaVault Plugin Developers。

在 OMV 的 shell 里也可以只读地核对:

sh
# 在 OMV 的 shell 里,以 root 身份
dpkg -l 'openmediavault-*'
apt-cache policy openmediavault-<插件名>

第一条列出已装的插件,第二条显示候选版本和它来自哪个软件源。

不可靠的信号

  • GitHub 上有仓库。 截至 2026-10-22,filemanager、ldap、diskclone、downloader、bcachefs、safecmd、aiassistant、developer 在 GitHub 上有代码,但 omv-extras 的 OMV 8 软件源里没有,界面里装不到。
  • 官方文档里的插件列表。 它还列着早已移除的 S3 和 OMV 8 里不存在的 Forked-daap;系统要求页还写着装 Flash Memory 插件。
  • 旧教程和旧论坛帖。 docker-gui、portainer、plex、syncthing 等 omv-extras 旧插件已经归档,不适用于 OMV 8,对应功能改用 Compose 应用。
旧的在 OMV 8 上
openmediavault-s3(MinIO)官方已于 2026-01 移除
openmediavault-forkeddaapd由 openmediavault-owntone 取代
openmediavault-flashmemory已归档,由 openmediavault-writecache 取代,见 writecache

最新的变化记录见 OMV 8 插件变化,全部插件的用途和教程位置见插件与应用。

装一个插件之前问自己 ​

  1. 它是在扩展 OMV 自己的能力,还是只是一个应用?应用优先用容器。
  2. 谁维护,最近有更新吗?omv-extras 的插件有的在仓库里标着 unstable 或 experimental,先看说明。
  3. 它依赖谁,卸载时会连带拿掉谁?见安装、更新与卸载插件。openmediavault-sharerootfs 就被八个插件依赖。
  4. 它的数据放在哪里,有没有被备份覆盖?
  5. 大版本升级时,这个插件有没有对应的新版本?见大版本升级。

常见问题 ​

插件列表是空的,或者提示 The index of available plugins does not exist。 插件列表来自 apt-get update 之后生成的索引。点一次检查是否有新插件...,还不行就按安装、更新与卸载插件里的办法重建软件包列表。

插件装上了,菜单里却没有。 硬刷新浏览器,见安装、更新与卸载插件。

官方插件和 omv-extras 插件怎么区分。 看维护者。另外,官方插件在 OMV 装好后就能看到,omv-extras 的插件要先装 omv-extras 才出现。

参考资料 ​

OpenMediaVault 非官方中文使用指南,与 openmediavault 项目及其开发者无隶属关系。