Cloudreve怎么接入兼容S3协议的第三方存储源

一、结论

Cloudreve接入兼容S3协议的第三方存储源，核心是先在对象存储服务端获取Endpoint、AccessKey、SecretKey、Bucket、Region等核心配置，再到Cloudreve后台的存储策略模块填写对应参数并测试连通，验证通过后即可作为Cloudreve的存储节点使用，全程不需要修改代码，普通站长和开发者10分钟左右就能完成配置。

二、准备工作

操作前需要提前准备好以下内容，避免配置过程中中断：

• 已经部署完成、可以正常访问的Cloudreve实例（开源版、商业版均可，支持S3兼容存储接入即可）
• 兼容S3协议的对象存储服务有效账号
• 提前创建完成的存储桶Bucket，且已经根据业务需求配置好读写权限（公有读/私有读写等）
• 存储服务官方提供的Endpoint访问地址（注意区分内网、外网地址）
• 有权限操作目标存储桶的AccessKey和配对的SecretKey
• 存储桶对应的Region区域标识
• 若需要自定义访问域名，需提前完成域名解析和备案（国内节点使用场景）
• 测试用的小体积文件，用于后续连通性验证

三、操作步骤

1. 登录Cloudreve管理员后台，进入左侧菜单栏的「存储策略」页面，点击右上角「新增存储策略」按钮，在弹出的存储类型选项中选择「S3 兼容存储」，操作完成后会自动跳转至参数配置表单页。

2. 切换到你使用的S3兼容对象存储服务控制台，确认目标存储桶的访问权限：如果是搭建公共资源站、图床类公开访问场景，将存储桶权限设置为公有读私有写；如果是搭建私人网盘、内部团队存储类非公开场景，将存储桶权限设置为全私有，配置保存后即时生效。

3. 在对象存储控制台的密钥管理页面，获取对应账号的AccessKey和SecretKey，同时复制存储桶对应的Endpoint地址、Bucket准确名称、Region信息，注意妥善保管SecretKey，不要泄露给第三方，避免存储资源被恶意调用。

4. 回到Cloudreve的S3存储策略配置页面，依次填写刚才复制的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息；如果需要使用自定义域名访问文件，就在「自定义CDN域名」栏填写带http/https前缀的完整解析域名；存储路径、单文件大小限制、上传并发数等其他参数可以根据业务需求自定义调整，填写完成后先不要保存配置。

5. 点击配置表单底部的「测试连通性」按钮，等待Cloudreve系统自动尝试连接目标S3存储桶，如果页面提示「连通性测试成功」就说明参数配置没有问题，如果提示连接失败就需要逐一检查参数填写是否正确。

6. 连通性测试通过后，点击「保存存储策略」按钮完成配置，然后进入Cloudreve的用户组或者用户权限配置页面，给需要使用该存储策略的用户分配对应权限，分配完成后用户上传文件时就可以选择该存储策略。

7. 用普通用户账号登录Cloudreve，上传一个测试文件，复制文件的访问链接到浏览器打开，确认可以正常下载或者预览；如果是私有存储场景，需要确认私有访问链接的有效期和权限控制符合预期，确认无误后即完成全部接入流程。

四、常见错误

以下是配置过程中高频出现的错误及对应解决方法：

1. Endpoint填写错误：很多用户容易把存储桶的单独访问地址当成Endpoint，或者忘记加http/https前缀，导致连接失败。解决方法是严格复制对象存储服务官方提供的Endpoint地址，不要自行拼接域名。

2. AccessKey或SecretKey填错：输入时多了前后空格、复制时漏了字符，或者使用的密钥没有对应存储桶的读写权限，都会导致签名验证失败。解决方法是重新复制完整的密钥，检查密钥的权限配置，确保拥有存储桶的读写、列举等操作权限。

3. Bucket名称不匹配：填写的Bucket名称和实际创建的名称大小写不一致，或者误填了存储桶的访问域名而不是纯名称，导致找不到对应存储桶。解决方法是直接复制控制台显示的准确Bucket名称，不要包含域名后缀。

