Debian 12 安装 OpenMediaVault 指南

OpenMediaVault 7（OMV7）在 Debian 12（bookworm）上的安装指南。OMV 是基于 Debian 的开源 NAS 发行版，只支持 Debian 系，不支持 CentOS/Ubuntu 22.04 作为独立服务器系统。本文给出官方一键脚本、手动配置源、离线/受限环境安装、容器内安装、首次登录与 admin 初始化，含实测版本 7.7.24-7 与关键服务验证。

OpenMediaVaultOpenMediaVault2026/10/06

Debian 12 安装 OpenMediaVault 指南

目标：在 Debian 12（bookworm，amd64）上安装 OpenMediaVault 7（代号 sandworm），完成 Web 界面、engined、nginx/php-fpm、monit、SMB/NFS 等组件就绪，并通过版本与核心服务验证。本文命令与输出均来自 Debian 12 容器实测（openmediavault 7.7.24-7）。

1. 前置说明

  • OpenMediaVault（OMV）是基于 Debian 的 NAS 发行版，官方只支持 Debian 系（OMV 7 对应 Debian 12 bookworm；OMV 8 对应 Debian 13 trixie）。
  • 不支持以 CentOS、Ubuntu 22.04 作为安装基底系统；若坚持用 Ubuntu 系，只能在其上先装 Debian 风格容器或用 OMV 官方 ISO。因此本文围绕 Debian 12 提供，与其它组件"CentOS/Ubuntu 两版"的写法不同。
  • OMV 官方脚本默认装 OMV 8（Debian 13）。若要在 Debian 12 装 OMV 7，需使用支持 bookworm 的脚本版本（见 §3）。
  • OMV 官方不提供 Docker 服务器镜像（社区明确 OMV does not work in Docker）；容器内安装需自建 systemd 镜像并绕开该检测（见 §6）。

2. 系统要求与准备

  • Debian 12 (bookworm) amd64，systemd 作为 PID1 运行。
  • root 权限；至少 2 GB 内存、数 GB 磁盘。
  • 建议独立数据盘（用于 /srv 存储与共享）；测试可用 loop 文件充当（见 §5）。

3. 在线一键安装（官方脚本，Debian 12/OMV 7）

OMV 官方脚本仓库 OpenMediaVault-Plugin-Developers/installScript 的 master 现在只支持 OMV 8/Debian 13。需要书签找到仍支持 bookworm 的历史版（如 09bc6dba），拉取 install 脚本：

wget -O /opt/install https://raw.githubusercontent.com/OpenMediaVault-Plugin-Developers/installScript/09bc6dba86686fa32f048d47e7cb533da933008b/install
bash /opt/install -m -r
  • -m：使用清华 tuna 镜像（中国大陆安装更快）。
  • -r：跳过结尾重启（容器/受限环境适用；真机可去掉让脚本自动重启）。
  • 脚本根据 lsb_release --codename 自动识别：bookworm → sandworm(OMV 7)、trixie → synchrony(OMV 8)。

脚本关键流程（真实日志节选，2026-10-06 实测）：

[omvinstall] script version :: 3.0.4
Debian :: bookworm
sandworm :: 7
Installing openmediavault required packages...   (postfix)
Installing openmediavault...                    (apt install openmediavault)
omv-confdbadm populate
omv-salt deploy run hosts
Installing CPU power package: cpufrequtils ...
Downloading omv-extras ...  (openmediavault-omvextrasorg_latest_all7.deb)
omv-aptclean repos ...
Salt state (omv-salt … ) ...
Succeeded: 92 (changed=35)
Failed:     0
Total states run:     92
Total run time:    5.969 s
[omvinstall] Done.

安装结束后需重启（真机）使网络与内核模块生效。

4. 手动配置源安装（离线/受限环境）

先装依赖与密钥，再添加 OMV 仓库：

# 基础依赖
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y postfix gnupg wget monit

# OMV 仓库密钥（dearmor 转 gpg）
wget --quiet -O- <OMV源码包密钥URL> | gpg --dearmor -o /etc/apt/trusted.gpg.d/openmediavault-archive-keyring.gpg

# OMV 7 仓库（sandworm）
echo "deb [signed-by=/etc/apt/trusted.gpg.d/openmediavault-archive-keyring.gpg] \
  https://packages.openmediavault.org/public sandworm main" \
  > /etc/apt/sources.list.d/openmediavault.list

apt-get update
apt-get install -y openmediavault openmediavault-keyring

# 初始化配置数据库与主机
omv-confdbadm populate
omv-salt deploy run hosts

真机可将 /etc/apt/sources.list 中的 Debian 源替换为内网镜像，配合离线 apt 缓存（apt-get download 收集 .deb 后 dpkg -i *.deb）实现内网离线安装。

5. 存储准备（共享前必需）

OMV 的共享文件夹必须挂载在某文件系统挂载点上。测试环境可用 loop 文件模拟一块磁盘：

dd if=/dev/zero of=/srv/testfs.img bs=1M count=1200
mkfs.ext4 -F /srv/testfs.img
mkdir -p /srv/testfs && mount -o loop /srv/testfs.img /srv/testfs

在 Web 界面"存储 → 文件系统"登记后，通过 salt 部署写入 /etc/fstab（实测）：

# >>> [openmediavault]
/dev/loop17             /srv/testfs     ext4    defaults,noatime        0 0
# <<< [openmediavault]

6. 容器内安装（测试/CI 用，需绕开检测）

官方脚本检测到容器会退出（Docker detected. OMV does not work in Docker!）。测试可用 systemd 系 Debian 12 镜像并在容器内删除 /.dockerenv：

docker run -d --privileged --name omv-deb12 --tmpfs /run --tmpfs /run/lock \
  --cgroupns=host -v /sys/fs/cgroup:/sys/fs/cgroup:rw \
  -p 8080:80 -p 445:445 -p 139:139 debian12-systemd
docker exec -it omv-deb12 bash
rm -f /.dockerenv                      # 绕过 Docker 检测（容器测试专用）
bash /opt/install -m -r

7. 首次登录与系统验证

  • Web 登录：http://<服务器IP>，默认 admin 用户；OMV7 首次会将 admin 初始化为默认口令并在首登引导修改（生产务必立即改密）。
  • 版本与包校验（实测）：
dpkg -l | grep -E "^ii  openmediavault" | awk '{print $2, $3}'
# openmediavault 7.7.24-7
# openmediavault-keyring 1.0.2-2
# openmediavault-omvextrasorg 7.0.6
  • 核心服务（实测 systemctl is-active）：
openmediavault-engined  active   # OMV 引擎（RPC 后端）
nginx                   active   # Web 界面
php8.2-fpm              active   # Web 后端 PHP
monit                   active   # 进程监控
  • Web 界面可达性（实测）：
curl -s http://localhost/ | grep -o "<title>[^<]*</title>"
# <title>openmediavault Workbench</title>

8. 常见问题

  • 脚本只装 OMV 8：master 脚本已只支持 trixie；Debian 12 务必用 §3 的历史脚本版本。
  • 容器内报 Docker detected：删除 /.dockerenv；但 OMV 在容器内共享层功能受限（见 SMB/NFS 专文）。
  • omv-confdbadm create 报 Permission denied … create.d/：create 属打包期工具，运行期建对象走 Web 界面或 omv-rpc。
  • OMV 不支持 CentOS/Ubuntu 体系：如需类似 NAS，考虑在 Ubuntu 用 Samba+NFS 方案或其他 NAS（见本组件其它文档）。
Debian 12 安装 OpenMediaVault 指南 - Quzuo