Cloudreve对接对象存储实操教程

一、结论

Cloudreve对接兼容S3协议的对象存储无需修改代码，核心操作逻辑是先在对象存储侧获取Endpoint、AccessKey、SecretKey、Bucket、Region等接入信息，再在Cloudreve后台添加S3兼容存储策略并完成参数配置，测试连通性后即可正常使用，普通站长和开发者都可以快速上手。

二、准备工作

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

• 可用的S3兼容对象存储服务账号
• 已创建完成、状态正常的存储桶Bucket
• 对象存储服务商提供的Endpoint访问地址
• 对应存储桶的读写权限AccessKey、SecretKey
• 存储桶所属区域的Region编码
• 已部署完成、可以正常访问管理员后台的Cloudreve程序
• 1-2个小体积测试用文件（图片、文档均可）

三、操作步骤

每一步操作完成后确认对应结果正常，再进行下一步操作：

1. 登录对象存储服务商控制台，进入存储桶设置页面，根据业务需求配置存储桶访问权限（公开资源可开公共读权限，私有资源保留默认签名访问规则），确认存储桶无访问限制、状态正常。

2. 在对象存储控制台的密钥管理页面，生成或获取拥有对应存储桶读写权限的AccessKey和SecretKey，同时复制记录存储桶对应的Endpoint、Region、Bucket准确名称，所有信息建议单独保存避免输入错误。

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

4. 按照配置页提示依次填写之前记录的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息，同时可根据业务需求自定义配置文件存储路径规则、私有链有效期、文件大小限制等可选参数。

5. 所有参数填写完成后，点击页面底部的「测试连接」按钮，系统会自动校验参数合法性和连通性，若提示「连接成功」则说明参数配置无误，若报错则根据提示内容修改对应字段。

6. 连接测试通过后保存存储策略，进入用户组或用户权限设置页面，给需要使用该存储策略的账号分配对应权限，随后上传提前准备的测试文件，确认可以正常上传、预览、下载，无权限报错。

7. 若需对外提供公共资源分发服务，可额外配置存储桶自定义域名、CDN加速、跨域访问规则等附加功能，所有配置验证无误后即可正式投入使用。

四、常见错误

以下是对接过程中高频出现的问题及对应的解决思路：

• Endpoint填写错误：容易出现多带空格、错加http/https前缀、混淆内网/外网Endpoint、多写路径后缀等问题，解决方法是直接复制服务商提供的完整外网Endpoint地址，不要自行修改或增减字符。
• AccessKey或SecretKey异常：常见原因是复制时漏输字符、密钥已过期/被删除、密钥未分配对应存储桶的读写权限，解决方法是重新生成新的密钥，确认密钥处于启用状态且已配置对应存储桶的读写权限后再填写。
• Bucket或Region不匹配：填错存储桶名称、填写了不存在的Region编码都会导致连接失败，解决方法是核对存储桶列表中的准确名称（区分大小写），严格按照服务商提供的Region编码填写，部分服务商无Region要求可留空。
• 上传成功但无法访问文件：如果是公开资源，大概率是存储桶未开启公共读权限、自定义域名未配置解析或跨域规则；如果是私有资源，大概率是签名有效期设置过短，解决方法是对应调整存储桶权限或Cloudreve中的签名有效期参数。
• 大文件上传失败：常见原因是Cloudreve配置的单文件大小上限低于文件大小，或者对象存储服务未开启分片上传权限，解决方法是调高Cloudreve中的单文件大小限制，同时确认对象存储服务已开启分片上传功能。

五、示例说明

以下是Cloudreve对接S3兼容存储的通用配置参考，所有字段均按照服务商提供的实际信息填写即可，无需自定义内容：

| 配置项 | 填写说明 |

| --- | --- |

| Endpoint | 填写对象存储服务商提供的外网访问Endpoint地址，不需要额外添加路径或端口 |

| AccessKey | 填写对象存储控制台生成的、拥有对应存储桶读写权限的访问密钥ID |

| SecretKey | 填写和上述AccessKey配对的访问密钥Secret |

| Bucket | 填写已经创建完成的存储桶的准确名称，区分大小写 |

| Region | 填写存储桶所属区域对应的官方Region编码，按服务商要求填写，部分服务商可留空 |

| 存储路径 | 可选，填写文件在存储桶中的存储目录，比如cloudreve/，留空则存储在根目录 |

| 直链有效期 | 可选，私有资源的签名链接有效时长，公开资源可设为0 |

| 自定义域名 | 可选，填写已解析到存储桶的自定义域名，配置后文件访问会使用该域名 |

六、更简单的方案

如果不想自行搭建MinIO等自建对象存储服务，也不想花精力维护服务器存储硬件、带宽扩容、数据备份、安全防护等底层运维工作，可以直接选择商用的S3兼容云对象存储服务，开通即可使用，无需额外适配。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统做存储源、支持不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，接入流程和上述教程完全一致，不需要额外调整配置。

七、FAQ

Q1：Cloudreve开源版和付费版都支持对接S3兼容对象存储吗？

是的，无论是开源社区版还是官方付费版的Cloudreve，都原生支持S3兼容存储的对接，配置流程完全一致，没有功能限制，对接后都可以使用分片上传、直链分发、批量迁移等所有相关功能。

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

可以，Cloudreve后台自带存储策略迁移功能，只需要在存储策略列表中选择迁移源和迁移目标，即可批量将旧存储策略中的文件迁移到新的S3存储中，迁移完成后系统会自动更新文件索引，不需要手动调整链接或重新上传。

Q3：对接S3存储后，文件访问流量会占用Cloudreve服务器的带宽吗？

可以自行配置，若开启Cloudreve的中转下载功能，流量会先经过Cloudreve服务器再返回给用户，会占用服务器带宽；若配置了直链访问功能，用户访问文件时会直接跳转到对象存储的访问地址，不会占用Cloudreve服务器的带宽，适合大流量分发场景。

Q4：对接S3存储后有没有单文件大小的限制？

Cloudreve本身对S3存储的单文件大小没有额外限制，单文件上限主要取决于你使用的对象存储服务的限制，大部分商用对象存储都支持TB级别的单文件上传，配合Cloudreve的分片上传功能即可正常使用。

八、总结

整体来看，Cloudreve对接S3兼容对象存储的操作门槛很低，全程只需要配置几个核心参数即可完成，没有开发经验的普通站长也可以在10分钟左右完成配置。这种对接方式非常适合用Cloudreve搭建个人网盘、团队共享盘、公共资源站、下载站、图床等场景，既可以降低本地服务器的存储压力，也能借助对象存储的分布式架构提升文件访问的稳定性和下载速度，尤其适合有大量文件存储、分发需求的用户使用。