OpenMediaVault Web 界面配置详解

目标：走通 OMV Workbench（http://<ip>）的核心配置链路，包括：首次登录引导、仪表盘、系统设置、文件系统登记、共享文件夹、SMB/NFS 共享、用户与权限、插件、计划任务。相关"界面改变底层产物"均给出真实命令对产物（config.xml 片段 /etc/fstab /etc/samba/smb.conf）。基于 OMV 7.7.24 实测。

1. 登录与界面总览

• URL：http://<服务器IP>；浏览器打开显示 openmediavault Workbench（实测）。
• 默认管理员：用户 admin。OMV7 首次登录会要求修改口令。
• 顶部栏：仪表盘（Dashboard）、存储（Storage）、服务（Services）、系统（System）、插件（omv-extras）等菜单。

2. 首次登录引导

• 首登要求：设置安全口令（最小复杂度）、Hostname、域名、网络接口（DHCP/静态）、时区、E-mail 通知。
• 这些会写入 /etc/openmediavault/config.xml 的网络与系统段，并通过 omv-salt deploy run hosts network 生效。

3. 仪表盘（Dashboard）

• 默认展示：系统信息、CPU 负载、内存、根文件系统占用、网络接口速率。
• 图形数据由 RRD（rrdtool）采集，产物在 /var/lib/openmediavault/rrd/（实测）：

df-root-day.png  df-root-hour.png  df-root-month.png  df-root-week.png  df-root-year.png
load-day.png     load-hour.png     load-month.png     load-week.png     load-year.png

4. 存储 → 文件系统

• 添加磁盘/文件系统：选择未分区磁盘 → 格式化（ext4/xfs/btrfs）→ 挂载点。
• "挂载点"登记后，salt 部署 fstab（实测写入 /etc/fstab）：

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

• 已挂载文件系统可在"存储 → 文件系统"看到挂载状态、容量、用量。命令行对产物：omv-rpc -u admin "FileSystemMgmt" "enumerateFilesystems" "{}"。

5. 访问权限管理 → 共享文件夹

共享文件夹是把"文件系统挂载点下的一个相对目录"注册为可被多个服务（SMB/NFS/rsync）引用的对象。在 访问权限管理 → 共享文件夹 → 添加：

• 名称（name）、备注（comment）、文件系统（选择 §4 的挂载点，即 mntentref）、相对路径（reldirpath，在挂载点下，如 data）。
• 保存后 OMV 立即创建该目录。对应 config.xml 结构（实测）：

<sharedfolder>
  <uuid>ec52a09e-…</uuid>
  <name>TestShare</name>
  <comment>test shared folder</comment>
  <mntentref>7e29f1f0-…</mntentref>   <!-- 引用文件系统挂载点 -->
  <reldirpath>data</reldirpath>
</sharedfolder>

6. 服务 → SMB/CIFS（Windows 文件共享）

• 开启服务：服务 → SMB/CIFS → 设置，勾选"启用"，设工作组与最小协议（默认 SMB2）。
• 添加共享：服务 → SMB/CIFS → 共享 → 添加，选择 §5 的共享文件夹，设置 guest、可读/可写、权限、回收站等。
• 产物为 /etc/samba/smb.conf（实测等价结构）：

[global]
   workgroup = WORKGROUP
   server string = %h OMV test
   security = user
[TestShare]
   path = /srv/testfs
   valid users = smbtest
   read only = no
   browseable = yes

• 重启生效：systemctl restart smbd nmbd（通过 Web 保存即触发）。

7. 服务 → NFS

• 服务 → NFS → 设置开启，服务 → NFS → 共享 → 添加：选择共享文件夹、客户端网段/主机、权限（rw/ro）、同步策略、no_subtree_check、no_root_squash 等。
• 产物为 /etc/exports，exportfs -ra 生效（实测）：

/srv/testfs  172.16.0.0/12(rw,sync,no_subtree_check,no_root_squash)

• 查看导出：showmount -e 127.0.0.1。注意：容器 overlayfs 环境下内核 NFS 拒绝导出 overlayfs 目录（见共享实测专文），真机/虚机上的独立分区路径可正常导出。

8. 用户与权限

• 访问权限管理 → 用户：创建系统用户（可勾选 Shell、SSH）。
• 组 与 共享文件夹权限：在 §5 共享文件夹编辑的"权限"标签，为特定用户/组授予读、读写权限（map 到 privileges/privilege 的 perms 5/7）。
• 命令行对产物：sharepriv 组与 /var/lib/samba passdb。

9. 插件管理与 omv-extras（Docker 等）

• 安装时脚本已装 openmediavault-omvextrasorg（实测 7.0.6）。
• 系统 → omv-extras：启用/禁用 Docker、Portainer、反病毒、proxmox 等插件源；系统 → 插件列出可安装的 openmediavault-* 插件。
• 安装后对应服务即在"服务"菜单出现（如 Docker、SharpSMB、syncthing 等）。

10. 计划任务/定时任务

• 系统 → 计划任务（cron）：可运行 Shell 命令（设定分钟/小时/周期），或定义 @reboot、定时快照（Btrfs）。
• 产物写入 OMV 的 cron 数据模型并使用 systemd timer/cron 触发；可用 omv-confdbadm read conf.system.cron 查看。

11. 配置持久化与备份

• OMV 所有配置集中在单文件 /etc/openmediavault/config.xml，其余 /etc 文件（fstab/smb.conf/exports）均由其 salt 渲染。
• 建议定期备份 config.xml：cp /etc/openmediavault/config.xml /root/config.xml.bak（恢复即"还原系统配置"，前提是版本一致）。
• 配置按数据模型约 72 个（/usr/share/openmediavault/datamodels/*.json）组织，omv-confdbadm read 可逐条查看。

12. 常见问题

• 共享盘写不进去：挂载点目录属主/权限未放开，给共享用户 chown 或在 SMB/NFS 权限设写。
• NFS 在容器内报 does not support NFS export：overlayfs 限制，真机/独立分区可避免。
• 保存后 SMB 未生效：确认 SMB/CIFS 服务已开启且 smbd/nmbd 处于 active。