Openmediavault 编译与安装过程
Openmediavault，简称OMV，是开源NAS解决方案的不二之选，更是黑群晖之外的最佳选择。基于Debian的灵活性，以及低资源占用，使得它能够在各种架构的操作系统上大放异彩，这其中也包括我的上古赛扬D（Celeron D）处理器。
然而，OMV固然好用，它的文档却是个巨坑：教程奇少无比，因为官方都在推荐用他们做好的镜像，对手动安装的专业用户非常不友好；而根据源码编译的教程更是空白，全靠用户自己猜！
于是，在踩了N个坑，失败N次之后，我决定，不要让这空白再继续坑害新入坑的OMV用户了！这篇编译和安装二合一的教程，应运而生。
准备
- 系统：Debian 10 Buster，不带任何桌面环境的基础版本
-
处理器架构：OMV官方推荐的AMD64、ARM、ARM64，以及i386
- 官方不提供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
开始编译
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源密钥环：
# 安装我们自己编译的版本
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
在浏览器中输入主机的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”入口。
网友评论