在树莓派等 ARM 设备上安装

ARM 设备走的是「先装 Debian 13，再装 OMV」这条路，和在 Debian 13 上安装 OMV是同一个思路。官方文档的说法是：树莓派用 omv-extras 的 installScript，Armbian 支持的开发板可以用 armbian-config。本篇以 OMV 8 的 omv-extras wiki 为准，讲树莓派的完整流程，再说明其他开发板和 installScript 的副作用。

哪些设备能装

OMV 8 只支持 64 位，ARM 上就是 arm64。omv-extras 的 OMV 8 兼容性页面给出的结论：

设备	能否装 OMV 8
树莓派 3B、3B+、3A+、4、400、5，Compute Module 3+、4、5	支持，前提是用 64 位系统
树莓派 1、Zero、Zero W、2 的旧版（v1.0）	不支持，只有 32 位
其他开发板（Armbian 支持的）	看系统是不是真正的 64 位，见下

omv-extras 的新手指南补充：树莓派 4 及以上用起来没问题，3B 能装但不推荐，CPU 一满，OMV 可能在网络里消失，或者共享打不开。开发板的挑选见ARM 单板机怎么选。

不支持的情况：桌面版镜像、Ubuntu 镜像、Debian 13 以外的版本、Armbian 页面底部的「Rolling releases from CI pipeline」和「Dedicated」镜像。Armbian 要选 Trixie 的 Minimal/IOT 或 CLI 镜像。

安装前先自检：必须是 64 位

OMV 8 不支持 32 位（Salt 只支持 amd64 和 arm64）。系统装好之后、运行任何 OMV 脚本之前，先在树莓派或开发板上确认，Raspberry Pi OS 和 Armbian 都一样：

# 在树莓派或开发板上执行（装 OMV 之前，普通用户或 root 都行）
uname -m
dpkg --print-architecture
grep VERSION_CODENAME /etc/os-release

uname -m	dpkg --print-architecture	结论
aarch64	arm64	完整的 64 位系统，可以继续
aarch64	armhf	64 位内核加 32 位用户空间，不能装 OMV 8
armv7l	armhf	纯 32 位系统，不能装 OMV 8

第三条命令应输出 VERSION_CODENAME=trixie，也就是 Debian 13。架构不对，或者不是 Trixie，就换成 64 位的 Trixie 镜像重新写卡，不要硬装。installScript 自己也只接受 Debian 13，并且只认 amd64 或 arm64，别的会直接退出。

开始之前

• 必须有线网络。 整个过程都要联网，而且 wiki 反复强调不要预先配置 Wi-Fi，也不要在装 OMV 之前运行 raspi-config。需要无线的话，装完在 OMV 界面里配，见代理与无线网络。
• 一张高质量的新 SD 卡。wiki 的建议是 8 GB 起步、16 GB 更耐用，选知名品牌、A1 等级以上，最好两张，装完克隆一张备份。电源要够用。
• 用 USB 固态盘做系统盘通常比 SD 卡耐久，取舍见系统盘怎么选。官方 FAQ 对 U 盘系统盘的提醒很直接：不做减少写入的优化，介质往往几周内就开始出问题。闪存介质同理，所以 installScript 默认会装 writecache 插件，见 writecache。
• 一台能 SSH 的电脑，和你路由器的管理页面，用来找开发板的 IP。

写卡会清空 SD 卡，脚本会改很多东西

• 影响范围：写入镜像会清空整张 SD 卡。installScript 会重写网络配置、卸载 NetworkManager、dhcpcd5 和 cloud-init，开启 root 的 SSH 密码登录，关闭性能统计采集，最后自动重启。不想让它动网络，运行时加 -n，见下文。完整清单见「installScript 做了什么」。
• 前置条件：用一张全新的卡，系统是全新的 Debian 13；有线网络；准备好显示器和键盘，万一重启后 IP 变了还能在本机查。
• 怎么回退：没有。出问题只能重新写卡。装好后第一件事是克隆 SD 卡，这也是 omv-extras wiki 的建议。

在树莓派上安装

