Cloudflare R2 / S3：存储上传文件和 AI 生成结果
在 ShipAny 应用中把头像、上传文件和 AI 生成的图片视频存到 Cloudflare R2（或任意 S3 兼容存储）——创建存储桶、API Token、自定义域名和后台配置。
最后更新: 2026年10月8日
只要 SaaS 需要接收上传或生成文件，就需要对象存储。ShipAny 默认使用 Cloudflare R2，也兼容任意 S3 协议的存储服务——R2 没有出口流量费，很适合分发 AI 生成的图片和视频。
ShipAny 帮你做了什么
- 图片上传（头像、参考图）：通过
/api/storage/upload-image，只接受白名单内的位图格式，SVG 会被刻意拒绝。 - 保存 AI 结果：生成服务把产出文件交给存储服务，结果保存在你自己的存储桶里，而不是模型服务商的临时链接。
- 公开访问地址：使用你自己的域名，并可设置上传路径前缀来组织文件。
配置步骤
- 在 Cloudflare 控制台进入 R2 object storage，创建一个存储桶。
- 开发阶段可以开启存储桶的 Public Development URL（
https://pub-xxx.r2.dev）；正式环境请绑定自定义域名，例如https://cdn.your-domain.com——开发地址有访问频率限制。 - 在 Manage API tokens 中创建能访问该存储桶的 User API Token，复制 Access Key ID、Secret Access Key 和 Endpoint。
- 在 ShipAny 中打开 管理后台 → 设置 → 存储，填入 Access Key、Secret Key、存储桶名称、域名（公开访问地址），以及可选的 Endpoint 和上传路径。
- 在
/settings/profile上传头像，在新标签页打开图片，确认可以公开访问。
注意事项
- 部署在 Cloudflare Workers 时必须配置存储——没有可写文件系统，上传和 AI 结果都依赖 R2。
- 一定要填域名字段，否则文件能上传成功，但链接打不开。
- 使用 AWS S3 或其他 S3 兼容服务？填入对应的 Endpoint 即可，其余配置相同。