开源NAS系统 Openmediavault（OMV）编译与安装教程

说到NAS，可能很多读者第一个想到的是群晖、威联通（QNAP）等大厂产品，购买之后可以开箱即用。也有些热爱DIY的读者，会选择自己组装一台NAS主机，然后自行安装操作系统，使其最大程度符合自己的需求。

DIY一台NAS，也许你第一个想到的是“黑群晖”系统，可在非群晖的机器上享受非官方的群晖体验。但除了黑群晖，或许你还有同样具备高度可玩性的选择，那就是本文要介绍的Openmediavault。

Openmediavault，简称OMV，是开源NAS解决方案的不二之选，更是黑群晖之外的最佳选择。基于Debian的灵活性，以及低资源占用，使得它能够在各种架构的操作系统上大放异彩，甚至包括早期32位架构的x86处理器，例如我手上2004年的老赛扬D（Celeron D）处理器。

然而，OMV固然好用，开发团队却给热爱DIY的玩家们挖了个巨坑：教程奇少无比！这是因为官方都在推荐用他们做好的镜像，并没有提供多少让用户自行配置系统的教程，这对手动安装的专业用户非常不友好。而根据源码编译的教程更是空白，全靠用户自己猜，自己摸着石头过河！

于是，在踩了N个坑，失败N次之后，我决定，不要让这空白再继续坑害新入坑的OMV用户了！这篇编译和安装二合一的教程，应运而生。

准备

系统：Debian 10 Buster，不带任何桌面环境的基础版本
处理器架构：OMV官方推荐的AMD64、ARM、ARM64，以及i386
- 对于32位处理器，OMV官方不提供i386架构的ISO镜像，但我们仍可以在Debian x86的系统上手动安装。
磁盘空间：至少2GB（因为接下来要安装大量的依赖包）
内存：至少512MB，推荐1GB及以上

提示：
为了便于操作，下文所有的命令都在root用户下进行。
本地用户，请使用sudo -i或sudo su来切换到root用户。
SSH登入远程服务器，可直接以root身份登录。
Debian的基础版本镜像可从我母校——华中科技大学的镜像源下载：http://mirrors.hust.edu.cn/debian-cd/current/。

OMV的本质是什么？

OMV的本质，就是建构在Nginx、PHP、Python等底层系统应用上的大型Web服务程序，类似于高知名度的宝塔平台。它本身不包含任何二进制文件和源码，所有有效的程序代码均为解释型语言，这使得它天生具有跨平台性——理论上，只要目标架构支持Debian、Dpkg，以及OMV的依赖程序，OMV就能在任意架构上的操作系统运行。

OMV基于Debian而构建，它的源代码编译后生成的是跨平台、无架构（noarch）的Deb程序包，整个编译过程并不会调用编译器来生成平台专用的二进制文件。因此，OMV能够在任何一个Debian操作系统实例上安装。

注：理论上Debian系、采用Dpkg的操作系统均可安装，比如Ubuntu。但笔者未进行测试。

克隆源代码

下载

OMV的源代码发布在GitHub上，可直接克隆下来。我们将源码下载到omv目录中。

# 安装Git和pip
apt install git python3-pip
# 克隆源码，放到omv目录下
git clone https://github.com/openmediavault/openmediavault.git omv

进入源码目录

OMV的核心源码放在deb子目录中：

cd omv/deb

编译过程

OMV的编译流程是个巨坑。不仅缺乏文档，更坑的是，它的Makefile写法并不规范：它的一些编译目标，完成的工作与我们预想的工作八竿子打不着，例如make install理论上应当用于安装编译好的软件，结果它被开发团队定义为“安装编译OMV所需的工具”。若不仔细研读，是很难找出真正的编译目标的。

好在，经过总结后，它的编译过程相当简单。

安装编译所需工具

make install

开始编译

make binary

编译完成后，omv/deb目录下会生成若干个deb安装包。一般如下所示。

$ ls *.deb
openmediavault-clamav_5.0-1_all.deb
openmediavault-diskstats_5.0-1_all.deb
openmediavault-forkeddaapd_5.0-1_all.deb
openmediavault-keyring_1.0_all.deb
openmediavault-ldap_4.0.6-1_all.deb
openmediavault-lvm2_5.0.1-1_all.deb
openmediavault-nut_5.0-1_all.deb
openmediavault-shairport_5.0-1_all.deb
openmediavault-snmp_5.0-1_all.deb
openmediavault-tftp_5.0-1_all.deb
openmediavault-usbbackup_5.0.1-1_all.deb
openmediavault_5.0.11_all.deb

坑：默认编译目标的问题

OMV的默认编译目标，也就是不带参数运行make时进行的编译过程，竟然不是编译Deb包，而是对各个子目录执行清理！这一点要格外小心，笔者已经无力吐槽了ε=(´ο｀*)))。。。

安装OMV

添加OMV官方源

OMV的少部分依赖，在Debian的官方源中是没有的，因此必须添加OMV源。

首先，将以下代码添加到/etc/apt/sources.list的末尾：

# Openmediavault official repository
deb http://packages.openmediavault.org/public usul main

接着，安装OMV源密钥环（keyring）：

# 安装我们自己编译的版本
cd omv/deb
dpkg -i openmediavault-keyring_1.0_all.deb
# 当然，你也可以在线安装
wget http://packages.openmediavault.org/public/pool/main/o/openmediavault-keyring/openmediavault-keyring_1.0_all.deb
dpkg -i openmediavault-keyring_1.0_all.deb

然后，更新软件源：

apt update

安装基础依赖包