1. 写入 Raspberry Pi OS Lite

用 Raspberry Pi Imager，版本要在 2.0 以上，更早的版本装不了 Debian Trixie。依次选：

1. 设备：你的树莓派型号。
2. 操作系统：Raspberry Pi OS（other）下的 Raspberry Pi OS Lite (64-bit)，这是不带桌面的 Debian Trixie。不要选带桌面的完整版，OMV 不兼容桌面。
3. 存储：你的 SD 卡。
4. 定制选项里设置主机名、地区、时区、键盘和一个用户名密码，这个用户就是后面 SSH 登录用的管理用户。Wi-Fi 一项保持不动。远程访问一项启用 SSH，选密码认证。Raspberry Pi Connect 是个远程访问工具，OMV 是服务器，暴露端口的东西要慎重，建议不启用。
5. 写入。确认「将要擦除」的警告后继续。

界面文字以你的 Imager 版本为准。

2. 第一次启动，找到 IP

接上网线，插卡通电，等 3 到 5 分钟。去路由器的 DHCP 列表里找新设备的 IP。找不到的话接显示器看启动过程；极少数情况要重启路由器再重启树莓派。

3. 更新系统，运行 preinstall

用 Imager 里设的用户 SSH 登录。此时系统还不是 OMV，所以命令用普通用户加 sudo：

# 在树莓派上执行（Raspberry Pi OS，普通用户）
sudo apt-get update
sudo apt-get upgrade -y

然后是 wiki 要求的 preinstall 脚本。我们读过它的源码，只有三件事：装 jq，卸载 cloud-init，按网卡的 MAC 地址写一个 systemd 链接文件，把网卡固定命名为 eth0。先下载、读完，再运行：

# 在树莓派上执行（Raspberry Pi OS，普通用户）
wget -O preinstall https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/preinstall
less preinstall
sudo bash preinstall
sudo reboot

重启后等 3 到 5 分钟，重新 SSH 登录。IP 变了的话，回路由器看一眼。

4. 运行 installScript

# 在树莓派上执行（Raspberry Pi OS，普通用户）
wget -O install https://github.com/OpenMediaVault-Plugin-Developers/installScript/raw/master/install
less install
chmod +x install
sudo ./install

wiki 和仓库 README 给的是一行 wget ... | sudo bash，等于不看内容直接以 root 执行。这个脚本有近千行，2026 年仍在持续更新，建议按上面的方式先读再跑，至少浏览一遍「installScript 做了什么」里列的几项。

想先不动网络，加 -n。 仓库 README 提醒：这个脚本可能改动原有的网络配置，对 Wi-Fi 的影响更大。网络是你自己精心配好的话，用 sudo ./install -n，脚本会跳过最后那一大段网络配置：不卸载 NetworkManager 和 dhcpcd5，不把网卡写进 OMV 的数据库，也不会在最后自动重启，要你自己重启。代价是 OMV 的 网络 → 接口 里是空的，之后要让 OMV 接管网络，需要自己处理原来的网络组件，本站没有验证过这条路径。

脚本跑起来后不要关掉 SSH 窗口，最长要约 30 分钟，结束时会自动重启（加了 -n 或 -r 除外）。重启后用浏览器打开 http://<树莓派的 IP>，用 admin 和 openmediavault 登录，见第一次登录。登录后顶部如果有黄色提示条，点应用。

installScript 做了什么

下面是我们读 install 脚本源码得出的清单。脚本只支持 Debian 13（trixie），检测到在 LXC 里会直接退出。

