Cloudreve怎么配置接入公有云对象存储

一、结论

Cloudreve配置接入公有云对象存储的核心逻辑是先在公有云对象存储侧获取S3兼容的接入凭证，再在Cloudreve管理后台选择S3兼容存储策略填写对应参数，测试连通后即可完成配置，全程无需修改代码，普通站长和开发者都可以快速操作。通常配置需要提前准备Endpoint、AccessKey、SecretKey、Bucket、Region五类核心信息，所有参数均可从对象存储服务控制台直接获取。

二、准备工作

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

• 可正常使用的公有云对象存储服务账号
• 已经创建完成、权限配置符合业务需求的存储桶Bucket
• 对应存储桶的Endpoint访问地址
• 拥有目标存储桶读写权限的AccessKey和SecretKey密钥对
• 存储桶所属区域的Region标识
• 已经部署完成、可正常登录管理员后台的Cloudreve程序
• 1个小于10MB的测试文件，用于验证配置后的上传下载功能是否正常

三、操作步骤

每一步操作完成后确认对应结果正常再进入下一步，可大幅降低配置出错概率：

1. 登录公有云对象存储控制台，确认目标存储桶的访问权限符合业务需求，比如公开读权限适合做公共资源存储、私有读写适合做私有网盘存储，操作完成后可在存储桶列表看到目标Bucket处于正常运行状态。

2. 在对象存储控制台的存储桶配置页或密钥管理页，复制获取该Bucket对应的Endpoint、Region信息，同时创建专门用于Cloudreve接入的AccessKey密钥对，操作完成后将五类核心参数统一整理到记事本备用，避免复制时遗漏字符。

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

4. 按照配置页提示依次填写提前整理好的Bucket、Endpoint、Region、AccessKey、SecretKey参数，同时可根据业务需求自定义配置存储路径规则、单文件大小上限、直链有效期、文件类型限制等可选参数，操作完成后检查所有必填项无空白、无多余空格即可进入下一步。

5. 点击配置页底部的「测试连接」按钮，等待Cloudreve系统主动发起对对象存储服务的连接测试，操作完成后如果页面提示连接成功即可进入下一步，如果提示连接失败需要回到参数页核对信息是否填写正确。

6. 连接测试通过后点击保存存储策略，再进入用户组管理页面，将该存储策略分配给需要使用的用户组或单个用户，操作完成后对应用户在Cloudreve前台上传文件时即可选择该存储策略。

7. 切换到普通用户账号登录Cloudreve前台，上传提前准备好的测试文件，上传成功后尝试在线预览、下载、分享该文件，确认所有功能正常可用即完成全部配置流程。

四、常见错误

以下是配置过程中出现概率最高的几类问题，遇到对应情况可直接参照解决：

• Endpoint填写错误：常见问题是漏写http/https前缀、填成了对象存储控制台的管理地址而非存储桶的用户访问地址，解决建议是直接从存储桶的配置信息页复制官方提供的Endpoint地址，不要手动输入。
• 密钥填写错误：包括AccessKey或SecretKey复制时带了多余空格、使用了已经过期或被禁用的密钥、密钥没有配置目标存储桶的读写权限，解决建议是复制密钥后先粘贴到记事本检查是否完整，同时确认密钥的权限范围包含目标Bucket的读写操作。
• Bucket或Region不匹配：填写的Bucket名称和实际创建的名称大小写不符、Region填写的内容和存储桶所属区域不一致，部分S3服务对这两个参数的匹配要求非常严格，解决建议是直接从存储桶基本信息页复制准确的名称和Region标识。
• 权限不足导致上传失败：包括存储桶设置了禁止公网写入、Cloudreve后台配置的单文件大小超出了存储桶的单文件上限、存储桶的存储空间已经耗尽，解决建议是先在对象存储控制台直接上传测试文件确认存储桶本身可正常读写，再核对权限和容量配置。
• 上传成功但访问链接不可用：通常是存储桶设置为私有访问但没有配置签名逻辑、绑定的自定义域名没有完成备案导致公网访问被拦截，解决建议是如果需要公开访问可先将存储桶设置为公共读，同时确认绑定的域名已经完成备案和解析。

五、示例说明

以下是Cloudreve S3兼容存储配置的通用填写示例，所有参数均需替换为你使用的对象存储服务提供的真实信息，不要直接照搬：

• Endpoint：填写对象存储服务为该存储桶提供的专属访问地址，需带http/https前缀
• AccessKey：填写你在对象存储服务侧创建的拥有该Bucket读写权限的访问密钥ID
• SecretKey：填写和上述AccessKey配对的访问密钥字符串
• Bucket：填写你提前创建的目标存储桶的准确名称
• Region：填写该存储桶所属区域的官方标识，部分服务如果无强制要求可留空或填写默认值
• 存储路径：可填写自定义路径前缀，比如cloudreve/userfiles/，也可留空直接存储在存储桶根目录
• 直链有效期：私有存储桶可设置直链的有效时长，公开存储桶可设置为永久有效
• 签名模式：大部分服务默认使用V2签名即可，部分新上线的S3兼容服务需要勾选V4签名选项

六、更简单的方案

如果不想自己搭建MinIO等私有存储服务、不想承担服务器存储硬件和带宽的运维成本，也不想使用流量阶梯收费较高的传统公有云存储，可以直接选择已经做好S3协议全兼容的第三方对象存储服务，省去大量运维和成本核算的工作量。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统作为存储源、支持不限流量下载分发的对象存储服务，可以了解七彩云对象存储，它的接入参数获取流程简单，不需要复杂的权限配置，新手也能快速完成Cloudreve的对接。

七、FAQ

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

可以，Cloudreve后台自带存储策略迁移工具，你可以在存储策略管理页选择将已有文件从本地存储批量迁移到新配置的S3存储策略中，迁移过程采用异步执行方式，不会影响现有文件的正常访问。

2. 配置的时候提示「签名不匹配」是什么原因？

签名不匹配通常是四类原因导致的：一是Endpoint、Region、Bucket三个参数不匹配，二是AccessKey或SecretKey填写错误，三是Cloudreve所在服务器的系统时间和标准时间差超过15分钟导致签名过期，四是部分S3服务要求使用V4签名，你可以在Cloudreve的S3配置页勾选「使用V4签名」选项再重试。

3. Cloudreve可以同时接入多个不同的对象存储服务吗？

可以，你可以在Cloudreve后台创建多个不同的S3存储策略，分别对应不同的对象存储服务，再给不同的用户组分配不同的存储策略，实现不同用户的文件存储到不同的存储服务中，满足多业务线的差异化存储需求。

4. 接入对象存储后，文件的下载速度是由Cloudreve服务器决定还是对象存储服务决定？

如果开启了Cloudreve的中转下载模式，文件会先经过Cloudreve服务器再返回给用户，速度会受Cloudreve服务器的带宽限制；如果开启了直链下载模式，文件会直接从对象存储服务返回给用户，速度由对象存储服务的带宽决定，不会占用Cloudreve服务器的带宽资源。

八、总结

整体来看，Cloudreve接入公有云对象存储的流程非常清晰，只需要提前准备好S3兼容的接入参数，按照步骤填写配置并测试即可完成，全程不需要修改代码，新手站长也能在10分钟内完成全部配置。这种接入方式适合需要扩展Cloudreve存储容量、降低本地服务器带宽成本、提升大文件下载分发速度的场景，不管是搭建个人私有网盘、团队共享盘还是公开资源站、下载站都可以完美适配。