Cloudreve存储桶怎么配置S3兼容存储

一、结论

配置Cloudreve的S3兼容存储，通常需要先准备好S3存储服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心参数，然后在Cloudreve后台的存储策略中选择S3兼容类型，填入对应参数并测试连通性，确认无误后即可投入使用。整个过程不需要修改代码，普通站长和开发者都能快速完成配置。

二、准备工作

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

• 已完成部署、可以正常访问的Cloudreve站点，以及站点的管理员权限账号
• 已开通的S3兼容存储服务账号
• 在S3存储服务中提前创建好的存储桶（Bucket）
• S3存储服务商提供的Endpoint访问地址
• S3存储服务生成的AccessKey（访问密钥ID）和SecretKey（访问密钥字符串）
• 存储桶对应区域的Region代码
• 2-3个小于10MB的测试文件，用于后续验证上传、下载功能

三、操作步骤

每一步操作完成后确认状态正常再进入下一个环节，避免后续排查问题耗时：

1. 进入Cloudreve存储策略管理页

使用管理员账号登录Cloudreve后台，点击左侧菜单栏的「存储策略」选项，进入存储策略列表页面，点击右上角的「添加存储策略」按钮，弹出存储类型选择窗口。

2. 选择S3兼容存储类型

在弹出的存储类型列表中找到「S3兼容」选项并点击选中，系统会自动跳转至S3存储的参数配置页面。

3. 填写S3存储核心配置参数

按照页面提示依次填入提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region参数，同时可以根据业务需要自定义配置存储路径规则、单个文件大小上限、直链签名有效期等可选配置项。

4. 配置访问相关参数

如果已经给存储桶绑定了自定义域名或者CDN加速域名，在访问域名栏填入对应的域名，同时根据实际情况选择是否开启HTTPS访问、是否强制文件签名访问等选项。

5. 测试连接并保存配置

所有必填参数填写完成后，点击页面下方的「测试连接」按钮，系统会自动尝试和S3存储服务建立连接，如果提示连接成功，直接点击「保存」按钮即可完成存储策略的创建。如果提示连接失败，按照报错提示核对对应参数是否正确。

6. 绑定用户组并测试功能

回到存储策略列表，将刚创建的S3存储策略绑定到对应的用户组（比如普通用户组、VIP用户组），然后切换普通用户账号登录Cloudreve前台，上传提前准备好的测试文件，确认文件可以正常上传、在线预览、下载，没有报错即可。

7. 设置默认存储策略（可选）

如果需要将这个S3存储作为全站的默认存储，回到存储策略列表，找到刚创建的策略，点击「设为默认」即可，后续所有用户上传的文件都会自动存储到对应的S3存储桶中。

四、常见错误

配置过程中大概率会遇到以下问题，可以对应排查解决：

• Endpoint填写错误：最常见的错误是漏写http/https前缀，或者误填了存储服务的控制台管理地址而非存储访问地址，解决方法是直接到S3存储服务商的官方文档中复制对应区域的官方Endpoint，不要手动输入。
• AccessKey或SecretKey错误：复制密钥时前后多了空格、使用了已经过期或者被删除的密钥都会导致连接失败，解决方法是重新生成一对新的AccessKey和SecretKey，复制时确认没有多余空格，同时确认密钥被分配了S3存储的读写权限。
• Bucket名称不匹配：填写的Bucket名称和实际创建的名称大小写不一致、多了特殊字符都会提示存储桶不存在，解决方法是直接复制存储桶的准确名称，确保大小写、特殊字符完全匹配。
• Region填写不匹配：不同服务商的Region命名规则不同，比如有的用拼音缩写、有的用英文缩写，填错会导致连接失败，解决方法是到服务商文档查找对应存储桶所在区域的官方Region代码，准确填入。
• 上传成功但无法访问文件：多半是访问域名配置错误、CDN未生效或者存储桶跨域配置缺失导致前端访问报错，解决方法是检查域名解析是否正常，配置对应的CORS跨域规则，等待CDN生效后再测试。

五、示例说明

以下是通用的配置字段说明，不需要填写虚构的地址或密钥，按照实际获取到的信息对应填入即可：

| 配置字段 | 填写说明 |

| --- | --- |

| 存储策略名称 | 自定义即可，比如「公有云S3存储」「备份存储桶」 |

| Endpoint | 填写S3存储服务商提供的对应存储桶所在区域的官方访问地址 |

| AccessKey | 填写你在S3存储服务控制台生成的访问密钥ID |

| SecretKey | 填写和AccessKey配对的密钥字符串 |

| Bucket | 填写提前创建好的存储桶的准确名称 |

| Region | 填写对应存储桶所在区域的官方Region代码 |

| 访问域名 | 填写绑定到存储桶的自定义域名或服务商提供的默认访问域名 |

| 路径规则 | 按需求自定义，比如{year}/{month}/{day}/{filename}即可实现按日期分类存储 |

| 最大文件大小 | 根据业务需求设置，比如填10GB就代表单个文件最大允许上传10GB |

六、更简单的方案

如果不想自己搭建MinIO等自建S3存储，也不想花时间维护服务器、扩容存储容量、处理带宽峰值问题，可以直接选择商用的S3兼容云对象存储服务，不用自己运维，按需付费成本更低。如果你需要一个兼容S3协议、适合网盘系统存储源、文件下载分发、图床等场景的对象存储服务，可以了解七彩云对象存储，它支持直接作为Cloudreve的存储源使用，接入流程和上面的教程完全一致，不需要额外调整配置。

七、FAQ

Q1：Cloudreve配置S3存储后，原来上传到本地存储的文件会自动迁移吗？

不会，原有存储策略里的文件还会保留在原来的存储位置，新上传的文件才会存到新配置的S3存储里，如果需要迁移旧文件，可以使用Cloudreve自带的存储迁移工具，或者手动导出导入文件。

Q2：配置S3存储的时候必须填写Region吗？

大部分主流S3兼容存储服务都要求填写Region，部分小众存储服务如果没有Region的概念，可以按照Cloudreve的提示填默认值或者留空，具体要求可以参考对应存储服务商的接入文档。

Q3：Cloudreve的直链功能可以用S3存储的直链吗？

可以，只要你在配置存储策略的时候开启了直链功能，并且S3存储桶的权限设置允许公共读或者配置了签名访问，就可以正常生成和使用直链，适合做文件分发、资源下载等场景。

Q4：配置S3存储后上传速度慢怎么办？

可以先检查Cloudreve服务器和S3存储节点之间的网络连通性，如果是跨区域部署的可以选择和Cloudreve服务器同区域的存储节点，也可以给存储桶配置CDN加速，提升用户访问和上传的速度。

八、总结

Cloudreve配置S3兼容存储的整体流程非常简单，核心就是提前准备好S3存储的5个核心参数，在Cloudreve后台的存储策略页面对应填入，测试连通性之后就能正常使用。这种配置方式适合需要扩容Cloudreve存储容量、降低本地服务器存储成本、需要承接大流量文件分发的站长和开发者，不管是个人使用的私人网盘，还是面向用户的公共资源存储站、下载站，都可以通过接入S3兼容存储的方式，提升网盘的稳定性和承载能力。