故障排查

出问题时先别急着改配置。这一栏按症状组织：你看到什么现象，就去对应的分类找；每篇都从只读检查开始，先弄清是哪一层出了问题，再决定要不要动手。

按症状选分类

你看到的现象	去这一类
安装器报错、找不到磁盘，或者装完后系统起不来	安装与启动
浏览器打不开 Web 界面、登录失败、出现 502 或 Failed to connect to socket	登录与访问
磁盘或文件系统不见了、变成只读、RAID 降级、系统盘写满	磁盘与文件系统
电脑连不上共享、看不到共享、权限错误、共享文件夹删不掉	共享与权限
更新失败、插件装完界面不对、点「应用」时报错	更新与插件
容器起不来、端口冲突、重启后容器没起来	容器问题
SMB 传输慢、负载一直很高、硬盘不休眠	性能与资源
以上都不是，或者自己查不出来	如何有效求助

排查的基本顺序

1. 记下现象和时间点。 最近改过什么（更新、装插件、加盘、断电、改网络）？问题出现前后各做了什么？
2. 先看是哪一层。 能 ping 通吗？能打开登录页吗？登录后哪一块报错？OMV 的界面、后台服务、文件系统是三层，故障往往只在其中一层。
3. 先读后写。 看状态、看日志、看配置都是只读操作，不会让情况更糟；改配置、重启服务、擦除磁盘、重建阵列都是写操作，放在读完之后。
4. 涉及数据时先停手。 磁盘、文件系统、阵列相关的故障，先确认有没有独立备份。RAID 等冗余手段防的是坏盘，不防误操作，也不能代替备份，见备份策略。

界面故障先看这一条

OMV 的 Web 界面依赖 nginx、php-fpm 和 omv-engined 三个后台组件，任何一个出问题，界面表现都不同。原理见OMV 是怎么工作的，对应的排查见502 Bad Gateway 与 Failed to connect to socket。

日志在哪里看

界面里的日志在 诊断 → 系统日志（Diagnostics → System Logs），下表同时给出命令行的写法（在 OMV 的 shell 里，以 root 身份执行，都是只读的）。系统日志由 journald 保存，OMV 把它的上限设为 1 GiB，大约能留三个月。

想查什么	界面里选的日志类型	命令行
系统的总体情况	系统日志（Syslog）	journalctl -b --no-pager -n 100
登录与认证	验证（Authentication）	journalctl --facility=auth,authpriv --no-pager -n 50
磁盘错误、USB、网卡	内核（Kernel）	journalctl -k -b --no-pager -n 100
开机过程	启动（Boot）	journalctl -b --no-pager，上一次启动用 journalctl -b -1
更新与插件安装	更新管理	/var/log/apt/term.log
S.M.A.R.T. 事件	S.M.A.R.T.	journalctl -t smartd --no-pager -n 50
Web 界面（nginx）	无	/var/log/nginx/openmediavault-webgui_error.log
Compose 的备份、更新、启停	无	/var/log/omv-compose-backup.log、omv-compose-update.log、omv-compose-run.log 等，都在 /var/log/ 下

界面里还有「守护进程」「消息」「Rsync - 任务」「Rsync - 服务器」「SMB/CIFS - 审核」等类型。更多用法见查看系统日志。

继续浏览

• 想了解救援工具本身：omv-firstaid 救援工具
• 想平时就把维护做好：健康检查清单
• 返回学习路线