在 Docker 部署 Nginx 时，访问页面返回 **500 错误（Internal Server Error）**，通常与配置文件语法、权限设置或挂载目录的路径问题有关。以下是一些排查思路和解决方案： ### 1. 检查 Nginx 配置文件语法 Nginx 的 `nginx.conf` 或站点配置文件（如 `/etc/nginx/conf.d/default.conf`）中可能存在语法错误，导致服务无法正常启动。 - 进入容器内部检查配置文件： ```bash docker exec -it nginx_container_id nginx -t ``` 如果输出类似 `syntax is ok` 和 `test is successful`，则表示配置文件无误 [^4]。 ### 2. 查看 Nginx 容器日志定位错误 通过查看容器的日志信息可以更精准地定位 500 错误的原因： ```bash docker logs nginx_container_id ``` 若日志中出现类似 `Permission denied` 或 `open() "/usr/share/nginx/html/index.html" failed (13: Permission denied)` 的提示，则说明存在权限问题 [^4]。 ### 3. 权限问题的常见原因及解决方法 #### a. 挂载目录的权限不足 如果将宿主机的静态资源目录挂载到容器中（如 `-v /data/gis:/usr/share/nginx/html`），需要确保该目录的权限允许 Nginx 读取内容。 - 修改宿主机目录权限： ```bash sudo chown -R www-data:www-data /data/gis sudo chmod -R 755 /data/gis ``` #### b. SELinux 或 AppArmor 限制 某些 Linux 系统启用了 SELinux 或 AppArmor，可能会阻止容器访问宿主机目录。 - 临时禁用 SELinux： ```bash sudo setenforce 0 ``` 若问题消失，则需调整 SELinux 策略或永久禁用它。 - 在运行容器时添加 `--privileged` 参数（不推荐用于生产环境）： ```bash docker run --privileged ... ``` #### c. 使用用户命名空间隔离 如果使用了用户命名空间（user namespace remapping），可能导致容器内的 `nginx` 用户无法访问宿主机文件。可以通过在容器内修改 Nginx 的运行用户为 `root` 来解决： ```nginx user root; ``` ### 4. 确保正确挂载静态资源目录 若部署的是前端项目，需确认是否将 HTML 文件正确挂载到了 `/usr/share/nginx/html` 路径下，并且 Nginx 配置文件中指向了正确的根目录路径： ```nginx server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html index.htm; try_files $uri $uri/ =404; } } ``` ### 示例：完整的 `docker-compose.yml` 配置 ```yaml version: '3' services: nginx: image: nginx:1.24.0 container_name: nginx ports: - "8080:80" - "443:443" volumes: - ./html:/usr/share/nginx/html - ./nginx.conf:/etc/nginx/nginx.conf - ./conf.d:/etc/nginx/conf.d - ./log:/var/log/nginx restart: always ``` ###