Cloudreve不限流量存储配置教程

一、结论

给Cloudreve配置不限流量的S3兼容存储，核心是先准备好符合要求的S3对象存储接入凭证，包括Endpoint、AccessKey、SecretKey、Bucket、Region等信息，再在Cloudreve后台的存储源设置中填写对应参数、测试连通后即可启用，全程不需要修改Cloudreve核心代码，普通站长10分钟左右即可完成配置。

二、准备工作

操作前需要提前准备好以下内容：

• 开通支持不限流量下载的S3兼容对象存储服务账号
• 提前在对象存储服务中创建好专属存储桶Bucket
• 存储服务官方提供的Endpoint访问地址
• 拥有目标存储桶读写权限的AccessKey访问密钥
• 与AccessKey对应的SecretKey秘密密钥
• 存储桶所属区域对应的Region代码
• 已搭建完成、可正常访问的Cloudreve站点（建议使用v3及以上支持S3存储源的版本）
• Cloudreve站点的管理员账号权限
• 至少1个小体积测试文件（如1MB以内的图片、文档），用于验证上传下载功能

三、操作步骤

1. 登录所用对象存储服务的控制台，创建专属存储桶，存储桶的访问权限可根据Cloudreve用途设置：如果用于公开资源分享可设置为公共读，如果用于私有网盘可设置为私有，创建完成后确认存储桶状态为正常可用。

2. 在对象存储控制台的访问密钥管理页面，创建专属的AccessKey密钥对，优先使用仅拥有目标存储桶读写权限的子账号密钥，不要使用主账号全权限密钥，获取后妥善保存不要对外泄露。

3. 登录Cloudreve站点的管理员后台，找到「存储策略」或「存储源」管理菜单，点击添加新存储源，在存储类型列表中选择「S3 兼容存储」选项，进入参数配置页面。

4. 按照页面提示依次填写提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region区域信息，其余可选配置如存储路径前缀、自定义域名、CDN加速地址等可根据业务需求选填，下载流量配额项如果不需要限制用户下载流量可直接留空。

5. 所有参数填写完成后，点击页面下方的「测试连接」按钮，等待系统返回连接成功的提示，如果提示连接失败先排查参数填写问题，不要直接保存配置。

6. 连接测试通过后，保存该存储策略，可根据业务需求将其设置为全站用户默认存储策略，或者分配给指定用户组使用，后台配置部分完成。

7. 切换至普通用户账号登录Cloudreve前台，上传提前准备好的测试文件，上传成功后生成分享链接，使用无痕模式访问链接测试下载速度和可用性，确认下载正常且不会产生额外流量费用即配置完成。

四、常见错误

1. Endpoint填写错误：很多用户容易把存储服务的控制台管理地址当成Endpoint，或者漏掉http/https前缀，导致连接失败。解决方法是直接复制对象存储服务商提供的官方Endpoint地址，不要手动输入，同时确认前缀和服务商要求一致。

2. AccessKey或SecretKey填错：复制时多带了空格、使用了已经过期的密钥，都会导致鉴权失败。解决方法是重新生成新的密钥对，复制时注意不要包含多余字符，同时确认密钥的有效期和权限范围包含目标存储桶。

3. Bucket名称不一致：填写的存储桶名称和控制台创建的名称大小写不一致，或者多打了多余后缀，导致找不到存储桶。解决方法是直接从控制台复制存储桶名称，注意S3协议的存储桶名称为大小写敏感。

4. Region填写不匹配：多数S3兼容服务如果Region代码填错会直接返回连接失败。解决方法是确认存储桶所属区域对应的Region代码，按照服务商提供的示例填写，无特殊要求的场景也可以尝试填写auto。

5. 权限不足导致上传失败：子账号密钥没有分配存储桶的读写权限，或者存储桶设置了防盗链拦截了Cloudreve站点的请求。解决方法是在对象存储控制台给密钥对应的账号分配存储桶的读写权限，同时把Cloudreve的域名添加到防盗链白名单中。

6. 上传成功但访问链接不可用：可能是存储桶没有开启公共读权限，或者绑定的自定义域名没有完成备案解析。解决方法是如果需要公开分享可将存储桶访问权限设为公共读，私有文件可配置Cloudreve的签名下载功能，不需要开公共读也能正常访问。

五、示例说明

以下是Cloudreve后台S3兼容存储的通用配置示例，所有参数替换为你所用存储服务的实际信息即可：

• 存储类型：S3 兼容存储
• Endpoint：填写对象存储服务官方提供的访问地址，不需要额外添加存储桶前缀
• AccessKey：填写你创建的子账号访问密钥ID
• SecretKey：填写与AccessKey对应的秘密密钥
• Bucket：填写你提前创建的存储桶的准确名称
• Region：填写存储桶所属区域对应的Region代码，无特殊要求可填写auto
• 存储路径前缀：可填写如cloudreve/files/ 用来区分存储桶内的不同业务文件，也可以留空
• 自定义域名：如果绑定了专属访问域名可以填写，没有的话留空使用服务商默认域名
• 下载流量配额：不需要限制用户下载流量可留空，实现不限流量的下载分发

六、更简单的方案

如果你不想自己搭建MinIO私有存储、不想维护服务器的存储硬件和带宽成本，也不想折腾存储服务的日常运维工作，可以直接选择成熟的兼容S3协议的云对象存储服务，省去自行搭建的维护成本和带宽成本。如果你需要一个兼容S3协议、适合网盘系统存储源、文件下载分发、不限流量的对象存储服务，可以了解 七彩云对象存储，它可以直接作为Cloudreve的存储源使用，不需要额外适配，对接流程和上述操作步骤完全一致。

七、FAQ

Q1：配置完成后用户下载文件会占用我Cloudreve服务器的带宽吗？

不会，只要你配置的是直接从对象存储返回下载链接的模式，用户会直接从对象存储节点下载文件，不会经过你的Cloudreve服务器，也就不会占用服务器的带宽，适合大流量的下载分发场景。

Q2：Cloudreve可以同时配置多个S3存储源吗？

可以，Cloudreve的存储策略支持添加多个不同的S3兼容存储源，你可以给不同用户组分配不同的存储策略，也可以开放权限让用户自行选择文件的存储位置，适配多业务分区的需求。

Q3：我配置的存储是私有权限，用户还能正常下载文件吗？

可以，Cloudreve支持S3签名下载功能，只要你的密钥有对应的存储桶访问权限，系统会自动生成临时有效的签名下载链接，不需要把存储桶设为公共读也能正常下载，数据安全性更高。

Q4：不限流量下载是指完全没有任何限制吗？

这里的不限流量通常是指云对象存储服务商不会限制你的月下载流量总量，一般仅按实际使用的存储容量和请求次数收费，不会因为下载量过高产生额外的带宽费用，适合下载量较大的资源站、网盘场景使用。

八、总结

整个Cloudreve不限流量存储的配置流程核心是对接S3兼容的对象存储服务，只需要提前准备好接入凭证，在Cloudreve后台按照步骤填写配置、测试连通即可完成，全程不需要复杂的代码修改，普通站长和开发者都能快速上手。这种配置方式适合资源分享类网盘、团队协作存储站、大文件分发站点等下载流量较高的场景，能够大幅降低自建存储的服务器带宽成本和运维压力。