Docker Compose中Nginx反向代理私有PyPI服务器配置错误排查

根据你描述的现象（Nginx 80端口正常访问，/pypi路径返回404，PyPI单独跑8080正常），核心问题大概率出在Nginx代理配置的路径匹配/转发逻辑，或是配置文件未被正确加载，以下是具体排查和修正步骤：

1. 优先检查Nginx配置文件是否被正确加载 #

如果docker-compose.yml中没有正确挂载pypi.conf到Nginx的配置目录，Nginx会使用默认配置（无/pypi路由规则），自然返回404。

• 确认docker-compose.yml中Nginx服务的volume挂载规则：

  nginx:
    # ... 其他配置
    volumes:
      # 确保本地pypi.conf路径正确，且挂载到Nginx的conf.d目录
      - ./pypi.conf:/etc/nginx/conf.d/pypi.conf
  

• 进入Nginx容器验证配置：

  docker exec -it <你的nginx容器名> sh
  # 查看conf.d目录下是否有pypi.conf
  ls /etc/nginx/conf.d/
  # 检查配置语法合法性
  nginx -t
  

  如果nginx -t报错，说明配置文件有语法错误，直接修正即可。

2. 修正Nginx代理的路径转发逻辑 #

PyPI服务器的根路径是/，当你通过/pypi访问时，Nginx默认会把完整路径/pypi转发给PyPI服务器，但PyPI没有这个路径，所以返回404。需要添加路径重写或调整proxy_pass写法：

正确的pypi.conf示例 #

server {
    listen 80;
    server_name localhost;

    location /pypi {
        # 重写路径，去掉/pypi前缀，转发给PyPI的根路径
        rewrite ^/pypi(.*)$ $1 break;
        # 使用Docker Compose的服务名作为地址（自动解析）
        proxy_pass http://pypi:8080;
        # 传递必要的请求头
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 根路径保留Nginx默认页面（可选）
    location / {
        root /usr/share/nginx/html;
        index index.html index.htm;
    }
}

或者用proxy_pass末尾的/自动截断前缀（需访问路径带末尾斜杠/pypi/）：

location /pypi/ {
    proxy_pass http://pypi:8080/;
    # 同上请求头配置
}
# 兼容不带斜杠的/pypi访问
location = /pypi {
    return 301 /pypi/;
}

3. 排查Docker网络连通性 #

确保Nginx和PyPI服务在同一个Docker网络中（默认Docker Compose会自动创建默认网络，所有服务都在其中），如果手动指定了网络，需确认两个服务都加入该网络：

version: '3.8'
networks:
  pypi-net:
    driver: bridge

services:
  pypi:
    # ... 其他配置
    networks:
      - pypi-net
  nginx:
    # ... 其他配置
    networks:
      - pypi-net

验证连通性：在Nginx容器内执行curl http://pypi:8080，如果能正常返回PyPI页面，说明网络没问题；如果失败，检查PyPI服务的名称是否和docker-compose.yml中一致。

4. 目录权限问题（可能性较低） #

如果挂载的pypi.conf权限过严，Nginx进程（默认用nginx用户）无法读取，会导致配置加载失败。可以修改本地文件权限：

chmod 644 ./pypi.conf

或在容器内检查文件权限：

docker exec -it <nginx容器名> ls -l /etc/nginx/conf.d/pypi.conf

总结 #

最常见的问题是Nginx配置未加载或路径转发逻辑错误，按照上述步骤逐一排查即可解决。

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