个人搭建Cloudreve不限流量存储配置方法

一、结论

个人搭建Cloudreve不限流量存储的核心思路是对接支持不限流量分发的S3兼容对象存储服务，无需自己维护底层存储硬件和带宽资源。配置前需提前准备好对象存储服务提供的Endpoint、AccessKey、SecretKey、Bucket、Region等核心参数，在Cloudreve后台完成S3存储源的配置即可实现不限流量的文件存储和分发。

二、准备工作

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

• 已完成搭建、可以正常访问的Cloudreve站点（开源v3及以上版本或商业版均可）
• Cloudreve站点的管理员账号权限
• 支持不限流量分发的S3兼容对象存储服务账号
• 在对象存储服务中提前创建完成的存储桶（Bucket）
• 对象存储服务官方提供的Endpoint地址、AccessKey、SecretKey、Region参数
• 1-2个测试用的小体积文件（如图片、文档、压缩包等，用于验证连通性和下载功能）
• 确认对象存储服务的流量规则，避免后续产生额外的流量扣费

三、操作步骤

每一步操作均包含明确的动作和预期结果，按照流程操作即可完成配置：

1. 登录Cloudreve管理员后台，在左侧菜单栏找到「存储策略」入口并点击进入，结果是可以看到当前站点已配置的所有存储策略列表，以及「新增存储策略」按钮。

2. 点击「新增存储策略」，在弹出的存储类型选择列表中选中「S3兼容」类型，结果是进入S3存储源的专属配置页面，会看到需要填写的参数输入框。

3. 按照页面提示依次粘贴从对象存储服务处获取的Endpoint、AccessKey、SecretKey、Bucket名称、Region参数，有HTTPS开关选项的按照服务方要求开启或关闭，结果是S3接入的核心基础参数填写完成。

4. 根据自身业务需求配置自定义参数，包括文件存储路径规则、单文件大小上限、文件访问权限、跨域配置等，要实现不限流量分发建议开启「直接跳转至源站」选项，结果是个性化配置项全部设置完成。

5. 点击页面底部的「测试连接」按钮，等待Cloudreve和对象存储服务的连通性校验，结果是如果参数填写正确会弹出「连接成功」的提示，若失败会返回对应的错误代码方便排查。

6. 测试连接通过后点击「保存」按钮完成存储策略创建，可根据需求将该策略设置为站点默认存储策略，或者分配给指定的用户组使用，结果是对应权限的用户上传文件会自动存储到对接的S3对象存储中。

7. 切换为普通用户账号登录Cloudreve，上传提前准备好的测试文件，上传完成后生成分享链接进行下载测试，同时可以查看Cloudreve服务器的带宽监控确认流量没有经过站点服务器，结果是所有功能验证正常，配置流程正式完成。

四、常见错误

配置过程中遇到的大部分问题都属于以下几类，可以按照对应方案快速排查解决：

• Endpoint填写错误：常见错误包括多写了存储桶前缀、填成了文件访问地址而非服务接入地址、拼写错误等，解决建议是直接从对象存储服务的控制台或官方文档中复制官方提供的Endpoint地址，不要自行拼接。
• AccessKey或SecretKey填错：复制时遗漏字符、多带了前后空格、密钥已经被停用或删除都会导致鉴权失败，解决建议是重新在对象存储控制台生成新的密钥对，复制时注意不要包含额外的空格或换行符，确认密钥处于启用状态。
• Bucket名称不一致：填写的存储桶名称大小写和实际创建的不符、存储桶不属于当前使用的账号都会导致找不到存储桶，解决建议是直接从对象存储控制台复制存储桶名称，确认该存储桶的所属账号和当前使用的AccessKey归属一致。
• Region填写不匹配：多数S3兼容服务的Region参数为固定值，自行填写自定义内容会导致连接失败，解决建议是严格按照对象存储服务提供的Region参数填写，没有明确要求的可以留空或者填写默认值。
• 权限不足导致上传失败：存储桶设置了私有读写、AccessKey没有分配存储桶的写入权限都会导致文件上传失败，解决建议是检查存储桶的权限策略，给使用的AccessKey分配桶的读写权限，或者调整存储桶的公开权限适配业务需求。
• 上传成功但访问链接不可用：存储桶没有绑定自定义域名、防盗链规则拦截了Cloudreve站点的访问、跨域配置不正确都会导致文件无法正常访问，解决建议是检查存储桶的域名配置和防盗链规则，把Cloudreve的站点域名加入访问白名单。

