![](https://cdnfile.sspai.com/2024/05/11/7c44e99432287b5491a63aea9d3273ef.png?imageView2/2/w/1120/q/40/interlace/1/ignore-error/1)
说到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