Docker环境下Nginx80端口按路径转发请求至WordPress、phpMyAdmin的配置报错问题

现有部署架构 #

• 虚拟机环境下通过Docker部署3个独立运行的容器，单容器独立访问均可正常提供服务：
  • WordPress站点容器：映射宿主机5050端口，容器内部集成独立Nginx承载站点流量
  • phpMyAdmin站点容器：映射宿主机5000端口，容器内部集成独立Nginx承载管理界面
  • 入口Nginx容器：映射宿主机80端口，作为统一对外流量入口
• 预期目标：通过入口Nginx的路径匹配规则实现反向代理，即访问localhost/wordpress时请求转发至5050端口的WordPress服务，访问localhost/phpmyadmin时请求转发至5000端口的phpMyAdmin服务。

故障触发场景 #

当前已在入口Nginx的default.conf中编写如下配置：

server {
    listen                  80;
    root                    /var/www/localhost/htdocs/;
    index                   index.html index.htm index.php;
    server_name             _;
    client_max_body_size    32m;
    error_page              500 502 503 504  /50x.html;
    location = /50x.html {
            root              /var/lib/nginx/html;
    }
    location /wordpress{
              proxy_pass  http://127.0.0.1:5050;  
    }
    location /phpmyadmin{
              proxy_pass  http://127.0.0.1:5000;  
    }
}

配置重载生效后，访问对应路径直接触发异常，报错页面如下：

根因定位 #

两个核心配置问题直接导致转发失败：

1. 容器网络隔离导致目标地址不可达
   入口Nginx容器内配置的127.0.0.1指向容器自身的本地回环地址，和宿主机映射的5050、5000端口完全不在同一个网络命名空间，容器内的Nginx根本无法通过这个地址触达后端服务，直接触发连接失败类报错。
2. 路径前缀传递逻辑不匹配
   当前location规则没有配置路径重写，请求会把完整的/wordpress/xxx、/phpmyadmin/xxx路径原样传递给后端容器；但后端容器内的服务都是部署在根路径/下的，无法识别带自定义前缀的路径，最终触发404、静态资源加载失败的问题。

可落地的修复方案 #

步骤1：解决网络可达性问题 #

放弃使用127.0.0.1作为代理目标，任选一种可靠的网络连通方案：

• 推荐方案：将三个容器加入同一个Docker自定义桥接网络，直接使用容器名作为代理目标地址，不需要依赖宿主机端口映射。
• 兼容方案：保留现有端口映射配置，代理目标替换为Docker默认网桥的网关IP（通常为172.17.0.1），通过宿主机的IP转发访问映射的5050、5000端口服务。

步骤2：修正路径转发规则 #

调整两个location块的匹配逻辑与proxy_pass配置，确保路径传递逻辑和后端服务匹配：

# 调整后的WordPress转发规则
location /wordpress/ {
    # proxy_pass 末尾带斜杠，自动剥离/wordpress前缀后传给后端
    proxy_pass http://<替换为实际可达的WordPress服务地址>:5050/;
    # 补充必要的请求头，确保后端应用获取真实的访问地址
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# 调整后的phpMyAdmin转发规则
location /phpmyadmin/ {
    proxy_pass http://<替换为实际可达的phpMyAdmin服务地址>:5000/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

步骤3：适配后端应用的路径识别配置 #

仅靠Nginx转发还无法完全让应用正常工作，需要调整对应应用的路径配置：

• WordPress：在站点wp-config.php中补充定义固定站点地址，让应用生成的资源链接带正确的路径前缀：

  define('WP_HOME', 'http://<你的宿主机访问IP>/wordpress');
  define('WP_SITEURL', 'http://<你的宿主机访问IP>/wordpress');
  

• phpMyAdmin：调整配置文件中的绝对URI参数，让页面跳转链接匹配路径前缀：

  $cfg['PmaAbsoluteUri'] = 'http://<你的宿主机访问IP>/phpmyadmin/';
  

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