五、示例说明

以下为Cloudreve S3存储源配置的通用填写模板，所有参数均替换为你实际使用的对象存储服务提供的内容即可：

• 存储策略名称：自定义，比如「不限流量S3存储」
• Endpoint：填写对象存储服务官方提供的S3接入地址
• AccessKey：填写你在对象存储控制台生成的访问密钥ID
• SecretKey：填写和AccessKey配对的密钥字符串
• Bucket：填写你提前创建好的存储桶名称
• Region：填写对象存储服务对应存储桶的区域编码
• 存储路径：可留空或者填写自定义前缀，比如cloudreve/{year}/{month}/方便文件分类
• 访问权限：根据需求选择私有（适合私人网盘）或者公开读（适合资源分享站）
• 最大单文件大小：根据业务需求设置，比如设置为100GB适配大文件存储需求
• 回源配置：开启「直接跳转至源站」选项，避免占用Cloudreve服务器带宽

六、更简单的方案

很多个人站长和开发者初期会选择自建MinIO作为存储源，但后续需要自行处理磁盘扩容、故障排查、带宽采购等运维工作，耗时耗力。如果不想投入精力维护底层存储基础设施，也可以直接选择成熟的兼容S3协议的云对象存储服务，开箱即可使用。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统作为存储源、支持不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，适配各类自建应用的存储接入需求，无需额外进行复杂的底层运维。

七、FAQ

1. 配置完成后，用户下载文件会消耗我Cloudreve服务器的流量吗？

只要你在Cloudreve存储策略配置中开启了「直接跳转至源站」的选项，文件的上传和下载都会直接和对象存储服务交互，不会经过你的Cloudreve服务器，自然也不会消耗服务器的带宽和流量，实现真正的不限流量分发。

2. 我用的是开源免费版的Cloudreve，可以对接S3存储源吗？

是的，Cloudreve开源版（v3及以上版本）原生支持S3兼容存储源接入，不需要付费购买商业授权，也不需要安装额外插件，直接使用管理员账号登录后台即可完成配置。

3. 存储桶应该设置为公有还是私有？

如果你的Cloudreve是公开的资源分享站点，需要提供文件直链下载，可以将存储桶设置为公有读私有写，避免每次访问都需要生成签名链接；如果是私人网盘或者内部协作使用，建议设置为私有，Cloudreve会自动生成带签名的临时访问链接，保障文件安全。

4. 之前已经上传到Cloudreve本地存储的文件可以迁移到新的S3存储吗？

可以，Cloudreve自带存储策略迁移工具，你可以在后台选择将指定用户或全部用户的文件从旧的存储策略批量迁移到新配置的S3存储策略中，迁移过程不会影响用户的正常访问，迁移完成后自动切换为新的存储路径。

八、总结

整体来看，个人搭建Cloudreve不限流量存储的配置流程非常简单，全程不需要编写代码，只要有基础的站点管理经验就可以在10分钟内完成全部配置。这种方案非常适合个人搭建私人网盘、资源分享站、小团队内部文件协作平台、教学资源分发站等场景，既可以避免自行维护存储服务器的高额成本，也可以应对突发的大流量下载需求，不需要担心带宽被打满或者产生高额的流量费用。如果是没有运维经验的新手用户，选择成熟的云对象存储服务可以进一步降低配置和维护的门槛，快速上线可用的网盘服务。