类别	它做的事
安装的软件	OMV 本体；omv-extras（openmediavault-omvextrasorg）；writecache 插件（加 -f 跳过）
SSH	启用 SSH 服务，允许 root 登录。OMV 的 SSH 默认就开着密码认证，所以这等于开启 root 的 SSH 密码登录。把当前 sudo 用户和 pi 用户加入 _ssh 组，admin 加入 openmediavault-admin 组
监测	关闭性能统计采集（系统 → 监测 里的已启动会是关的），并重新部署 monit、rrdcached、collectd
时间与名称	开启 NTP，把系统当前的时区、主机名、域名写进 OMV 数据库
电源	电源按钮设为「无操作」，待机模式设为关机，设置 CPU 调频策略
网络（ARM 上才执行，加 -n 跳过）	卸载 network-manager、dhcpcd5、cloud-init；把所有网卡写进 OMV 数据库，当前是静态 IP 的保持静态，否则用 DHCP；启用 systemd-resolved；部署 systemd-networkd；预约重启，最后重启（只想跳过重启加 -r）
其他	chmod g-w,o-w /；卸载 udisks2；安装期间让 apt 强制走 IPv4（加 -i 改为允许 IPv6）
树莓派专有	设置看门狗为 14 秒；关闭内核 backports；CPU 调频设为 schedutil
非 amd64 专有	调频策略不是 schedutil 时，创建 /etc/cron.d/make_nas_processes_faster 每分钟给 smbd、nfsiod、ftpd 调 ionice，并让 rsyslog 过滤相关日志

脚本还有个 -m 选项：改用清华 TUNA 的镜像下载 OMV、Debian 的 backports 与 security、omv-extras、Docker 和 Proxmox 的软件包，适合国内网络。镜像的更多设置见软件源、国内镜像与第一次更新。

其他开发板（Armbian）

Armbian 支持的非树莓派开发板，流程相同：选 Trixie 的 Minimal/IOT 或 CLI 镜像，核对 SHA256 后写卡，SSH 登录，做上面的 64 位自检，更新系统，再运行 installScript。有些 Allwinner 板子（如 NanoPi Neo2）的 Armbian 默认是 32 位用户空间，装不了 OMV 8，所以自检不能省。官方文档还提到可以用 Armbian 的 armbian-config 工具一步安装 OMV，并带上性能与可靠性调整，我们没有验证过这条路径。omv-extras 的 Armbian 页面截至 2026-10-23 仍是草稿，建议同样以 installScript 为准。

官方文档里还有一篇「SD 卡镜像」的安装说明，写的是 ARM 镜像开箱即用，首次启动要初始化约 30 分钟，期间不能断电。我们没有找到 OMV 8 的官方 ARM 镜像下载，不确定这一条是否还适用，记为待核实。

检查结果

• 浏览器能登录 OMV，登录后能看到仪表盘。

• 在 OMV 的 shell 里确认系统架构：

  # 在 OMV 的 shell 里执行
  dpkg --print-architecture

  输出 arm64。

• 服务 → SSH（Services → SSH）里，允许 root 登录（Permit root login）是勾着的。这是脚本的副作用，不是你设的。

• 系统 → 监测（System → Monitoring）里，已启动是关着的。想要仪表盘上的性能图表，就勾上，保存，再点应用。

• 系统 → 插件（System → Plugins）里能看到 omv-extras 和 writecache，系统下多出 omv-extras 菜单。需要的话刷新浏览器，Ctrl+Shift+R。

常见问题

脚本跑完，浏览器连不上，SSH 也断了。 IP 可能变了。去路由器看这台设备现在的地址。个别路由器的 DHCP 租期很短，到安装结束时地址已经换了。

脚本报「Unsupported version」。 系统不是 Debian 13。用 cat /etc/os-release 确认，必须是 Trixie。

我想用 Wi-Fi。 OMV 的界面默认不显示树莓派内置的无线网卡，要手动添加：网络 → 接口 → 创建 → Wi-Fi，设备、SSID、密码、IPv4 选 DHCP，保存并应用。服务器尽量走有线，见代理与无线网络。

装完 root 还能用密码 SSH 登录，怎么办。 先建一个属于 _ssh 和 sudo 组的普通用户，确认它能登录，再关闭 root 登录，见 SSH 加固。

想把树莓派做成完整的 NAS。 供电、USB 硬盘、writecache、性能预期，见树莓派 NAS。

参考资料

• Installing OMV8 on a Raspberry PI（omv-extras wiki）
• OMV8 Compatibility（omv-extras wiki）
• installScript 仓库
• Installation on Debian（官方文档）