Cloudreve对象存储挂载配置详细教程

一、结论

Cloudreve挂载S3兼容对象存储的核心操作思路非常清晰，你只需要提前准备好对象存储服务的Endpoint、AccessKey、SecretKey、Bucket、Region等接入信息，在Cloudreve后台的存储策略中选择S3兼容类型填写对应参数，测试连通后分配权限即可完成配置，全程不需要修改程序代码，普通站长和开发者都可以快速上手。

二、准备工作

操作前需要提前准备好以下内容，避免配置过程中来回切换页面耽误时间：

• 已经部署完成、可以正常访问的Cloudreve站点，以及站点的管理员账号权限
• 任意兼容S3协议的对象存储服务的正常可用账号
• 提前在对象存储服务中创建完成的存储桶（Bucket），可根据业务需求提前设置好私有/公开读写权限
• 对象存储服务官方提供的Endpoint地址、AccessKey、SecretKey、Region信息，可从对象存储控制台的密钥管理或API接入页面获取
• 若需要使用自定义域名访问存储资源，需提前准备好已备案的域名，并完成基础解析配置
• 1-2个测试用的小文件，用于配置完成后验证上传、访问功能是否正常

三、操作步骤

每一步操作都有明确的动作和预期结果，按照流程操作即可避免出错：

1. 登录Cloudreve管理员后台，在左侧菜单栏找到「存储策略」选项，点击「新增存储策略」按钮，在弹出的存储类型选择框中选中「S3 兼容」类型，确认后进入配置页面。预期结果：成功打开S3存储策略的专属配置表单，页面包含基础配置、S3协议配置、访问设置等多个配置模块。

2. 在基础配置模块填写自定义的存储策略名称（仅用于后台识别，可根据业务场景命名，比如“个人网盘存储”“资源站存储”等），按需设置该存储策略的总容量上限、单文件大小限制、禁止上传的文件后缀黑名单等规则，完成后保存基础配置部分。预期结果：基础规则设置完成，后续上传到该存储策略的所有文件都会自动遵守这些限制规则。

3. 下拉页面到S3协议配置模块，依次填写提前准备好的Endpoint、AccessKey、SecretKey、Bucket名称、Region信息，若你使用的对象存储服务没有明确要求填写Region，可按照服务方文档说明填写默认值或留空，同时根据需求勾选是否启用HTTPS、是否使用路径式访问等选项。预期结果：S3接入的核心参数填写完成，没有遗漏必填项。

4. 进入路径映射和访问设置模块，按需设置文件在存储桶中的存储路径前缀（比如设置为cloudreve/files/，则所有上传的文件都会存到存储桶的对应目录下，留空则直接存在存储桶根目录），根据存储桶的权限设置选择是否开启签名URL、设置签名有效期，若使用自定义域名可在对应栏填写绑定的域名地址。预期结果：文件存储规则和访问规则设置完成，符合业务的实际使用需求。

5. 点击页面底部的「测试连接」按钮，系统会自动向配置的存储桶上传一个临时测试文件并尝试读取，如果页面提示“连接成功”则说明参数填写完全正确；如果提示连接失败，可根据报错提示核对对应配置项。预期结果：连通性验证通过，确认填写的所有S3接入参数有效。

6. 保存整个存储策略配置，然后进入「用户组」或「用户管理」页面，给需要使用该存储策略的用户/用户组分配该存储策略的使用权限，也可以设置为默认存储策略。预期结果：对应权限的用户已经可以在上传文件时选择该存储策略，管理员也可以将该策略设置为用户默认存储位置。

7. 切换到普通用户账号登录Cloudreve前台，上传提前准备好的测试文件，复制文件的访问链接到无痕浏览器窗口打开，确认可以正常访问或下载，没有权限报错或资源不存在的提示。预期结果：整个挂载配置流程全部完成，存储策略可以正式投入使用。

四、常见错误

以下是配置过程中高频出现的错误及对应的解决方法，遇到问题可以优先核对：

