树莓派下Docker+Nginx配子域名部署PHP站与Nextcloud出现502错误求助

排查与解决步骤 #

1. 确认502错误来源 #

执行命令查看你部署的nginx容器日志：
docker logs webserver

• 若日志出现connect() failed/fastcgi pass failed类报错，属于nginx与php-fpm通信异常，是最常见的故障原因
• 若日志无访问记录，属于外层反向代理无法找到该web容器，为网络配置问题

2. 对应故障修复 #

通信异常修复

你当前仅挂载了nginx配置目录，但未配置php请求转发规则，默认nginx配置无法处理php请求，直接返回502。
在本地./nginx目录下新建default.conf配置文件，写入以下内容：

server {
    listen 80;
    server_name domain.com;
    root /var/www/html;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

同时修正php服务的挂载配置，你当前将目录挂载为文件会导致php容器读取配置失败，把./php:/usr/local/etc/php/php.ini改为./php/php.ini:/usr/local/etc/php/conf.d/custom.ini，提前在本地创建./php/php.ini文件即可。

网络配置修复

你当前的compose项目默认使用内部网络，没有加入公共的net网络，外层反向代理无法找到web容器。
在docker-compose.yml末尾添加外部网络声明，完整配置如下：

version: '3'
services:
 # Nginx server configuration
  web:
    image: nginx:latest
    container_name: webserver
    environment:
      VIRTUAL_HOST: 'domain.com'
      VIRTUAL_PORT: 80
    depends_on:
      - php
    volumes:
      - ./webcontent:/var/www/html
      - ./nginx:/etc/nginx/conf.d/
    networks:
      - default
      - net
 # Php-fpm configuration
  php:
    image: php:7.2-fpm
    volumes:
      - ./webcontent:/var/www/html
      - ./php/php.ini:/usr/local/etc/php/conf.d/custom.ini

networks:
  net:
    external: true

web服务同时接入compose内部网络（与php通信）和外部net网络（与外层反向代理通信），php仅需接入内部网络即可。

3. 验证效果 #

执行docker-compose down && docker-compose up -d重启服务，等待10秒后访问域名测试，若仍有异常可再次查看web容器日志定位具体问题。

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