如何在Poetry中为Python项目配置私有PyPI凭据-Python教程-PHP中文网

根本原因是凭据未绑定到正确仓库名或poetry默认不向私有源发送认证头；需确保pyproject.toml中source的name与poetry config http-basic.完全一致，并显式配置仓库url和凭据。

如何在poetry中为python项目配置私有pypi凭据

poetry config 为什么配了私有源却还是拉不到包

根本原因通常是凭据没绑定到正确的仓库名，或者 Poetry 默认只信任 https://pypi.org，对私有源默认不发送认证头。即使你在 pyproject.toml 里写了 [[tool.poetry.source]]，Poetry 也不会自动读取系统凭据或环境变量——它只认自己管理的凭据库。

实操建议：

python-code-analyz

专业Python代码分析与优化，支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。

下载

先确认私有源在 pyproject.toml 中定义的 name 字段（比如 my-private），后续所有凭据操作都必须严格匹配这个名字
运行 poetry config repositories.my-private https://pypi.example.com/simple/ 显式注册仓库（仅注册 URL 不含认证）
再用 poetry config http-basic.my-private username password 绑定凭据——注意这里 my-private 必须和 source 的 name 完全一致
如果密码含特殊字符（如 @、/），需 URL 编码；推荐改用 poetry config http-basic.my-private username "your-raw-password" 并加英文双引号包裹

使用 API token 而不是用户名密码时怎么配

多数现代私有 PyPI（如 Nexus、Artifactory、JFrog）推荐用 token 替代明文密码，但 Poetry 不区分“密码”字段语义，一律当密码处理。关键点在于：token 通常要作为用户名传入，密码留空或填占位符。

实操建议：

若服务端要求 token 放在 Authorization 头的 Bearer 位置（如某些 Nexus 配置），Poetry 原生不支持；此时必须退回到 .pypirc + poetry config virtualenvs.create false 手动 pip install，或改用 pip index config（Poetry 1.7+ 实验性支持）
更通用的做法是：把 token 当作用户名，密码设为空字符串——执行 poetry config http-basic.my-private "APITOKEN-abc123" ""
验证是否生效：运行 poetry config --list | grep http-basic，确认输出包含 http-basic.my-private 对应项

CI 环境下如何安全注入私有源凭据

CI（如 GitHub Actions、GitLab CI）里不能硬编码密码到 pyproject.toml 或 shell 脚本中。Poetry 本身不读取 $POETRY_HTTP_BASIC_USERNAME 这类环境变量，必须显式调用 poetry config。

实操建议：

GitHub Actions 示例：在 job 步骤中插入 poetry config http-basic.my-private "${{ secrets.PRIVATE_PYPI_USERNAME }}" "${{ secrets.PRIVATE_PYPI_PASSWORD }}"
GitLab CI 示例：用 before_script 执行 poetry config http-basic.my-private "$PRIVATE_PYPI_USERNAME" "$PRIVATE_PYPI_PASSWORD"，并确保变量在 CI 设置中标记为 masked
切忌在 CI 中执行 poetry config --local，因为 --local 会写入项目根目录下的 poetry.toml，可能意外提交到 Git
每次 CI 启动新容器时，凭据都是干净的，所以务必把 poetry config 放在 poetry install 或 poetry publish 之前

poetry publish 推送包到私有源失败的常见卡点

poetry publish 默认推送到 PyPI 官方源，即使你配置了私有源，也必须显式指定 -r 参数，否则会报 HTTP Error 403: Forbidden（因为它试图往 pypi.org 推，而你没给官方账号权限）。

实操建议：

推送前确认已运行 poetry config repositories.my-private https://pypi.example.com/simple/ 和 poetry config http-basic.my-private ...
推送命令必须带 -r my-private：例如 poetry publish -r my-private --build
注意私有源的上传 endpoint 通常是 /simple/ 的父路径（比如 https://pypi.example.com/），但 Poetry 的 repositories.<name></name> 配置值必须以 /simple/ 结尾，否则 publish 会拼错 URL
如果遇到 ConnectionError 或证书错误，在 CI 中可临时加 poetry config certificates.my-private.cert /path/to/cert.pem（仅限自签名证书场景）