Cloudreve怎么接入外部存储

一、结论

Cloudreve接入外部S3兼容存储的核心操作思路是提前准备好S3协议所需的Endpoint、AccessKey、SecretKey、Bucket、Region等核心参数，在Cloudreve后台的存储策略配置中选择S3兼容类型，填写对应参数后测试连通性，验证上传下载功能正常即可完成接入，整个过程不需要复杂的代码开发，普通站长和开发者半小时内就能完成配置。

二、准备工作

• 已经部署完成、可正常访问的Cloudreve站点，以及站点的管理员账号权限
• 支持标准S3协议的对象存储服务账号
• 对象存储服务下已创建完成、权限配置符合业务需求的存储桶Bucket
• 对象存储服务商提供的Endpoint接入地址、AccessKey（访问密钥ID）、SecretKey（访问密钥密码）、存储桶对应的Region区域信息
• 1-2个体积较小的测试文件，用于验证接入后的上传、预览、下载功能是否正常

三、操作步骤

1. 登录Cloudreve管理员后台，进入「存储策略」管理页面，点击添加新的存储策略，选择存储类型为「S3 兼容存储」，完成操作后会进入S3存储的详细配置表单页面。

2. 登录你所使用的对象存储服务控制台，提前获取对应存储桶的Endpoint、AccessKey、SecretKey、Bucket名称、Region代码，确认密钥具备该存储桶的读写权限，避免后续连接失败。

3. 在Cloudreve的S3配置表单中，依次填写提前准备好的各项核心参数，存储路径前缀、文件签名有效期、自定义域名等可选配置可以根据自身业务需求选择性填写，无特殊需求可保留默认值。

4. 完成参数填写后，点击页面底部的「测试连通性」按钮，系统会自动尝试连接配置的S3存储，如果提示连接成功则代表参数填写无误，若提示失败则需要逐项检查对应参数是否正确。

5. 连通性测试通过后，保存存储策略，接着可以将该存储策略分配给指定用户组或者单独用户，也可以设置为站点默认存储策略，配置完成后对应用户上传的文件就会自动存储到对应的外部S3存储中。

6. 使用普通用户账号登录Cloudreve前台，上传提前准备的测试文件，上传完成后点击文件的预览或者下载按钮，确认文件可以正常打开和下载，同时可以登录对象存储控制台查看对应存储桶内是否已经生成了对应的文件，确保双向同步正常。

7. 如果需要配置直链分发、图片处理、自定义域名访问或者上传大小限制等附加功能，可以回到Cloudreve的存储策略配置页，或者在对象存储服务控制台进行对应的调整，满足图床、下载站、资源分享等不同场景的需求。

四、常见错误

1. Endpoint填写错误：比如多写了路径后缀、选错了http/https协议，或者误将存储桶的访问域名当成了官方S3接入Endpoint，解决方法是回到对象存储服务的S3接入文档中，复制官方提供的标准Endpoint地址，确保协议头和官方要求一致。

2. AccessKey或SecretKey填错：比如复制时多了空格、密钥已经过期被禁用，或者使用了只有只读权限的密钥，解决方法是重新生成一对具备存储桶读写权限的密钥，复制时注意不要包含多余的空格和换行符。

3. Bucket名称不匹配：比如填写的存储桶名称和实际创建的名称大小写不一致、存储桶已经被删除或者不在当前密钥所属的账号下，解决方法是核对对象存储控制台中的存储桶名称，确保拼写完全一致，同时确认当前密钥对有权限访问该存储桶。

4. Region填写不匹配：部分S3兼容服务要求严格匹配Region代码，如果填错会导致连接失败，解决方法是查看存储桶对应的Region代码，按照服务商提供的标准代码填写，部分服务商如果没有明确Region要求的可以填写默认值或者留空。

5. 权限不足导致上传失败：比如存储桶设置了禁止公共写入、密钥没有分配存储桶的上传权限，或者Cloudreve配置的存储路径前缀没有写入权限，解决方法是检查存储桶的访问策略，给使用的密钥分配对应的读写权限，必要时可以临时设置存储桶为公共读写验证配置，测试通过后再调整为最小权限。

