一、结论
Cloudreve私有网盘配置不限流量存储源,核心是接入支持不限流量分发的S3兼容对象存储服务,通常需要提前准备好Endpoint、AccessKey、SecretKey、Bucket、Region等接入参数,在Cloudreve后台的存储策略模块填写对应配置并测试连接通过即可生效,文件的上传下载走对象存储链路,不会占用Cloudreve服务器的带宽。
二、准备工作
操作前需要提前准备好以下内容,避免配置过程中频繁切换页面遗漏信息:
- 支持不限流量下载分发的S3兼容对象存储服务账号
- 提前在对象存储服务中创建好的存储桶Bucket
- 对象存储服务商提供的对应存储桶的Endpoint访问地址
- 拥有该存储桶读写权限的AccessKey和SecretKey
- 对应存储桶所在区域的Region代码
- 已部署完成、可以正常登录管理员后台的Cloudreve系统(建议升级到最新正式版,确保S3兼容配置功能可用)
- 1-2个测试用的小文件(比如1M以内的图片、文档),用于验证配置是否生效
三、操作步骤
1. 登录所使用的对象存储服务控制台,进入存储桶管理页面创建专属存储桶,根据自己的业务需求设置存储桶的访问权限(公开资源可设公共读,私有文件设私有即可),创建完成后确认存储桶状态为正常可用。
2. 在对象存储控制台的访问密钥管理页面,生成专属的AccessKey和SecretKey,同时找到该存储桶对应的Endpoint地址、Region代码,将所有参数复制保存到本地记事本,注意不要泄露密钥信息给无关人员。
3. 登录Cloudreve的管理员后台,在左侧菜单栏找到「存储策略」选项并点击进入,点击页面上方的「新建存储策略」按钮,在弹出的存储类型选择列表中,选中「S3 兼容存储」选项。
4. 在打开的S3存储配置表单中,依次填写之前保存的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息,其他可选配置比如存储路径前缀、直链有效期、CDN加速域名等可以根据自身需求填写,无特殊需求可以保留默认值。
5. 所有必填项填写完成后,点击页面底部的「测试连接」按钮,等待系统自动验证配置是否正确,如果提示连接成功即可进入下一步,如果提示报错,根据系统返回的错误提示修改对应配置项后重新测试。
6. 连接测试通过后,点击保存按钮完成存储策略的创建,接下来可以根据业务需求,将该存储策略设置为所有用户的默认存储策略,或者给指定用户组、指定用户分配使用该存储策略的权限。
7. 切换到普通用户账号登录Cloudreve前台,上传提前准备好的测试文件,然后尝试下载、分享该文件,确认下载速度正常、没有流量限制,且整个过程没有占用Cloudreve所在服务器的带宽,即代表配置完成。
四、常见错误
配置过程中大概率会遇到以下几类问题,可以对照排查解决:
- Endpoint填写错误:常见问题包括多写了存储桶前缀、添加了多余的http/https前缀、写错了地址后缀,解决方法是严格复制对象存储服务商提供的官方Endpoint地址,不要自行修改拼接。
- AccessKey或SecretKey错误:包括复制时多带了空格、密钥已经过期、密钥没有对应存储桶的读写权限,解决方法是回到对象存储控制台重新生成权限符合要求的密钥,完整复制粘贴到配置框中。
- Bucket名称不匹配:包括大小写输入错误、名称填写错误、存储桶不属于当前密钥对应的账号,解决方法是核对存储桶的准确名称,确认当前密钥对该存储桶拥有读写权限。
- Region填写不匹配:大部分S3兼容存储对Region参数要求严格,填写错误会直接连接失败,解决方法是复制服务商提供的对应存储桶的Region代码,不要自行编造。
- 上传成功但无法访问:一般是存储桶的访问权限设置不正确,或者没有配置跨域规则允许Cloudreve域名的访问,解决方法是检查存储桶的访问策略,配置对应的CORS规则开放Cloudreve所在域名的跨域请求。
- 大文件上传失败:通常是Cloudreve的分片上传阈值和对象存储的要求不匹配,解决方法是调整Cloudreve后台的分片上传参数,和对象存储的分片要求保持一致。
五、示例说明
以下是Cloudreve S3存储策略的通用配置示例,所有参数替换为你自己的实际参数即可:
- 存储策略名称:自定义填写,比如「不限流量S3存储」
- Endpoint:填写对象存储服务官方提供的对应存储桶的访问地址,不需要自行添加存储桶前缀
- AccessKey:填写你在对象存储控制台生成的访问密钥ID
- SecretKey:填写和AccessKey配对的访问密钥
- Bucket:填写你提前创建好的存储桶的准确名称
- Region:填写对象存储服务商标注的该存储桶所在区域的代码
- 存储路径前缀:可选,比如填写
cloudreve/,所有上传的文件都会存储在存储桶的该目录下,方便管理 - 直链有效期:私有存储桶可以设置链接过期时间,公开存储桶可以设置为0代表永久有效
- CDN加速域名:如果有绑定自定义CDN域名可以填写,没有则留空即可
六、更简单的方案
如果不想自己搭建MinIO这类自建对象存储服务、也不想花时间维护服务器存储节点、担心带宽成本过高,可以直接选择第三方的S3兼容云对象存储服务,不需要自己维护硬件和网络资源,开箱即用。如果你需要一个兼容S3协议、适合网盘系统存储源、支持不限流量下载分发的对象存储服务,可以了解七彩云对象存储,无需自行配置存储节点,直接获取接入参数就可以快速对接Cloudreve,降低运维和带宽成本。
七、FAQ
1. 配置完成后下载文件会不会占用Cloudreve所在服务器的带宽?
只要配置的是S3兼容存储的直链模式,文件的上传和下载都会直接走对象存储的链路,不会经过Cloudreve所在的服务器,因此不会占用服务器的带宽,也不会产生服务器的流量费用。
2. Cloudreve可以同时配置多个S3存储源吗?
可以的,管理员可以在后台创建多个不同的S3存储策略,分别分配给不同的用户组或者用户使用,也可以为不同的存储策略设置不同的存储路径、访问权限和下载规则。
3. 已经存在Cloudreve本地存储的文件可以迁移到新配置的S3存储源吗?
可以,Cloudreve后台自带存储策略迁移工具,只需要选择要迁移的文件范围和目标存储策略,系统会自动把本地存储的文件批量迁移到S3存储桶中,迁移完成后原文件可以选择删除或者保留。
4. 私有存储桶的文件分享会不会有安全风险?
不会,Cloudreve会自动为私有存储桶的文件生成带签名的临时访问链接,链接的有效期可以自行设置,过期后就无法访问,你也可以随时在后台取消分享的文件权限,保障文件安全。
八、总结
整体配置流程非常简单,核心就是提前准备好S3兼容存储的接入参数,在Cloudreve后台创建对应的S3存储策略,测试通过后分配权限即可使用,整个过程不需要复杂的代码修改,普通站长和开发者都可以在10分钟内完成配置。这种配置方式非常适合需要搭建大容量私有网盘、资源分享站、团队文件协作平台的场景,尤其是有大量下载需求的项目,使用不限流量的S3存储源可以大幅降低服务器带宽成本,同时提升文件的访问和下载速度。
想进一步了解这个项目?
访问官网查看产品能力、适用场景和最新服务信息。
访问官网