Docker部署Nginx端口修改问题：Pi-hole占80端口后无法访问

问题根源分析 #

1. 直接Docker启动的错误
   Nginx官方镜像默认在容器内监听80端口，你执行的docker run -it -p 8080:8080是把主机8080端口映射到容器的8080端口，但容器内Nginx根本没监听这个端口，自然无法访问。

2. Docker Compose配置的错误

• 端口映射"5555:55"完全错误，容器内Nginx默认监听80，不是55；
• 环境变量NGINX_PORT=3333需要配合Nginx模板文件生效，如果没有自定义模板，这个变量不会自动修改Nginx的监听端口。

正确解决方案 #

方案1：直接用Docker命令启动 #

把主机端口映射到容器的80端口（避开被Pi-hole占用的80，选其他比如8080）：

docker run -d -p 8080:80 nginx

• -d让容器后台运行，替代-it（交互式适合调试，后台运行更稳定）；
• -p 8080:80表示主机的8080端口转发到容器内的80端口（Nginx默认监听端口）。

执行后用docker ps查看，应该显示类似：

CONTAINER ID   IMAGE   PORTS                  NAMES
xxx            nginx   0.0.0.0:8080->80/tcp   xxx

此时访问mylocalip:8080就能看到Nginx默认页面。

方案2：修正Docker Compose配置 #

如果要保留自定义模板，修正端口映射和环境变量的配合：

version: "3.9"
services:
  web:
    image: nginx
    volumes:
      - ./templates:/etc/nginx/templates
    ports:
      - "5555:80"  # 主机5555映射到容器默认的80端口
    environment:
      - NGINX_HOST=foobar.com
      - NGINX_PORT=80  # 对应容器内Nginx监听的端口，默认是80

如果想让Nginx在容器内监听其他端口（比如3333），需要确保./templates目录下有正确的模板文件，比如default.conf.template，内容包含：

server {
    listen ${NGINX_PORT};
    server_name ${NGINX_HOST};

    location / {
        root /usr/share/nginx/html;
        index index.html index.htm;
    }
}

此时Docker Compose配置修改为：

version: "3.9"
services:
  web:
    image: nginx
    volumes:
      - ./templates:/etc/nginx/templates
    ports:
      - "5555:3333"  # 主机5555映射到容器的3333端口
    environment:
      - NGINX_HOST=foobar.com
      - NGINX_PORT=3333

启动后访问mylocalip:5555即可。

额外检查项 #

• 确认主机防火墙没有封锁你使用的端口（比如8080、5555）；
• 用docker logs <容器ID/名称>查看Nginx日志，排查启动或运行报错；
• 确保Pi-hole只占用了80端口，没有占用你选择的其他端口（可以用netstat -tulpn | grep 端口号检查）。

内容的提问来源于stack exchange，提问作者franzi98