如何配置Poetry通过API密钥从Artifactory下载依赖包？

1. 准备必要信息 #

• 获取公司Artifactory的PyPI仓库地址，格式通常为https://<你的Artifactory域名>/api/pypi/<仓库名称>/simple，注意必须以/simple结尾，这是PyPI标准的索引路径
• 拿到你的Artifactory API密钥：在Artifactory个人设置页面找到「API Key」选项，生成或复制已有的密钥；同时确认你的Artifactory用户名（通常是公司邮箱或工号）

2. 添加Artifactory源并设置优先级 #

之前poetry source add命令失败大概率是未指定优先级，导致Poetry仍默认优先使用PyPI。执行以下命令：

poetry source add --priority=default artifactory <你的Artifactory仓库地址>

--priority=default会让Poetry优先从这个Artifactory源拉取依赖，而非默认的PyPI。

3. 配置API密钥认证 #

有两种方式配置认证信息：

方式一：用Poetry命令直接配置

执行：

poetry config http-basic.artifactory <你的Artifactory用户名> <你的API密钥>

这里的「password」字段填的是API密钥，不是你的Artifactory登录密码。

方式二：手动编辑配置文件

找到Poetry的全局配置文件（默认在~/.config/poetry/poetry.toml），或者项目根目录的poetry.toml（仅对当前项目生效），添加以下内容：

[http-basic]
artifactory = { username = "<你的用户名>", password = "<你的API密钥>" }

4. 验证配置是否生效 #

• 执行poetry config --list，查看输出中是否包含http-basic.artifactory的配置项，确认用户名和密钥已正确设置
• 尝试安装一个依赖包，比如poetry install <公司内部包名>，观察日志是否显示从你的Artifactory地址拉取资源

常见问题排查 #

• 如果拉取失败，先检查仓库地址是否正确，确保能通过浏览器访问该地址
• 确认你的API密钥拥有目标仓库的读取权限，如果没有，联系Artifactory管理员开通
• 若公司网络需要代理，执行以下命令配置代理：

  poetry config http-proxy http://<代理地址>:<端口>
  poetry config https-proxy https://<代理地址>:<端口>
  

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