• Endpoint填写错误：常见问题包括漏写http/https前缀、多写了存储桶名称后缀、拼写错误，或者填成了存储桶的访问地址而非服务统一的Endpoint。解决建议：直接从对象存储服务的官方S3接入文档中复制Endpoint地址，不要手动拼写，确认地址没有多余的后缀字符。
• AccessKey或SecretKey填错：常见问题包括复制时多带了前后空格、大小写错误，或者使用了已经过期、被禁用的密钥。解决建议：在对象存储控制台重新生成新的AccessKey对，复制时注意不要选中多余的空格或换行符，确认密钥处于启用状态。
• Bucket名称不一致：常见问题包括填写的存储桶名称和实际创建的名称拼写、大小写不一致，或者存储桶还未创建就提前填写了名称。解决建议：回到对象存储控制台核对存储桶的准确名称，确认存储桶已经在对应区域创建成功，没有被删除或冻结。
• Region填写不匹配：常见问题包括填写的地域编码和存储桶所在的实际地域不一致，或者不需要填写Region的服务填了错误的值。解决建议：查看对象存储服务的S3接入说明，确认对应存储桶的Region编码，若服务方没有明确要求，可填写auto或留空。
• 权限不足导致上传失败：常见问题包括AccessKey没有分配对应存储桶的读写权限，或者存储桶设置了禁止外部写入的访问控制策略。解决建议：检查AccessKey的权限策略，确认已经开通了s3:PutObject「s3:GetObject`等必要权限，同时调整存储桶的访问控制规则允许写入。
• 上传成功但访问链接不可用：常见问题包括自定义域名解析未生效、CDN还在部署中，或者私有存储桶没有开启签名URL功能。解决建议：公共读文件需要确认存储桶的公开访问权限已经开启，域名解析已经生效；私有文件需要确认Cloudreve已经开启了签名URL功能，签名有效期设置合理。

五、示例说明

以下是通用的S3存储策略配置示例，所有字段都按照实际获取的信息填写即可，不需要刻意和示例保持一致：

| 配置项 | 填写说明 |

| --- | --- |

| 存储策略名称 | 自定义，例如「团队共享网盘存储」 |

| Endpoint | 填写对象存储服务官方提供的S3接入地址 |

| AccessKey | 填写对象存储控制台生成的访问密钥ID |

| SecretKey | 填写与AccessKey对应的密钥字符串 |

| Bucket | 填写提前创建好的存储桶的准确名称 |

| Region | 按照对象存储服务要求填写对应地域编码，无要求可填auto |

| 存储路径前缀 | 自定义，例如cloudreve/user_files/，留空则存储在存储桶根目录 |

| 签名URL有效期 | 私有文件建议设置为1800秒（30分钟），公共读文件可关闭签名 |

| 是否启用HTTPS | 建议开启，避免访问时出现安全提示 |

六、更简单的方案

如果你不想自己搭建MinIO等自建对象存储服务、不想额外维护服务器的存储资源，也不想处理自建存储的带宽扩容、数据灾备、日常运维等问题，可以直接选择市面上成熟的兼容S3协议的云对象存储服务，开箱即用，不需要投入额外的运维成本。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统作为存储源、同时支持不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，它也支持图床、资源站、下载站等多种场景的存储需求，接入门槛低。

七、FAQ

Q：Cloudreve开源版可以挂载S3兼容的对象存储吗？

A：可以，无论是开源版还是商业版的Cloudreve，都原生支持S3兼容存储策略的添加，操作流程完全一致，不需要额外安装插件或修改代码。

Q：挂载新的对象存储后，之前上传到Cloudreve本地存储的文件可以迁移到对象存储里吗？

A：可以，Cloudreve后台自带存储策略迁移工具，你可以在存储策略菜单中找到迁移功能，选择把本地存储的文件批量迁移到新的对象存储策略中，迁移完成后用户的原有访问链接不会发生变化，不需要额外调整。

Q：挂载多个对象存储策略会不会影响用户的使用体验？

A：不会，你可以给不同的用户组分配不同的存储策略，用户在上传文件的时候也可以自主选择要使用的存储位置，整个过程对用户来说是透明的，不需要额外的操作。

Q：后续如果要更换其他S3兼容的对象存储服务，需要重新配置所有内容吗？

A：不需要，只要新的对象存储服务兼容S3协议，只需要修改存储策略里的Endpoint、密钥、Bucket等参数，把旧存储桶里的文件全部同步到新的存储桶里，就可以无缝切换，用户的访问不会受到影响。

八、总结

整个Cloudreve挂载S3对象存储的流程非常简单，核心就是提前准备好S3接入凭证，在后台填写配置、测试连通、分配权限三个核心步骤，全程操作只需要10分钟左右，没有复杂的技术门槛。这种挂载方式非常适合个人搭建私人网盘、团队搭建内部文件共享系统、站长搭建资源分享站点等场景，相比本地存储，对象存储的扩展性更强、带宽成本更低、数据可靠性更高，也更适合大文件存储和分发的需求。如果后续业务规模扩大，也可以随时更换存储服务或者扩容存储容量，不需要调整Cloudreve的核心配置，灵活性很高。