外观
官方资源与社区
这一页列 OMV 的官方入口和常用的社区资源,按「去哪里查、去哪里问、去哪里下载」分组。外部链接优先指向官方来源,查资料时注意看页面的最后修改日期:OMV 8 发布不久,不少页面还停留在 OMV 6、7 时代。
官方(OMV 项目)
| 资源 | 地址 | 说明 |
|---|---|---|
| 官网 | https://www.openmediavault.org/ | 发布公告和新闻 |
| 官方文档 | https://docs.openmediavault.org/en/stable/ | 英文参考手册。部分内容已过时,例如仍列出已移除的 S3 插件、已被取代的 Flash Memory 插件,更新机制仍写成 cron-apt。与源码冲突时以源码为准 |
| 文档源码 | https://github.com/openmediavault/openmediavault-docs | 文档的 reStructuredText 源文件,发现错误可以在这里提 issue |
| 主仓库 | https://github.com/openmediavault/openmediavault | 核心和官方插件的源码,也是报告 bug 的地方 |
| ISO 下载 | https://sourceforge.net/projects/openmediavault/files/ | 安装镜像,下载后要校验,见下载、校验并制作安装 U 盘 |
| 官方软件源 | https://packages.openmediavault.org/public/ | OMV 本体和官方插件的 apt 源,OMV 8 对应 synchrony |
| 官方论坛 | https://forum.openmediavault.org/ | 使用问题和插件问题多半在这里解决。论坛对脚本抓取返回 403,需要用浏览器访问 |
| 界面翻译 | https://docs.openmediavault.org/en/stable/development/contribute.html | 官方文档的贡献指南里写了如何参与界面翻译:签署贡献者协议,再在 Transifex 上加入 OMV 项目 |
官方文档的 Support 页还列了其他渠道,其中部分条目可能已经不活跃,以官网的当前说明为准。
omv-extras
| 资源 | 地址 | 说明 |
|---|---|---|
| omv-extras wiki | https://wiki.omv-extras.org/ | OMV 8 的页面 id 以 omv8: 开头,例如 omv8:new_user_guide(新手指南)、omv8:docker_in_omv(Docker 指南) |
| 插件仓库组织 | https://github.com/OpenMediaVault-Plugin-Developers | 各 omv-extras 插件的源码和 issue |
| omv-extras 软件源仓库 | https://github.com/OpenMediaVault-Plugin-Developers/packages | apt 索引、安装脚本、Compose 示例清单 |
| 整机安装脚本 | https://github.com/OpenMediaVault-Plugin-Developers/installScript | 给树莓派等设备安装 OMV 和 omv-extras,有副作用,见在树莓派等 ARM 设备上安装 |
wiki 的首页最后修改于 2025-12-18,页面里的插件清单标注的还是 OMV 6.x 和 7.x;OMV 8 的内容从 omv8 栏目进入。wiki 里有些页面仍是「文档编写中,请参考 OMV 7 文档」的占位,引用时留意页面日期。
国内镜像
| 资源 | 地址 | 说明 |
|---|---|---|
| 清华大学 TUNA 镜像帮助页 | https://mirrors.tuna.tsinghua.edu.cn/help/OpenMediaVault/ | 核对时页面已列出 8.0(synchrony)和 7.0(sandworm)等版本,并提醒:OMV 的公钥由软件源自己提供,换镜像后应通过其他渠道确认密钥。配置方法以该页当前内容为准 |
怎么在安装时和安装后换镜像,见软件源、国内镜像与第一次更新。
上游项目文档
OMV 底层是 Debian,很多问题的答案在上游文档里。
| 资源 | 地址 | 什么时候看 |
|---|---|---|
| Debian 文档 | https://www.debian.org/doc/ | 系统层面的问题 |
| Debian 版本页 | https://www.debian.org/releases/ | Debian 各版本的支持周期 |
| Samba 文档 | https://www.samba.org/samba/docs/ | SMB 的扩展选项能写哪些指令 |
| SaltStack 文档 | https://docs.saltproject.io/en/latest/ | 写自定义 Salt 状态时 |
| Docker 文档 | https://docs.docker.com/ | Compose 文件怎么写 |
| SnapRAID | https://www.snapraid.it/ | 校验、同步、修复的原理与命令 |
| mergerfs | https://github.com/trapexit/mergerfs | 策略与选项的完整说明 |
| BorgBackup 文档 | https://borgbackup.readthedocs.io/ | borg 的仓库、归档与保留策略 |
| restic 文档 | https://restic.readthedocs.io/ | restic 的仓库类型与备份命令 |
发布报道
姊妹站
Proxmox VE 使用指南是同一位作者的姊妹站。想把 OMV 装在 Proxmox VE 的虚拟机里,可以看它的 OpenMediaVault:在 PVE 上跑一台轻量 NAS,本站的对应实战场景是在 Proxmox VE 上跑 OMV。
提问之前
- 记下 OMV 版本号,方法见版本对照表。
- 运行
omv-sysinfo或在诊断 → 报告(Diagnostics → Report)里生成诊断报告。分享前遮盖主机名、IP、序列号和密码。 - 选对地方:核心和官方插件的 bug 去主仓库提 issue;omv-extras 插件的问题去对应插件仓库的 issue;使用上的问题去论坛。
- 求助的完整步骤见如何有效求助。