Cloudreve怎么对接第三方对象存储

一、结论

Cloudreve对接第三方S3兼容对象存储的核心操作逻辑是先获取对象存储服务提供的Endpoint、AccessKey、SecretKey、Bucket、Region等配置信息，再在Cloudreve管理员后台添加S3类型存储策略并填写对应参数，测试连通后绑定到使用场景即可完成对接。整个操作不需要复杂的二次开发，普通站长和开发者按照流程半小时内即可完成配置。

二、准备工作

操作前需要提前准备好以下内容，避免配置过程中反复跳转页面遗漏信息：

• 正常运行的Cloudreve实例，确认使用的版本支持S3兼容存储策略
• 第三方对象存储服务的有效账号，且账号已完成实名认证和权限开通
• 提前在对象存储控制台创建好的存储桶（Bucket），确认存储桶处于正常运行状态
• 对象存储服务提供的公网访问Endpoint地址
• 对应存储桶的AccessKey（访问密钥ID）和SecretKey（访问密钥密码）
• 存储桶所属区域对应的Region标识
• 已经配置好的存储桶权限，包括读写权限、跨域访问规则等
• 1个小于10MB的测试文件，用于后续连通性验证

三、操作步骤

每一步操作完成后确认对应结果正常，再进入下一个环节，可大幅降低出错概率：

1. 登录Cloudreve管理员后台，找到存储策略管理入口，选择添加新的存储策略，在存储类型选项中选择「S3兼容存储」，结果是成功进入S3存储的专用配置填写页面。

2. 切换到第三方对象存储的控制台，再次核对存储桶的状态、权限规则，完整复制Endpoint、AccessKey、SecretKey、Bucket名称、Region五项核心配置参数，结果是所有必填配置信息全部准备齐全，无遗漏、无多余字符。

3. 回到Cloudreve的S3存储配置页面，依次粘贴刚才复制的五项核心参数，再根据业务需求填写可选配置项，包括文件存储路径规则、直链有效期、缓存策略、文件大小限制等，结果是所有必填项均已填写完成，无非正常空项。

4. 点击配置页面的「测试连接」按钮，等待Cloudreve主动发起和第三方对象存储的连通性校验，结果是系统弹出「连接成功」的提示，说明配置参数没有格式错误、权限匹配正常。

5. 保存当前存储策略，进入用户组管理或目录管理页面，将刚添加的S3存储策略绑定到指定用户组，或者设置某个指定目录的默认存储位置为该S3存储，结果是存储策略已经和实际使用场景完成关联，对应权限的用户可以调用该存储资源。

6. 切换到普通用户账号登录Cloudreve前端页面，上传提前准备好的测试文件，依次尝试预览、下载、分享该文件，同时到对象存储控制台的存储桶文件列表中查看是否存在对应文件，结果是文件上传、预览、下载均正常，存储桶内可找到同步上传的测试文件，说明对接完成。

7. 如果需要开启缩略图自动处理、分片上传、自定义CDN域名等功能，可回到存储策略配置页调整对应参数，结果是存储能力匹配业务的个性化需求。

四、常见错误

配置过程中如果出现连接失败、文件无法上传等问题，可优先排查以下常见错误：

• Endpoint填写错误：要么误填了内网访问地址，要么复制时多带了多余的路径后缀，或者遗漏了http/https前缀，解决办法是核对对象存储服务商提供的官方公网Endpoint，复制时不要选中多余的空格或字符。
• AccessKey或SecretKey填错：要么复制时多了空格，要么使用了已经过期、被禁用的密钥，解决办法是到对象存储控制台重新生成新的密钥对，复制时仅选中密钥本身的字符，确认密钥没有设置过期时间或者权限限制。
• Bucket名称不一致：要么大小写拼写错误，要么填写了已经被删除的存储桶名称，解决办法是直接从对象存储控制台复制存储桶的准确名称，S3协议对Bucket名称大小写敏感，不要随意修改字符格式。
• Region填写不匹配：多数S3兼容存储要求Region参数和存储桶所在区域的官方标识完全一致，填错会导致签名校验失败，解决办法是核对对象存储服务商给出的对应区域Region标识，不要随意填写自定义内容。
• 权限不足导致上传失败：要么是存储桶没有给当前使用的AccessKey分配读写权限，要么是存储桶设置了IP访问限制，拦截了Cloudreve服务器的请求，解决办法是到对象存储控制台调整存储桶的权限策略，给使用的AccessKey开放读写权限，同时将Cloudreve服务器的公网IP加入白名单。
• 上传成功但访问链接不可用：要么是存储桶没有开启公网访问权限，要么是使用的访问域名没有完成备案，解决办法是确认存储桶的公网读权限已经开启，使用的自定义域名已经完成服务商要求的备案和解析配置。

