Link to this sectionAzure Blob Storage 集成#

Azure Blob Storage 集成可将你的存储账户容器连接到 Ultralytics Platform。你的图像将保留在你的容器中——平台会就地索引它们，因此你无需上传副本即可浏览、标注和训练 YOLO 模型。

Pro 功能

Azure Blob Storage 数据集需要 Pro 或 Enterprise 计划。免费工作区可以看到该集成，但在连接时会被提示升级。如果订阅结束，现有的 Azure Blob Storage 数据集仍可完全访问——只有新连接和导入需要 Pro 计划。

Link to this section获取连接字符串#

平台仅从你的存储中进行读取——它绝不会写入、修改或删除你的 blob。当前的集成需要一个账户访问密钥连接字符串，尽管平台仅使用列表（list）和读取（read）操作，但该字符串会授予账户级的特权：

1. 在 Azure 门户中，打开你的存储账户。
2. 转到 Security + networking > Access keys（安全+网络 > 访问密钥）。
3. 复制一个 connection string（连接字符串）。

仅限公共 Azure 云

连接使用标准的 blob.core.windows.net 端点。主权云（Azure China、Azure Government）和自定义 blob 端点不受支持。

Link to this section连接到 Platform#

1. 转到 Settings > Integrations（设置 > 集成）并找到 Microsoft Azure 卡片。
2. 点击 Connect（连接）并粘贴连接字符串。
3. 平台会列出存储账户中的容器。选择要连接的容器，或手动输入容器名称。
4. 点击 Connect（连接）。平台在保存任何内容之前，会验证其是否可以列出并读取每个选定的容器。

稍后重新连接同一个存储账户会将新容器添加到现有集成中。仅当替换后的凭据仍然可以读取你已连接的所有容器时，已保存的凭据才会被替换。

凭据安全性

如果账户密钥在平台外部泄露，它可能被用于授权写入和删除操作或创建 SAS 令牌。凭据在静态时会使用 AES-256-GCM 进行加密，绝不会返回给浏览器，也绝不会进入训练作业载荷。请尽可能使用专用的存储账户。若要撤销访问权限，请在 Azure 中轮换存储账户访问密钥。

Link to this section从 Blob 容器创建数据集#

1. 点击 New Dataset 并打开 Cloud storage 选项卡。
2. 选择一个已连接的容器并浏览到包含你数据的文件夹。
3. 确认文件夹，调整数据集名称，然后创建数据集。

Platform 会列出文件夹一次并索引其发现的内容：

• Images（图像）—— .jpg、.jpeg、.png、.webp 和 .avif blob 会通过读取边界标头请求的维度进行索引。源像素绝不会从你的容器中被复制出来。
• Labels — YOLO .txt 附带文件被解析为 Platform 标注，匹配标准 images/ → labels/ 布局或作为同文件夹下的并列文件。
• Metadata — data.yaml/data.yml 提供类别名称、任务类型和姿态关键点形状，与 归档上传 完全一致。
• Splits（拆分）—— blob 路径中的 train、val 和 test 文件夹名称会自动分配拆分。

该数据集随后表现得与其他数据集一样：浏览并 标注 它，将其设置为公开或私有，与你的 团队 分享它，并通过托管训练在上面进行 训练。原始文件按需流式传输，索引图像不会消耗你的 Platform 存储配额。

限制

单次导入最多可索引 50,000 个 blob，标签或 YAML 文件每个最多 1 MB。较大的容器应拆分为多个数据集。

保持已索引的 blob 不可变

每个已索引的图像都会固定在其 blob ETag 上，如果 blob 在后台发生变化，平台会失败以确保安全。请添加新的 blob，而不是覆盖现有文件。

Link to this section导入失败#

如果导入失败（例如空文件夹、路径拼写错误或权限被撤销），数据集页面会显示错误。编辑者可以点击 Retry import（重试导入），使用存储的容器和文件夹重新启动，或者创建一个指向已更正路径的新数据集。

Link to this section训练#

托管训练通过正常的训练流程进行。工作节点会在运行期间将固定的原始文件下载到临时作业存储中，并在作业清理时将其删除——你的 Azure 凭据绝不会到达计算环境。

Link to this section当前限制#

Azure 支持的数据集目前排除了一些需要平台拥有图像副本的功能：自动标注、聚类分析、数据集克隆以及不可变的 版本快照。

删除 Azure 支持的数据集或其中的单个图像仅会移除平台的引用——你的 blob 绝不会被触及。

另请参阅 Google Cloud Storage 和 Amazon S3 集成。