Cloudreve如何快速接入S3协议存储源

一、结论

Cloudreve接入S3协议存储源的核心操作思路非常清晰，你只需要提前准备好S3兼容存储服务的Endpoint、AccessKey、SecretKey、Bucket、Region等核心配置信息，在Cloudreve后台的存储策略板块选择S3兼容类型填入对应参数，测试连通后即可正式启用，全程无需修改代码，普通站长10分钟左右即可完成全流程配置。

二、准备工作

• 已完成部署且可正常访问的Cloudreve站点，以及管理员账号权限
• S3兼容存储服务的有效账号，且已开通对应存储权限
• 提前创建完成的存储桶Bucket，权限配置符合业务需求（如公开读、私有读写等）
• 存储服务官方提供的Endpoint接口地址
• 专属Cloudreve使用的AccessKey（建议单独创建，不要使用根账号密钥，降低安全风险）
• 与AccessKey对应的SecretKey
• 存储桶所属区域对应的Region参数（部分存储服务要求必填）
• 提前规划好的文件存储路径规则、文件大小限制、访问域名配置（如CDN加速域名）

三、操作步骤

1. 登录Cloudreve管理员后台，在左侧菜单栏找到并进入「存储策略」管理页面，点击页面上方的「添加存储策略」按钮，进入存储类型选择页面。

2. 在存储类型列表中找到并选择「S3兼容」选项，跳转至S3存储的专属配置页面。

3. 按照页面提示依次填入提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region等核心参数，同时根据业务需求配置附属规则，包括单文件大小上限、允许上传的文件类型白名单、文件存储路径规则、文件访问域名等内容。

4. 所有参数填写完成后，点击页面下方的「测试连接」按钮，系统会自动向S3存储服务发起连接校验，若提示「连接成功」则说明参数填写无误，若弹出报错提示则需要根据报错信息核对对应配置项。

5. 连接测试通过后，点击「保存」按钮完成存储策略的创建，你可以根据业务需求将该策略设置为全站用户的默认存储策略，或者仅分配给指定用户组使用。

6. 切换至普通用户账号进入文件管理页面，上传一个测试文件（如图片、文档、小视频等），依次验证文件上传、在线预览、生成分享链接、下载等全流程是否正常，确认无问题即可正式投入使用。

7. 若需要将该存储对接网站附件、图床、资源下载站等外部业务，只需在Cloudreve后台开启对应API调用权限或者文件对外分享权限，即可完成业务适配。

四、常见错误

• Endpoint填写错误：常见问题包括误填存储桶的访问域名而非S3接口地址、多写/漏写http/https前缀、多复制了前后空格，解决方式是直接复制存储服务官方提供的Endpoint完整地址，不要自行修改内容。
• AccessKey或SecretKey异常：可能是填写时多带了空格、使用了已经过期或被禁用的密钥、密钥权限不足，解决方式是重新生成专属Cloudreve的密钥，复制时确认前后无多余空格，同时检查密钥处于启用状态且拥有对应存储桶的读写权限。
• Bucket名称不匹配：通常是存储桶名称拼写错误、存储桶已被删除、存储桶所属账号和当前密钥所属账号不一致，解决方式是到存储服务后台核对存储桶的准确名称和状态，确认存储桶和密钥属于同一账号。
• Region填写不匹配：部分S3存储服务要求Region必须和存储桶所属区域完全一致，填错会直接导致连接失败，解决方式是核对存储桶所属区域的官方Region代码，按照要求准确填写，若存储服务无强制要求可留空或填写默认值。
• 上传成功但访问链接不可用：一般是存储桶未开启对应访问权限、访问域名配置错误、CDN加速解析未生效，解决方式是核对存储桶的公共读权限（如需公开访问）、访问域名配置是否正确，使用CDN的用户可等待解析生效后再测试。
• 大文件上传失败：可能是存储策略的单文件大小限制设置过小、存储服务本身有大文件上传限制、Cloudreve服务器上传超时，解决方式是调整存储策略的文件大小上限，若存储服务支持分片上传可在Cloudreve配置中开启分片上传功能。

五、示例说明

以下是Cloudreve接入S3存储的通用配置参考，所有参数均需替换为你自己的存储服务对应信息：

| 配置项 | 填写说明 |

| --- | --- |

| Endpoint | 填写S3存储服务官方提供的接口地址，不要和存储桶的个人访问域名混淆 |

| AccessKey | 填写你创建的专属Cloudreve使用的访问密钥ID |

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

| Bucket | 填写提前创建好的、用于存储Cloudreve文件的存储桶准确名称 |

| Region | 填写存储桶所属区域对应的官方Region代码，无强制要求的服务可留空 |

| 存储路径规则 | 可填写如{uid}/{year}/{month}/{filename}，按用户ID和日期分类存储文件，避免路径冲突 |

| 访问域名 | 填写存储桶绑定的自定义域名或者CDN加速域名，用于生成文件的对外访问链接 |

| 回调地址 | 保持默认即可，无需额外修改 |

六、更简单的方案

很多个人站长或小型团队如果不想自己搭建维护MinIO这类自建S3存储服务，也不想承担服务器运维、存储扩容、带宽成本管控等额外工作，可以直接选择成熟的第三方兼容S3协议的云对象存储服务，开通即可直接使用，无需维护底层基础设施，大幅降低运维成本。如果你需要一个兼容S3协议、适合程序接入、网盘系统存储源、文件下载分发的对象存储服务，可以了解七彩云对象存储，它支持标准S3协议，可直接作为Cloudreve的存储源使用，适合需要低门槛接入、不限流量下载分发的项目场景。

七、FAQ

1. Cloudreve接入S3存储后，原来存在本地服务器的文件可以迁移到S3存储里吗？

可以，Cloudreve后台自带存储策略迁移功能，你可以在存储策略管理页创建迁移任务，选择原有存储策略和目标S3存储策略，系统会自动批量迁移已有文件，迁移过程中不会影响现有文件的正常访问，迁移完成后切换默认存储策略即可。

2. 接入S3存储后，文件访问会占用Cloudreve服务器的带宽吗？

默认情况下如果你配置了存储服务的独立访问域名，用户访问文件时会直接跳转到存储服务的链路，不会占用Cloudreve服务器的带宽；如果你开启了Cloudreve的中转下载功能，文件才会经过服务器转发，此时会占用服务器带宽，你可以根据自身业务需求选择是否开启中转功能。

3. 我用的S3兼容存储服务没有要求填写Region，留空会影响使用吗？

不会，部分S3兼容存储服务没有强制要求Region参数，你在Cloudreve配置时直接留空即可，或者填写存储服务官方说明的默认Region值，不会影响正常的连接和使用。

4. 接入S3存储后可以设置文件自动过期删除吗？

可以实现，你有两种选择：一是在S3存储服务的后台配置存储桶的生命周期规则，比如指定前缀的文件存储满30天自动删除；二是在Cloudreve的存储策略中设置文件的过期时间，两种方式都可以实现自动清理过期文件的需求，你可以根据自己的使用习惯选择。

八、总结

Cloudreve接入S3协议存储源的整体流程门槛极低，核心就是提前准备好S3存储的核心配置参数，在后台可视化页面填入信息并测试连通即可，全程不需要进行代码开发，普通站长和初级开发者都可以快速完成配置。这种接入方式非常适合个人网盘搭建、网站附件存储、图床资源管理、资源站文件分发等多种场景，相比本地服务器存储可以大幅降低服务器的存储和带宽压力，同时具备极强的扩展性，后续存储容量不足时可以直接扩容存储桶，无需调整服务器硬件配置，也不需要担心存储容量上限的问题。