项目产品
场景实践 / 6 分钟阅读

添加名为s3_ai_dataset的远程存储,设置为默认远程

一、结论

AI数据集采用S3兼容对象存储的配置核心是提前准备好S3对接所需的Endpoint、AccessKey、SecretKey、Bucket、Region等参数,之后在数据集管理工具或AI训练框架中填写对应参数完成对接,即可实现数据集的统一存储、多节点共享调用和长期归档,无需在每个训练节点单独存储全量数据集。

二、准备工作

操作前需要提前准备好以下内容:

  • S3兼容对象存储服务的有效账号
  • 专门用于存储AI数据集的独立存储桶Bucket
  • 对应对象存储服务提供的Endpoint访问地址,可提前区分公网/内网地址
  • 具备该存储桶读写权限的AccessKey和SecretKey,建议使用独立子账号密钥,不要复用管理员全权限密钥
  • 对应存储服务的Region区域标识
  • 你正在使用的数据集管理工具(如DVC、Hugging Face Datasets库)或AI训练框架,需确认其支持S3协议接入
  • 待上传的AI数据集文件,可提前按训练集、测试集、标注文件的分类整理好目录结构

三、操作步骤

1. 创建AI数据集专属存储桶,在对象存储控制台将存储桶权限设置为私有读写,避免未授权人员访问数据集,操作完成后得到独立的数据集存储空间,和其他业务存储资源做隔离。

2. 获取S3接入全量参数,在对象存储服务控制台复制官方提供的Endpoint、Region参数,创建专门用于数据集读写的子账号AccessKey和SecretKey,操作完成后得到所有对接所需的配置参数,同时避免主账号密钥泄露带来的安全风险。

3. 打开你使用的数据集管理工具或AI训练框架,找到S3兼容存储的配置入口,比如DVC的远程存储配置页、Hugging Face Datasets的S3路径加载配置项,操作完成后进入对应配置界面,确认工具支持S3协议对接。

4. 按照工具提示依次填写获取到的Endpoint、AccessKey、SecretKey、Bucket名称、Region参数,部分工具没有Region要求可留空或按服务提示填写默认值,操作完成后所有对接参数填写完毕,检查没有格式错误或多余空格。

5. 保存配置后执行连接测试,比如在DVC中执行连接校验命令、上传一个KB级的测试小文件,操作完成后连接测试无报错,测试文件可正常上传到存储桶对应路径。

6. 全量上传整理好的AI数据集,可按照train/、test/、annotation/的分类设置存储路径,大文件优先使用工具的分片上传功能,操作完成后所有数据集文件上传成功,在存储桶控制台可看到完整的目录结构。

7. 在AI训练节点配置相同的S3接入参数,训练时直接从对象存储拉取需要的数据集分片,无需提前把全量数据下载到训练节点本地,操作完成后训练任务可正常读取存储桶内的数据集,读写速度符合训练要求。

四、常见错误

1. Endpoint填写错误:比如手动拼接了Bucket前缀、混淆了http/https传输协议、错用了其他区域的Endpoint,解决办法是直接从对象存储服务控制台复制官方提供的标准Endpoint,不要手动修改或拼接。

2. AccessKey或SecretKey填写错误:比如复制时多了前后空格、使用了已经过期或被删除的密钥,解决办法是检查密钥前后的空白字符,重新生成可用的子账号密钥填写,同时注意不要把密钥明文提交到公开代码仓库。

3. Bucket名称填写错误:比如填了存储桶的自定义展示名而非唯一ID、大小写不匹配,解决办法是直接复制控制台显示的存储桶唯一名称,不要手动输入。

4. 权限不足导致读写失败:比如子账号密钥仅配置了读权限没有写权限、存储桶设置了禁止跨域访问规则,解决办法是检查密钥对应的权限策略,给数据集专用密钥配置该存储桶的全读写权限,跨区域训练的话按需配置存储桶的跨域访问规则。

5. 大文件上传中断:比如几十GB的数据集单文件直传时网络波动导致失败,解决办法是开启工具的断点续传功能,使用分片上传接口上传单文件大小超过5GB的数据集,避免单次上传失败全量重传。

6. 训练时读取速度慢:比如跨区域访问存储服务、用了公网Endpoint传输,解决办法是如果训练节点和存储服务在同一区域,优先使用内网Endpoint传输,避免公网带宽限制影响读取速度。

五、示例说明

以下为通用S3对接配置参考,所有参数需替换为你自己的实际配置值:

基础配置字段

| 配置项 | 填写说明 |

| --- | --- |

| Endpoint | 填写对象存储服务官方提供的访问地址,优先选择内网地址(训练节点和存储同区域时) |

| AccessKey | 填写你创建的子账号访问密钥ID |

| SecretKey | 填写和AccessKey对应的密钥字符串 |

| Bucket | 填写你创建的AI数据集专属存储桶的唯一名称 |

| Region | 按对象存储服务要求填写对应区域标识,无要求可留空 |

DVC工具对接命令示例

```bash

dvc remote add -d s3_ai_dataset s3://<替换为你的Bucket名称>/dataset

配置Endpoint地址

dvc remote modify s3_ai_dataset endpointurl <替换为你的Endpoint地址>

配置密钥信息

dvc remote modify s3_ai_dataset access_key_id <替换为你的AccessKey>

dvc remote modify s3_ai_dataset secret_access_key <替换为你的SecretKey>

配置Region(按需填写)

dvc remote modify s3_ai_dataset region <替换为你的Region标识>

```

