Nginx反向代理非根路径/mylocation配合pypiserver失败问题排查

我之前折腾私有PyPI服务器的时候，也碰到过把Nginx代理路径从根路径改成子路径后反向代理失效的情况，结合你给出的配置片段，咱们一步步来排查和解决：

核心问题分析 #

pypiserver默认是假设自己运行在网站根路径下的，当你把Nginx的代理路径改成/mylocation后，有两个关键环节容易出问题：

• Nginx没有正确把请求路径的前缀去掉后转发给pypiserver
• pypiserver不知道自己的上下文路径是/mylocation，生成的内部链接还是根路径，导致页面跳转、资源加载失败

具体修复步骤 #

1. 完善Nginx的location配置

你需要在location /mylocation块里添加路径重写规则，同时确保传递正确的请求头，修改后的配置大概是这样：

server {
    server_name mypi.com;
    listen 443 ssl;
    ssl_certificate /cert/path;
    ssl_certificate_key /key/path;
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

    location /mylocation {
        auth_basic "Howdy!";
        auth_basic_user_file /path/to/your/htpasswd/file; # 补全你的认证文件路径
        # 假设pypiserver运行在本地8080端口，根据实际情况修改
        proxy_pass http://localhost:8080;
        # 传递必要的头部，让pypiserver知道真实的请求信息
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        # 关键：把/mylocation前缀去掉后再转发给pypiserver
        rewrite ^/mylocation(.*)$ $1 break;
    }
}

2. 启动pypiserver时指定上下文路径

启动pypiserver的时候，需要加上--url-prefix参数，告诉它自己的上下文路径是/mylocation，这样它生成的所有链接都会自动带上这个前缀，和Nginx的代理路径匹配。比如你的启动命令可以改成：

pypi-server --url-prefix /mylocation -p 8080 /path/to/your/packages/directory

3. 验证配置并重启服务

修改完配置后，先检查Nginx配置是否合法：

nginx -t

如果没有报错，重启Nginx和pypiserver：

systemctl restart nginx
# 这里根据你启动pypiserver的方式重启，比如用systemd的话：
systemctl restart pypiserver

测试验证 #

最后可以通过两种方式验证：

• 浏览器访问https://mypi.com/mylocation，看看能不能正常加载pypiserver的页面，点击链接是否都能正常跳转
• 用pip测试安装包：

pip install --index-url https://mypi.com/mylocation/simple/ your-package-name

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