OMV 命令速查

OMV 自带一组 omv-* 命令，大多放在 /usr/sbin。下面所有命令都在 OMV 的 shell（本机控制台或 SSH，root 身份）里执行，不写 sudo。omv-salt、omv-confdbadm、omv-sysinfo 支持 Tab 补全，输入命令后按两次 Tab 就能列出可用的子命令或模块名。

标「改配置」「中断服务」的命令先看这里

影响范围：这类命令会重写配置文件、重启服务或升级软件包。执行期间 Web 界面、SMB、NFS 等服务可能短暂不可用，SSH 会话可能断开。
前置条件：系统盘有可用的备份，见备份系统盘。改网络相关的操作要在本机控制台旁边做，别通过会被断开的 SSH 做。
怎么回退：配置类改动通过界面或 omv-firstaid 回退；升级类操作靠系统盘备份回退。
会直接改写配置数据库的命令（omv-confdbadm 的 create、update、delete、migrate、populate）本页只写用途，不给可复制的写入示例，原理和风险见配置数据库。

日常会用到的命令

命令	作用	执行位置	风险提示
`omv-firstaid`	文本救援菜单，界面打不开或改坏网络时用，菜单项见下一节	OMV 的 shell，最好在本机控制台	改配置：部分菜单项会改网络、重置密码、恢复配置
`omv-sysinfo`	收集系统信息：OMV 与 Debian 版本、日期、主机名、网络、mdadm、monit、磁盘与挂载、apt 源、插件列表等。`-l` 列出所有检查项，`-c <类别>` 只跑一类（例如 20 是网络，40 是文件系统），`omv-sysinfo <名称>` 只跑一项。`诊断 → 报告`（Diagnostics → Report）生成的就是它的输出	OMV 的 shell	只读。输出里有主机名、IP、序列号，贴出去之前先脱敏
`omv-upgrade`	非交互的升级：先 `apt-get update`，再模拟一次升级，如果模拟结果会移除 `openmediavault` 包就中止，否则执行 `apt-get dist-upgrade`	OMV 的 shell	中断服务：升级会重启服务，有时需要重启系统。日常更新更建议用 `系统 → 更新管理 → 更新`（System → Update Management → Updates），见系统更新
`omv-release-upgrade`	把 OMV 7 升级到 OMV 8，同时完成 Debian 12 到 13 的发行版升级。只在大版本的最后几个小版本里提供（OMV 7 从 7.7.24-6 起），OMV 8 当前版本里没有这条命令	OMV 的 shell	中断服务，改变范围大：先备份系统盘，步骤见大版本升级
`omv-env`	管理环境变量（`OMV_*`）：`list` 列出所有可用变量，`get` 查看已设置的变量，`set` 设置，`unset` 删除。值保存在 `/etc/default/openmediavault`	OMV 的 shell	`list`、`get` 只读；`set`、`unset` 改配置，改完要按环境变量里的步骤让它生效
`omv-salt`	部署配置，子命令见下一节。界面上点应用，后台就是在跑 `omv-salt deploy run`	OMV 的 shell	中断服务：会重写配置并重启服务
`omv-confdbadm`	直接读写配置数据库，子命令见下一节	OMV 的 shell	`read`、`exists`、`list-ids` 只读；其余会改数据库
`omv-rpc`	调用后端 RPC：`omv-rpc [-u <用户>] <服务> <方法> [JSON 参数]`，默认用 admin 身份，输出 JSON	OMV 的 shell	读类方法（`get…`、`enumerate…`）只读；`set…`、`create…`、`delete…` 等于绕过界面直接改配置，见 omv-rpc 与 JSON-RPC 接口
`omv-run`	执行一条命令，并可把输出用邮件发出：`-e` 发邮件，`-s <主题>` 设主题，`-a <邮件头>` 追加邮件头，`-u <用户>` 指定收件用户（默认 root）。自己写脚本、想把某条命令的输出用邮件发出去时可以用它	OMV 的 shell	取决于被执行的命令
`nginx_ensite`、`nginx_dissite`	启用、停用一个 nginx 站点：`nginx_ensite <站点名>`。操作的是 `/etc/nginx/sites-enabled/` 里的符号链接，站点文件要先放进 `sites-available`	OMV 的 shell	改配置。不要对 `openmediavault-webgui` 用 `nginx_dissite`，Web 界面会打不开
`omv-btrfs-scrub`	对所有已挂载的 Btrfs 文件系统逐个做 scrub，`-e` 把报告邮件发给 root。默认读写模式，有冗余时会修复坏块；优先级和只读开关用环境变量 `OMV_BTRFS_SCRUB_PRIORITY`、`OMV_BTRFS_SCRUB_READONLY` 调	OMV 的 shell	I/O 负载高、耗时长，别和备份、RAID 同步同时跑，见 Btrfs 维护
`omv-sfsnapadm`	管理共享文件夹的 Btrfs 快照：`list` 列出快照，`cleanup` 按保留策略清理，`cleanup -s` 只模拟	OMV 的 shell	`list` 只读；`cleanup` 会删除超出保留数量的快照，丢数据：先用 `-s` 看清会删什么，见共享文件夹快照

