外观
本站阅读约定
花五分钟读完这页，后面每篇文章的标注你都能看懂，也不会被「点了保存却没生效」这类老问题绊住。
文章顶部的徽章
正文上方有一排小标签，来自文章自带的元数据：蓝色的是难度、来源、许可和版本，黄色的是风险。从左到右依次是：
| 徽章 | 取值 | 含义 |
|---|---|---|
| 难度 | 入门 / 进阶 / 深入 | 入门：面向第一次用 OMV 的读者；进阶：假定你读过相关的基础章节；深入：涉及命令行、底层机制或救援，出问题要自己读日志 |
| 组件来源 | 核心功能 / 官方插件 / omv-extras 插件 / Compose 应用 / 系统层 | 这篇用到的功能从哪里来，见下一节 |
| 许可 | 开源 / 免费使用 / 免费增值 / 订阅 / 买断 | 主要出现在「插件与应用」栏目，说明软件的授权方式 |
| 风险 | 数据丢失风险 / 网络暴露风险 / 服务中断风险 | 见「风险等级」；没有风险徽章就是常规操作 |
| OMV 版本 | 例如 OMV 8.x | 内容所依据的大版本；没有这个徽章，说明内容不随大版本变化，或者各版本通用 |
组件来源是什么意思
OMV 的核心刻意保持精简，很多功能靠插件或容器加上去，所以先分清功能从哪里来：
- 核心功能：OMV 本体自带，装好就有。
- 官方插件：OMV 开发者维护，和核心在同一个仓库，在
系统 → 插件（System → Plugins）里安装。 - omv-extras 插件：社区项目 omv-extras 维护，先装好 omv-extras，才会出现在插件列表里。
- Compose 应用：用 Compose 插件运行的 Docker 容器，不是 OMV 插件。
- 系统层：Debian、内核和命令行这一层，在 OMV 界面之外。
三种来源的区别和怎么选，见插件体系：官方插件、omv-extras 与容器。
风险等级
| 徽章 | 含义 | 你该做的准备 |
|---|---|---|
| （无） | 常规操作：只读检查，或创建新对象 | 直接做 |
| 服务中断风险 | 会让运行中的服务中断，例如重启、改网络、换内核、升级大版本 | 选维护时段，提前通知使用者 |
| 网络暴露风险 | 会把服务暴露到不可信网络，例如端口映射、防火墙放行、FTP | 先想清楚暴露的是什么，做好认证和加密 |
| 数据丢失风险 | 操作错了数据回不来，例如擦除磁盘、创建文件系统、RAID 变更、递归修改 ACL、恢复覆盖、卸载插件 | 先确认独立备份可用，再动手 |
后三档的文章正文里一定有黄色（warning）或红色（danger）的警示块，写明影响范围、前置条件和怎么回退。看到警示块请读完再往下操作，这是本站唯一的硬性要求。
冗余不是备份
RAID、Btrfs RAID1、ZFS 镜像和 SnapRAID 防的是硬盘坏了；备份防的是删错了、被加密了、配置改崩了、整台机器烧了。只有冗余、没有独立备份的 NAS，遇到误删就是全损。本站会反复强调这一句。
界面路径怎么写
OMV 的界面支持中文。本站按官方中文翻译写菜单路径，每篇文章里某个菜单第一次出现时在后面括号附上英文原名，之后只写中文：
- 菜单路径用行内代码和箭头，例如
存储器 → 文件系统（Storage → File Systems）。 - 按钮和字段名用粗体，例如 挂载（Mount）、应用（Apply）。
- 官方译名有时不通顺（例如 Storage 译作「存储器」，Serial Number 译作「序号」），本站照实写，不润色，这样你在界面上能直接对上。
- 找不到官方中文译名时（部分插件菜单没有翻译），写英文原名，并注明「以你界面上的显示为准」。
- 想看英文界面，点右上角的用户图标（用户设置，Profile Settings），在菜单里选 语言（Language）。切到英文后，括号里的英文就是你看到的字样。
菜单位置会随版本和已装插件变化。对不上的时候，先按功能名称搜索，位置变了，名字一般还在。
保存不等于生效
在 OMV 里改完设置点保存，配置只是写进了数据库。页面顶部会出现一条黄色的提示条「待应用的配置更改」（Pending configuration changes），提示条右侧有三个图标按钮，鼠标悬停会显示「显示详情」「撤销」「应用」，对勾图标就是应用。点它并确认之后，配置才会写进系统并生效。「共享建好了但电脑上看不到」，十有八九是没点应用。原理见OMV 是怎么工作的。
命令在哪里执行
命令块前面会说明执行位置，只有三种：
- OMV 的 shell：用 SSH 登录 OMV，或者在 OMV 主机自己的显示器和键盘上登录控制台，以 root 身份执行。本站不写
sudo。如果你已经关掉了 root 的 SSH 登录，就用加入了_ssh和sudo组的普通用户登录，再执行sudo su切到 root（官方文档的做法，见SSH 加固）。 - 客户端电脑：你自己的笔记本或台式机，例如校验安装镜像、映射网络驱动器。
- 容器内部：在 Docker 或 Podman 容器里执行，文中会明确写出来。
需要你替换的部分用尖括号占位，写在代码里，例如：
sh
# 在 OMV 的 shell 里执行
smartctl -i /dev/<磁盘><磁盘> 指设备名，例如 sda，在 存储器 → 磁盘（Storage → Disks）的 设备（Device）列能看到。设备名会随插拔顺序变化，凡是会擦除数据的操作，都要先按型号和序号确认目标盘。
每篇文章的结构
先说完成后的结果，再讲必要的知识和步骤，最后给两块固定内容：检查结果告诉你怎么自己验证做对了，常见问题列出典型症状和下一步该查什么。导读页只列文章和完成标准，没有检查结果。
资料核查与实机核验
徽章下面可能有一行小字，说明这篇文章的验证状态：
- 资料核查：某日期：作者对照官方文档、OMV 源码、omv-extras 的 wiki 和插件源码核对过关键事实，但没有在真实设备上按步骤操作过。这一行后面会补一句「尚无本站实机验证记录，请按文中的检查步骤确认本机结果」。
- 实机核验：某日期：作者在标注的版本和硬件上实际操作过，适用范围见正文。
- 两行都没有：没有核查记录，请把它当作思路参考，不要当操作手册。导读页不显示这一行。
构建通过不等于操作已验证
本站有一套自动检查（元数据、内部链接、附件路径、首页可达性），但它只能保证网站结构正确，不能证明步骤在真实设备上验证过。2026-10-23 的首轮内容全部只做了资料核查，没有任何一篇做过实机验证。涉及数据的操作，请先在测试盘和测试共享上演练，并确保备份可用。
版本差异
OMV 的大版本跟随 Debian：OMV 8（代号 Synchrony）基于 Debian 13。本站以 OMV 8.x 为基线；OMV 7 已在 2026-06 停止支持，只在升级和历史部分出现。大版本之间，软件源格式、菜单位置、插件可用性和命令参数都可能变化，对照表见版本演进。