Cloudreve怎么接入兼容S3的存储服务

一、结论

Cloudreve接入兼容S3的存储服务，核心是提前准备好S3服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心配置项，在Cloudreve后台的存储策略板块选择S3兼容类型，填写对应配置后测试连通性即可完成接入。全程无需修改代码，仅需后台可视化配置就能完成存储源替换，适配所有支持标准S3协议的对象存储服务。

二、准备工作

操作前需要提前准备好以下内容，避免中途停顿查找信息：

• 开通任意支持标准S3协议的对象存储服务的有效账号
• 在对象存储服务侧提前创建完成、权限配置符合业务需求的存储桶（Bucket），例如公开资源站需配置公共读权限，私密网盘需配置私有读写权限
• 对应存储桶的官方Endpoint访问地址、拥有该存储桶读写权限的AccessKey和SecretKey、存储桶对应的Region标识
• 已经搭建完成、可正常登录管理员后台的Cloudreve实例，建议选择V3.5及以上版本，对S3协议兼容性更好
• 几个小体积的测试文件，用于后续验证上传、预览、下载功能是否正常
• 若需自定义域名访问，需提前完成存储桶的域名绑定和备案配置

三、操作步骤

每一步操作均明确操作动作和预期结果，避免操作偏差：

1. 登录你使用的S3兼容对象存储服务的控制台，确认已创建的存储桶权限、名称符合业务要求，结果是存储桶状态正常，无权限或命名冲突问题。

2. 在对象存储控制台的存储桶配置页或密钥管理页，获取对应存储桶的Endpoint、AccessKey、SecretKey、Region信息，将所有信息统一记录在临时文档中，结果是核心配置信息完整，无遗漏项。

3. 登录Cloudreve站点的管理员后台，在左侧菜单栏找到「存储策略」选项，点击进入后选择「添加存储策略」，结果是进入存储策略类型选择页面。

4. 在存储策略类型列表中选择「S3 兼容」选项，结果是进入S3兼容存储的专属配置表单页面。

5. 按照表单提示依次填写提前记录的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息，同时可根据业务需要配置存储路径、单文件大小限制、直链有效期、自定义响应头等附加参数，结果是所有必填项均填写完成，无空字段。

6. 点击页面底部的「测试连接」按钮，等待系统自动验证配置有效性，结果是系统提示「连接测试成功」，若出现报错则按照提示内容修改对应配置项后重新测试。

7. 测试连接通过后保存存储策略，将该存储策略绑定到对应用户组或者特定存储目录，上传提前准备的测试文件，确认可以正常上传、预览、下载，结果是整个接入流程完成，Cloudreve已正式使用该S3存储作为存储源。

四、常见错误

整理了实操过程中高频出现的错误及对应解决建议：

• Endpoint填写错误：常见问题是自行将Bucket名称拼接在Endpoint前缀中，或者写错协议类型（如应填https误填为http），解决建议是直接复制对象存储服务官方提供的Endpoint完整地址，不要自行修改拼接，同时确认协议和服务侧要求一致。
• AccessKey或SecretKey填写错误：多为复制时多带了首尾空格，或者使用了已过期、被禁用的密钥，解决建议是重新复制密钥信息，确认密钥的有效期和权限包含对应存储桶的读写权限，尽量使用仅授权该存储桶访问的子账号密钥，不要使用根账号全权限密钥降低安全风险。
• Bucket名称不一致：填写的Bucket名称和对象存储侧实际创建的名称大小写、拼写有出入，或者存储桶不属于当前密钥对应的账号，解决建议是直接复制对象存储控制台显示的Bucket全称，同时确认该密钥有权限访问对应存储桶。
• Region填写不匹配：多数S3兼容服务的Region有固定标识，自行编造会导致连接失败，解决建议是直接复制对象存储服务提供的对应存储桶所属区域标识，部分服务无强制要求的可留空或填默认值。
• 权限不足导致上传失败：存储桶权限设置为私有，但Cloudreve侧未开启签名配置，或者密钥缺少对应操作权限，解决建议是先将存储桶临时设为公共读测试上传是否正常，确认配置无误后再调整私有权限下的签名规则，同时确认密钥拥有PutObject、GetObject等必要操作权限。
• 上传成功但访问链接不可用：常见原因为存储桶未开启公网访问权限，或者Cloudreve侧配置的自定义域名和存储桶绑定的域名不一致，解决建议是先在对象存储控制台直接上传文件测试公网访问是否正常，再检查Cloudreve侧的域名配置和存储桶绑定域名是否匹配。

