OpenMediaVault 使用指南

外观

入门核心功能官方插件服务中断风险OMV 8.x

资料核查：2026-10-23T00:00:00.000Z；尚无本站实机验证记录，请按文中的检查步骤确认本机结果。

插件装完界面不对 ​

适用范围 ​

  • 装完插件，左侧菜单里没有对应的入口，或者点开是空白页、旧页面。
  • 卸载插件之后，菜单、页面字段或仪表盘小部件仍然留着。
  • 页面缺少某些字段，行为和教程不一致。

官方排障页对「界面里缺字段，或者显示已经卸载的内容」的建议只有一句：清除浏览器缓存。这一页在它的基础上，多讲几项确认和修复方法。

开始排查前 ​

先知道几件事，免得把「正常」当成故障：

  • 安装或卸载插件之后，界面会自动重新加载一次，请等它完成。
  • **有些插件没有菜单。**例如 openmediavault-sharerootfs 没有独立的界面，它只是改变了系统的行为。
  • **插件的菜单不一定在你以为的位置。**软件 RAID 在 存储器 → RAID 管理（Storage → Multiple Device），ZFS 在 存储器 → zfs（Storage → zfs），远程挂载在 存储器 → 远程挂载（Storage → Remote Mount），内核在 系统 → 内核（System → Kernel），Compose 在 服务 → Compose（Services → Compose）。每个插件的入口见插件与应用的总表。
  • omv-extras 的新手指南提到，装完 omv-extras 之后，可能需要重启，系统 菜单下才会出现 omv-extras。

排查步骤 ​

1. 先硬刷新浏览器 ​

在 Web 界面上按 Ctrl + Shift + R（macOS 用 Command + Shift + R）。omv-extras 的安装脚本在结束时，也会提示登录后要按这个组合键。

如果硬刷新没用：用浏览器的隐私窗口重新登录看看，或者清除这个站点的缓存和站点数据。换一个浏览器验证，可以排除是不是浏览器的问题。

从源码来看，nginx 对 index.html 和 *.json 返回的是「不缓存」的头，所以残留的具体来源（浏览器内存里的界面状态，还是别的静态资源缓存）无法仅凭源码断定，实操上以官方建议为准：硬刷新或清缓存。

2. 确认插件真的装上了，或者卸干净了 ​

在 系统 → 插件（System → Plugins）里找到这个插件，看它是否已安装。插件列表来自 apt 的软件包索引，刚加了软件源，或者刚装了 omv-extras 的话，要先点检查是否有新插件…（Check for new plugins）刷新。

在 shell 里确认：

sh
# 在 OMV 的 shell 里执行（只读）
dpkg -l 'openmediavault-*' | grep '^ii'

行首是 ii 表示已经安装。界面和这里的结果不一致，才继续往下查。

3. 确认没有未应用的更改 ​

有的插件装完，要在它自己的页面里保存设置，并点页面顶部黄色提示条上的应用，服务才会真正部署。例如 Compose 插件，要先设置好共享文件夹、保存、应用，Docker 才会安装。看看页面顶部有没有待应用的更改。

4. 在 shell 里重建界面配置 ​

这一步会重启 Web 界面的后台引擎

影响范围：omv-engined 重启期间，Web 界面会有几秒到几十秒打不开或报错，文件共享、容器等服务不受影响。

前置条件：先确认没有正在界面里执行的长任务（安装更新、RAID 操作、备份），并且前面的硬刷新、软件包检查都做过了。

回退办法：这两条命令只重新生成界面配置并重启引擎，不改你的设置，不需要回退。重启失败时，按502 Bad Gateway 与 Failed to connect to socket检查。

插件的安装和卸载，会通过软件包的触发器做两件事：执行 omv-mkworkbench all，重新生成菜单、路由、仪表盘小部件等界面配置文件；然后重启 omv-engined。触发器没有跑完或被中断时，界面就会不对。可以手动执行同样的两条命令：

sh
# 在 OMV 的 shell 里执行；界面会短暂不可用
omv-mkworkbench all
monit restart omv-engined

完成后再硬刷新一次浏览器。

5. 检查软件包状态 ​

sh
# 在 OMV 的 shell 里执行（只读）
dpkg --audit

没有输出表示正常。有输出，说明有软件包没有配置完成，按更新失败与软件源报错的第 7 节处理。

6. 卸载之后的残留 ​

  • 在 系统 → 插件 里卸载，等于 apt-get --auto-remove --purge remove：会清除插件的配置，并自动移除不再需要的依赖。如果别的插件依赖它，也会被一并卸载，例如卸载 openmediavault-sharerootfs 会让依赖它的 Compose 等插件一起被卸掉。卸载前请先读安装、更新与卸载插件。
  • 已经卸载的插件，如果它的模块还留在「待应用的更改」列表里，不用担心：应用时 OMV 会自动忽略并清理这些已经不存在的模块。

7. 插件本身的问题 ​

菜单和页面都在，但页面报错：看 诊断 → 系统日志（Diagnostics → System Logs）里的日志，或者：

sh
# 在 OMV 的 shell 里执行（只读）
journalctl -u openmediavault-engined -b --no-pager | tail -n 40

问题出在插件本身的，omv-extras 的插件要去对应的 GitHub 仓库或论坛的 omv-extras 板块反馈，见如何有效求助。

确认恢复 ​

  1. 硬刷新之后，插件的菜单出现了，或者残留的菜单消失了。
  2. 点开插件的页面，能正常加载数据，没有报错。
  3. dpkg -l 的结果和 系统 → 插件 里显示的一致。
  4. 页面顶部没有待应用的更改。
  5. 换一个浏览器或设备登录，看到的结果相同。

仍未解决 ​

附上：dpkg -l 'openmediavault-*' | grep '^ii' 的输出、系统 → 插件 里该插件的截图、journalctl -u openmediavault-engined 的相关行，以及操作系统和浏览器版本。读如何有效求助。

参考资料 ​

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