先用这几条只读命令看一眼系统，都是安全的：

# 在 OMV 的 shell（root）执行，只读
omv-sysinfo -l                                    # 列出全部检查项
omv-sysinfo -c 20                                 # 只看网络类信息
omv-salt deploy list-dirty                        # 有哪些模块在等待「应用」
omv-env get                                       # 已设置的环境变量
omv-confdbadm list-ids                            # 列出全部数据模型 ID
omv-confdbadm read --prettify conf.service.ssh    # 读取 SSH 服务的配置
omv-rpc System getInformation                     # 版本、CPU、内存、内核等信息（JSON）

omv-firstaid 的菜单项

菜单项在界面上是英文。每个菜单项的详细用法见 omv-firstaid 救援工具。

菜单项	作用	风险提示
Configure network interface	重新配置网络接口，改坏网络后的救命菜单	中断服务：IP 可能变化，当前 SSH 会断开
Configure time zone	设置时区	改配置
Configure workbench	设置 Web 界面的 HTTP 端口，以及是否启用 HTTPS、HTTPS 端口、证书、是否只允许 HTTPS	中断服务：改端口后 Web 界面的地址会变
Change Workbench administrator password	重置 Web 管理员密码	改配置
Reset failed login attempt counter	清零登录失败计数，账户因输错密码被锁时用	改配置
Restore configuration backup	找到最新的 `config.xml.<序号>` 修订副本，显示与当前配置的差异，确认后用它覆盖当前配置。修订副本只在「保存后、应用前」存在	改配置：会覆盖当前配置，确认前先看差异
Check configuration status file	检查 `dirtymodules.json` 是不是合法的 JSON，不合法就删掉它	改配置：被删掉的待应用清单要靠重新保存或手动部署找回
Check RRD database	检查性能统计的 RRD 文件，删除无效的：不是 RRD 文件的直接删，时间戳在未来的会先询问	改配置：被删除的文件对应的历史曲线会丢失
Refresh APT package lists and clean caches	清空 APT 缓存和软件包列表后重新 `apt-get update --fix-missing`，8.3.0 起提供	改配置：之后要重新下载索引
Clear local upload package repository	清空本地上传软件包仓库	改配置
Submit diagnostic report to administrator	把诊断报告用邮件发给管理员；邮件服务没启用时可以复制到 U 盘	只读，报告里有主机信息
Disable Workbench administrator's 2FA TOTP	由 2FA 插件提供，管理员被两步验证锁在门外时关闭它	改配置：关闭后记得重新启用

omv-salt 与 omv-confdbadm 的子命令

命令	作用	执行位置	风险提示
`omv-salt deploy list`	列出所有可部署的模块（服务）名	OMV 的 shell	只读
`omv-salt deploy list-dirty`	列出被标记为「待应用」的模块	OMV 的 shell	只读
`omv-salt deploy run <模块>`	重新部署一个或多个模块。`--append-dirty` 会把待应用的模块一起部署，成功后清空待应用列表；`-q` 安静模式	OMV 的 shell	中断服务：重写配置文件并重启对应服务
`omv-salt stage list`	列出阶段：`prepare`、`setup`、`deploy`、`all`	OMV 的 shell	只读
`omv-salt stage run prepare`	让 Salt 使用的环境变量等数据保持最新，并同步各模块。改了环境变量之后先跑它	OMV 的 shell	改配置
`omv-salt stage run deploy`	重新部署所有服务的配置	OMV 的 shell	中断服务：所有受管服务都可能重启
`omv-salt stage run all`	`prepare` 加 `deploy`	OMV 的 shell	中断服务
`omv-confdbadm list-ids`	列出所有数据模型 ID	OMV 的 shell	只读
`omv-confdbadm read`	读取配置对象并输出 JSON，参数是数据模型 ID，可加 `--prettify`、`--uuid`、`--filter`，`--defaults` 打印默认值	OMV 的 shell	只读
`omv-confdbadm exists`	判断配置对象是否存在，退出码 0 表示存在	OMV 的 shell	只读
`omv-confdbadm create`、`update`、`delete`	直接创建默认配置、更新、删除数据库里的配置对象	OMV 的 shell	改配置数据库：绕过界面的校验，写错会让界面报错。只写用途，不给示例
`omv-confdbadm migrate`	应用配置迁移，升级软件包时由 OMV 自己调用	OMV 的 shell	改配置数据库，不要手动运行
`omv-confdbadm populate`	往数据库里填充默认配置，在 Debian 上手动安装 OMV 时用一次，见在 Debian 13 上安装 OMV	OMV 的 shell	改配置数据库