五、示例说明

以下是Cloudreve S3兼容存储的通用配置示例，所有字段均按实际获取的信息填写即可，无需额外修改：

| 配置项 | 填写说明 |

| --- | --- |

| Endpoint | 填写S3兼容对象存储服务官方提供的对应存储桶访问地址，无需自行拼接Bucket名称 |

| AccessKey | 填写对象存储服务分配的、拥有对应存储桶读写权限的访问密钥ID |

| SecretKey | 填写和上述AccessKey配对的访问密钥Secret |

| Bucket | 填写提前创建的存储桶完整名称，大小写、拼写和控制台显示保持一致 |

| Region | 填写对象存储服务提供的对应存储桶所属区域标识，部分服务无强制要求可留空 |

| 存储路径 | 可选配置，填写文件在存储桶中存放的目录前缀，留空则默认存储在桶根目录 |

| 直链有效期 | 私有存储桶可配置直链有效时长，公开存储桶可设置为永久有效 |

六、更简单的方案

如果不想自己搭建MinIO这类自建S3存储服务，也不想花精力维护服务器、处理存储扩容、流量高峰的带宽调度，可以直接选择成熟的兼容S3协议的云对象存储服务，不用自行维护底层存储架构，开箱即可使用。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统接入、图床、资源站存储和不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，配置流程和上述通用步骤完全一致，无需额外适配，可大幅降低自建存储的运维成本。

七、FAQ

Q1：Cloudreve接入S3存储后，之前存在本地的文件可以迁移到S3存储里吗？

可以，Cloudreve后台自带存储策略迁移工具，你可以在存储策略页面新建迁移任务，选择原有存储策略和目标S3存储策略，即可将原有文件批量迁移到S3存储中，迁移过程不会影响现有用户的文件访问。

Q2：接入S3存储后，用户下载文件是走Cloudreve服务器的流量还是直接走对象存储的流量？

可以自行配置，若开启Cloudreve的中转下载功能，就会消耗Cloudreve服务器的带宽；若开启直链下载功能，用户会直接访问对象存储的地址下载文件，不会消耗Cloudreve服务器的带宽，适合大文件分发场景。

Q3：不同版本的Cloudreve对S3协议的兼容性有区别吗？

有区别，建议使用V3.5及以上版本的Cloudreve，对S3兼容存储的适配更完善，支持更多S3原生特性，低版本可能会出现部分配置项不支持、连接失败的问题，升级到最新稳定版即可解决。

Q4：接入S3存储后可以自定义文件的缓存规则吗？

可以，你既可以在对象存储服务侧配置存储桶的全局缓存过期时间，也可以在Cloudreve的存储策略配置中设置自定义HTTP响应头，针对不同类型的文件配置差异化的缓存规则，提高用户访问速度。

八、总结

Cloudreve接入兼容S3的存储服务整体流程清晰，仅需提前准备好S3服务的核心配置项，在Cloudreve后台完成可视化配置即可，全程无需修改代码，适合站长、开发者快速替换网盘系统的存储源，降低本地存储的扩容压力和运维成本。这种接入方式适配自建网盘、资源分享站、个人文件存储、团队协作网盘等多种场景，既可以选择自建S3存储服务满足个性化的部署需求，也可以选择商用云对象存储服务降低运维负担，用户可以根据自身的业务规模、预算和技术能力灵活选择适配的方案。