一、结论
Cloudreve网盘系统配置S3兼容对象存储作为默认存储源的核心思路，是先从对象存储服务商处获取完整的S3接入参数，再在Cloudreve管理后台添加S3类型的存储策略，验证连通后将其设置为默认优先级即可。配置过程通常需要准备Endpoint、AccessKey、SecretKey、Bucket、Region五类核心信息。
二、准备工作
开始配置前建议提前整理好以下内容，避免配置过程中反复切换页面：
- 已部署完成、可正常登录管理后台的Cloudreve网盘系统，确认版本支持S3兼容存储驱动（多数正式版本默认内置，无需额外安装插件）
- 可用的对象存储服务账号，自建MinIO需提前完成服务部署，公有云对象存储需提前开通对应服务
- 提前创建好的存储桶（Bucket），确认存储桶状态正常、无欠费或锁定限制
- 完整的S3接入信息：Endpoint访问地址、AccessKey访问密钥ID、SecretKey私有访问密钥、Region地域标识
- 1-2个用于测试的小体积文件，比如图片、文本文档等
- 若使用自定义域名或CDN加速，需提前完成域名解析和备案（国内节点建议）
三、操作步骤
1. 进入存储策略新增页面
做什么：使用管理员账号登录Cloudreve后台，在左侧菜单栏找到“存储策略”板块，点击“新建存储策略”按钮。
结果：进入存储类型选择界面，能看到本地存储、S3兼容存储、其他云存储等多个可选驱动。
2. 选择S3兼容存储驱动
做什么：在存储类型列表中，选中标注为“S3兼容存储”“Amazon S3”的选项，确认进入下一步配置。
结果：打开S3存储参数配置表单，展示Endpoint、密钥、存储桶等核心配置项。
3. 填写核心接入参数
做什么：将提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息依次填入对应输入框，粘贴后注意检查首尾是否有多余空格、大小写是否一致，不要自行将存储桶名称拼接在Endpoint中。基础接入阶段可以先不配置自定义域名、CDN地址等高级选项。
结果：所有核心参数填写完成，表单没有提示格式类错误。
4. 配置存储规则与权限
做什么：根据网盘的文件管理需求，设置文件在存储桶中的根路径前缀，例如可以按用户ID、文件类型划分目录；同时设置该存储策略的可用范围，选择是所有用户可用还是仅指定用户组可用。
结果：文件上传后的存储路径规则、可使用该存储的用户权限配置完成。
5. 测试连通并保存策略
做什么：点击表单中的“测试连接”或“连通性验证”按钮，等待系统返回检测结果；如果提示连接成功，即可保存当前存储策略；如果报错，可根据错误提示对照常见问题核对参数。
结果：新的S3存储策略被成功添加到Cloudreve的存储策略列表中。
6. 设置为默认存储源
做什么：回到存储策略列表，找到刚添加的S3存储策略，将其优先级调整到最高，或直接点击“设为默认”按钮。
结果：后续用户上传文件时，系统会默认选择该对象存储作为文件存放位置，无需手动切换。
7. 全链路功能验证
做什么：切换到普通用户账号，上传一张图片或小体积文档，上传完成后依次测试在线预览、下载、删除功能；也可以登录对象存储控制台，查看对应路径下是否生成了目标文件。
结果：确认上传、存储、访问、删除全流程正常，默认存储源配置生效。
8. 配置分发加速
做什么：如果有自定义域名或CDN加速需求，可在存储策略的“访问域名”选项中填写已经完成解析的域名，再到对象存储控制台配置对应的CORS跨域规则和回源规则。
结果：用户访问文件时将走自定义域名或CDN链路，下载速度和稳定性进一步提升。
四、常见错误
1. Endpoint填写错误
常见问题包括误将存储桶名拼接在Endpoint中、多写或少写HTTP/HTTPS前缀、公网部署的Cloudreve误用内网Endpoint地址。解决建议：直接复制对象存储服务商官方给出的完整Endpoint地址，对照Cloudreve的字段提示核对格式，配置前可以先在Cloudreve所在服务器上测试Endpoint的网络连通性，排除网络不通的问题。
2. 密钥填写错误或权限不足
常见问题包括AccessKey和SecretKey填写顺序颠倒、复制时带入首尾空格，或使用的密钥没有目标存储桶的读写权限。解决建议：重新到对象存储控制台复制密钥，粘贴后检查内容是否完整；如果使用子账号密钥，需要提前给子账号授予目标存储桶的文件读写、目录列举权限，避免因权限不足导致上传失败。
3. 存储桶或地域信息不匹配
常见问题包括Bucket名称写错大小写、误选了其他账号下的存储桶，Region参数和存储桶实际所在地域不一致。解决建议：登录对象存储控制台进入存储桶详情页，核对完整桶名和地域标识，严格按照服务商给出的标准Region代码填写，不要自行拼写地域名称。
4. 上传成功但无法预览或下载
通常由跨域配置错误、存储桶权限不匹配导致：如果存储桶是私有读权限，但Cloudreve未开启签名URL，会导致文件无法匿名访问；如果使用了自定义域名但未配置CORS规则，会出现跨域拦截。解决建议：先确认存储桶的访问权限，私有读桶需在Cloudreve中开启签名URL选项；使用自定义域名时，要在对象存储侧添加Cloudreve域名到CORS允许列表中。
5. 大文件上传频繁失败
一般是分片上传配置不当、超时时间过短或存储桶配额不足导致。解决建议：先确认对象存储服务支持的单文件大小上限，在Cloudreve的S3配置中开启分片上传功能，根据服务器和对象存储之间的网络情况适当调大超时时间，同时检查存储桶的容量配额是否充足。
6. 设为默认后文件仍上传到本地
通常是存储策略优先级或用户组权限配置问题。解决建议：回到存储策略列表，确认S3存储策略的优先级高于本地存储策略；再检查对应用户组的权限设置，取消用户组强制绑定本地存储的规则，刷新页面后重新上传测试。
五、示例说明
以下为通用配置参考，不同版本Cloudreve的字段名称可能略有差异，以实际页面显示为准，请勿填写来源不明的公开密钥或测试地址：
| 配置项 | 填写说明 |
| --- | --- |
| 存储驱动类型 | 选择S3兼容存储 / Amazon S3 |
| Endpoint | 填写对象存储服务商提供的完整S3访问地址，不要自行拼接存储桶名称 |
| AccessKey | 填写账号或子账号的访问密钥ID |
| SecretKey | 填写与AccessKey对应的私有密钥，注意妥善保管避免外泄 |
| Bucket | 填写提前创建好的存储桶完整名称，注意区分大小写 |
| Region | 填写存储桶实际所在地域的标准标识，以服务商提供的信息为准 |
| 根路径 | 可选，填写文件在桶内的存放前缀，例如 cloudreve/files/ |
| 访问域名 | 可选，填写自定义CDN域名或桶访问域名，不填则使用默认Endpoint访问 |
六、更简单的方案
如果不想自行部署MinIO等自建对象存储服务，也不想承担服务器磁盘维护、扩容、数据备份和带宽扩容的成本，可以直接选择兼容标准S3协议的公有云对象存储服务，开通后即可获取接入参数，无需维护底层硬件。
如果你需要一个兼容S3协议、适合作为Cloudreve这类网盘系统存储源、支持文件直链和不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，它同样适用于图床、网站附件存储、大文件分发、AI数据存储等场景，接入流程完全遵循标准S3配置逻辑。
七、FAQ
所有兼容S3协议的对象存储都能接入Cloudreve吗？
只要完整支持标准S3协议的上传、下载、文件列举等基础接口，基本都可以通过Cloudreve内置的S3兼容存储驱动接入。部分经过深度定制、裁剪了标准接口的存储服务可能出现兼容问题，正式接入前可以先使用测试密钥验证连通性和文件上传下载功能。
配置为默认存储源后，原本地存储的文件会自动迁移吗？
不会。新设置的默认存储策略仅对配置生效后新上传的文件生效，历史本地文件仍会保留在Cloudreve服务器的本地磁盘中。如果需要迁移历史文件，可以使用Cloudreve官方的文件迁移插件，也可以先将本地文件批量同步到对象存储，再通过批量修改路径的方式完成切换。
接入时用主账号密钥还是子账号密钥更合适？
优先建议使用子账号密钥。可以在对象存储控制台创建仅拥有目标存储桶读写、列举权限的子账号，将子账号的AccessKey和SecretKey填入Cloudreve，即使密钥意外泄露，也可以随时禁用子账号，不会影响账号下的其他存储资源，安全性更高。
对象存储作为存储源，会占用Cloudreve服务器的带宽吗？
上传环节如果是服务端中转模式，会短暂占用服务器的上行带宽；如果开启了客户端直传，文件会直接从用户端上传到对象存储，基本不占用服务器带宽。下载环节如果直接使用对象存储默认地址或CDN域名，文件流量直接由对象存储或CDN承载，不会占用Cloudreve服务器的带宽，更适合大文件分发场景。
可以同时配置多个对象存储存储策略吗？
可以。Cloudreve支持添加多个不同服务商、不同存储桶的S3存储策略，你可以根据用户组、文件类型分配不同的存储位置，也可以调整多个策略的优先级，系统会按照优先级顺序自动选择可用的存储源。
八、总结
Cloudreve对接对象存储作为默认存储源的操作门槛并不高，核心可以归纳为准备接入参数、添加S3存储策略、验证连通性、设置默认优先级、全链路测试五个环节，多数接入失败都是参数填写错误或权限配置不当导致的，对照服务商的接入说明逐一核对即可解决。
这种存储方案适合服务器磁盘空间不足、需要降低带宽压力、有大文件分发需求、需要多服务共享文件的站长和开发者使用，搭配CDN还可以进一步提升不同地区用户的访问速度，同时减少本地磁盘损坏带来的数据丢失风险。
想进一步了解这个项目？
访问官网查看产品能力、适用场景和最新服务信息。
访问官网