如何高效将Python库上传至离线Artifactory PyPI仓库？

前置准备 #

• 确认你的Artifactory PyPI仓库是本地类型仓库（仅本地仓库支持上传，远程代理仓库无法直接上传包）
• 获取Artifactory用户凭证：用户名 + API密钥（在Artifactory个人设置中可生成或查看API密钥）
• 确保上传机器（联网机器或已部署必要工具的离线机器）具备Python环境或Artifactory CLI工具

方法1：使用Artifactory CLI（jf）批量上传（推荐） #

这是官方提供的高效批量上传工具，无需编写脚本，操作简单：

1. 安装jf CLI：
   • 在联网机器下载对应系统的jf二进制包，复制到离线环境后添加到系统PATH
2. 配置Artifactory连接：

   jf c add
   

   按提示输入Artifactory地址（如https://your-arti-domain/artifactory）、用户名、API密钥，设置连接别名（如company-pypi）
3. 批量上传包：
   进入存放所有.whl/.tar.gz包的目录，执行：

   # 上传所有whl格式包
   jf rt upload "*.whl" "pypi-local/" --recursive
   # 同时上传whl和源码包（tar.gz格式）
   jf rt upload "*.{whl,tar.gz}" "pypi-local/" --recursive
   

   其中pypi-local替换为你的实际PyPI本地仓库名称

方法2：Twine + 批量脚本上传 #

适合熟悉Python脚本的场景，灵活性高：

1. 安装Twine：
   离线环境下先下载Twine的包，执行pip install twine-xxx.whl完成安装
2. 编写批量上传脚本：
   创建batch_upload.py文件，填入以下内容（替换配置信息）：

   import os
   import subprocess
   
   # 配置项
   ARTI_PYPI_URL = "https://your-arti-domain/artifactory/api/pypi/pypi-local"
   USER = "你的Artifactory用户名"
   API_KEY = "你的Artifactory API密钥"
   PACKAGE_FOLDER = "/path/to/your/packages"
   
   # 遍历所有合法包文件
   pkg_files = [f for f in os.listdir(PACKAGE_FOLDER) 
                if f.endswith(('.whl', '.tar.gz', '.zip'))]
   
   for pkg in pkg_files:
       pkg_path = os.path.join(PACKAGE_FOLDER, pkg)
       print(f"正在上传: {pkg}")
       # 调用twine上传
       res = subprocess.run(
           ["twine", "upload", "--repository-url", ARTI_PYPI_URL,
            "--username", USER, "--password", API_KEY, pkg_path],
           capture_output=True, text=True
       )
       if res.returncode == 0:
           print(f"{pkg} 上传成功")
       else:
           print(f"{pkg} 上传失败: {res.stderr}")
   

3. 运行脚本：

   python batch_upload.py
   

方法3：Web UI批量上传（适合少量包） #

如果包数量不多，直接通过Artifactory界面操作：

1. 登录Artifactory Web UI，进入目标PyPI本地仓库
2. 点击页面上方的Upload按钮
3. 在上传窗口中，拖拽多个包文件到指定区域，或点击Select Files批量选择
4. 确认文件后点击Upload完成上传

注意事项 #

• 确保包文件名符合PyPI规范（如requests-2.31.0-py3-none-any.whl），Artifactory会自动识别包的元信息，无需手动创建setuptools条目
• 同事复用方案时，只需替换各自的用户名和API密钥即可
• 上传完成后可通过pip install --index-url https://your-arti-domain/artifactory/api/pypi/pypi-local/simple 包名验证是否能正常安装

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