云存储连接是平台读取与写入对象数据的存放位置，用于数据上传、云端导入、导出产物落桶与数据采集回传。连接分为全局连接与项目级连接，浏览器直传依赖存储桶的跨域规则。
使用前提
| 项 | 内容 |
|---|
| 菜单入口 | 管理 → 云存储 |
| 路由 | /clouds |
| 角色 | 云存储页面为管理员角色；项目级连接项目经理亦可创建 |
| 权限 | 「查看云存储」、「管理云存储」 |
| 依赖 | 已创建存储桶；具备访问密钥；浏览器直传需存储桶配置跨域规则 |
连接配置
存储类型
新建连接时可从 8 种对象存储中选择。MinIO 已停止新增，既有连接继续可用但不可再创建。
| 类型 | 服务商 |
|---|
| 腾讯云 COS | 腾讯云对象存储 |
| 阿里云 OSS | 阿里云对象存储 |
| 华为云 OBS | 华为云对象存储 |
| 火山引擎 TOS | 火山引擎对象存储 |
| Amazon S3 | 亚马逊云对象存储 |
| Azure Blob Storage | 微软云对象存储 |
| Cloudflare R2 | Cloudflare 对象存储 |
| 自建云存储 MinIO | 自建对象存储（已停止新增，仅既有连接可用） |
| RustFS 对象存储 | 自建对象存储 |
连接范围
连接的可见范围由「是否开放」与「项目」两个字段共同决定。
| 范围 | 字段取值 | 可见对象 | 可创建的角色 |
|---|
| 全局连接 | 是否开放 = 是 | 所有项目 | 管理员 |
| 项目级连接 | 是否开放 = 否，并选择项目 | 仅所选项目 | 管理员、项目经理 |
云存储页面要求管理员角色；项目经理的项目级连接能力见权限说明。
连接字段
| 字段 | 类型 | 必填 | 说明 |
|---|
| 云存储名称 | 文本 | 否 | 小写字母开头，仅含小写字母与数字；留空自动生成 |
| 存储区域 | 文本 | 否 | 存储桶所在区域 |
| 是否开放 | 枚举 | 是 | 所有用户均可上传 / 仅系统或管理员可上传 |
| 只读模式 | 枚举 | 是 | 只读（禁止写入与删除）/ 可读写 |
| 云厂商 | 枚举 | 是 | 上表 8 种可新建类型之一；既有 MinIO 连接仍可编辑 |
| 访问配置 | 文本 | 按厂商 | 密钥、区域、存储桶、端点等字段，随类型不同 |
| 项目 | 多选 | 否 | 关联项目，平台按项目控制连接的可见范围 |
访问配置字段
各类型在访问配置区需要填写的字段，随云厂商不同。
| 类型 | 必填字段 | 可选字段 |
|---|
| 腾讯云 COS | 密钥 ID、密钥 Key、区域、存储桶 | 无 |
| 阿里云 OSS | 密钥 ID、密钥 Key、区域、存储桶 | 端点、内网端点 |
| 华为云 OBS | 密钥 ID、密钥 Key、区域、存储桶 | 端点 |
| 火山引擎 TOS | 密钥 ID、密钥 Key、区域、存储桶 | 端点、内网端点 |
| Amazon S3 | 密钥 ID、密钥 Key、区域、存储桶 | 加速端点 |
| Azure Blob Storage | 存储端点、存储桶、访问密钥、秘密密钥 | 无 |
| Cloudflare R2 | 存储端点、存储桶、访问密钥 ID、访问密钥 Key | 无 |
| 自建云存储 MinIO | 主机地址、端口、存储桶、访问密钥 ID、访问密钥 Key | 访问协议、对外 HTTPS 代理地址、内网端点 |
| RustFS 对象存储 | 主机地址、端口、存储桶、访问密钥 ID、访问密钥 Key | 访问协议 |
连接管理
列表字段
| 字段 | 说明 |
|---|
| 云存储名 | 连接名称，点击进入对象浏览 |
| 云服务商 | 云存储类型标签 |
| 存储桶 | 从访问配置中提取的存储桶名 |
| 区域 | 从访问配置或区域字段提取 |
| 操作 | 编辑、删除 |
对象浏览
在连接详情中打开对象浏览，按前缀查看存储桶内的对象。点击连接行或对象浏览入口进入。
| 前缀 | 含义 |
|---|
| 全部 | 不限制前缀 |
| 系统导入 | dataset/ |
| 用户上传 | users/ |
| 导出时间对齐 | aligns/ |
| 导出丢帧检测 | framedrops/ |
| 导出 MCap 切块 | splits/ |
| 列表 字段 | 说明 |
|---|
| 数据名 | 对象键，点击下载 |
| 上传时间 | 对象最后修改时间 |
| 文件大小 | 对象大小 |
| 导入数据 | 已入库显示入口链接；未入库且扩展名受支持时可导入 |
| 文件操作 | 删除远端对象 |
| 操作 | 作用 | 约束 |
|---|
| 导入 | 将对象导入为平台数据集 | 仅 .mcap、.bag、.db3 |
| 删除 | 删除远端对象 | 只读模式下禁止 |
| 批量下载 | 下载所选对象 | 单次最多 10 个 |
| 批量删除 | 删除所选对象 | 只读模式下禁止 |
| 导出下载链接 | 导出当前前缀下对象的下载链接清单 | 只读 |
约束与限制
| 项 | 取值 | 说明 |
|---|
| 名称唯一 | 同名连接不可重复创建 | 保存时校验 |
| 名称格式 | 小写字母开头，仅含小写字母与数字 | 格式错误拒绝保存 |
| 只读模式 | 从底层禁止写入与删除 | 适用于第三方数据源 |
| 非管理员可见范围 | 仅 ispublic=true 的连接 | 私有连接仅管理员可见 |
| 批量下载 | 单次最多 10 个对象 | 超出部分不下载 |
| 导入格式 | .mcap、.bag、.db3 | 其他扩展名不提供导入入口 |
| 删除连接 | 管理员 操作，删除后不可恢复 | 关联项目一并解除 |
| 浏览器直传 | 需存储桶允许平台来源的跨域请求 | 未配置时上传失败 |
失败处理
| 现象 | 可能原因 | 处置 | 责任方 |
|---|
| 测试连接失败 | 密钥、区域、端点或存储桶错误；网络不可达 | 核对各厂商必填字段；确认网络连通 | 管理员、平台运维 |
| 提示连接成功但跨域不完整 | 存储桶未配置跨域规则 | 按提示添加允许来源、方法、请求头与响应头 | 管理员、平台运维 |
| 云存储列表为空 | 当前账号非管理员，且无公开连接 | 由管理员创建连接或将其设为对所有用户开放 | 管理员 |
| 上传对象失败 | 只读模式、跨域未配置或存储权限不足 | 检查只读开关与存储桶写权限 | 管理员 |
| 导入入口不显示 | 对象扩展名不在受支持范围 | 仅 .mcap、.bag、.db3 可导入 | 管理员 |
| 删除对象失败 | 只读模式禁止写入与删除 | 关闭只读模式后重试 | 管理员 |
相关页面