PY
DSTW PyPI Proxy 公共代理服务
四入口代理可用

pip 代理配置教程

把 pip 的 index-url 配置为当前代理入口的 simple 地址,让服务器、容器和构建任务稳定安装 Python 包。

4代理域名
6配置场景
300s成功响应缓存

推荐配置

优先配置 https://pipproxy.kj99885.com/simple 作为 pip 索引地址;Simple 页面中的包文件链接会自动改写回当前代理入口。

index-url最常用的 pip 代理配置
requirements批量安装依赖无需改文件
download准备离线包和构建缓存
pip

临时使用代理

单次安装时指定代理索引,不改动机器上的 pip 配置,适合临时排障和一次性脚本。

pip install -i https://pipproxy.kj99885.com/simple requests
python3 -m pip install -i https://pipproxy.kj99885.com/simple requests
config

全局配置代理

把当前用户的 pip 默认索引切换到代理入口,后续 install、download、wheel 都会自动使用。

python3 -m pip config set global.index-url https://pipproxy.kj99885.com/simple
python3 -m pip config get global.index-url
reset

恢复官方索引

需要恢复默认访问方式时删除配置项即可,适合发布完成后清理构建环境。

python3 -m pip config list
python3 -m pip config unset global.index-url
requirements

requirements.txt

批量安装依赖时只替换索引地址,requirements 文件内容保持不变。

pip install -i https://pipproxy.kj99885.com/simple -r requirements.txt
pip download -i https://pipproxy.kj99885.com/simple -r requirements.txt -d ./packages
download

离线包准备

先把依赖包下载到本地目录,再同步到内网制品库或离线服务器。

pip download -i https://pipproxy.kj99885.com/simple requests -d ./packages
pip wheel -i https://pipproxy.kj99885.com/simple requests -w ./wheels
API

JSON API

查询包版本、文件列表和元数据,用于自动化判断升级。

curl -L "https://pipproxy.kj99885.com/https://pypi.org/pypi/requests/json"
python3 -c "import requests; print(requests.get('https://pipproxy.kj99885.com/https://pypi.org/pypi/requests/json').json()['info']['version'])"
URL

直接访问

Simple、JSON、包文件地址都可以直接拼接到代理入口后面。

https://pipproxy.kj99885.com/https://pypi.org/simple/requests/
https://pipproxy.kj99885.com/https://files.pythonhosted.org/packages/source/r/requests/requests-2.31.0.tar.gz