外观
安装、更新与卸载插件
完成后，你会在 系统 → 插件（System → Plugins）里安装和卸载插件，知道点下去背后执行了什么，也知道卸载为什么可能一口气拿掉好几个插件。
页面说明
系统 → 插件是一个带搜索框的列表。每一行显示插件名和版本、一句话说明、绿色的已安装（Installed）标记和支持的架构。列表一次只能选一行，工具栏有三个按钮：
| 按钮 | 提示文字 | 做什么 |
|---|---|---|
| 放大镜 | 检查是否有新插件...（Check for new plugins） | 同步软件包列表，相当于 apt-get update，并重建插件索引 |
| 下载箭头 | 安装（Install） | 安装选中的插件，只对未安装的行可用 |
| 垃圾桶 | 卸载（Uninstall） | 卸载选中的插件，只对已安装的行可用 |
每一行的详情里还有类别、维护者、主页、软件源和大小，另有几列默认隐藏，显示方式以你界面上看到的为准。
检查新插件
检查是否有新插件... 会以后台任务运行软件包列表更新。这些时候要点它：
- 刚装完 omv-extras，新增的插件才会出现。
- 想看某个插件有没有新版本。
- 列表是空的，或者提示
The index of available plugins does not exist（见下文常见问题）。
安装
- 在列表里选中插件，点安装，确认对话框（「确定要安装选中的插件？」）点是。
- 等任务对话框跑完，页面会自动重载。
- 硬刷新浏览器（Windows 和 Linux 按
Ctrl+Shift+R，macOS 按Cmd+Shift+R）。新插件的菜单靠它才稳妥地出现，原因见下文「装完或卸完界面不对」。
界面实际执行的是带 --yes、--reinstall、--fix-missing、--allow-unauthenticated 等参数的 apt-get install，没有逐项确认。插件依赖的 Debian 软件包会一起装上，也就是说它会装什么，你不会在界面里看到清单。想事先知道，可以只读地模拟一次：
sh
# 在 OMV 的 shell 里，以 root 身份；--simulate 只模拟，不改动系统
apt-get --simulate install openmediavault-<插件名>以 Inst 开头的行是将被安装的包。界面里的安装带了 --allow-unauthenticated，不会因为软件包签名校验失败而拒绝，所以只启用你信任的软件源，见插件体系。
更新
插件是普通的 apt 软件包，没有单独的更新按钮。它们的新版本出现在 系统 → 更新管理 → 更新（System → Update Management → Updates），和系统包一起升级，也可以用 omv-upgrade。更新完如果界面异常，同样硬刷新。更新的做法见系统更新。
卸载
选中已安装的插件，点卸载，确认对话框（「确定卸载该插件？」）点是。界面实际执行的是：
text
apt-get --yes --auto-remove --purge remove <插件包名>这三个参数意味着：
remove：卸载这个包，同时卸载所有依赖它的包。apt 会自动带上，不会问你。--purge：连配置一起清除。插件在 OMV 数据库里的设置会被删掉。--auto-remove：顺手移除因此不再被任何软件需要的依赖包。
界面上只有一句「确定卸载该插件？」，不会告诉你还有哪些插件会跟着消失。
卸载会连带卸载依赖它的插件，并清除它们的配置
- 影响范围：被卸载的插件，加上所有依赖它的插件。它们在 OMV 里的设置会被清除（Compose 的设置、SnapRAID 的阵列和驱动器定义、scripts 里的脚本记录等），由它们管理的服务、容器、定时任务会停止。共享文件夹和数据盘里的数据文件不在 apt 的清理范围内，但失去了管理它们的配置，要重新建立后才能再用。
- 前置条件：先用下文的命令确认连带范围；记下或截图相关配置；做一次系统盘备份；先停掉相关业务。
- 怎么回退：重新安装插件只能把软件包装回来，恢复不了被清除的配置。要恢复，靠卸载前的备份或你自己的配置记录。所以确认之后再点。
常见的依赖链
下表依据 2026-10-22 的 synchrony 软件包索引：
| 卸载这个 | 会连带卸载 |
|---|---|
openmediavault-sharerootfs | openmediavault-compose、-kvm、-microvm、-nvmetcp、-scripts、-snapraid、-symlinks、-tgt，以及再依赖它们的 -imagecheck（依赖 compose）和 -snapraid-aio（依赖 snapraid） |
openmediavault-omvextrasorg（omv-extras） | openmediavault-compose（依赖 omv-extras 8 以上）及依赖 compose 的 -imagecheck；omv-extras 的软件源也会被清掉 |
openmediavault-compose | openmediavault-imagecheck |
openmediavault-snapraid | openmediavault-snapraid-aio |
openmediavault-sharerootfs 没有界面，看起来毫无存在感，却被八个插件依赖，是最容易被误删的一个，见sharerootfs。
卸载前先模拟
下面两条都是只读的：
sh
# 在 OMV 的 shell 里，以 root 身份
# 看哪些已安装的包依赖它
apt-cache rdepends --installed openmediavault-<插件名>
# 模拟界面将执行的卸载，只显示会发生什么，不改动系统
apt-get --simulate --auto-remove --purge remove openmediavault-<插件名>第二条输出里以 Purg 或 Remv 开头的行，就是真正点下卸载后会被移除的包。清单比你预期的长，就先别点。
装完或卸完界面不对
安装和卸载时，OMV 会重新生成界面用到的菜单、路由和翻译文件，并重启后端服务 omv-engined。浏览器里已经加载的旧界面，需要硬刷新才能用上新的菜单。官方故障排查对「界面上缺少字段，或者还显示着已卸载的东西」的建议是清除浏览器缓存。
- 先硬刷新（
Ctrl+Shift+R或Cmd+Shift+R）。 - 不行就清除这个站点的缓存，或者换个浏览器、开无痕窗口试。
- 仍然不对，见插件装完界面不对。
检查结果
- 安装后，
系统 → 插件里该插件显示已安装，对应的菜单出现。 - 在 OMV 的 shell 里确认：
sh
# 在 OMV 的 shell 里，以 root 身份
dpkg -l openmediavault-<插件名>第一列是 ii 表示已安装。卸载后这条命令会提示没有匹配的软件包。
常见问题
列表里找不到想装的插件。 先点检查是否有新插件...。omv-extras 的插件要先安装 omv-extras。还找不到，多半是软件源里根本没有它，见插件体系。
提示 The index of available plugins does not exist。 插件列表依赖 apt-get update 之后生成的索引文件，它不存在时会报这个错。点一次检查是否有新插件...；还不行，在本机控制台运行 omv-firstaid，选 Refresh APT package lists and clean caches（8.3.0 起有），或者用 系统 → omv-extras（System → omv-extras）页的 apt clean 按钮。网络和镜像问题见软件源、国内镜像与第一次更新，更新失败见更新失败与软件源报错。
安装失败，提示包数据库被锁。 另一个 apt 或 dpkg 进程正在运行，比如系统在自动更新。等它结束再试。
界面里没有「上传 .deb」按钮。 OMV 8 的插件页没有这个按钮（后端接口还在）。不要用 dpkg -i 装来路不明的插件包；界面也只允许安装包名以 openmediavault- 开头的包。
想装的是 Debian 里的普通软件，不是插件。 能用，但官方有两条警告：不要装 apache，它会导致 openmediavault 包被卸载；不要从 Debian 的 backports、testing、experimental 装包，OMV 严格绑定它所基于的 Debian 版本。更稳的办法是用容器，见插件还是容器。