Cloudreve怎么配置接入第三方对象存储作为存储源

一、结论

Cloudreve接入第三方对象存储作为存储源的核心是通过其内置的S3兼容存储配置项实现，操作前需提前准备好对象存储的Endpoint、AccessKey、SecretKey、Bucket、Region等核心信息，在Cloudreve后台填写配置并测试连通即可完成接入，全程无需修改代码，普通站长和开发者10分钟左右即可完成操作。

二、准备工作

• 已部署完成、可正常访问的Cloudreve站点，且拥有管理员账号权限
• 第三方对象存储服务的有效账号
• 提前在对象存储服务中创建完成的存储桶（Bucket）
• 对象存储服务商提供的Endpoint访问地址
• 对象存储账号生成的AccessKey和SecretKey密钥对
• 存储桶所属的Region（区域）代码
• 1个小于10MB的测试用文件，用于验证上传、下载功能是否正常
• 若需配置自定义域名访问，需提前准备好已备案的解析域名

三、操作步骤

1. 登录Cloudreve管理员后台，在左侧菜单栏找到「存储策略」入口并点击进入，结果是进入存储策略管理页，可看到所有已配置的存储策略列表，支持新增、编辑、删除存储策略。

2. 点击页面右上角的「添加存储策略」按钮，在弹出的存储类型选择列表中，选中「S3 兼容存储」选项，结果是进入S3存储专属的配置表单页面，所有配置项均对应S3协议的标准参数。

3. 按照表单提示依次填写提前准备好的Endpoint、AccessKey、SecretKey、Bucket、Region等必填参数，注意需按照对象存储服务商的要求填写Endpoint的协议头（http/https），不要遗漏或多写后缀，结果是所有必填项均填写完成，无空值或明显格式错误。

4. 根据自身业务需求配置可选参数，包括文件存储路径规则、文件访问权限、直链有效期、文件大小限制等，例如搭建公共图床可设置公开读权限，搭建私有网盘可设置私有读写权限，结果是可选参数配置符合业务场景的实际需求。

5. 所有参数填写完成后，点击表单底部的「测试连接」按钮，Cloudreve会自动向对应存储桶发起连接测试和临时文件写入测试，结果是页面弹出「连接成功」的提示，代表所有参数填写正确、存储桶权限正常。

6. 测试通过后点击「保存」按钮完成存储策略创建，可在存储策略列表中看到刚添加的S3存储策略，可将其设置为全站默认存储策略，或分配给指定用户组使用，结果是对应用户组上传文件时，系统会自动将文件存入第三方对象存储中，不再占用Cloudreve服务器的本地存储空间。

7. 切换到普通用户账号，上传提前准备好的测试文件，复制文件的访问链接在无痕浏览器中打开，同时测试文件下载、删除、分享等操作，结果是所有操作均正常完成，文件访问速度符合预期，代表接入配置正式生效。

四、常见错误

• Endpoint填写错误：常见问题为漏加http/https协议头、误填存储桶单独的访问域名而非服务商提供的通用Endpoint、多写了存储桶前缀，解决建议是核对对象存储服务商的官方S3接入文档，确保Endpoint的协议、域名、后缀完全与官方说明一致。
• AccessKey或SecretKey填错：常见问题为复制时多带了前后空格、使用了已过期的密钥、子账号密钥未分配对应存储桶的操作权限，解决建议是重新生成并复制密钥，确认密钥所属账号拥有存储桶的PutObject、GetObject、DeleteObject等最小必要权限。
• Bucket或Region不匹配：常见问题为存储桶名称拼写错误、大小写不符、存储桶创建在A区域却填写了B区域的Region代码，解决建议是进入对象存储服务的存储桶详情页，复制官方显示的Bucket名称和Region代码，手动填写时注意大小写区分。
• 权限不足导致上传失败：常见问题为存储桶设置了禁止公共写入、密钥权限范围不包含当前配置的存储桶、Cloudreve配置的文件访问权限与存储桶的权限策略冲突，解决建议是检查存储桶的访问控制策略，给密钥配置对应存储桶的全读写权限或最小必要操作权限。
• 上传成功但访问链接不可用：常见问题为存储桶未配置跨域规则导致Cloudreve无法读取文件、自定义访问域名未完成备案或解析、CDN加速配置未生效，解决建议是在对象存储后台配置允许Cloudreve站点域名的跨域请求，确认访问域名已完成工信部备案和DNS解析。