# Debian 10 提供的软件包
apt install php-fpm php-json php-cgi php-cli php-mbstring ethtool python3-dialog acl xfsprogs jfsutils ntfs-3g sdparm postfix bsd-mailx cpufrequtils smartmontools uuid nfs-kernel-server proftpd-basic sshpass samba samba-common-bin rsync avahi-daemon libnss-mdns beep php-bcmath gdisk rrdtool collectd anacron cron-apt quota php-xml quotatool lvm2 watchdog libjson-perl liblocale-po-perl proftpd-mod-vroot libjavascript-minifier-xs-perl xmlstarlet socat rrdcached nginx wpasupplicant btrfs-progs samba-vfs-modules python3-pyudev python3-natsort jq chrony python3-netifaces python3-lxml salt-minion php-yaml python-click python3-click
# Debian 10 不提供的软件包，在OMV源中提供
apt install monit php-pam libjs-extjs6 wsdd

此时会发生依赖关系错误，这是正常现象。我们接着运行以下命令，修复依赖关系：

apt --fix-broken install

再重复运行之前的那一长串apt install，即可正常安装。

安装OMV主程序包

为了方便安装，OMV的开发者将所有安装过程都整合在了一个包中，不需要再零零散散安装大量的包。

接下来，你可以选择安装官方版本，或者是我们自己编译的版本。二选一。

安装官方版本

OMV可由官方源直接安装：

apt install postfix openmediavault

期间会出现大量的日志，耐心等待，直到成功完成。要注意，一旦出现任何一种错误，OMV都是没法用的！

安装我们编译的版本

# 重新进入到源码目录
cd omv/deb
# 然后开始安装
dpkg -i openmediavault-keyring_1.0_all.deb     # 源密钥环
dpkg -i openmediavault_5.0.11_all.deb          # 主安装包

填坑：解决`Unit file is masked`问题

在某些机器（如VPS）上手动安装OMV时，常常会出现Unit file is masked的问题。该问题非常致命，会中断OMV后续的安装进程。

Failed to preset unit: Unit file /etc/systemd/system/openmediavault-cleanup-php.service is masked.
/usr/bin/deb-systemd-helper: error: systemctl preset failed on openmediavault-cleanup-php.service: No such file or directory
dpkg: error processing package openmediavault (--configure):
 installed openmediavault package post-installation script subprocess returned error exit status 1 
Errors were encountered while processing:
 openmediavault
E: Sub-process /usr/bin/dpkg returned an error code (1)

实际上，了解systemd对服务的管理机制，就不难得知，这里的“mask”是系统服务的一个状态，相当于被“屏蔽”。据此，解决办法很简单，但凡有一个服务提示被masked，就运行下面的命令来unmask，然后重新安装，直到安装过程能够顺利继续：

# systemctl unmask <被报错的服务名>，例如：
systemctl unmask openmediavault-cleanup-php.service

启动OMV

运行以下命令即可立即启动OMV：

omv-run

事实上，新版本OMV直接配置成了系统服务，可以自动启动，只需重启电脑即可。

在浏览器中输入主机的IP地址，即可打开OMV的登录页面。默认的凭据如下：

凭据	值
默认用户名	admin
默认密码	openmediavault

添加OMVExtras插件库

OMVExtras插件库是官方所提供的插件源，建议添加，这样我们就能够用上更多强悍的插件。

开发者提供了一键安装方法：

wget -O - http://omv-extras.org/install | bash

要是不能下载脚本，则把下面该脚本的内容保存为install.sh，chmod 755后运行：

#!/bin/bash

declare -i version

url="https://github.com/OpenMediaVault-Plugin-Developers/packages/raw/master/"

version=$(dpkg -l openmediavault | awk '$2 == "openmediavault" { print substr($3,1,1) }')

echo ${version}

if [ ${version} -eq 5 ]; then
  echo "Downloading omv-extras.org plugin for openmediavault 5.x ..."
  file="openmediavault-omvextrasorg_latest_all5.deb"
elif [ ${version} -eq 4 ]; then
  echo "Downloading omv-extras.org plugin for openmediavault 4.x ..."
  file="openmediavault-omvextrasorg_latest_all4.deb"
elif [ ${version} -eq 3 ]; then
  echo "Downloading omv-extras.org plugin for openmediavault 3.x ..."
  file="openmediavault-omvextrasorg_latest_all3.deb"
elif [ ${version} -eq 2 ]; then
  echo "Downloading omv-extras.org plugin for openmediavault 2.x ..."
  file="openmediavault-omvextrasorg_latest_all.deb"
else
  echo "Unsupported version of openmediavault"
  exit 0
fi

if [ -f "${file}" ]; then
  rm ${file}
fi
wget --no-check-certificate ${url}/${file}
if [ -f "${file}" ]; then
  dpkg -i ${file}

  if [ $? -gt 0 ]; then
    echo "Installing other dependencies ..."
    apt-get -f install
  fi

  echo "Updating repos ..."
  apt-get update
else
  echo "There was a problem downloading the package."
fi

exit 0

安装完成后，刷新浏览器，即可看到OMV的左栏中多出了一个“OMV-Extras”入口。

写在最后

虽然OMV的官方镜像提供了更便捷、更完备的安装程序，适用于x86_64、ARM64等主流架构，但如果你想让家里32位处理器的老电脑发挥余热，或者是追求更高的定制性，就需要自行编译配置。

这篇教程，可以说填补了OMV官方文档缺少自行构建指导的坑，旨在满足专业玩家的需求。相信这篇教程能对你有所帮助。

参考资料

OMV系列教程1——在Debian上安装OpenMediaVault开源NAS系统

Unmask a Masked Service in Systemd - Ruan Bekker

Why are some systemd services in the “masked” state?

Install OMV5 on Debian 10 (Buster) OMV 5.x (development) - Openmediavault Forum

使用OpenMediaVault构建您自己的NAS

准备