Cloudreve如何对接第三方对象存储作为存储源

一、结论

Cloudreve原生支持对接S3兼容的第三方对象存储作为存储源，整个操作的核心逻辑是提前准备好Endpoint、AccessKey、SecretKey、Bucket、Region等S3接入必备参数，之后在Cloudreve后台的存储策略配置页填写参数、测试连通即可完成对接，无需额外代码修改。

二、准备工作

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

• 已完成搭建、拥有管理员账号权限的Cloudreve站点
• 支持S3协议的对象存储服务账号
• 对象存储服务中已创建完成、权限配置符合业务要求的存储桶（Bucket）
• 对象存储服务商提供的Endpoint访问地址
• 对象存储服务生成的AccessKey（访问密钥ID）
• 与AccessKey配对的SecretKey（访问密钥凭证）
• 存储桶所属地域对应的Region代码
• 若需要前端直传功能，需提前准备好Cloudreve站点域名用于配置跨域规则

三、操作步骤

1. 登录Cloudreve管理员后台，进入左侧菜单栏的「存储策略」页面，结果是可以看到「新增存储策略」的操作按钮。

2. 点击「新增存储策略」，在弹出的存储类型选择列表中选择「S3兼容存储」，结果是进入S3存储专属的配置表单页面。

3. 登录第三方对象存储服务商控制台，确认已创建存储桶，按需配置存储桶的读写权限、跨域CORS规则、防盗链规则，结果是获得符合Cloudreve对接要求的可用存储桶实体。

4. 在对象存储服务商控制台的密钥管理页面，生成专属的AccessKey与SecretKey，同时复制存储桶对应的Endpoint、Region、Bucket名称信息，结果是拿到所有需要填写的核心配置参数。

5. 回到Cloudreve的S3存储配置表单，按提示依次填写获取到的Endpoint、AccessKey、SecretKey、Bucket、Region参数，根据业务需要自定义配置文件存储路径规则、直链有效期、分片上传阈值、文件大小限制等可选配置项，结果是所有必填配置项填写完成。

6. 点击配置页底部的「测试连接」按钮，等待系统校验参数有效性，结果是弹出「连接成功」提示即说明参数配置无错误，若提示连接失败则需要对照报错信息核对对应配置项。

7. 测试连接通过后保存存储策略，进入用户组管理页面，将该存储策略分配给对应的用户组，或者设置为全站默认存储策略，结果是对应权限的用户上传文件会自动存储到对接的第三方对象存储中。

8. 切换到普通用户账号，上传测试文件，依次测试预览、下载、分享、删除等操作，确认所有功能正常，结果是完成整个Cloudreve对接第三方对象存储的流程。

四、常见错误

1. Endpoint填写错误：常见问题为手动输入时多写了Bucket前缀、http/https协议头错误、选择了错误地域的Endpoint，解决方法是直接从对象存储服务商控制台复制官方提供的标准Endpoint地址，不要手动输入。

2. AccessKey或SecretKey错误：常见问题为复制时带了多余空格、字符复制不全、密钥已被禁用或删除，解决方法是重新生成新的密钥对，复制时确认无多余字符，同时确认密钥处于启用状态。

3. Bucket名称不匹配：常见问题为填写的存储桶名称和实际创建的名称大小写不一致、存在多余字符，解决方法是直接从服务商控制台复制Bucket名称，注意区分大小写。

4. Region填写不匹配：常见问题为填写的地域代码和存储桶实际所属地域不一致，解决方法是核对服务商提供的地域代码对照表，按存储桶实际所属地域填写对应代码，部分无强制要求的服务商可留空或填写默认值。

5. 权限不足上传失败：常见问题为存储桶未给对应密钥分配上传、下载、删除等操作权限，或者存储桶设置了禁止公网写入，解决方法是调整存储桶的权限策略，给使用的密钥配置最小必要权限集（至少包含S3的读写操作权限）。

6. 上传成功但无法访问：常见问题为存储桶的跨域规则未添加Cloudreve站点域名、防盗链规则拦截了访问请求、未开启静态网站访问，解决方法是检查存储桶的访问控制配置，将Cloudreve站点域名加入跨域白名单和防盗链白名单。

五、示例说明

以下为Cloudreve对接S3兼容存储的通用配置示例，所有参数需替换为自己的实际信息：

• 存储策略类型：S3兼容存储
• Endpoint：填写第三方对象存储服务商提供的标准访问地址，无需额外添加Bucket前缀
• AccessKey：填写服务商控制台生成的访问密钥ID
• SecretKey：填写与AccessKey配对的访问密钥凭证
• Bucket：填写已创建完成的存储桶名称，注意区分大小写
• Region：填写存储桶所属地域对应的官方代码，无强制要求的服务商可留空
• 存储路径规则：可按业务需求自定义，例如{year}/{month}/{day}/{md5}{ext}
• 直链有效期：私有桶可设置为所需的有效期时长，公共桶可设置为永久有效
• 分片上传阈值：可设置为100MB，大于该大小的文件会自动分片上传

六、更简单的方案

如果不想自己搭建MinIO等自建存储服务，也不想承担服务器存储扩容、带宽成本、容灾备份等运维工作，可以直接选择商业化的S3兼容云对象存储服务，省去运维成本的同时还能获得更高的可用性和全国范围的分发加速能力。如果你需要一个兼容S3协议、适合网盘系统存储源、附件存储、图床和不限流量下载分发的对象存储服务，可以了解七彩云对象存储，它对接Cloudreve的流程和上述通用步骤完全一致，无需额外适配，对新手站长和开发者更友好。

七、FAQ

1. Cloudreve对接S3存储后，之前存在本地的文件可以迁移到第三方对象存储吗？

可以，Cloudreve后台自带存储迁移工具，你可以在存储策略管理页创建迁移任务，选择将旧存储策略中的文件批量迁移到新对接的S3存储中，迁移过程不会影响现有文件的正常访问。

2. 对接S3存储后，用户访问文件会占用Cloudreve服务器的带宽吗？

取决于你的配置：如果开启了直链访问模式，用户访问文件会直接跳转到对象存储的访问地址，不占用Cloudreve服务器的带宽；如果使用代理回源模式，文件会先经过Cloudreve服务器再返回给用户，会占用Cloudreve服务器的带宽。

3. 开源版Cloudreve也可以对接第三方S3存储吗？

可以，无论是开源版还是付费版Cloudreve都原生支持S3兼容存储的对接，功能上没有限制，配置流程完全一致。

4. 对接S3存储时必须开启存储桶的公共读权限吗？

不一定，如果你的需求是私有存储，不需要对外分享文件，可以不开公共读权限，Cloudreve会自动生成带签名的临时访问链接；如果需要对外提供公开的下载直链，就需要开启公共读权限或者配置对应的公开访问策略。

八、总结

Cloudreve对接第三方S3兼容对象存储的流程非常简单，核心就是提前准备好S3接入的5项核心参数，在后台完成配置、测试、权限分配三步即可，整个流程最快10分钟就能完成。这种对接方式非常适合需要降低自建存储成本、提升文件访问速度、支撑大文件下载分发、图床、资源站、共享网盘等场景的站长和开发者，不需要修改代码就能完成存储扩容，后续也可以根据业务需求随时切换不同的S3存储服务，灵活性非常高。