Nginx Proxy Manager 端口映射配置问题排查指南

Nginx Proxy Manager (NPM) 是一款流行的反向代理管理工具，但在实际使用中可能会遇到端口配置问题导致服务无法通过域名访问的情况。本文将详细分析这类问题的成因和解决方案。

问题现象

用户报告了一个典型场景：通过内部IP地址和端口（如192.168.1.200:81）可以正常访问NPM及其代理的服务，但通过配置的完整域名（如nginx.DOMAIN.co.uk）却无法访问。值得注意的是，这种问题可能在使用一段时间后突然出现，即使网络环境和配置看似没有变化。

根本原因分析

经过排查，发现问题的根源在于容器更新后端口映射配置被重置为默认值。具体表现为：

1. 容器更新机制（如Watchtower自动更新）可能导致原有端口映射配置丢失
2. 路由器上的端口转发规则与容器实际监听的端口不匹配
3. 自定义端口转发配置未被正确保留

解决方案

1. 检查容器端口映射

在Portainer或Docker命令行中确认NPM容器的端口映射配置是否正确。标准配置应包括：

• 80端口（HTTP）映射到宿主机的某个端口（如8080）
• 443端口（HTTPS）映射到宿主机的某个端口（如8443）
• 81端口（管理界面）映射到宿主机的某个端口（如8181）

2. 验证路由器端口转发

确保路由器上的端口转发规则与容器配置一致。典型配置示例：

外部端口	内部IP地址	内部端口	协议类型
80	192.168.1.200	8080	TCP
443	192.168.1.200	8443	TCP
8181	192.168.1.200	8181	TCP

3. 防止配置重置

为避免未来更新导致配置丢失，建议：

1. 使用Docker Compose文件管理容器配置
2. 在自动更新工具中排除关键容器
3. 定期备份容器配置

最佳实践

1. 文档化配置：记录所有端口映射和转发规则
2. 变更管理：任何更新后立即验证核心功能
3. 监控设置：配置健康检查监控关键端口

通过以上步骤，可以确保Nginx Proxy Manager在各种网络环境下稳定运行，避免因端口配置问题导致的服务中断。