OpenMediaVault 使用指南

外观

进阶系统层服务中断风险OMV 8.x

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

在 Debian 13 上安装 OMV ​

OMV 本质上是一组装在 Debian 上的软件包，所以也可以先装好 Debian，再把 OMV 装上去。官方把这当作 ISO 装不上时的兜底办法，也是 ARM 设备的基础。

什么时候用这种方式 ​

  • ISO 安装器认不出你的硬件，比如 NVMe 硬盘、需要较新内核的网卡。
  • 需要自定义分区，ISO 安装器只提供预设的整盘安装。
  • 机器只有 UEFI，没有 Legacy/CSM 选项。 官方只支持以 BIOS（Legacy/CSM）方式引导 ISO，8.x 版文档的建议是：想在别的引导方式下用，先装 Debian，再装 OMV。引导方式由 Debian 决定，Debian 13 的安装器完整支持 UEFI，装好后 OMV 照常安装。有用户报告在 UEFI 下用 ISO 也能装上，但这不在官方支持范围内，见下载、校验并制作安装 U 盘。
  • 你已经有一台装好的 Debian 13，或者一个现成的虚拟机模板。

开始之前 ​

  • 系统是 Debian 13（trixie），架构是 amd64 或 arm64。OMV 8 只支持这两种。
  • 只装最小系统：在 Debian 安装器的软件选择里，只勾 SSH server 和 standard system utilities。不要装桌面环境，也不要装 Web 服务器。检测到桌面环境，OMV 会拒绝安装；nginx 要用 80 端口，安装时必须空闲；装了 apache，会导致 openmediavault 包被卸载。
  • 全新的系统，最好没有别的用途。用 Debian 云镜像（自带 cloud-init）的话要知道：openmediavault 包声明了与 cloud-init 冲突，安装时会把它卸载。
  • 以 root 身份操作，可以联网。
  • 手边有本机控制台（显示器键盘，或者虚拟机、IPMI 的控制台）。第 6 步会重新部署网络，SSH 很可能断开。

OMV 会接管这台机器

  • 影响范围：OMV 装好后接管网络、SSH、Samba、NFS、配额、nginx 等服务的配置，这台机器上已有的相关配置会被覆盖。官方文档说得很明白：OMV 只会导入网络和时间相关的现有设置，其他服务要在界面里重新配置。
  • 前置条件：用一台全新的 Debian，不要装在已经跑着别的服务的机器上。虚拟机先打个快照。
  • 怎么回退：OMV 没有「干净卸载」。想撤销，只能重装系统或还原快照，所以不要在有用的系统上试。

安装步骤 ​

下面所有命令都在这台 Debian 上以 root 身份执行。从普通用户切换用 su -。

1. 先备好 systemd-resolved ​

官方文档特别警告：安装 OMV 之前，要先装好并配置 systemd-resolved。否则 OMV 的包会顺带把它装上，DNS 解析就失效了，而安装过程中还要联网下载很多包，结果就是安装失败。

sh
# 在 Debian 13 上以 root 执行
apt-get install --yes systemd-resolved psmisc
systemctl enable --now systemd-resolved.service
systemctl restart systemd-resolved.service
resolvectl dns <网卡名> <DNS 服务器的 IP>
  • 网卡名用 ip -br link 查，DNS 服务器填路由器的地址或者你信任的公共 DNS。
  • 这是临时配置，重启后失效。装完 OMV 后，网络由 OMV 接管，配置才会固定下来。
  • 如果机器用 DHCP，DHCP 客户端可能干扰 systemd-resolved，表现为 apt-get 和 wget 都失败。官方的处理办法是执行 killall dhcpcd，再重新执行一遍 resolvectl dns 那一行。

2. 导入 OMV 软件源的密钥 ​

sh
# 在 Debian 13 上以 root 执行
apt-get install --yes gnupg
wget --quiet --output-document=- https://packages.openmediavault.io/archive.key | gpg --dearmor --yes --output "/usr/share/keyrings/openmediavault-archive-keyring.gpg"

如果这个地址连不上，OMV 自带的镜像列表和 installScript 里还有 https://openmediavault.github.io/packages/archive.key 这个地址，把上面命令里的网址换成它即可。

导入后可以看一眼指纹：

sh
# 在 Debian 13 上以 root 执行
gpg --show-keys /usr/share/keyrings/openmediavault-archive-keyring.gpg

截至 2026-10-23，输出里应有指纹 D67506C878E08A94FD7E009424863F0C716B980B，我们从官方 ISO 的 .key 文件和 openmediavault.github.io 上的 archive.key 两处核对过，一致。

3. 添加 OMV 的软件源 ​

sh
# 在 Debian 13 上以 root 执行
cat <<EOF > /etc/apt/sources.list.d/openmediavault.list
deb [signed-by=/usr/share/keyrings/openmediavault-archive-keyring.gpg] http://packages.openmediavault.org/public/ synchrony main
deb [signed-by=/usr/share/keyrings/openmediavault-archive-keyring.gpg] http://packages.openmediavault.io/ synchrony main
EOF

synchrony 是 OMV 8 的代号。官方文档里还有几行被注释掉的：SourceForge 镜像、synchrony-proposed（预发布）、partner（第三方），默认都不需要。

在中国大陆，可以用清华 TUNA 的镜像：把上面两行里的网址分别换成下面两个，其余部分，包括 [signed-by=...]，保持不变：

text
https://mirrors.tuna.tsinghua.edu.cn/OpenMediaVault/public
https://mirrors.tuna.tsinghua.edu.cn/OpenMediaVault/packages

