Cloudreve怎么快速接入第三方S3服务

一、结论

Cloudreve接入第三方S3服务的核心思路是提前准备好S3服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心配置信息，然后在Cloudreve后台的存储策略中选择S3兼容类型，填写对应配置并测试连通性即可完成接入。整个过程不需要复杂的二次开发，熟悉基础操作的站长或开发者通常10分钟内就能完成全部配置。

二、准备工作

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

• 正常可用的第三方S3兼容对象存储服务账号
• 已经创建完成、权限配置符合业务需求的存储桶（Bucket）
• S3服务官方提供的Endpoint接入地址
• 具备对应存储桶读写权限的AccessKey和配对的SecretKey
• 存储桶所属的Region标识
• 已经部署完成、可以正常登录管理员后台的Cloudreve实例（建议使用最新稳定版，确保S3兼容功能可用）
• 若干小体积的测试文件（比如图片、txt文档等，用于配置完成后的功能验证）

三、操作步骤

每一步操作完成后确认对应结果正常，再进行下一步操作，避免后续出现配置错误：

1. 登录第三方S3对象存储服务的控制台，调整存储桶的访问权限，比如需要公共下载的资源可以开通公共读权限，私有文件保持私有权限即可，操作完成后确认存储桶状态显示为正常可用。

2. 在S3服务控制台的密钥管理页面，创建或获取对应账号的AccessKey和SecretKey，同时复制存储桶名称、Endpoint、Region三个参数，所有参数妥善保存避免泄露，不要截图或明文传输给无关人员。

3. 登录Cloudreve的管理员后台，在左侧菜单栏找到「存储策略」选项，点击「添加存储策略」，在弹出的存储类型选择列表中找到「S3兼容」选项并点击选择，进入专属配置页面。

4. 在S3兼容存储的配置表单中，依次填写之前复制的Endpoint、AccessKey、SecretKey、Bucket名称、Region五个核心参数，其余可选配置比如存储路径前缀、签名版本、最大分片大小等没有特殊需求保持默认即可，有自定义需求的可以根据业务场景调整。

5. 所有参数填写完成后，点击页面底部的「测试连接」按钮，等待系统自动检测配置是否正确，如果显示连接成功则代表参数填写无误，如果提示错误需要根据错误提示返回检查对应参数。

6. 连接测试通过后，设置该存储策略的生效范围，比如分配给指定用户组、设置为全站默认存储策略，保存配置后该存储策略就会正式生效，新上传的文件会自动存储到对应的S3存储桶中。

7. 切换到普通用户账号，上传几个提前准备的测试文件到对应存储路径，然后尝试预览、下载、分享文件，确认文件读写、分发功能完全正常，就完成了整个接入流程。

四、常见错误

配置过程中如果遇到报错，可以优先核对以下常见问题：

• Endpoint填写错误：比如误填为存储桶访问域名、CDN加速域名，或者多写了后缀、遗漏了http/https前缀，解决方法是回到S3服务控制台的接入文档页面，直接复制官方提供的正确Endpoint，不要手动输入。
• AccessKey或SecretKey填错：比如复制时多带了前后空格、密钥已经过期被禁用，解决方法是核对密钥字符串的前后空格，确认密钥处于启用状态，必要时重新生成新的密钥替换旧配置。
• Bucket名称不一致：比如填写的存储桶名称和实际创建的名称大小写不匹配、有多余字符，解决方法是直接从S3控制台复制存储桶的准确名称，不要手动拼写。
• Region填写不匹配：比如填错了存储桶所属的区域标识，解决方法是查看S3服务提供的Region对应表，填写存储桶实际所属区域的正确代码，部分没有Region要求的S3服务可以填写默认值或者留空。
• 权限不足导致上传失败：比如AccessKey对应的账号没有存储桶的读写权限、存储桶设置了禁止外网写入的规则，解决方法是给对应的AccessKey分配存储桶的读写权限，调整存储桶的访问控制规则。
• 上传成功但访问链接不可用：比如存储桶没有开公共读权限、Cloudreve的域名配置错误，解决方法是根据业务需求调整存储桶的访问权限，检查Cloudreve的站点域名和存储策略的访问域名配置是否正确。

