说到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 -isudo 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.shchmod 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