DigitalOcean Spaces 本身是一个兼容 S3 API 的对象存储服务，它把存储桶和边缘加速能力打包在一起。开启 Spaces CDN 后，同一个存储桶会获得一个由 DigitalOcean 边缘节点提供的加速域名，静态文件可以被缓存到离用户更近的位置。这适合个人项目、中小型应用以及不想维护复杂 CDN 配置的团队。与单独的云存储加第三方 CDN 相比，Spaces 在控制台里完成存储和加速的切换，省去了一部分运维工作。
一、开启 CDN 与绑定自定义域名
在 DigitalOcean 控制台中创建 Space 时，可以选择是否启用 CDN。启用后系统会分配一个形如 your-space.nyc3.cdn.digitaloceanspaces.com 的边缘域名。这个域名可以直接用于测试，但生产环境通常建议绑定自己的域名，因为它关系到 HTTPS 证书和品牌一致性。
绑定自定义域名需要在 DNS 服务商处添加一条 CNAME 记录，将你的子域名指向 Spaces 提供的边缘域名。比如把 static.yourdomain.com 指向 your-space.nyc3.cdn.digitaloceanspaces.com。之后回到 Spaces 设置页添加该域名，DigitalOcean 会自动签发 Let's Encrypt 证书。证书生效后，用户通过 HTTPS 访问文件时不会再出现证书不匹配的问题。
上传文件可以使用控制台网页、s3cmd、rclone 或各类 S3 SDK。下面是一个用 s3cmd 上传整个目录并同时设置缓存头的例子。
s3cmd --access_key=你的ACCESS_KEY --secret_key=你的SECRET_KEY \ --host=nyc3.digitaloceanspaces.com \ --host-bucket=your-space.nyc3.digitaloceanspaces.com \ sync ./dist/ s3://your-space/ \ --add-header='Cache-Control: max-age=31536000, public'
注意这里访问域名和上传域名不同。上传时走 nyc3.digitaloceanspaces.com，加速访问走 nyc3.cdn.digitaloceanspaces.com。如果只绑定了自定义域名，可以只给最终用户暴露自定义域名，上传仍然用源站域名。
二、缓存策略与失效机制
Spaces CDN 会尊重对象自带的 Cache-Control 和 Expires 响应头。对于不经常变化的静态资源，建议设置较长的缓存时间，例如图片、字体、前端构建产物带哈希的文件，可以设置 max-age=31536000 并表示 immutable。这样浏览器和 CDN 边缘节点都能缓存更久，减少回源请求。
但缓存时间越长，更新就越麻烦。如果文件名不带版本号，旧文件可能在 CDN 和用户浏览器里停留很久。推荐的方案是文件名加内容哈希，例如 app.a1b2c3.js，每次构建生成新文件名，这样新 HTML 引用的就是新的 URL，不需要手动失效。对于必须覆盖的固定文件，Spaces 提供缓存清除功能，可以在控制台选择文件或前缀进行 purge，也可以通过 API 触发。
# 使用 s3cmd 修改单个对象的缓存头
s3cmd modify s3://your-space/assets/logo.png \
--add-header='Cache-Control: max-age=86400, public'
# 使用 DigitalOcean API 清除某个前缀的缓存
curl -X DELETE \
-H "Authorization: Bearer $DO_TOKEN" \
"https://api.digitalocean.com/v2/cdn/endpoints/$CDN_ID/cache" \
-d '{"files":["assets/legacy/*"]}'
上面的 API 调用中，$CDN_ID 需要替换成你在 Spaces CDN 设置页看到的端点 ID。清除操作需要几秒到几分钟在全球节点生效，所以不要把 purge 当成高频更新手段。把内容哈希作为默认策略，能避免大部分缓存延迟问题。
另外，Spaces CDN 对 Vary: Origin 的支持有限，如果你的文件需要按请求来源返回不同内容，最好提前设计存储结构，避免把动态逻辑放在 CDN 层。
三、性能对比与成本控制
从性能角度看，Spaces CDN 适合静态资源分发、图片缩略图、视频切片、软件安装包等场景。DigitalOcean 的节点数量和覆盖面虽然不及大型 CDN 厂商，但对于中小规模应用已经足够。测试时可以用 curl -I 查看响应头，确认是否命中 CDN 缓存。
curl -I https://static.yourdomain.com/assets/logo.png # 关注 X-Cache 或 Age 头，Age 大于 0 通常表示命中缓存 HTTP/2 200 content-type: image/png cache-control: max-age=31536000, public age: 3721
成本方面，Spaces 的基础价格是每月 5 美元，包含 250 GiB 存储和 1 TiB 出站流量。这个免费额度对个人项目、演示站点和轻量商业项目很友好。超出后存储和流量按用量计费，价格透明。需要注意的是，如果绑定自定义域名并使用 CDN，但源站和 CDN 之间的回源流量在某些情况下也可能计费，具体以 DigitalOcean 定价页面为准。
与 Cloudflare R2 或 AWS CloudFront 相比，Spaces CDN 的优势在于配置简单、与 DigitalOcean 其他服务集成紧密，适合已经使用 Droplet 或 App Platform 的团队。如果追求更细的规则控制、边缘函数或更复杂的安全策略，可以考虑在 Spaces 前面再套一层 Cloudflare，但那样会多一层配置。
为了控制成本，可以定期清理过期文件和未使用的存储桶，开启生命周期规则自动删除旧版本。Spaces 支持通过 S3 API 设置生命周期策略，例如 30 天后删除临时上传目录中的对象。
四、常见问题与避坑指南
第一个常见问题是浏览器缓存和 CDN 缓存叠加导致更新不可见。即使你在 Spaces 后台清除了 CDN 缓存，用户浏览器如果还保留旧缓存，仍然可能看到旧内容。因此文件名加哈希比依赖缓存头更可靠。对于 HTML 文件，建议设置较短的缓存时间，例如 max-age=60 或 no-cache，让浏览器每次先验证，而其他资源长缓存。
第二个常见问题是 CORS 配置。前端使用 fetch 或 XHR 请求 Spaces 上的文件时，如果跨域，需要在存储桶上配置 CORS 规则。Spaces 支持 S3 兼容的 CORS XML 配置。下面是一个允许来自 https://app.yourdomain.com 的 GET 请求的例子。
<CORSConfiguration>
<CORSRule>
<AllowedOrigin>https://app.yourdomain.com</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
</CORSRule>
</CORSConfiguration>
注意这个 XML 片段中尖括号被转义为 < 和 >，实际保存到 Spaces 或通过 s3cmd 设置时，需要写入真实的 XML 标签。这里用转义是为了在 HTML 页面中正常显示。
第三个问题是对象权限。默认情况下 Space 中的文件可以公开访问，如果误传了私有配置文件，可能造成安全隐患。上传前可以使用 --acl-private 或设置桶策略限制公开读取，只对需要公开的目录开放。对于敏感文件，使用预签名 URL 提供临时访问，而不是把桶设为公开。
最后一个容易忽略的地方是区域选择。创建 Space 时必须选择区域，CDN 边缘节点会围绕该区域分配。如果主要用户在中国大陆，Spaces CDN 的加速效果可能有限，此时需要额外考虑合规和网络路径问题。总之，Spaces CDN 是一个低门槛的对象存储加速方案，掌握缓存策略和域名绑定后，可以覆盖大多数静态资源分发场景。
