Docker端口映射问题解决方案

当Docker端口映射出现问题时，可以按照以下步骤进行排查和解决：

常见错误原因

1. 端口已被主机其他服务占用
2. 防火墙或安全组阻止了端口访问
3. 容器内服务未正确监听指定端口
4. 映射语法错误
5. 容器未正常运行

排查步骤

1. 检查端口占用情况

# Linux/Mac
sudo lsof -i :<端口号>
# 或
netstat -tulnp | grep <端口号>

# Windows
netstat -ano | findstr :<端口号>

如果端口被占用，可以： - 停止占用端口的服务 - 更换Docker映射的主机端口

2. 检查容器状态

docker ps -a

确认容器状态为"Up"且运行时间正常

3. 检查容器内服务是否监听正确端口

docker exec -it <容器名或ID> netstat -tulnp
# 或
docker exec -it <容器名或ID> ss -tulnp

4. 检查防火墙设置

# 临时关闭防火墙测试(Linux)
sudo systemctl stop firewalld   # CentOS/RHEL
sudo systemctl stop ufw         # Ubuntu

# Windows检查防火墙设置

5. 检查Docker端口映射是否正确

docker inspect <容器名或ID> | grep -i port

解决方案

方案1：重新运行容器并正确映射端口

docker run -p <主机端口>:<容器端口> <镜像名>

确保映射格式正确，例如：

docker run -p 8080:80 nginx

方案2：释放被占用端口

# 找到占用进程并停止
kill <进程ID>

方案3：调整防火墙规则

# Linux添加防火墙规则示例
sudo ufw allow 8080/tcp   # Ubuntu
sudo firewall-cmd --add-port=8080/tcp --permanent && sudo firewall-cmd --reload  # CentOS/RHEL

方案4：检查容器内应用配置

确保容器内应用确实监听在映射的容器端口上，必要时修改应用配置文件。

高级排查

1. 查看Docker日志：

docker logs <容器名或ID>

2. 检查Docker网络设置：

docker network inspect bridge

3. 尝试使用主机网络模式测试：

docker run --network host <镜像名>

如果以上方法都不能解决问题，可能需要检查Docker守护进程日志或考虑重新安装Docker。