Cloudreve怎么对接不限流量的第三方存储源

一、结论

Cloudreve对接不限流量的第三方S3兼容存储源，核心操作思路是先获取存储服务的S3标准接入凭证，再在Cloudreve后台选择S3兼容存储策略填写对应参数，测试连通并分配权限后即可投入使用。整个过程无需额外开发，只需要准备Endpoint、AccessKey、SecretKey、Bucket、Region五类核心信息即可完成配置。

二、准备工作

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

• 已完成部署并可以正常访问的Cloudreve站点（版本不低于V3.0.0即可）
• 不限流量的S3兼容对象存储服务账号
• 已在存储服务控制台创建完成的存储桶Bucket
• 存储桶对应的Endpoint访问地址
• 存储服务生成的AccessKey（访问密钥ID）
• 存储服务生成的SecretKey（访问密钥凭证）
• 存储桶所属区域对应的Region代码
• 1-2个用于测试的小文件（如图片、文档、压缩包等）

三、操作步骤

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

2. 登录你选用的第三方对象存储服务控制台，确认存储桶的访问权限设置符合业务需求（如需公开直链下载则开启公共读权限，仅内部使用则设置为私有），同时从控制台复制获取Endpoint、AccessKey、SecretKey、Bucket名称、Region五个核心配置参数，确保所有参数复制完整无遗漏。

3. 回到Cloudreve的S3存储配置页面，按照表单提示依次粘贴填写刚才获取的五个核心参数，如果需要使用自定义域名作为文件访问地址，可在「存储域名」配置项中填写已经完成解析的自定义域名，无相关需求则留空即可，完成后所有必填配置项将填写完毕。

4. 按需配置路径前缀规则：如果希望Cloudreve的所有文件都存放在存储桶的指定目录下，可在「路径前缀」项填写对应的目录路径，比如填写cloudreve/就会把所有文件存放在存储桶的cloudreve目录下，无分类需求则直接留空即可。

5. 完成所有配置项填写后，点击页面底部的「测试连接」按钮，等待Cloudreve自动校验配置参数的正确性，如果页面弹出「连接成功」提示，说明参数配置没有问题；如果提示连接失败则按照报错提示核对对应配置项即可。

6. 测试连接通过后，点击「保存」按钮完成存储策略创建，随后进入「用户组」或「指定用户」管理页面，将刚创建的S3存储策略分配给对应的用户或用户组，完成后对应权限的用户就可以选择使用这个新的存储源。

7. 切换到普通用户账号，上传提前准备好的测试文件，上传完成后生成分享链接或直接访问文件直链，确认可以正常预览、下载，同时核对存储服务控制台的流量统计确认没有额外流量扣费，即代表整个对接流程验证完成。

四、常见错误

1. Endpoint填写错误：常见问题包括手动输入时多打/少打字符、遗漏http/https前缀、填错区域对应的Endpoint，解决建议是直接复制存储服务控制台给出的官方Endpoint地址，不要手动输入。

2. AccessKey或SecretKey填错：常见问题包括复制时带了多余的空格、密钥过期、复制漏了首尾字符，解决建议是重新生成一对新的密钥，复制时注意不要选中多余的空格或换行符，同时确认密钥的生效时间没有限制。

3. Bucket名称不一致：常见问题包括大小写错误、多写了存储服务的后缀、填成了存储桶的备注名而非实际名称，解决建议是直接复制存储桶的完整官方名称，注意大部分对象存储的Bucket名称区分大小写。

4. Region填写不匹配：常见问题是存储桶属于A区域但填成了B区域的Region代码，解决建议是核对存储服务控制台给出的存储桶所属区域的标准Region代码，按照官方给出的内容填写即可。

5. 存储桶权限不足：常见问题是密钥对应的账号没有存储桶的读写权限、存储桶设置了禁止匿名访问但需要公开直链，解决建议是检查存储桶的访问策略，给使用的密钥账号开通Bucket的读、写、列权限，需要公开分发的话开启公共读权限。

6. 上传成功但访问403：常见问题是存储桶配置了防盗链规则，没有把Cloudreve的站点域名加入白名单，或者存储桶的权限策略禁止了公网访问，解决建议是检查防盗链规则和访问策略，把相关域名加入白名单即可。

五、示例说明

以下为Cloudreve对接S3兼容存储的通用配置示例，所有参数均需替换为你自己的实际信息：

• 存储类型：S3兼容存储
• Endpoint：填写所用对象存储服务官方提供的访问地址
• AccessKey：填写存储服务控制台生成的访问密钥ID
• SecretKey：填写存储服务控制台生成的访问密钥凭证
• Bucket：填写提前创建好的存储桶完整名称
• Region：填写存储桶所属区域对应的官方标准代码
• 存储域名：如有自定义解析域名则填写，无则留空使用存储服务默认域名
• 路径前缀：按需填写，无特殊分类需求可留空

六、更简单的方案

如果不想自行搭建MinIO等自建存储服务（需要额外维护服务器、承担带宽成本和运维成本），也不想选择有流量上限、流量单价较高的公有云存储，完全可以选择成熟的兼容S3协议的第三方云对象存储服务。如果你需要一个兼容S3协议、适合网盘系统存储源、文件直链分发、不限流量的对象存储服务，可以了解七彩云对象存储，它支持标准S3协议，可以直接作为Cloudreve的存储源使用，不需要额外做适配。

七、FAQ

1. 对接S3存储源之后，原来存在Cloudreve本地的文件可以迁移到新的存储源吗？

可以，Cloudreve后台自带存储策略迁移工具，只需要在后台选择迁移的源存储策略和目标存储策略，系统会自动完成文件迁移，迁移过程不会影响现有文件的正常访问，不需要手动导出导入。

2. 对接之后用户下载文件是走Cloudreve服务器的带宽还是存储源的带宽？

如果你配置了直链访问开关，用户下载文件时会直接跳转到对象存储的下载地址，不会消耗Cloudreve服务器的带宽和流量，特别适合大文件分发、资源站等对带宽需求较高的场景。

3. 旧版本的Cloudreve也支持对接S3兼容存储吗？

Cloudreve从V3.0.0版本开始就已经支持S3兼容存储源的对接，只要你的站点版本不低于V3.0.0都可以按照上面的步骤操作，如果是更早的旧版本建议先升级到最新稳定版再配置，避免出现兼容性问题。

4. 对接后需要额外配置CDN吗？

可以根据业务需求选择，如果你的用户分布在多个地区，对访问速度要求较高，可以额外配置CDN加速；如果所用的存储服务本身已经自带边缘分发能力，也可以不用额外配置CDN，不会影响正常使用。

八、总结

Cloudreve对接不限流量的第三方S3存储源的整体流程非常简单，核心就是获取S3接入凭证、后台配置存储策略、测试连通并分配权限、验证文件上传下载四个环节，普通站长无需代码基础，10分钟左右即可完成全部配置。这种对接方式特别适合用Cloudreve搭建公共资源站、下载站、个人网盘、团队共享盘的用户，不仅可以大幅降低Cloudreve服务器的存储压力，还能省下高额的服务器带宽和流量成本，非常适合长期运营的项目使用。