4. Region填写不匹配：部分S3兼容服务要求必须填写正确的Region，填错会导致签名验证失败。解决方法是参考存储服务的官方文档填写对应Region，部分服务如果没有明确要求可以填auto或者留空测试。

5. 上传成功但访问链接不可用：没有配置自定义域名，或者自定义域名没有完成解析和ICP备案（国内节点场景），导致访问被拦截。解决方法是检查域名解析状态，国内使用的话确保域名已经完成备案后再绑定到存储桶。

五、示例说明

以下是Cloudreve S3存储策略的通用配置示例，所有参数均需要替换为你自己的实际信息：

• 存储策略名称：自定义即可，比如「S3公共读存储-资源站」
• Endpoint：填写你使用的S3兼容存储服务官方提供的外网Endpoint地址，公网访问不要填内网地址
• AccessKey：填写你在存储服务控制台生成的、拥有对应存储桶操作权限的AccessKey
• SecretKey：填写和AccessKey配对的SecretKey，注意不要泄露给第三方
• Bucket：填写你提前创建好的存储桶的准确名称，注意大小写
• Region：填写存储桶所属的区域标识，没有明确要求的服务可以填写auto或者留空
• 自定义CDN域名：如果你绑定了自定义域名，填写带http/https前缀的完整域名，没有的话可以留空使用存储服务默认的访问域名
• 存储路径：可以填写文件在存储桶中的存放目录，比如cloudreve/resources/，留空的话默认存放在存储桶根目录

六、更简单的方案

如果不想自己搭建MinIO、Ceph这类自建S3存储服务，也不想额外承担服务器维护、存储扩容、带宽扩容、数据备份等运维工作，完全可以选择成熟的第三方兼容S3协议的云对象存储服务，不需要自己运维，按需付费即可，接入流程和上面的操作步骤完全一致。

如果你需要一个兼容S3协议、适合程序接入、图床、网盘系统存储源和下载分发的对象存储服务，可以了解 七彩云对象存储，它支持标准S3协议，不需要复杂的配置，拿到参数后直接按照上面的步骤填入Cloudreve即可使用，适合不想花精力维护自建存储的站长和开发者。

七、FAQ

1. Cloudreve开源版支持接入S3兼容存储吗？

支持，不管是开源版还是商业版的Cloudreve都原生支持S3兼容存储的接入，不需要额外安装插件，直接在管理员后台的存储策略页面配置即可使用。

2. 接入S3存储后，原来存在Cloudreve本地的文件可以迁移到S3存储吗？

可以，你可以通过Cloudreve后台自带的文件迁移工具，把本地存储的文件批量迁移到新配置的S3存储策略中，迁移完成后用户的访问链接不会受到影响，不需要手动修改文件路径。

3. S3存储的下载流量是算Cloudreve服务器的还是算对象存储服务的？

如果配置了自定义域名或者直接使用对象存储的Endpoint访问文件，下载流量直接走对象存储服务的带宽，不会占用Cloudreve服务器的带宽，非常适合大文件分发、下载站这类高流量场景，可以大幅降低服务器的带宽成本。

4. 可以同时接入多个不同的S3兼容存储源吗？

可以，Cloudreve支持同时添加多个不同的S3存储策略，你可以给不同的用户组分配不同的存储策略，也可以让用户自行选择上传的存储位置，满足多存储节点的业务需求。

八、总结

整体来看，Cloudreve接入S3兼容第三方存储源的流程非常简单，只需要提前准备好对应的S3配置参数，在后台填写测试后即可上线使用，不需要任何代码修改，普通站长和开发者都可以快速完成操作。这种接入方式适合需要降低Cloudreve服务器存储压力、节省服务器带宽成本、需要高可用存储和大文件分发的场景，不管是搭建个人网盘、团队协作存储、公共资源下载站还是图床服务，都可以通过接入S3兼容存储大幅提升服务的稳定性和承载能力。