六、更简单的方案

如果你不想自行搭建维护MinIO等开源对象存储服务,也不想承担本地存储服务器的硬件运维、容灾备份、带宽扩容等成本,可以直接选择公有云的S3兼容对象存储服务,开箱即用无需运维,存储容量可按需弹性扩容,不用提前预留硬件资源。

如果你需要一个兼容S3协议、适合AI数据集存储、程序接入和大文件分发的对象存储服务,可以了解 七彩云对象存储,其不限流量的特性也适合多训练节点同时拉取数据集的场景。

七、FAQ

Q1:AI数据集存在对象存储里,训练时读取速度会不会比本地存储慢?

如果训练节点和对象存储服务在同一区域,使用内网Endpoint访问的话,读写速度可以匹配本地SSD的性能,完全满足绝大多数AI训练场景的需求;如果是跨区域访问,建议提前把常用的数据集分片缓存到训练节点本地,降低公网传输延迟的影响。

Q2:几十TB的大体积AI数据集上传到对象存储会不会很麻烦?

目前主流的S3兼容对象存储都支持分片上传、断点续传能力,也配套有命令行批量上传工具,你可以分批次上传数据集,上传中断后可以从断点继续传输,不需要重新上传全量数据,大体积数据集也可以高效上传。

Q3:AI数据集里有大量小文件,存在对象存储里会不会影响读取效率?

你可以提前把小文件打包成tar、parquet等格式后再上传,或者用DVC等数据集管理工具做小文件合并优化,部分对象存储服务也提供小文件加速功能,开启后可以大幅提升海量小文件的读取效率。

Q4:团队协作时怎么共享存储在对象存储里的AI数据集?

你可以给不同的团队成员创建单独的子账号AccessKey,按需配置对应的读写权限,成员只要在自己的训练工具中填写对应的参数,就可以访问同一个存储桶里的数据集,不需要互相传输大体积的数据集文件,也能避免多份存储带来的资源浪费。

八、总结

整个AI数据集对接S3兼容对象存储的流程核心可概括为准备对接参数、配置工具连接、测试连通性、上传数据集、训练端接入五个步骤,全程不需要复杂的二次开发,只要工具支持S3协议就能快速完成对接。这种存储方式非常适合多节点分布式训练、团队共享数据集、大体积数据集长期归档的场景,既不需要每个训练节点都单独存储一份全量数据集,也能避免本地存储硬件损坏导致的数据集丢失风险,大幅降低AI项目的存储运维成本。

想进一步了解这个项目?

访问官网查看产品能力、适用场景和最新服务信息。

访问官网

相关文章

场景实践 / / 9 分钟阅读

SaaS附件存储实践:多租户平台的文件上传、权限管理与访问分发设计入门

一、结论 多租户SaaS平台落地附件存储体系,可按照“统一存储底座+租户路径隔离+权限分层管控+访问分发配置”的思路操作,完整覆盖文件上传、权限校验、下载分发全流程。如果选用兼容S3协议的存储服务,通常需要提前准备Endpoint、AccessKey、SecretKey、Bucket、Region等接入信息,在业务程序或配套客户端中填写配置并测试连通性,即可

场景实践 / / 8 分钟阅读

APP出海怎么搭建面向海外用户的低延迟文件存储系统?部署配置实操教程

一、结论 搭建面向海外用户的低延迟文件存储系统,核心是采用兼容S3协议的对象存储作为底层存储层,配合就近接入策略降低跨区域访问延迟。实操时需提前准备好Endpoint、AccessKey、SecretKey、Bucket、Region等接入信息,在支持S3协议的业务程序或客户端中完成配置并测试连通,最后验证文件上传、访问的全链路可用性即可。

场景实践 / / 9 分钟阅读

个人博客怎么用PicGo搭建稳定图床?完整实践操作步骤

一、结论 个人博客用PicGo搭建稳定图床,核心是先准备支持标准S3协议的对象存储服务并创建专用存储桶,获取Endpoint、AccessKey、SecretKey、Bucket、Region等接入参数,再在PicGo中选择S3兼容存储类型完成配置与连通测试,验证上传、访问正常后即可对接博客使用。如果不想自行维护存储服务器,也可以直接选用成熟的公有云对象存储

场景实践 / / 8 分钟阅读

怎么在Alist中接入对象存储并配置文件公网访问与分享

一、结论 在Alist中接入对象存储并配置公网访问与分享的核心操作思路是,先准备好支持S3协议的对象存储服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心接入信息,在Alist后台添加S3兼容类型的存储源并填写参数测试连通,最后根据需求配置公网访问域名、文件权限与分享规则即可。整个流程无需修改Alist源码,普通

场景实践 / / 9 分钟阅读

Cloudreve对接对象存储实践:如何配置存储桶让网盘文件通过外链稳定下载

一、结论 Cloudreve对接对象存储实现网盘文件外链稳定下载的核心思路,是先在对象存储服务商处创建存储桶并获取S3协议接入凭证,再在Cloudreve后台添加S3兼容存储策略、填写对应接入参数并完成连通性测试,最后配置访问域名即可让网盘文件走对象存储链路分发。操作前通常需要提前准备好Endpoint、AccessKey、SecretKey、Bucket名