内部辅助命令

这些命令由 OMV 自己调用，平时不需要手动运行。认识它们是为了看日志和排错时知道谁在干什么。

命令	作用
`omv-engined`	RPC 守护进程，运行全部 PHP 后端代码。由 systemd 单元 `openmediavault-engined` 启动，monit 看护。别手动再起一个，要重启用 `systemctl`
`omv-mkaptidx`	重建插件索引和可升级软件包索引，`apt-get update` 之后会自动触发。`系统 → 插件`（System → Plugins）的列表来自它生成的 `/var/lib/openmediavault/apt/pluginsindex.json`
`omv-mkworkbench`	根据各插件的导航、路由、仪表盘、日志、翻译定义重建 Workbench 的配置文件，安装和卸载插件时自动运行。插件装完界面不对，先硬刷新浏览器
`omv-mkrrdgraph`	用 RRD 数据生成性能统计的曲线图，由 cron 调用
`omv-btrfs-dfree`	给 Samba 的 `dfree command` 用，在 Btrfs 上报告正确的剩余空间

插件带来的命令

命令	来自	作用	执行位置	风险提示
`omv-aptclean`	omv-extras	清理 APT 缓存并重建索引，带 `repos` 参数时还会重写 omv-extras 与 Docker 的软件源。`系统 → omv-extras`（System → omv-extras）的 apt clean 和 apt clean repos 按钮调用它	OMV 的 shell	改配置：`repos` 会删除 `sources.list.d` 里内容含 docker 的文件，见配置文件与目录索引
`omv-changebackports`	omv-extras	`YES` 或 `NO` 开关 Debian backports 内核，并重新部署 APT 配置	OMV 的 shell	改配置：会删掉 `/etc/apt/sources.list` 里的 backports 行
`omv-showkey`	omv-extras	打印 `config.xml` 里某一节，例如 `omv-showkey fstab`	OMV 的 shell	只读
`omv-compose-run`	Compose 插件	用和插件完全一样的参数对一个栈运行 `docker compose`，见服务与日志命令	OMV 的 shell	取决于所跑的子命令
`omv-onedrive-auth`	官方 onedrive 插件	完成 OneDrive 授权，启用插件并应用配置后要以 root 运行一次	OMV 的 shell	改配置
`omv-restore-helper`	backup 插件	在救援系统里把系统盘备份恢复到目标盘，会覆盖目标盘，只能在救援环境里用	救援系统	丢数据：只写用途，步骤见备份系统盘
`omv-mkraid`、`omv-rmraid`	官方 md 插件	创建、删除软件 RAID 阵列，由 `存储器 → RAID 管理`（Storage → Multiple Device）页面调用	OMV 的 shell	丢数据：不要手动运行，见软件 RAID
`omv-installproxmox`、`omv-kernelfamily`、`omv-removekernels`、`omv-installiso`、`omv-writeiso`	内核插件	安装 Proxmox 内核、设置启动家族、移除内核、安装救援 ISO、把 ISO 写到盘上	OMV 的 shell	丢数据与中断服务：由 `系统 → 内核`（System → Kernel）调用，`omv-writeiso` 会擦除目标盘，见内核插件

OMV 命令速查 ​

日常会用到的命令 ​

omv-firstaid 的菜单项 ​

omv-salt 与 omv-confdbadm 的子命令 ​

内部辅助命令 ​

插件带来的命令 ​

继续浏览 ​