章节索引
网页能访问,并不表示开发工具也读取了相同的代理。先保留失败命令、目标域名和配置来源,在临时终端里重试;明确是哪一个程序发出请求之后,再修改对应设置,避免旧端口留在多个文件里。
找到实 际发 起下载的工具
按失败命令查看代理来源,并观察客户端是否记录到该请求。临时调整后原命令能够完成,才考虑保存设置,同时记下撤销方法。浏览器访问正常不能证明命令行工具的链路也正常。
从报错动作查找设置位置
| 失败发生在哪里 | 负责请求的程序 | 可检查的配置来源 |
|---|---|---|
| python -m pip install | pip 及其 HTTP 请求库 | 从 pip config debug、代理变量及 --proxy 参数检查 |
| conda install / create | 环境管理器 | 用 conda config --show-sources 定位来源,再查看 ~/.condarc |
| git+https://... | 源码版本工具 | git config --show-origin --get-regexp http.*proxy |
| 构建过程中额外获取文件 | 依赖包自带的构建程序 | 从详细输出定位失败的资源地址 |
用临时设置检查原请求
将示例端口替换为本机正在监听的 mixed-port,再观察连接记录里的目标与处理策略。确认是原来的下载请求经由代理完成,而非另一次浏览器访问成功。
使用示例前,查看大小写形式的代理变量,并检查 pip 与 Conda 的配置文件。临时窗口也可能继承已有设置,不能跳过来源检查。
找到旧代理值时,记录内容及所在位置后再调整。组织要求保留的配置应保持原有约束,避免一次临时排查把长期使用的设置覆盖掉。
示例适用于已经确认没有旧代理的临时环境。测试后撤掉本次增加的变量;若修改过旧值,应依照记录恢复,而不是直接删除已有配置。
PROXY_PORT=7890
export HTTP_PROXY="http://127.0.0.1:$PROXY_PORT"
export HTTPS_PROXY="http://127.0.0.1:$PROXY_PORT"
export NO_PROXY=localhost,127.0.0.1,::1
python -m pip install --dry-run --ignore-installed --no-cache-dir packaging
conda search python
unset HTTP_PROXY HTTPS_PROXY NO_PROXY$ProxyPort = 7890
$env:HTTP_PROXY = "http://127.0.0.1:$ProxyPort"
$env:HTTPS_PROXY = "http://127.0.0.1:$ProxyPort"
$env:NO_PROXY = "localhost,127.0.0.1,::1"
py -m pip install --dry-run --ignore-installed --no-cache-dir packaging
Remove-Item Env:HTTP_PROXY, Env:HTTPS_PROXY, Env:NO_PROXY设 置 只对哪个环境生效?
python -m pip config debug
python -m pip config list -v
# 代理参数按 scheme://[user:password@]host:port 填写
python -m pip install --proxy http://127.0.0.1:7890 requests
# 确认用户配置中的旧值后再撤销
python -m pip config --user unset global.proxy# 在项目虚拟环境已激活的终端使用
python -m pip config --site set global.proxy http://127.0.0.1:7890
python -m pip config --site list
# 结束使用后撤销该环境的设置
python -m pip config --site unset global.proxy全局文件、用户文件、虚拟环境与 PIP_CONFIG_FILE 都可能影响 pip。使用 debug 输出查看实际读取位置,避免编辑了并未生效的文件。
--site 对应当前激活的虚拟环境。个人代理留在本机,虚拟环境目录不纳入版本管理,依赖清单也不应混入个人连接配置。
自定义索引启用后,需要区分索引页和软件包文件各自的请求地址。元数据能读取而 wheel 下载失败时,应继续查看文件所在主机及证书链路。
检 查 环境管 理器和软 件源
proxy_servers:
http: http://127.0.0.1:7890
https: http://127.0.0.1:7890
ssl_verify: trueconda config --show-sources
conda config --show proxy_servers ssl_verify channels
# 确认无需保留后移除代理映射
conda config --remove-key proxy_servers环境管理器先取得源的元数据,再获取软件包。某个源自身不可用时,代理正确也未必能完成下载;根据最后失败的地址检查来源,不要同时重写全部软件源。
证书错误应 从信 任 链排 查
对照系统时间、索引主机和组织的 HTTPS 检查要求。已取得管理员提供的 CA 文件时,为相应工具指定该文件,并保留证书验证。
使用系统证书库前,先查所装工具对 truststore 选项的支持条件。
将 ssl_verify 设为 false 会影响后续请求的校验。遇到陌生签发者时,先检查本机软件及连接路径,避免直接导入来历不明的根证书。
# 安装器的临时证书参数
python -m pip install --cert /path/to/company-ca.pem requests
# 按工具支持情况选择证书来源
ssl_verify: /path/to/company-ca.pem
# ssl_verify: truststore源码 依赖由谁 负责 连接 ?
git+https 依赖会交由 Git 获取。可在项目外尝试读取目标仓库,借配置来源输出查找旧代理;访问认证使用已有凭据管理方式,私密令牌不写入依赖清单。
构建隔离还可能创建临时环境来获取构建工具。启用详细输出,找到真正失败的 URL 后,再判断应该修改安装器、源码工具还是构建程序。
REPO_URL='https://github.com/pallets/flask.git'
PACKAGE_NAME='packaging'
git config --show-origin --get-regexp 'http..*.proxy|http.proxy' || true
git ls-remote "$REPO_URL"
python -m pip install -vvv "$PACKAGE_NAME"结束排查后检查 遗 留配置
清理及验证要点
- 怎样确认 pip 没有沿用旧代理?用 config debug 查看生效来源,再重试原安装命令。
- Conda 撤销后应查哪里?查看 show-sources,确认失效的 proxy_servers 不再生效。
- 新终端仍有旧值怎么办?检查继承到的 HTTP_PROXY、HTTPS_PROXY 与 ALL_PROXY,按此前记录恢复。
- 分别验证安装包、软件源元数据及源码依赖,避免用单项成功替代全部检查
- 客户端退出后,检查命令是否仍尝试连接已经停止的本地端口
- 重新检查各工具的证书验证选项