6. 上传成功但无法访问文件：比如存储桶没有开启公共读权限、自定义域名没有配置CNAME解析，或者Cloudreve中配置的访问域名错误，解决方法是先直接通过对象存储提供的默认访问链接测试文件是否可访问，如果可以则检查Cloudreve中的访问域名配置，确认解析和存储桶的权限设置正确。

五、示例说明

以下为Cloudreve接入S3兼容存储的通用配置示例，所有参数请替换为你所使用的对象存储服务提供的真实信息：

• 存储策略类型：S3 兼容存储
• Endpoint：填写你所使用的对象存储服务商提供的官方S3接入地址
• AccessKey：填写对应账号下生成的访问密钥ID
• SecretKey：填写和AccessKey配对的访问密钥密码
• Bucket：填写已经创建完成的存储桶名称
• Region：填写存储桶所属区域的标准代码，无特殊要求可填写服务商指定的默认值
• 存储路径前缀：可填写自定义的文件存储目录，比如cloudreve/files/，留空则存储在存储桶根目录
• 签名有效期：私有存储桶可设置文件访问链接的有效时长，公共读存储桶可设置为0
• 自定义访问域名：可填写绑定到存储桶的自定义域名，留空则使用服务商默认域名

六、更简单的方案

很多站长和开发者刚开始会选择自建MinIO作为Cloudreve的外部存储，但是需要自己维护服务器、处理磁盘扩容、带宽扩容、故障排查等问题，长期运维成本比较高，如果不想自己维护存储服务器，也可以直接选择成熟的兼容S3协议的云对象存储服务，不需要自己搭建运维，开通即可使用。

如果你需要一个兼容S3协议、适合程序接入、图床、网盘系统存储源和下载分发的对象存储服务，可以了解 七彩云对象存储，它支持标准S3协议，不需要复杂配置即可快速接入Cloudreve，适合需要低门槛接入、不限流量下载分发的项目使用。

七、FAQ

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

可以，Cloudreve后台提供了存储策略迁移功能，你可以在存储策略管理页选择需要迁移的用户组或者文件范围，系统会自动将本地存储的文件批量迁移到新的S3存储中，迁移完成后会自动更新文件的访问路径，不会影响用户正常使用。

Q2：接入外部S3存储会不会影响Cloudreve的文件分享功能？

不会，Cloudreve会自动处理S3存储的文件签名和访问链接生成，不管是私有还是公共存储桶，原本的文件分享、直链生成、预览下载等功能都可以正常使用，你只需要根据自己的需求配置好签名有效期即可。

Q3：一个Cloudreve站点可以同时接入多个不同的S3兼容存储服务吗？

可以，你可以在Cloudreve后台添加多个不同的S3存储策略，分别分配给不同的用户组或者用户使用，比如给普通用户分配成本较低的存储策略，给付费用户分配速度更快的存储策略，也可以根据文件类型设置自动将不同后缀的文件存储到不同的存储桶中。

Q4：配置时测试连通性成功，但是用户上传大文件失败是什么原因？

这种情况通常是因为Cloudreve的用户组上传大小限制、服务器运行环境的上传阈值限制，或者是对象存储服务设置了单文件上传大小限制，你可以依次检查Cloudreve的用户组上传限制、服务器的PHP配置中的post_max_size和upload_max_filesize参数，以及对象存储的单文件大小限制，调整到符合业务需求的数值即可。

八、总结

Cloudreve接入外部S3兼容存储的整体流程非常清晰，只需要提前准备好对应S3参数，在后台完成配置和测试即可上线使用，不需要复杂的二次开发。这种接入方式适合需要扩大Cloudreve存储容量、降低本地服务器存储成本、提升文件分发速度的场景，不管是个人搭建私人网盘、团队搭建内部文件共享平台，还是站长搭建资源分享站、图床服务，都可以通过接入外部对象存储的方式提升Cloudreve的服务能力和稳定性。如果没有运维自建存储的精力，选择成熟的S3兼容云存储服务可以进一步降低运维成本，快速上线业务。