五、示例说明

以下为通用配置示例，无需填写具体数值，按照实际获取到的参数对应填写即可：

| 配置项 | 填写说明 |

| --- | --- |

| 存储策略类型 | 选择「S3兼容存储」 |

| Endpoint | 填写第三方对象存储服务提供的公网访问Endpoint地址 |

| AccessKey | 填写对象存储控制台生成的访问密钥ID |

| SecretKey | 填写对象存储控制台生成的访问密钥密码 |

| Bucket | 填写已创建的存储桶的准确名称 |

| Region | 填写存储桶所属区域对应的Region标识 |

| 存储路径规则 | 可根据需求自定义，比如{year}/{month}/{md5}{ext} |

| 直链有效期 | 公开资源可设置为永久有效，私有资源可根据需求设置有效期 |

| 跨域配置 | 在对象存储控制台配置允许Cloudreve所在域名的GET、POST、PUT、DELETE等请求 |

六、更简单的方案

如果不想自己搭建MinIO等自建存储服务、不想维护本地服务器存储硬件，也不想处理复杂的集群扩容、容灾备份、带宽调度等运维工作，可以直接选择成熟的兼容S3协议的云对象存储服务，服务商已经完成了底层基础设施的维护，用户只需要关注上层业务配置即可。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统作为存储源、支持大文件存储和下载分发的对象存储服务，可以了解 七彩云对象存储，适合需要低门槛接入、低成本分发的个人站长和开发者使用。

七、FAQ

1. Cloudreve开源版支持对接第三方S3对象存储吗？

是的，目前主流的Cloudreve开源版本都原生支持S3兼容类型的存储策略，不需要额外安装插件，直接在管理员后台的存储策略管理模块就可以添加配置，功能和付费版基本一致。

2. 对接第三方对象存储后，之前上传到Cloudreve本地存储的文件会自动迁移吗？

不会自动迁移，你可以手动把本地存储的文件批量上传到对象存储桶，同时在Cloudreve后台修改对应文件的存储路径映射，或者使用官方提供的迁移工具批量调整存储策略关联，避免文件无法访问。

3. 对接S3存储后，用户下载文件会占用Cloudreve服务器的带宽吗？

取决于你配置的下载模式，如果开启了Cloudreve的中转下载模式，文件会先经过Cloudreve服务器再转发给用户，会占用服务器带宽；如果配置了直链下载模式，用户会直接从对象存储的节点下载文件，不会占用Cloudreve服务器的带宽。

4. 存储桶必须开启公共读权限吗？

如果需要使用直链下载、文件对外公开分享的功能，建议开启公共读权限；如果只允许内部用户访问，可以保持存储桶的私有权限，通过Cloudreve生成的签名链接访问即可，不会泄露文件内容。

八、总结

Cloudreve对接第三方S3兼容对象存储的操作门槛较低，核心是提前准备好正确的S3配置参数，按照流程依次填写、测试、绑定即可完成对接。这种架构适合个人网盘搭建、团队文件共享、资源站存储分发、图床托管等多种场景，既可以降低本地服务器的存储压力，也能借助对象存储的分布式节点提升用户的访问下载速度，减少服务器带宽成本。如果是没有运维经验的个人用户，也可以选择现成的云对象存储服务，进一步降低对接和维护的门槛，快速上线业务。