一、结论
Cloudreve配置S3存储源的核心操作思路为：先准备好S3兼容对象存储的Endpoint、AccessKey、SecretKey、存储桶（Bucket）、地域（Region）等接入信息，再在Cloudreve后台的存储策略中选择S3兼容存储类型填写参数，测试连通并验证上传下载正常后，即可作为网盘的底层存储使用。
二、准备工作
开始配置前，请确认你已经准备好以下内容，避免配置中途反复切换控制台查找信息：
- 已部署完成、可正常访问的Cloudreve站点，且拥有站点管理员后台权限；
- 可用的S3兼容对象存储服务（可以是自建的MinIO，也可以是云服务商提供的标准S3服务）；
- 对象存储中提前创建好的、专用于Cloudreve存储的存储桶（Bucket）；
- S3服务专属的接入地址（Endpoint）、访问密钥对（AccessKey ID与SecretKey，简称AK/SK）、存储桶所属地域（Region，部分私有部署S3服务无强制要求）；
- 用于测试的小体积文件，例如图片、文本文档，方便快速验证上传、预览、下载全链路；
- 提前确认AK对应的账号拥有目标存储桶的文件上传、读取、删除等必要权限，避免后续出现权限报错。
三、操作步骤
1. 进入Cloudreve存储策略新增页
做什么：使用管理员账号登录Cloudreve站点，在后台管理菜单中找到“存储策略”入口，选择新增存储策略。
结果：进入存储类型选择界面，可看到本地存储、S3兼容存储等多种可选存储类型。
2. 选择S3兼容存储类型
做什么：在存储类型列表中，选中S3协议对应的选项（不同版本命名略有差异，通常标注为“S3兼容存储”“Amazon S3”），确认进入参数配置页。
结果：打开S3存储源的配置表单，包含密钥、服务地址、存储桶等必填项和若干高级可选项。
3. 填写核心接入参数
做什么：将提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region依次填入对应输入框，填写时注意区分大小写、不要携带首尾空格；若有Path Style寻址、文件路径前缀、自定义域名等可选配置，可根据使用的S3服务要求和业务需求调整，无特殊需求可先保留默认设置，方便排查问题。
结果：所有必填参数填写完成，基础配置符合S3服务的接入要求。
4. 保存配置并测试连通性
做什么：确认参数无误后保存配置，若当前Cloudreve版本自带连接测试功能，点击测试按钮检测与S3服务的连通和鉴权状态；无测试功能可直接进入下一步。
结果：收到连接成功提示，或无参数格式类报错，说明基础网络和鉴权信息正常。
5. 配置存储策略使用规则
做什么：在存储策略的规则设置页，配置可使用该存储的用户组、单文件大小上限、允许上传的文件类型、是否生成直链等规则，按需将该策略设置为默认上传存储策略。
结果：普通用户上传文件时会自动路由到该S3存储源，上传行为符合预设的管理规则。
6. 全链路功能测试
做什么：使用普通用户账号或退出管理员账号，上传提前准备的测试文件，上传完成后依次测试预览、下载、分享功能，同时可登录对象存储控制台，确认文件已存入指定的存储桶路径。
结果：文件上传、预览、下载、分享均正常，对象存储侧可查到对应文件，说明存储源对接生效。
7. 正式上线使用
做什么：测试无问题后，可根据业务需求补充配置跨域规则、CDN加速、自定义域名等配套能力，逐步将上传流量切换到S3存储源。
结果：Cloudreve底层存储对接完成，文件不再占用本地服务器磁盘空间，可正式承载网盘业务。
四、常见错误
- Endpoint填写错误：比如误填了对象存储的控制台管理地址、自行拼接了多余的路径后缀、漏写HTTP/HTTPS协议，通常会报连接超时、无法定位服务的错误。解决建议：直接复制对象存储服务商官方提供的S3专属Endpoint，填写后检查首尾是否有空格，同时确认Cloudreve所在服务器可正常访问该地址。
- AccessKey或SecretKey填写错误：复制时带了空格、混用了不同账号的密钥、密钥被禁用或删除，会返回403鉴权失败报错。解决建议：重新到对象存储控制台复制完整密钥对，检查填写格式，确认密钥处于启用状态，且没有额外的IP限制、操作范围限制。
- Bucket名称或Region不匹配：填错存储桶名称、地域选择与实际部署区域不符，可能出现连接失败或上传后找不到文件的问题。解决建议：到存储桶详情页核对完整名称和所属地域，严格按照服务商给出的信息填写，不要随意选择默认地域。
- 权限不足导致操作失败：即使密钥正确，若AK对应的角色没有绑定目标存储桶的上传、读取、删除权限，也会出现操作被拦截的问题。解决建议：检查对象存储侧的访问权限策略，给当前密钥授予对应存储桶的必要操作权限，生产环境遵循最小权限原则，不要使用全局全权限的密钥。
- 上传成功但访问链接不可用：通常是存储桶未开放对应访问权限、没有配置公开访问域名，或者Cloudreve内的域名配置与实际规则不符导致。解决建议：需要匿名直链的场景可按需配置存储桶公共读权限或绑定CDN、自定义域名，再到Cloudreve存储策略中更新对应访问域名。
- 寻址方式不兼容：自建MinIO等私有S3服务大多需要开启Path Style寻址，若保持公有云默认的虚拟主机寻址模式，可能出现连接失败。解决建议：根据S3服务商的说明调整寻址方式选项，私有部署存储优先尝试开启Path Style。
五、示例说明
以下为通用配置参考，所有参数请替换为你自己的S3服务信息，不要直接复制使用：
| 配置项 | 填写说明 |
| --- | --- |
| 存储类型 | 选择S3兼容存储 / Amazon S3（根据Cloudreve版本选项调整） |
| Endpoint | 填写对象存储服务商提供的S3专属访问地址，需包含HTTP/HTTPS协议头 |
| AccessKey ID | 填写在对象存储控制台创建的访问密钥ID |
| SecretAccessKey | 填写和AccessKey ID配对的私有访问密钥 |
| Bucket名称 | 填写提前创建好的、用于Cloudreve存储的存储桶全称 |
| Region | 填写存储桶所属的地域标识，部分私有部署S3服务可按要求留空 |
| 寻址方式 | 可选，公有云S3一般用默认虚拟主机寻址，自建MinIO通常需要开启Path Style模式 |
| 自定义访问域名 | 可选，绑定了CDN或自定义域名时填写，未配置则保留默认 |
| 路径前缀 | 可选，若希望所有Cloudreve文件都存在存储桶指定目录下可填写，如cloudreve/ |
六、更简单的方案
如果不想自行部署维护MinIO等私有S3服务，也不想占用云服务器的本地磁盘空间、自行处理硬盘扩容、故障备份、带宽瓶颈等问题，可以直接选择兼容标准S3协议的公有云对象存储服务，开箱即用，运维成本更低。
如果你需要一个兼容S3协议、适合作为Cloudreve这类网盘系统存储源，同时支持图床搭建、程序附件存储、大文件下载分发的对象存储服务，可以了解 七彩云对象存储，它支持标准S3接入，也适配不限流量下载分发、低成本文件承载的项目场景。
选择这类服务时，只需要在控制台创建存储桶、获取AK/SK和接入地址，就可以直接按照前文的步骤配置到Cloudreve中，不需要自行维护存储服务的可用性。
七、FAQ
Q1：配置S3存储源后，Cloudreve之前存在本地的文件会自动转移到对象存储吗？
A：不会自动迁移。新增的S3存储策略仅对配置生效后新上传的文件生效，历史本地文件仍会保留在服务器原路径下。如果需要迁移历史文件，可先将本地文件按原有目录结构上传到S3存储桶，再通过数据库批量更新文件路径记录，也可以使用对应版本的第三方迁移脚本辅助操作，迁移前务必备份全站数据和文件，避免数据丢失。
Q2：所有参数确认填写正确，但Cloudreve提示S3连接失败怎么办？
A：先按优先级排查：第一检查网络连通性，Cloudreve所在服务器的防火墙、安全组是否拦截了到Endpoint的出站请求，自建S3服务还要确认服务端口开放、运行状态正常；第二检查参数格式，确认密钥、Bucket名称没有多余空格、大小写一致；第三检查密钥权限，确认AK未被禁用，且拥有目标存储桶的操作权限。
Q3：对接S3后，用户分享的文件下载速度取决于什么？需要开公共读权限吗？
A：下载速度取决于S3服务本身的带宽、用户到服务节点的网络质量，如果绑定了CDN加速则取决于CDN节点的调度效果。权限方面，如果需要生成未登录用户可直接访问的分享链接，可按需开启存储桶对应路径的公共读权限；如果仅对注册用户开放访问，保持存储桶私有即可，由Cloudreve负责鉴权后生成临时访问链接，安全性更高，不建议开启存储桶的公共写权限。
Q4：同一个Cloudreve站点可以同时添加多个S3存储源吗？
A：大部分较新版本的Cloudreve支持添加多个存储策略，你可以配置多个不同的S3存储源，针对不同用户组、不同文件类型分配不同的存储策略，比如将图片文件分配到专门的图床存储桶，大文件分配到下载分发专用的存储桶，灵活适配不同业务需求。
八、总结
Cloudreve对接S3存储源的核心流程可以概括为“准备资源-后台配置-测试验证”三步：提前创建好存储桶并获取Endpoint、AK/SK、Region等接入信息，在Cloudreve后台新增S3兼容存储策略并填写对应参数，最后通过上传、预览、下载测试确认全链路正常即可完成配置。
这种方案适合需要扩容网盘存储空间、降低本地服务器磁盘占用、实现文件分布式存储或者多渠道下载分发的站长、开发者和项目方使用，既可以搭配自建的私有S3存储部署，也可以选择成熟的公有云对象存储减少运维工作量，只要保证参数准确、权限匹配、网络连通，通常都能顺利完成对接。
想进一步了解这个项目？
访问官网查看产品能力、适用场景和最新服务信息。
访问官网