TUNA 的帮助页给出的示例没有写 signed-by，这里保留它，是因为第 2 步的密钥放在这个位置。这个组合我们没有实测过，记为待核实。

这个文件以后会被 OMV 重写

OMV 装好后，会按自己的模板重新生成这个文件，改成从一份镜像列表里按优先级取源。所以手写的 TUNA 地址只管第一次安装。想长期用国内镜像，要按软件源、国内镜像与第一次更新里的环境变量办法设置。

4. 安装 openmediavault ​

sh
# 在 Debian 13 上以 root 执行
export LANG=C.UTF-8
export DEBIAN_FRONTEND=noninteractive
export APT_LISTCHANGES_FRONTEND=none
apt-get update
apt-get --yes --auto-remove --show-upgraded \
    --allow-downgrades --allow-change-held-packages \
    --no-install-recommends \
    --option DPkg::Options::="--force-confdef" \
    --option DPkg::Options::="--force-confold" \
    install openmediavault

参数照官方抄，不要自己增删。它们的作用是：全程不交互、不装推荐包、已有的配置文件保持原样。耗时取决于网速，会装上一大批依赖。

5. 初始化配置数据库 ​

sh
# 在 Debian 13 上以 root 执行
omv-confdbadm populate
omv-salt deploy run hosts

omv-confdbadm populate 把这台机器现有的主机名、网卡、时区等设置导入 OMV 的配置数据库。它必须先于下一步执行，因为下一步会重写网络配置。

官方文档说它只解析 /etc/network/interfaces。但按源码，populate 还会解析 /etc/netplan/ 下 YAML 文件里的以太网配置，以源码为准。如果你的网络是用 NetworkManager 或其他方式配置的，数据库里不会有网卡信息，下一步就改用 omv-firstaid。

omv-salt deploy run hosts 不在官方文档的步骤里，是官方一键脚本在这一步之后多做的：让主机名能被正确解析，否则后面 Salt 收集系统信息会非常慢。

6. 部署网络 ​

sh
# 在 Debian 13 上以 root 执行
omv-salt deploy run systemd-networkd

也可以改用 omv-firstaid，从命令行菜单里配置网卡，见omv-firstaid 救援工具。这一步之后，网络由 OMV 通过 netplan 交给 systemd-networkd 管理，原来的 /etc/network/interfaces 会被改写成一个占位文件。IP 地址可能变化，通过 SSH 操作的话连接会断开，这时去本机控制台看新地址。

7. 重启，打开 Web 界面 ​

sh
# 在 Debian 13 上以 root 执行
reboot

重启后，用浏览器打开 http://<机器的 IP>，用 admin 和 openmediavault 登录，下一篇第一次登录接着做。

装完之后要注意 ​

  • 安装 Debian 时创建的普通用户，现在不能 SSH 登录了。 OMV 只允许 root 和 _ssh 组的成员用 SSH。想让它继续能登录，在 OMV 的 shell 里把它加进 _ssh 组：usermod -aG _ssh <用户名>。账户的统一管理放到用户与用户组里讲。
  • root 默认可以用密码 SSH 登录，这是 OMV 留的后门，方便界面坏了时进来救。装好后应当关掉，先建好能用的普通用户，见 SSH 加固。
  • OMV 接管的配置文件不要手改，见OMV 是怎么工作的。
  • 不要往这台机器上装 apache，也不要从 Debian 的 backports、testing 装包。 额外的软件优先用容器。

检查结果 ​

sh
# 在 OMV 的 shell 里执行
dpkg -l openmediavault
systemctl is-active nginx openmediavault-engined
  • 第一条末尾一行以 ii 开头，说明包装好了。
  • 第二条输出两个 active。
  • 浏览器里能打开登录页，登录后 网络 → 接口（Network → Interfaces）里能看到你的网卡。界面的位置和用法见认识 Web 管理界面。

常见问题 ​

apt-get install 中途 DNS 解析失败。 多半是没做第 1 步，或者做了但 DHCP 客户端把配置冲掉了。重做第 1 步，包括 killall dhcpcd。

提示检测到桌面环境，拒绝安装。 官方的安装脚本检查 gdm3、lightdm、lxdm、sddm、slim、wdm、xdm 这些包，装有桌面的系统不被支持。换一台最小安装的系统，不要靠卸载桌面包来凑合。

apt-get 找不到 openmediavault 包。 检查软件源文件的内容有没有抄错，是不是 Debian 13，再用 apt-cache policy openmediavault 看候选版本。

装完界面空白或报 502。 先在本机控制台运行 omv-firstaid，再看502 Bad Gateway 与 Failed to connect to socket。

我用的是 Debian 12。 OMV 8 只支持 Debian 13。Debian 12 对应的 OMV 7 已在 2026-06 停止支持，不建议新装。已有 OMV 7 的升级见大版本升级：从 OMV 7 到 OMV 8。

官方仓库里的一键安装脚本

官方仓库的 README 提到：在现有 Debian 系统上，以 root 执行 wget -O - https://get.openmediavault.io | sh - 可以快速安装。仓库根目录的 install.sh 是对应的脚本，我们读过源码：它检查 root、Debian 13、amd64 或 arm64、有没有桌面环境，然后做的事和上面第 2 到 5 步基本一致。它没有做第 1 步，也没有部署网络。

我们写作时没能连上 get.openmediavault.io，没有核对它实际返回的内容和仓库里的脚本是否一致。所以不要把远程脚本直接管道给 shell，要用就先下载、读完再执行：

sh
# 在 Debian 13 上以 root 执行
wget -O omv-install.sh https://get.openmediavault.io
less omv-install.sh
sh omv-install.sh

参考资料 ​

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