Web 界面打不开

适用范围

浏览器访问 NAS 时出现下面这些情况：连接被拒绝（ERR_CONNECTION_REFUSED）、连接超时或找不到主机、证书警告之后白屏、地址栏被自动改成 https:// 后失败。

不适用：页面能打开，但显示 502 Bad Gateway 或 Failed to connect to socket，见502 Bad Gateway 与 Failed to connect to socket；能打开登录页但登不进去，见登录失败与账户被锁；NAS 本机根本进不了系统，见系统无法启动。

开始排查前

本页有两项操作可能让你暂时失联

影响范围：重启 nginx 只影响 Web 界面，文件共享不受影响。omv-firstaid 里的「配置网络接口」会删除现有的全部网络接口配置（包括 Bond、VLAN），NAS 的 IP 可能变化，SMB、NFS 等网络服务会中断。

前置条件：在 NAS 本机的控制台（显示器加键盘）操作，或者 SSH 仍然可用。命令都在 OMV 的 shell（root 身份）里执行。

回退办法：检查类命令都是只读的。改了端口或 HTTPS 之后，用 omv-firstaid 再配置一次即可。改网络之前先读改坏网络后怎么救。

先记下：最近有没有改过网络、端口、证书、防火墙规则，有没有装过容器（容器常常占用 80 或 443）。

排查步骤

1. 先看浏览器报的是哪一种

浏览器提示	通常说明	下一步
连接被拒绝	主机在线，但这个端口上没有程序在监听	第 3、4 步
连接超时、无法访问、找不到主机	地址不对、网络不通，或者被防火墙丢弃	第 2、5 步
打开了，但显示 502 或 Failed to connect to socket	nginx 在运行，后端没有运行	见 502 Bad Gateway
证书警告；地址被自动跳到 https:// 后失败	HTTPS 相关设置或证书的问题	第 3、4 步

2. 确认 NAS 的 IP 地址

1. 看 NAS 本机的控制台。登录提示上方会列出每个网络接口的地址，格式是「接口名: 地址」。这段提示是开机时生成的，IP 在运行中变化后可能过期，所以还要用命令确认：

# 在 OMV 的 shell 里执行
ip -br addr

2. DHCP 分到的地址可能变化。也可以在路由器的客户端列表里找 NAS。长期方案是设静态 IP 或在路由器上做 DHCP 预留，见网络接口：DHCP、静态 IP 与 DNS。
3. 如果只看到 169.254. 开头的地址：说明没有从 DHCP 拿到地址。OMV 8.2.1 起，DHCP 模式下会同时设置链路本地地址，保证机器不至于完全联系不上。omv-extras 的新手指南提到，首次启动偶尔会因路由器响应太慢拿不到地址，重启 NAS（必要时先重启路由器）通常就好了。
4. 在另一台电脑上 ping <NAS 的 IP>，并确认两者在同一网段，没有被 VLAN 或访客网络隔离。

3. 确认端口和 HTTPS 设置

默认是 HTTP 的 80 端口。在 系统 → 工作台 → 设置（System → Workbench → Settings）里可以修改端口、启用 SSL/TLS，以及勾选强制使用 SSL/TLS（Force SSL/TLS）。

• 改过端口：要访问 http://<IP>:<端口>。
• 启用了强制 SSL/TLS：访问 http:// 会被自动跳转到 https://<主机>:<HTTPS 端口>。HTTPS 端口或所选证书有问题时，跳转之后就打不开。

在 NAS 上想直接知道当前监听什么端口，用下一步的 ss。

4. 在 NAS 上检查 nginx

# 在 OMV 的 shell 里执行（只读检查）
systemctl status nginx --no-pager
ss -tlnp | grep -E ':80 |:443 '
nginx -t
tail -n 30 /var/log/nginx/openmediavault-webgui_error.log

按结果判断：

• nginx 是 active (running)，ss 显示 nginx 在监听 80（或你设的端口）：nginx 没问题，问题在地址、网络或防火墙，回到第 2、5 步。
• nginx 没有运行，nginx -t 报 Address already in use 或 bind() to 0.0.0.0:80 failed：端口被别的程序占了。omv-extras 的文档明确提到「OMV 与 Docker 抢 80 端口」是常见问题。ss 输出里如果有 docker-proxy，就是容器映射了 80 或 443。处理见端口冲突。
• nginx -t 报 cannot load certificate：所选的 SSL 证书文件不存在或已损坏，见下一节。
• nginx -t 报其他语法错误：官方说明 nginx 对 sites-available 目录里的语法错误很敏感，任何一个不合格的文件都会让 nginx 无法重启。把你自己加的站点文件移出这个目录。不要动 OMV 自己的 openmediavault-webgui。

排除原因后，让 OMV 按数据库重写它接管的 nginx 配置并重启：

# 在 OMV 的 shell 里执行；会重写 /etc/nginx/sites-available/openmediavault-webgui 并重启 nginx
omv-salt deploy run nginx

这一步会先执行 nginx -t，通过才会重启。

5. HTTPS 与证书

• 浏览器对自签名证书的警告是正常现象，选择继续访问即可；想要消除警告，见证书：自签名、导入与 Let's Encrypt。
• 强制 HTTPS 之后打不开：在 NAS 本机运行 omv-firstaid，选 Configure workbench。依次输入 HTTP 端口；如果系统里有证书，会询问是否启用 HTTPS。选择不启用，就会回到只用 HTTP 的状态。这只是为了先找回访问，进入界面修好证书之后，要重新启用 HTTPS，不要长期只用 HTTP。

omv-firstaid 会一并应用所有待应用的更改

Configure workbench 在保存设置之后，会应用全部待应用的配置更改，不只是 Web 界面的设置。如果你有还没来得及检查的更改，先想清楚再运行。

另外，这类菜单项通过 omv-engined 读写配置，引擎没有运行时它们也会失败，见502 Bad Gateway 与 Failed to connect to socket。

6. 防火墙

如果最近在 网络 → 防火墙 → 规则（Network → Firewall → Rules）里加过规则，检查有没有把 Web 界面所用的端口挡掉。在 NAS 本机可以只读地查看当前规则：

# 在 OMV 的 shell 里执行
iptables -S

规则顺序和「先放行管理入口」的做法见防火墙规则。如果规则已经把你锁在外面，只能在本机控制台处理，涉及配置数据库的操作见进阶的配置数据库：config.xml 与 omv-confdbadm，改之前先做备份。

7. 网络配置被改坏

怀疑是网络接口配置的问题时，用 omv-firstaid 的 Configure network interface。它会删除所有已配置的接口，再按你的回答重建一个，注意事项见改坏网络后怎么救。

确认恢复

1. 在另一台电脑的浏览器里打开 http://<IP>（或你设置的地址和端口），能看到登录页并能登录。
2. 在 NAS 上执行 systemctl is-active nginx php8.4-fpm openmediavault-engined，三项都是 active。
3. 重启 NAS 一次，再次访问，确认不是临时恢复。

仍未解决

附上：浏览器报错的原文、systemctl status nginx 和 nginx -t 的输出、ss -tlnp 的输出、ip -br addr 的输出。发布之前去掉 IP、主机名，读如何有效求助。

参考资料

• OMV 官方文档：How does it work?，其中说明了 nginx、php-fpm 与 omv-engined 的关系，以及 sites-available 里的错误文件会让 nginx 无法启动
• omv-extras wiki：OMV 8 新手指南，首次启动拿不到地址的处理
• 本站：Web 界面安全：HTTPS、端口与自动注销、omv-firstaid 救援工具