Cloudreve存储桶怎么正确配置

一、结论

Cloudreve配置S3兼容存储桶的核心操作思路是先获取对应对象存储服务的S3接入参数，再在Cloudreve后台的存储策略模块选择S3兼容类型，填写参数并完成连通性测试即可正常使用。配置过程通常需要提前准备Endpoint、AccessKey、SecretKey、Bucket、Region五类核心信息，全程操作无需修改代码，仅需在可视化后台完成配置。

二、准备工作

操作前需要提前准备以下内容，避免配置过程中出现信息遗漏：

• 已开通且处于正常状态的对象存储服务账号
• 提前创建完成、权限配置符合业务需求的存储桶Bucket
• 对象存储服务官方提供的S3接入Endpoint地址
• 具备对应存储桶读写权限的AccessKey和配对的SecretKey
• 存储桶所属的Region区域标识
• 已部署完成、拥有管理员权限的Cloudreve站点
• 1-2个大小适中的测试用文件（如图片、文档等）

三、操作步骤

1. 登录所用对象存储服务的控制台，进入存储桶配置页面，确认存储桶的访问权限、跨域规则等配置符合业务需求，如需公开分享文件建议提前开启公共读权限，结果是存储桶处于正常可访问状态，无权限或状态异常提示。

2. 在对象存储控制台的密钥管理页面，获取具备目标存储桶读写权限的AccessKey和SecretKey，同时记录Endpoint、Region、存储桶名称等所有S3接入相关信息，结果是五类核心配置参数全部收集完成，无遗漏项。

3. 登录Cloudreve的管理员后台，在左侧菜单栏找到「存储策略」选项，点击「添加存储策略」按钮，在弹出的存储类型选择列表中点击「S3兼容存储」，结果是进入S3存储策略的专属配置页面。

4. 按照页面提示的必填项，依次填写提前收集的Endpoint、AccessKey、SecretKey、Bucket名称、Region字段，可根据业务需求额外配置存储路径前缀、单文件大小限制、私有外链有效期等可选参数，结果是所有必填配置项填写完成，无空项或格式错误提示。

5. 点击页面底部的「测试连接」按钮，等待Cloudreve系统自动验证配置参数的正确性，结果是页面弹出连接成功的提示，证明所有参数填写无误、存储桶可以正常连通。

6. 点击保存按钮完成存储策略创建，回到Cloudreve前台用户页面，选择对应存储路径上传提前准备好的测试文件，依次尝试文件预览、下载、生成分享链接等操作，结果是文件全流程操作正常，无报错或无法访问的情况。

7. 如需将该存储策略设置为用户默认存储，可回到存储策略管理页面，将该策略设置为新用户默认分配策略，结果是后续新注册用户的默认存储空间将自动使用该S3存储桶的资源。

四、常见错误

配置过程中容易出现以下几类问题，可对应排查解决：

• Endpoint填写错误：常见错误包括手动输入时多写了空格或后缀、误将存储桶访问域名填为Endpoint，解决建议是直接从对象存储服务的S3接入文档中复制官方提供的Endpoint地址，避免手动输入。
• AccessKey或SecretKey填错：包括复制时多带了空格、密钥已经过期或被禁用，解决建议是检查密钥前后是否有多余空白字符，确认密钥处于启用状态且未过期，必要时重新生成新的读写权限密钥。
• Bucket名称不匹配：填写了错误的存储桶名称、存储桶已被删除或跨账号调用，解决建议是核对对象存储控制台的存储桶名称，确认桶处于正常运行状态且当前密钥具备该桶的访问权限。
• Region填写不匹配：填错了存储桶所属的区域标识，或者部分无区域区分的服务多填了Region参数，解决建议是参考对象存储服务的官方区域说明填写对应代码，无区域要求的服务可留空或填写官方给出的默认值。
• 权限不足导致上传失败：使用的AccessKey仅具备读权限没有写权限、存储桶未开放对应读写权限，解决建议是检查密钥的权限范围，确认存储桶的访问策略已经放开对应操作权限，公开访问的文件需要开启公共读权限。
• 上传成功但访问链接不可用：存储桶未配置跨域CORS规则、加速域名未完成解析或备案，解决建议是在对象存储控制台配置跨域规则，允许Cloudreve站点域名的访问请求，确认自定义域名已经完成备案和解析配置。

五、示例说明

以下为Cloudreve S3存储策略的通用配置示例，所有字段需替换为自身使用的对象存储服务的真实信息：

• Endpoint：填写所用对象存储服务官方提供的S3接入地址，无需拼接存储桶名称前缀
• AccessKey：填写对象存储服务生成的、具备对应存储桶读写权限的访问密钥ID
• SecretKey：填写与上述AccessKey配对的访问密钥Secret
• Bucket：填写提前创建好的存储桶的准确名称，注意大小写一致
• Region：填写存储桶所属区域的官方标识，无区域区分的服务可填写默认值
• 存储路径前缀：可自定义填写，例如cloudreve/userfiles/，所有上传的文件都会存储到该路径下，避免与其他业务的文件混淆
• 外链有效期：私有存储桶可设置外链的有效时长（单位为秒），公开存储桶可设置为0即永久有效

六、更简单的方案

如果不想自行搭建MinIO等自建对象存储服务，也不想承担服务器存储的磁盘扩容、数据备份、带宽成本等运维压力，可以直接选择成熟的兼容S3协议的云对象存储服务，无需自行维护底层资源，配置逻辑和通用S3服务完全一致，无需额外适配。如果你需要一个兼容S3协议、适合网盘系统存储源、文件下载分发、图床存储的对象存储服务，可以了解 七彩云对象存储。

七、FAQ

1. Cloudreve配置S3存储后，上传的文件会占用Cloudreve服务器的存储空间吗？

不会，配置S3兼容存储后，所有用户上传的文件会直接上传到对应的对象存储桶中，Cloudreve仅承担文件管理、权限校验、链接调度的功能，不会占用自身服务器的存储资源。

2. 同一个Cloudreve后台可以配置多个不同的S3存储桶吗？

可以，Cloudreve支持添加多个不同的存储策略，每个策略可以对应不同的存储桶，甚至可以对接不同的对象存储服务商，你可以根据用户组、文件类型、业务场景分配不同的存储策略，灵活调整存储成本。

3. 私有存储桶配置完成后，分享的链接会泄露对象存储的源站信息吗？

不会，Cloudreve会对私有存储桶的访问链接做签名代理，用户看到的分享链接是Cloudreve的站点域名地址，不会直接暴露对象存储的源站域名、密钥等敏感信息，安全性更高。

4. 测试连接时提示“证书错误”是什么原因？

通常是因为填写的Endpoint是HTTP格式但服务仅支持HTTPS访问，或者使用了自签名SSL证书不被Cloudreve服务器信任，建议直接更换为对象存储服务官方提供的HTTPS格式的Endpoint地址即可解决。

八、总结

Cloudreve配置S3兼容存储桶的整体操作流程门槛较低，无需代码基础即可完成，核心是提前确认所有S3接入参数的准确性，完成配置后做好全流程的功能测试即可正式投入使用。这种配置方式适合需要大规模存储文件、降低自身服务器存储和带宽成本的个人站长、开发者和小型团队使用，除Cloudreve之外，这套S3配置逻辑也同样适用于Alist、PicGo、WordPress等其他支持S3协议的程序接入，通用性较强。