五、示例说明

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

| 配置项 | 填写说明 |

| --- | --- |

| Endpoint | 填写对应对象存储服务商提供的S3访问入口地址，需携带http/https协议头 |

| AccessKey | 填写对象存储账号生成的访问密钥ID，属于敏感信息请勿泄露给无关人员 |

| SecretKey | 填写与AccessKey对应的密钥凭证，请勿公开张贴或提交到公开代码仓库 |

| Bucket | 填写提前创建好的存储桶名称，注意大小写和拼写与官方显示完全一致 |

| Region | 填写存储桶所属区域的代码，可在对象存储服务商的存储桶信息页查询 |

| 存储路径 | 可填写自定义路径，比如cloudreve/userfiles/，所有上传文件会自动存储到该路径下 |

| 访问权限 | 可选私有读写、公开读等，根据业务场景选择，公开资源建议选公开读以降低访问成本 |

| 直链设置 | 开启后用户访问文件直接跳转至对象存储地址，不占用Cloudreve服务器带宽 |

六、更简单的方案

如果不想自己搭建MinIO等私有对象存储、不想额外维护服务器存储节点，也可以直接选择成熟的兼容S3协议的公有云对象存储服务，无需自己运维底层存储集群，开箱即用，还可按需扩容存储空间。如果你需要一个兼容S3协议、适合网盘系统存储源、图床、文件下载分发的对象存储服务，可以了解 七彩云对象存储，支持直接作为Cloudreve的存储源接入，不需要额外适配，配置流程和上面的通用步骤完全一致。

七、FAQ

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

不会自动迁移，原有本地存储的文件仍会保留在服务器本地的存储路径中，只有配置完成后新上传的文件才会存储到新接入的第三方对象存储中。如果需要迁移旧文件，可以手动导出后重新上传，或者使用Cloudreve官方提供的存储策略迁移工具进行批量操作。

Q2：Cloudreve可以同时接入多个不同的第三方对象存储作为存储源吗？

可以，Cloudreve支持添加多个不同的存储策略，每个存储策略可以对应不同厂商、不同区域的对象存储服务，你可以根据用户组、文件类型、文件大小等维度分配不同的存储策略，满足多场景的差异化存储需求。

Q3：接入第三方对象存储后，文件访问的流量是走Cloudreve服务器还是直接走对象存储的流量？

可以在配置存储策略时自行选择，如果开启了「直链模式」，用户访问文件时会直接跳转至对象存储的访问地址，不会占用Cloudreve服务器的带宽；如果关闭直链模式，文件会经过Cloudreve服务器中转后返回给用户，会占用Cloudreve服务器的带宽和性能。

Q4：配置完成后测试连接提示「签名不匹配」是什么原因？

签名不匹配通常是因为Endpoint、Region、AccessKey、SecretKey四个核心参数中某一个填写错误，或者Cloudreve所在服务器的系统时间与标准时间偏差过大导致的，建议依次核对四个参数的正确性，同时确认Cloudreve服务器已开启网络时间同步，时间误差不超过15分钟。

八、总结

整体来看，Cloudreve接入第三方S3兼容对象存储的操作流程非常清晰，只需要提前准备好S3协议所需的核心参数，按照后台表单提示填写测试即可完成接入，全程不需要修改代码，没有开发经验的普通站长也可以快速上手。这种接入方式非常适合个人网盘搭建、网站附件存储、公共图床、资源下载站等多种场景，既可以降低自建存储的运维成本，也可以获得更高的文件访问稳定性和下载速度，是Cloudreve生产环境部署的主流存储方案。