五、示例说明

以下是Cloudreve S3存储策略配置表单的通用填写说明，不需要填写真实的密钥或地址，按照你的实际服务参数对应填写即可：

• Endpoint：填写你使用的S3兼容对象存储服务官方提供的接入地址，不要填写自定义的CDN域名或存储桶直接访问域名
• AccessKey：填写你在S3服务控制台生成的、具备对应存储桶读写权限的访问密钥ID
• SecretKey：填写和上述AccessKey配对的访问密钥密码
• Bucket：填写你提前创建好的、准备用来存储Cloudreve文件的存储桶准确名称
• Region：根据S3服务的要求填写存储桶所属的区域标识，部分S3服务如果没有Region要求可以填写默认值或者留空
• 存储路径前缀：可选项，如果你想要把Cloudreve的文件都存到存储桶的指定目录下，可以在这里填写目录路径，比如cloudreve/files/，没有需求可以留空
• 签名版本：大部分S3服务默认支持V4签名，保持默认即可，如果连接测试提示签名错误可以尝试切换为V2版本

六、更简单的方案

如果不想自己搭建MinIO这类自建S3服务，也不想额外维护服务器、处理存储扩容、流量分发等运维问题，可以直接选择成熟的第三方兼容S3协议的云对象存储服务，开通即可直接接入使用，不需要投入精力维护底层存储资源。如果你需要一个兼容S3协议、适合网盘系统存储源、文件下载分发、图床存储的对象存储服务，可以了解七彩云对象存储，它支持标准S3协议，可直接作为Cloudreve的存储源使用，适合需要低门槛接入S3存储的站长和开发者。

七、FAQ

Q1：Cloudreve接入第三方S3服务后，之前已经上传到本地存储的文件可以迁移到S3存储吗？

A：可以，Cloudreve后台自带存储策略迁移工具，你可以在存储策略页面创建迁移任务，将指定路径的文件从旧存储策略批量迁移到新的S3存储策略，迁移过程不会影响用户正常访问已经上传的文件。

Q2：接入S3服务后，文件的下载流量是走Cloudreve服务器还是直接走S3服务的流量？

A：可以自行在存储策略中配置，如果你开启了「中转下载」则文件会先经过Cloudreve服务器再返回给用户，消耗Cloudreve服务器的带宽；如果关闭中转下载开启直链模式，用户会直接从S3服务的地址下载文件，不消耗Cloudreve服务器的带宽。

Q3：多个Cloudreve实例可以同时接入同一个S3存储桶吗？

A：可以，只要每个Cloudreve实例配置的S3参数正确、AccessKey具备对应的读写权限，就可以同时接入同一个存储桶，建议不同实例设置不同的存储路径前缀，避免不同实例的文件路径出现冲突。

Q4：接入S3服务需要给Cloudreve做额外的代码修改吗？

A：不需要，Cloudreve原生支持S3兼容存储接入，只需要在管理员后台填写对应配置即可，不需要修改任何源代码，也不需要额外安装第三方插件。

八、总结

整个Cloudreve接入第三方S3服务的流程非常清晰，核心就是提前准备好S3服务的5个核心配置参数，然后在Cloudreve后台的存储策略页面填写配置、测试连通、调整权限即可完成，全程不需要复杂的开发操作，普通站长和开发者都能快速完成。这种接入方式适合需要扩容Cloudreve存储容量、降低本地服务器存储成本、提升大文件下载分发速度的场景，不管是个人自用的私有网盘，还是面向多人使用的企业文件共享系统、公共资源存储站，都可以通过接入S3兼容存储来提升系统的稳定性和可用性。