指定本地GitLab PyPI源后pip仍连接pypi.org的解决方法

根因说明 #

指定--index-url后pip仍连接pypi.org来自两个触发点：

• 客户端侧：仅指定--index-url不会清空pip已加载的额外索引配置，全局pip配置、用户级pip配置、环境变量中配置的公网PyPI源会被默认启用，pip会同时向所有配置的源发起包检索请求
• 服务端侧：GitLab内置PyPI仓库默认支持上游代理功能，当私有仓库内未命中请求的包/版本时，会自动返回302响应重定向到配置的上游公网pypi.org地址，这也是你日志中收到302响应后立刻发起pypi.org连接的直接原因

操作步骤 #

1. 客户端pip配置（必做，彻底锁死仅访问私有源） #

临时单次安装时，执行命令追加--no-extra-index-url参数——这是强制禁用所有额外索引源的核心参数，命令示例：

pip install --index-url <你的GitLab PyPI simple索引地址> \
  --no-extra-index-url \
  --trusted-host <你的GitLab服务域名，例如mycompvgit.mycomp.local> \
  要安装的包名

如果需要永久生效，直接修改pip配置文件，无需每次执行命令追加参数，不同系统的配置文件路径如下：

• Linux/macOS：~/.pip/pip.conf
• Windows：%APPDATA%\pip\pip.ini

在配置文件中写入以下内容：

[global]
index-url = <你的GitLab PyPI simple索引地址>
extra-index-url =
trusted-host = <你的GitLab服务域名>

配置完成后执行pip config list校验生效配置，确认不存在任何指向pypi.org的源地址。

2. GitLab服务端配置调整（必做，消除302跳公网的问题） #

联系GitLab管理员调整对应项目的PyPI仓库配置：

• 进入项目「设置 > 包与镜像 > PyPI仓库」配置页
• 找到「上游代理/远程仓库缓存」配置项，直接关闭该功能，不要将pypi.org配置为上游地址
• 保存配置后，私有仓库未命中包时会直接返回404，不会再返回跳转到公网的302响应

注意：关闭上游代理前必须将所有需要安装的包、以及包的全层级依赖全部上传到私有PyPI仓库，否则缺包时会直接安装失败，不会自动从公网拉取。

验证方式 #

在阻断公网连接的环境下，追加-vv参数执行安装命令，查看详细日志，若所有HTTPS连接的目标地址仅为你的GitLab私有源域名，无任何指向pypi.org的连接记录，即配置生效。

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