在 POSIX shell 中只为一次 uv 命令设置代理,可在调用时直接赋值:

HTTP_PROXY=http://203.0.113.10:8080 \
HTTPS_PROXY=http://203.0.113.10:8080 \
uv add requests

把示例端点换成服务地址,或从HTTP 代理列表中挑选的候选。这些赋值作用于本次命令及其子进程,不是写入 shell 启动文件;PowerShell 的语法不同。HTTPS 目标也可以使用 http:// 代理监听端。ALL_PROXY 提供通用代理设置,NO_PROXY 指定绕过规则。

如果路由可用,但获认可的组织 CA 不在 uv 自带的 Mozilla 根证书中,而且该 CA 已安装到系统信任库,可改用系统信任:

HTTPS_PROXY=http://203.0.113.10:8080 \
uv --system-certs add requests

选项是 --system-certs。对应的 UV_SYSTEM_CERTS=true 环境变量在 uv 0.11.0 中加入;旧版本请查看本机安装版本的帮助。若单独提供 PEM 证书包,则使用文档说明的 SSL_CERT_FILE 或 SSL_CERT_DIR 信任接口。这些信任设置都不负责选择代理地址。

在认定路由测试成功前,先读命令输出。uv 可能直接复用缓存包,根本没有下载。实际操作除了索引,还可能访问文件、重定向、托管 Python 下载或 Git 依赖。记录失败阶段及错误。如果仍走错路,检查继承的代理与绕过值;修改包索引是在选内容源,不是在选正向代理。

相关文章