外观
如何有效求助
OMV 的社区支持是志愿者提供的，官方 wiki 的说法是「免费的（gratis）」。别人能不能帮到你、多快帮到你，很大程度上取决于你给出的信息质量。这一页告诉你：求助前先自查什么、收集哪些信息、怎样脱敏、去哪个渠道发、怎么写。
先自查
- 看本站的故障排查，按症状找对应的文章。
- 搜官方论坛和官方文档。看帖子的日期和对应的 OMV 版本：官方 wiki 提醒，三年以上的帖子可能不再适用于当前版本。
- 确认你的环境在支持范围内：
- OMV 8 只支持 amd64 和 arm64，不支持 32 位硬件；
- OMV 官方明确说明，它需要对系统配置有完全的、独占的控制权，不能装在容器里（包括 LXC），也不能同时装图形桌面环境；
- 树莓派 3B 以前的型号不受支持，wiki 明确要求不要在论坛里为这些型号求助。
- 回想最近改过什么：更新、装插件、加盘、断电、改网络。这往往就是答案，也是别人最想知道的信息。
系统被「改造」过，很难得到帮助
官方文档指出，把 OMV 升级到 Debian testing 或 unstable、从 backports 和 testing 装软件包、装 Apache 之类的操作，结局很可能是 Web 界面损坏。遇到这种情况，请在求助时如实说明，否则别人会在错误的前提下替你排查。
求助前要准备的信息
描述问题时，至少包含这些：
- 现象：错误提示的原文（复制文字，不要只发截图），发生的时间点。
- 复现步骤：点了什么，看到了什么，你期望看到什么。
- 最近的变更。
- 环境：OMV 的版本、安装方式（ISO、在 Debian 上安装、树莓派、虚拟机）、硬件（CPU、内存、系统盘类型、数据盘的型号和连接方式、网卡）、装了哪些插件。
- 已经试过什么，结果如何。
OMV 版本和插件列表，在 shell 里这样取：
sh
# 在 OMV 的 shell 里执行（只读）
dpkg -l openmediavault
dpkg -l 'openmediavault-*'Web 界面里的错误，官方文档建议截图保留详细的错误信息（backtrace），才能判断到底是哪里出了问题。
用 omv-sysinfo 生成系统报告
omv-sysinfo 是 OMV 自带的诊断脚本合集，一次收集版本、网络、文件系统和软件包信息，是论坛里最常被要求的东西。有两种取法。
方式一：Web 界面。 打开 诊断 → 报告（Diagnostics → Report），页面显示的就是 omv-sysinfo 的输出，页面上有复制到剪贴板的按钮。
方式二：命令行。
sh
# 在 OMV 的 shell 里执行（以 root 身份，本机控制台或 SSH）
omv-sysinfo > /root/omv-sysinfo.txt然后通过 SFTP 或 scp 把文件取回本机，脱敏后再使用。
常用的几种用法（来自 usr/sbin/omv-sysinfo 的源码）：
| 用法 | 作用 |
|---|---|
omv-sysinfo | 运行全部诊断脚本 |
omv-sysinfo -l | 列出可用的诊断脚本，它们放在 /usr/share/openmediavault/sysinfo/modules.d/ |
omv-sysinfo -c 40 | 只运行某一类脚本，40 是类别号，这里是文件系统相关 |
omv-sysinfo blkid | 只运行某一个脚本，可以只写脚本名的一部分，但要保证只匹配到一个 |
报告里有什么
脚本按编号分类，默认包含的内容如下，右边一列是分享前要特别留意的地方：
| 类别 | 内容 | 要留意的敏感信息 |
|---|---|---|
| 00 | Debian 和 OMV 的版本 | 无 |
| 10 | 日期、主机名、区域设置、内核版本、运行时间 | 主机名、域名 |
| 20 | ip addr（含 MAC 地址）、各网卡的 ethtool 信息、iptables 规则、路由表、ss -na（全部套接字，含连接对端的地址） | 内网和公网 IP、MAC 地址 |
| 30 | /proc/mdstat 和 mdadm.conf，monit status | mdadm.conf 里的邮箱地址、阵列 UUID |
| 40 | df、blkid（UUID 和标签）、/etc/fstab、挂载信息、分区表 | 磁盘标签、远程挂载的服务器地址 |
| 50 | apt 源、完整的软件包列表、OMV 插件和更新索引 | 私有软件源的地址和凭据 |
它不包含：S.M.A.R.T. 信息、dmesg、CPU 与 PCI、USB 硬件信息、容器信息、各服务的日志。此外，第 50 类只输出 sources.list.d 里的 .list 文件，新格式的 .sources 文件（omv-extras 用的就是）不在其中。这些要根据问题类型另外补充。
按问题类型补充
| 问题类型 | 额外附上 |
|---|---|
| 磁盘、文件系统、RAID | lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINT,MODEL,SERIAL、smartctl -a /dev/<磁盘>、journalctl -k -b -p warning、cat /proc/mdstat |
| 打不开界面、登录、502 | systemctl status nginx php8.4-fpm openmediavault-engined --no-pager、tail -n 50 /var/log/nginx/openmediavault-webgui_error.log、journalctl -u openmediavault-engined -b --no-pager -n 50 |
| 更新、插件、应用配置 | apt-get update 的完整输出、cat /etc/apt/sources.list.d/*.sources、dpkg --audit、omv-salt deploy list-dirty、失败任务里 Result: False 那一段 |
| 网络、共享 | ip -br addr、ss -tlnp、testparm -s、journalctl -u smbd --no-pager -n 100 |
| 容器 | compose 文件（先删密码）、docker ps -a、omv-compose-run <栈名> logs --tail 100 |
| 性能 | uptime、top -b -n 1、free -h、iperf3 的结果 |
| 系统起不来 | 停住画面的照片；能进系统之后的 journalctl -xb --no-pager -n 100 |
分享之前一定要脱敏
日志和报告里夹带的信息，比你想的多。分享之前逐行检查。
| 要处理的内容 | 怎么处理 |
|---|---|
| 主机名、域名 | 换成统一的占位符，例如 NAS-HOST、example.lan |
| IP 地址（内网和公网）、MAC 地址 | 换成文档专用地址（如 192.0.2.10）和假 MAC。同一个地址永远替换成同一个占位符，这样别人仍能看懂网络关系 |
| 邮箱地址、SMTP 服务器、账号 | 删除或替换 |
密码、令牌、API Key、VPN 密钥（WireGuard、Tailscale）、Compose 的 .env 文件里的变量 | 整段删除 |
URL 里的凭据，例如 https://用户:密码@主机 | 删除凭据部分。注意 apt 源、远程挂载、rclone 配置里可能有 |
| 序列号、WWN | 酌情遮盖。UUID 本身不算机密，但能标识你的磁盘 |
| 内部的用户名、共享名 | 如果不想公开，替换掉 |
| 截图 | 遮盖 IP、主机名、序列号和任何账号信息 |
这些内容永远不要贴出来
- 整份
/etc/openmediavault/config.xml。它是 OMV 的配置数据库，里面可能有邮件通知用的 SMTP 账号和密码、代理的账号和密码、用户的 SSH 公钥等。 /etc/shadow、SSH 私钥、Samba 的密码库、没有处理过的.env文件。- 没有处理过的整屏截图。
一旦不小心发出去了，立刻修改对应的密码和密钥，并请版主编辑或删除帖子，因为内容可能已经被缓存或收录。
发出去之前，可以用下面的命令把可疑的行先找出来，再逐行判断：
sh
# 在你保存报告的机器上执行；输出里匹配到的每一行都要人工检查
grep -n -i -E 'pass|token|secret|key|@' omv-sysinfo.txt去哪里求助
官方论坛：首选
地址：https://forum.openmediavault.org/
- 支持类的问题先到论坛，不要直接提 GitHub issue（见下一节）。
- 先搜索。发帖时选最贴近的版块：论坛里有指南（Guides）、Docker、omv-extras 等专门的板块。
- 版本、相关的日志和命令输出、硬件平台，是官方 wiki 要求的最低限度。没有这些信息，再有经验的成员也帮不上忙。
- 官方论坛和 GitHub 上的主要交流语言是英文（论坛有哪些语言版块，以你在论坛首页看到的为准），建议用英文描述，报错信息和命令输出保持原文，不要翻译。
- 要有耐心：回复可能要等几天。
- 较长的帖子、带外部链接的帖子，可能被垃圾邮件过滤器扣下等待审核。官方排障页的提醒是：不要反复重发，等待审核即可。
- 有人给出建议，要回帖反馈结果，不管有没有解决。
- 存储问题要特别小心：官方 wiki 提醒，处理文件系统、磁盘、阵列问题时，有经验的成员默认你有完整备份，所以他们的建议可能导致数据丢失。先确认你的数据是安全的，再动手。
wiki 还推荐了论坛里一个持续维护的帖子 Solutions to Common Problems，本站没有核对它的内容。
GitHub issue：被版主建议时才用
地址：https://github.com/openmediavault/openmediavault/issues
官方 bug 模板的第一句话是：只有在论坛的版主建议你这样做时，才在这里提 issue；求助和提问要先去论坛。模板要求填写：
- 现象、复现步骤、期望的行为、截图；
- 论坛帖子的链接；
- 服务器环境：
uname -a的结果、dpkg -l | grep openmediavault里的 OMV 版本； - 客户端环境：设备、操作系统、浏览器及其版本。
功能需求有单独的模板。这个仓库里有 OMV 核心和官方插件（md、lvm2、ftp、nut、2FA 等）。文档里的错误，可以到官方文档仓库 https://github.com/openmediavault/openmediavault-docs 反馈。
安全漏洞：不要公开提 issue
如果你认为发现了 OMV 的安全漏洞，按官方的 SECURITY.md，发邮件到 security [at] openmediavault [dot] org，并且在官方发布修复之前不要公开披露。报告里要写清漏洞的影响、复现步骤、受影响的版本，以及你已有的缓解办法或补丁。
下面这些不属于安全报告：不涉及安全的普通 bug；Debian、PHP、Python、Samba、nginx 等底层软件的问题；只有管理员自己才能利用的问题。
omv-extras 插件的问题
先分清你用的是哪种插件：官方插件与 OMV 在同一个仓库，omv-extras 插件由社区维护，两者的反馈渠道不同。对照插件与应用的总表确认。
- 官方 bug 模板明确写着：**非核心插件的问题，要到
OpenMediaVault-Plugin-Developers组织下对应的仓库去提。**组织地址是 https://github.com/OpenMediaVault-Plugin-Developers，每个插件一个仓库，名字通常是openmediavault-<插件名>，issue 页是仓库地址加/issues。 - 以 omv-extras 的 filemanager 插件页为例：用法类的问题，发到论坛里的 omv-extras 板块；bug 和功能需求，提到插件仓库的 issue 里。
- omv-extras 的文档和说明在 https://wiki.omv-extras.org/。
- 个别插件的源码在第三方仓库（例如
openmediavault-imagecheck），以插件的说明页和仓库为准。
不属于 OMV 的问题
- 容器里应用自己的问题，去那个应用的官方渠道。omv-extras 的文档也指出，Docker 应用跑不起来，绝大多数情况和 OMV 或 Compose 插件无关。
- Debian、内核、硬件兼容性：官方 FAQ 的说法是参考 Debian 的硬件兼容性列表。
- 本站是非官方的教程，没有技术支持渠道，问题请到上面的官方渠道反馈。
帖子模板
text
标题：一句话说清症状，例如「OMV 8.x 更新时报 NO_PUBKEY」
【环境】
- OMV 版本：
- 安装方式：（ISO / 在 Debian 上安装 / 树莓派 / PVE 虚拟机）
- 硬件：CPU、内存、系统盘、数据盘（型号和连接方式）
- 相关的插件：
【现象】
（错误提示的原文，发生的时间点）
【复现步骤】
1.
2.
【最近的变更】
（更新、装插件、加盘、断电、改网络……）
【已经试过】
（做了什么，结果如何）
【附件】
omv-sysinfo 的输出（已脱敏）、相关日志长输出用代码块或文本附件，不要截成图片，否则别人没法复制和检索。
参考资料
- OMV 官方文档：Support（提供尽可能多的信息，界面错误要截图保留 backtrace）、Troubleshooting、FAQ
- omv-extras wiki：Utilities, Maintenance and Backup 的「When things go wrong」一节
- OMV 主仓库：bug 模板、SECURITY.md
- 本站：官方资源与社区、OMV 命令行工具一览