DRM-X 6.0 鸽子和橄榄枝标志DRM-X 6.0文档
◎ 简体中文

连接云存储

连接 AWS S3、Microsoft Azure、Google Cloud Storage、Alibaba Cloud OSS 或 Tencent Cloud COS,用于分发加密媒体。

查看 Markdown在线示例更新于 2026-10-26

按照 第一个云存储加密包教程连接提供商、发布测试片段并验证播放。

使用 Tencent Cloud COS 时,请参阅逐步配置 COS 并验证播放的教程。

1. 选择存储服务#

使用托管的 1AICLOUD,或连接 AWS S3、Microsoft Azure Blob Storage、Google Cloud Storage、Alibaba Cloud OSS 或 Tencent Cloud COS。为加密媒体和计划公开的资源创建专用存储桶或容器。原始视频和私有文档应保存在其他存储中。

投入生产前,须使用您自己的账户、权限、区域和分发设置验证这些连接器。连接检查成功仅表示可以列出对象;还须完成下述上传及播放检查。

提供方连接字段访问方式
AWS S3存储桶、区域、Access key ID、Secret access keyAmazon S3 API。请参阅配有图示的 S3 和 CloudFront 指南。
Microsoft Azure Blob Storage容器、存储账户名称、存储账户密钥原生 Blob API,使用短期有效、仅限 HTTPS、仅限单个 Blob 的上传 SAS。仅支持 Azure 公有云。
Google Cloud Storage存储桶、服务账户 HMAC access ID 和 HMAC secret位于 https://storage.googleapis.com 的 XML API。服务账户 JSON 密钥不是 HMAC 凭据。
Alibaba Cloud OSS存储桶、区域(例如 cn-hangzhou)、RAM AccessKey ID 和 AccessKey secret位于 https://oss-cn-hangzhou.aliyuncs.com 的 S3 兼容 API。您可能需要请 Alibaba Cloud 为账户启用 S3 兼容身份验证。
Tencent Cloud COS含 APPID 的完整存储桶名称、区域(例如 ap-guangzhou)、CAM SecretId 和 SecretKey位于 https://cos.ap-guangzhou.myqcloud.com 的 S3 兼容 API。

DRM-X 根据账户或区域生成新增提供方的 API 端点。云服务商单独收取存储、请求、分发及适用的带宽费用。请根据实际用量,将提供方价格与可用的 1AICLOUD 套餐进行比较。

2. 配置凭据#

仅授予分发存储桶所需的列出、读取、写入、复制和删除权限。Google 使用 Cloud Storage Settings → Interoperability 中的服务账户 HMAC 凭据;Alibaba 使用 RAM 凭据;Tencent 使用 CAM 凭据。仅在 Console → Cloud Storage → Connect storage 中保存凭据。DRM-X 会加密保存的凭据,保存后不会返回秘密值。编辑时将两个凭据字段均留空可保留原凭据;更换凭据时须同时填写两项。

Azure 应使用启用了 Shared Key 访问的专用存储账户。账户密钥可以访问整个存储账户,因此请将分发数据与私有数据隔离。本连接器不包含 Microsoft Entra 身份验证、用户委派 SAS 或主权云端点支持。

3. 配置公共 HTTPS 分发#

为加密媒体选择公共分发 URL 或 CDN 源站。AWS 可使用私有 S3 存储桶和 CloudFront Origin Access Control。Azure 可使用已配置的 HTTPS CDN,或明确允许公共 Blob 访问的容器。直接使用 Blob URL 时,须包含账户名和容器名,例如 https://ACCOUNT.blob.core.windows.net/CONTAINER/protected。Google、Alibaba 和 Tencent 须配置映射到存储桶的 HTTPS 分发域名或 CDN。公共前缀不得使用云控制台 URL、仅供私有 API 使用的端点、会过期的签名 URL 或含凭据的 URL。

公共对象访问会公开加密字节;DRM 许可证授权控制解密。请在最终分发主机(包括 CDN 响应)上配置 GET/HEAD CORS。

4. 允许浏览器上传和播放#

创建上传 CORS 规则,仅允许来自 https://6.drm-x.com 的 PUT。允许 Content-Type 及下列提供方专用请求头。请使用相应提供方的 CORS 配置格式;Azure 和 Google 不接受 S3 CORS JSON 文档。

提供方还需允许的上传请求头
AWS S3、Google Cloud Storage、Tencent Cloud COSx-amz-meta-drmx-sha256
Alibaba Cloud OSSx-amz-meta-drmx-sha256, x-oss-s3-compat
Microsoft Azure Blob Storagex-ms-blob-type, x-ms-meta-drmx_sha256

另设一条播放规则,允许 GET 和 HEAD,允许请求头 Range,并公开响应头 ETag、Content-Length、Content-Range 和 Accept-Ranges。公共加密媒体的读取来源可设为 *,也可以列出准确的播放器来源。媒体请求不得携带跨域 Cookie。CORS 是浏览器配置,并非访问授权。

5. 连接并映射路径#

打开 Cloud Storage,选择 Connect storage,选择提供方并填写字段。可设置加密内容基础路径及匹配的公共 URL 前缀。例如,基础路径 protected 和公共前缀 https://media.example.com/protected 会将对象 movie/manifest.mpd 映射到键 protected/movie/manifest.mpd。直接使用 Azure URL 时,公共前缀中也必须包含容器。选择 Save and verify。若希望 Packager 发布到此处,请将该连接设为默认。

已保存的存储连接仍可使用。提供方身份、凭据、默认选项和已发布 URL 均会保留。您仍可编辑、验证这些连接并使用它们上传。

6. 使用您的账户验证#

  1. 先在 Console 验证对象列表,再上传一个小型加密示例。核对字节数及公共 Preview URL。
  2. 测试公共 GET 和 HEAD,再测试 Range: bytes=0-15。确认字节内容、HTTP 206 和 Content-Range 符合预期。
  3. 测试文件夹、含空格及非 ASCII 字符的文件名、重命名、凭据轮换,以及删除可丢弃的测试对象。验证权限不足时操作失败且不会泄露秘密值。
  4. 使用 Desktop Packager 或 CLI 发布完整的加密输出包。确认状态为 Published,再通过 Content ID 在目标浏览器/设备上播放并测试跳转。
  5. 将提供方、区域、结果和时间戳保留为验证记录。不要记录账户秘密值或已签名上传 URL。

浏览器单次请求上传上限为 5 GiB;Azure 为 5,000 MiB。大型视频请使用 Packager 分段输出。保留策略、软删除、快照和版本控制可能保留提供方侧的数据或阻止删除。删除当前对象并不能证明所有保留版本均已清除。

7. 故障排查#

若能列出文件但无法上传,请检查 PUT CORS、所有已签名请求头、写入权限和时钟/有效期。若上传成功但公共 URL 不可用,请核对存储桶/容器、基础路径、CDN 源站映射和区分大小写的文件名。若 URL 可直接访问但播放提示 Failed to fetch,请检查 GET/HEAD CORS 和 CDN 缓存。若 Alibaba 拒绝 S3 身份验证,请向 Alibaba Cloud 支持确认兼容模式。

官方参考文献#