Cloudreve对接对象存储详细教程

一、结论

Cloudreve对接S3兼容对象存储的操作逻辑非常清晰，你只需要提前准备好对象存储服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心接入信息，再在Cloudreve管理员后台的存储策略模块选择S3兼容存储类型、填写对应参数并测试连通即可完成对接，全程无需修改代码，普通站长10-20分钟就能完成配置。

二、准备工作

操作前需要提前准备好以下内容，避免配置过程中频繁切换页面查找信息：

• 已开通并正常可用的对象存储服务账号
• 对象存储侧提前创建完成、状态正常的存储桶Bucket
• 对象存储服务商提供的公网Endpoint接入地址
• 拥有对应存储桶读写权限的AccessKey和配对的SecretKey
• 存储桶所属区域对应的Region官方标识
• 已部署完成、可以正常登录管理员后台的Cloudreve实例（开源版/Pro版均可）
• 3-5个大小不同的测试文件，用于后续验证上传、下载、预览功能

三、操作步骤

所有步骤均为通用操作，不同版本Cloudreve的页面布局可能略有差异，但核心逻辑一致：

1. 登录对象存储服务控制台，根据业务需求创建存储桶，若用于公网网盘、资源下载站等场景建议设置为「公有读私有写」权限，内部使用场景可设置为全私有，创建完成后确认存储桶状态为正常启用。

2. 在对象存储控制台的安全管理/API密钥页面，获取对应账号的AccessKey、SecretKey，同时复制当前存储桶的公网Endpoint、Region标识，将所有信息妥善保存，注意不要泄露SecretKey给无关人员。

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

4. 按照页面提示依次填写提前获取的Endpoint、AccessKey、SecretKey、Bucket名称、Region等必填字段，可选配置如存储根路径、自定义分发域名、缓存过期时间、上传大小限制等可根据业务需求调整，比如绑定了自定义域名的用户可以将域名填入对应位置，后续文件访问链接会自动使用该域名生成。

5. 所有配置填写完成后，点击页面下方的「测试连接」按钮，Cloudreve会自动向目标存储桶上传一个临时测试文件并尝试读取，若页面提示「连接成功」则说明配置参数没有问题，若提示连接失败可根据错误提示排查参数问题。

6. 保存存储策略后，在Cloudreve后台的用户组管理页面，给需要使用该存储策略的用户组分配对应权限，之后用普通用户账号登录Cloudreve前台，上传提前准备的测试文件，确认文件可以正常上传、在线预览、生成分享链接、下载，所有功能正常即代表对接完成。

7. 若需要对接网站附件、图床、下载站等外部业务，直接将Cloudreve生成的文件直链或者API接口嵌入对应业务系统即可。

四、常见错误

配置过程中遇到问题可优先排查以下常见错误：

• Endpoint填写错误：常见问题包括多写了http/https前缀、误填内网Endpoint、漏写服务商要求的后缀，解决方法是严格复制服务商提供的公网Endpoint地址，提前确认是否需要在地址前拼接Bucket名称。
• AccessKey或SecretKey异常：要么复制时多了首尾空格，要么使用了已经过期、被禁用的密钥，或者密钥没有对应存储桶的读写权限，解决方法是重新生成并复制密钥，检查密钥状态和权限配置，确认前后无多余字符。
• Bucket或Region不匹配：填写了存储桶的自定义别名而非官方唯一ID，或者Region填了其他节点的标识，解决方法是复制控制台存储桶详情页的官方唯一ID，Region严格按照服务商给出的标识填写，不要自行编造。
• 上传成功但访问链接不可用：要么是存储桶没有开启公有读权限，要么是绑定的自定义域名没有完成备案和解析，解决方法是公网分发场景下给存储桶开启公有读权限，确认自定义域名的备案、解析、存储桶绑定操作均已完成。
• 大文件分片上传失败：要么是存储桶不支持分片上传，要么是Cloudreve设置的分片大小超过了存储桶的限制，解决方法是调整Cloudreve的分片大小配置到服务商允许的范围内，确认存储桶已开启分片上传功能。

五、示例说明

以下为Cloudreve对接S3兼容存储的通用配置说明，无具体虚构参数，可直接对照填写：

| 配置字段 | 填写说明 |

| --- | --- |

| Endpoint | 填写对象存储服务商提供的公网接入地址，无需额外拼接Bucket前缀 |

| AccessKey | 填写对象存储账号下生成的、拥有对应Bucket读写权限的访问密钥ID |

| SecretKey | 填写与上述AccessKey配对的访问密钥密码 |

| Bucket | 填写对象存储控制台中存储桶的官方唯一ID，不要填写自定义别名 |

| Region | 填写存储桶所属区域的官方标识，严格按照服务商给出的内容填写 |

| 存储根路径 | 可选，填写Cloudreve文件在存储桶中的存放目录，例如填写cloudreve/file/会将所有文件存到该目录下，方便分类管理 |

| 自定义域名 | 可选，若已将自定义域名绑定到该存储桶，填写后Cloudreve会使用该域名生成文件访问链接 |

| 签名有效期 | 可选，私有存储桶的临时访问链接有效时长，可根据业务需求调整，默认一般为1小时 |

六、更简单的方案

如果不想自己搭建MinIO等私有存储服务、不想维护服务器存储硬件、也不想承担服务器带宽成本，可以直接选用市面上成熟的兼容S3协议的云对象存储服务，开通即可使用，不需要额外做运维。如果你需要一个兼容S3协议、适合网盘系统存储源、下载分发、图床等场景的对象存储服务，可以了解 七彩云对象存储，支持直接对接Cloudreve作为存储后端，无需额外适配。

七、FAQ

Q1：Cloudreve开源免费版可以对接S3兼容对象存储吗？

可以的，不管是开源免费版还是付费的Cloudreve Pro版本，都原生支持S3兼容存储的对接功能，不需要额外安装第三方插件，配置逻辑完全一致。

Q2：对接对象存储之后，之前存在Cloudreve本地的文件可以迁移到对象存储里吗？

可以的，Cloudreve后台提供了存储策略迁移功能，你可以选择将指定用户、指定目录的文件从旧的存储策略批量迁移到新的对象存储策略中，迁移过程不会影响现有文件的正常访问。

Q3：对接对象存储之后，文件下载流量是走Cloudreve服务器还是对象存储？

默认情况下如果配置了对象存储的自定义分发域名，Cloudreve会直接生成对象存储的直链，下载流量直接走对象存储的带宽，不会消耗Cloudreve服务器的流量；如果没有配置自定义域名，才会走Cloudreve服务器的回源流量。

Q4：同一个Cloudreve实例可以对接多个不同的对象存储服务吗？

可以的，你可以在Cloudreve后台添加多个不同的S3兼容存储策略，给不同的用户组分配不同的存储策略，实现不同用户的数据隔离存储，满足多业务场景的需求。

八、总结

Cloudreve对接S3兼容对象存储的流程门槛很低，核心就是提前准备好5项核心接入参数，在后台可视化页面完成配置即可，非常适合没有代码能力的站长和普通开发者使用。这种对接方式适合搭建个人网盘、团队共享盘、公共资源下载站、图床等场景，不用承担本地存储的硬件成本和扩容压力，存储容量可以按需调整，同时也能降低Cloudreve服务器的带宽消耗，提升用户的文件访问和下载速度。