技术咨询：如何用Python上传本地文件至Box？能否借助Jenkins实现？

DevOps 小满

2026-5-20

嘿，作为Python新手，完全可以搞定把本地文件传到Box.com这件事，两种方式都可行——直接用Python代码手动/脚本化上传，或者借助Jenkins实现自动化上传。我给你拆解一下具体怎么做：

一、直接用Python上传到Box.com

Box官方提供了Python SDK boxsdk，用它来做上传非常方便，步骤也清晰：

先安装依赖包
打开终端/命令行，运行：

pip install boxsdk

获取Box认证信息
你需要先登录Box开发者平台创建一个应用，然后拿到三个关键信息：

Client ID
Client Secret
临时的Developer Token（适合新手快速测试，有效期60分钟）
如果要长期稳定使用，后续可以换成JWT服务账号认证，不过先从开发者token入手更简单。

编写上传代码
把下面的代码保存成upload_to_box.py，替换成你的认证信息和本地文件路径：

from boxsdk import Client, OAuth2
import os

# 从环境变量读取认证信息（也可以直接替换成你的信息，测试用）
oauth = OAuth2(
    client_id=os.environ.get('BOX_CLIENT_ID', '你的Client ID'),
    client_secret=os.environ.get('BOX_CLIENT_SECRET', '你的Client Secret'),
    access_token=os.environ.get('BOX_ACCESS_TOKEN', '你的Developer Token')
)

# 初始化Box客户端
client = Client(oauth)

# 配置上传参数
local_file_path = '/Users/xxx/Documents/test.pdf'  # 你的本地文件路径
box_target_folder_id = '0'  # Box根目录的ID固定为0，也可以换成其他文件夹ID

# 执行上传
with open(local_file_path, 'rb') as file_stream:
    uploaded_file = client.folder(box_target_folder_id).upload_stream(file_stream, file.name)

print(f"文件上传成功！Box文件ID: {uploaded_file.id}")

运行这个脚本，就能把本地文件传到Box的根目录了。

二、借助Jenkins完成上传

如果需要自动化上传（比如定时上传、触发事件后上传），用Jenkins是个不错的选择，步骤如下：

准备工作
确保Jenkins服务器能访问到要上传的文件：

可以把文件放到Jenkins的工作目录里（比如通过Git仓库拉取，或者用Jenkins的“文件参数”让用户上传到工作区）
或者让Jenkins服务器能访问你的本地文件系统（比如共享目录）

两种实现方式

方式一：调用Python脚本
在Jenkins里创建一个自由风格项目，添加「执行Shell」（Linux/macOS）或「执行Windows批处理命令」步骤，运行你写好的Python脚本。
注意：不要把Box的认证信息硬编码在脚本里！用Jenkins的「凭据管理」存储敏感信息，然后在构建步骤里通过环境变量读取，比如：
```
export BOX_CLIENT_ID=$(cat $BOX_CLIENT_ID_FILE)
export BOX_CLIENT_SECRET=$(cat $BOX_CLIENT_SECRET_FILE)
export BOX_ACCESS_TOKEN=$(cat $BOX_ACCESS_TOKEN_FILE)
python upload_to_box.py
```
脚本里就可以通过os.environ.get()来获取这些环境变量，更安全。
方式二：使用Box插件
如果Jenkins安装了Box插件（可以在插件市场搜索安装），可以直接添加「Box Upload」构建步骤：
- 配置Box的认证凭据（比如JWT）
- 指定本地文件路径（Jenkins工作区里的路径）
- 设置Box的目标文件夹路径或ID
  这种方式不用写代码，适合不想折腾脚本的场景。

额外优势
用Jenkins的话，你还可以配置定时任务（比如每天凌晨自动上传备份文件），或者设置触发条件（比如代码提交到Git仓库后自动上传构建产物），而且凭据管理更安全，避免敏感信息泄露。

如果在配置认证、写代码或者Jenkins设置的时候遇到具体问题，比如权限不足、token过期，可以再细化问题提问哦！

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