快速入门
S3 集成
Label Studio 支持与 S3 兼容存储集成，用于导入数据和导出标注。常见选项包括 Amazon S3、Ceph RGW 以及其他 S3 兼容对象存储服务。
前提条件
- 具有相应权限的 S3 兼容存储桶
- 访问凭据（Access Key ID 和 Secret Access Key）
存储桶和凭据必须来自受支持的 S3 兼容服务；平台不要求特定的对象存储产品。
在 Label Studio 中使用 S3
-
访问存储设置
- 打开 Label Studio 项目
- 转到 Settings > Cloud Storage
-
添加源存储
- 单击 Add Source Storage
- 选择 AWS S3 作为存储类型
- 填写所需信息：
- Storage Title：存储连接的名称
- Bucket Name：S3 存储桶名称
- Region Name：存储地域（例如，AWS S3 使用 us-east-1；如果提供商不要求，也可以留空）
- S3 Endpoint：可选的自定义 S3 endpoint（AWS S3 默认值留空；使用非默认或 S3 兼容 endpoint 时进行设置）
- Access Key ID：访问密钥
- Secret Access Key：密钥
- Session Token：临时凭据的可选 session token
- Bucket Prefix：存储桶中的可选路径前缀（例如，
data/、input/） - File Filter Regex：用于筛选文件的可选 regex（例如，
.*csv或.*(jpe?g|png|tiff)）
- 配置可选设置：
- Treat every bucket object as a source file：针对媒体文件勾选；针对 JSON 任务文件取消勾选
- Recursive scan：启用后递归扫描子目录
- Use pre-signed URLs：启用后可通过浏览器直接访问 S3（推荐）
- Expiration minutes：在启用 Use pre-signed URLs 时的 URL 过期时间（默认：15 分钟）
- 单击 Check Connection 测试连通性
- 单击 Add Storage 创建存储连接
-
添加目标存储（可选）
- 单击 Add Target Storage 将标注导出到 S3
- 填写与源存储类似的 S3 参数
- 目标存储的其他参数：
- SSE KMS Key ID：用于服务端加密的可选 KMS key
- 配置可选设置：
- Can delete objects from storage：启用后允许从存储中删除标注
- 单击 Check Connection 测试连通性
- 单击 Add Storage 创建存储连接
-
将数据上传到 S3
- 将数据文件上传到已配置的 S3 存储桶和前缀路径
- 确保可使用已配置的访问凭据访问这些数据文件
- 使用 AWS CLI 或其他 S3 兼容客户端进行批量上传
-
导入数据
- 在
Source Cloud Storage下单击 Sync Storage，从 S3 导入数据 - 每当 S3 存储桶中新增数据时，都可使用同步操作
- 在
-
执行标注
- 在 Label Studio 界面中访问已导入的数据
- 使用已配置的标注界面完成标注
-
导出标注
- 单击 Export 按钮，以多种格式（JSON、CSV 等）下载标注结果
- 或在
Target Cloud Storage中单击 Sync Storage，将标注推送到 S3 - 注意：目标存储仅以 JSON 格式导出标注。使用 Label Studio SDK 可将 JSON 标注转换为其他格式（CSV、COCO、Pascal VOC、YOLO 等）。详情请参见 SDK converter。
-
将数据和标注应用于模型训练/验证
- 使用 AWS CLI、boto3 或其他 S3 客户端从 S3 下载训练数据和标注。实现细节请参见 S3 examples。
- 如有需要，使用 Label Studio SDK 转换标注格式。
- 将数据集成到机器学习流水线中。
- 使用标注进行模型训练或验证。
存储结构建议
- 为不同项目使用不同的存储桶或不同的路径前缀，以避免数据冲突。
- 目标存储和源存储可以使用同一个 S3 存储桶，但采用不同的路径前缀（例如，源使用
input/，目标使用output/），也可以使用不同的存储桶，以获得更好的数据隔离和访问控制。
其他资源
有关 Label Studio 快速入门指南，请参阅官方文档：Getting Started With Label Studio: A Step-By-Step Guide