Cloudreve常用的几种存储源实际使用哪个性能更好

一、结论

Cloudreve常用存储源主要分为本地存储、自建MinIO、公有云S3兼容存储三类，实际性能通常为节点覆盖匹配用户群体的S3兼容存储最优，同区域自建MinIO次之，异地服务器本地存储性能表现最差。接入S3兼容类存储源时，通常需要提前准备好Endpoint、AccessKey、SecretKey、Bucket、Region等信息，再到Cloudreve管理后台对应配置页面填写并测试连接即可完成接入。

二、准备工作

• 已完成部署且可以正常访问的Cloudreve程序，版本需支持对应存储源的接入能力；
• 拥有管理员权限的Cloudreve账号，可访问存储策略配置页面；
• 若选择S3兼容类存储源，需提前准备对应服务的账号、存储桶（Bucket）、Endpoint地址、AccessKey、SecretKey、Region信息；
• 若选择本地存储，需确认服务器存储路径的读写权限充足，磁盘剩余空间符合业务需求；
• 若选择自建MinIO，需确认MinIO服务运行正常，公网带宽满足业务访问需求；
• 用于测试的1MB以内小文件、1GB以上大文件若干，用于验证上传下载性能和功能完整性。

三、操作步骤

1. 完成存储源性能测试选型：分别对备选的本地存储、自建MinIO、S3兼容存储三类存储源进行基础性能测试，测试内容包括小文件上传延迟、大文件下载速度、100并发访问成功率，结合自身用户群体的地域分布选择性能最优的存储源，测试完成后确定最终要接入的存储源类型。

2. 提取对应存储源的接入参数：如果选择S3兼容存储，到对应服务控制台提取Endpoint、AccessKey、SecretKey、Bucket、Region五组核心参数；如果选择本地存储，确认服务器上用于存储Cloudreve文件的绝对路径，确保路径权限开放给Cloudreve运行用户；如果选择自建MinIO，提取对应服务的接入地址、密钥、存储桶信息，结果是所有必填接入参数全部整理完成，无遗漏。

3. 进入Cloudreve存储策略配置页：登录Cloudreve管理员后台，在左侧菜单栏找到「存储策略」选项，点击「新建存储策略」按钮，在弹出的存储类型选择框中，根据之前确定的存储源类型选择对应选项，S3兼容类存储选择「S3兼容存储」（部分旧版本显示为Amazon S3），本地存储选择「本地」，自建MinIO也可选择S3兼容类型接入，结果是进入对应存储类型的专属配置页面。

4. 填写存储源配置信息：按照页面提示依次填写所有必填配置项，S3兼容类存储需依次填入Endpoint、AccessKey、SecretKey、Bucket、Region，同时可根据业务需求填写存储路径前缀、自定义访问域名、回调规则等可选配置；本地存储需填写存储绝对路径、访问URL前缀等信息，结果是所有必填配置项全部填写完成，无空项。

5. 测试存储源连接：填写完所有配置后不要直接保存，先点击页面下方的「测试连接」按钮，Cloudreve会自动向目标存储源上传测试文件、尝试访问和删除测试文件，验证连接可用性和权限配置是否正确，结果是页面提示「连接测试成功」，无报错信息。

6. 验证功能和性能：保存存储策略后，切换到普通用户账号，将测试用的小文件和大文件上传到对应存储策略的目录下，测试文件上传速度、在线预览、分享链接生成、下载速度等功能是否正常，同时验证大文件断点续传、多文件批量上传等特殊功能是否符合预期，结果是所有功能正常，性能满足业务需求。

7. 正式上线使用：如果需要将该存储源作为全站默认存储，回到存储策略列表页面，将该策略设置为默认存储策略，后续新用户上传的文件会自动存储到该存储源中；如果仅用于部分用户组，可在用户组配置中指定对应存储策略即可，结果是存储源正式投入业务使用。

四、常见错误

1. Endpoint填写错误：常见问题包括多写了Bucket前缀、使用了仅内网可访问的Endpoint地址、http/https协议填写错误，解决建议：直接复制存储服务商提供的官方公网Endpoint地址，确认协议类型与服务端配置一致，不要自行修改地址内容。

2. AccessKey或SecretKey填错：常见问题包括复制时带了多余的空格、使用了已经过期或被禁用的密钥、密钥权限配置不足，解决建议：到存储服务控制台重新生成新的读写权限密钥，复制时逐字符核对，确保没有多余字符，同时确认密钥分配了对应存储桶的全读写权限。

3. Bucket与Region不匹配：常见问题包括填写了不存在的Bucket名称、Bucket所属区域和填写的Region信息不一致，解决建议：到存储服务控制台核对Bucket的准确名称和所属区域标识，完全按照控制台显示的内容填写，不要自行编造区域代码。

4. 权限不足导致上传失败：常见问题包括存储桶设置了私有访问但未配置Cloudreve签名规则、跨域规则未配置导致前端上传请求被拦截，解决建议：按照Cloudreve后台提示的跨域规则，到存储桶控制台配置允许的请求来源、请求方法和请求头，私有存储桶需开启Cloudreve的签名访问功能。

5. 上传成功但访问链接不可用：常见问题包括存储桶未开启公网访问权限、自定义域名未完成解析和绑定、CDN加速配置未生效，解决建议：确认存储桶的访问权限符合业务需求，检查域名解析记录是否生效，CDN加速节点配置完成后等待10分钟再测试访问。

五、示例说明

以下为Cloudreve接入S3兼容存储的通用配置示例，无需填写真实信息：

• 存储类型：选择「S3兼容存储」（部分旧版本选择「Amazon S3」即可）
• Endpoint：填写对应对象存储服务提供的公网访问地址，注意匹配http/https协议
• AccessKey：填写存储服务后台生成的访问密钥ID
• SecretKey：填写存储服务后台生成的访问密钥密码
• Bucket：填写提前创建完成的存储桶名称
• Region：填写存储桶所属的区域标识，完全按照存储服务商提供的内容填写
• 存储路径：可填写自定义文件前缀，例如/cloudreve/files/，不填默认存储到桶根目录
• 访问域名：填写存储桶绑定的自定义访问域名，或服务商提供的默认公网访问域名
• 跨域配置：按照Cloudreve后台提示的规则，到存储桶控制台配置允许的请求来源、请求方法和请求头

六、更简单的方案

如果不想自己维护本地存储的磁盘扩容、RAID备份、故障修复，也不想折腾自建MinIO的服务器运维、带宽升级、安全防护，可以选择成熟的第三方兼容S3协议的云对象存储服务，无需自己维护底层基础设施，仅需按需使用存储容量和下载流量即可，运维成本远低于自建存储方案。如果你需要一个兼容S3协议、适合Cloudreve等网盘系统作为存储源、支持不限流量下载分发的对象存储服务，可以了解 七彩云对象存储，接入流程与上述S3兼容存储配置步骤完全一致，适合对性能要求较高又不想花费精力维护自建存储的站长和开发者。

七、FAQ

1. Cloudreve接入新的存储源后，已经上传的旧文件可以迁移到新存储源吗？

可以，Cloudreve后台自带存储策略迁移功能，你只需要在存储策略页面选择要迁移的源策略和目标策略，设置要迁移的文件范围，系统会自动在后台静默迁移文件，迁移过程中不会影响现有文件的正常访问，迁移完成后切换默认存储策略即可。

2. 不同存储源的性能差异主要在哪些场景下会体现出来？

性能差异主要体现在大文件上传下载、多用户并发访问、大流量文件分发这三类场景中，公有云S3兼容存储通常自带多节点带宽冗余和CDN加速能力，并发访问时的稳定性和速度远高于本地存储和自建MinIO，更适合用户量超过100人、有大文件分发需求的Cloudreve站点。

3. 接入S3兼容存储会不会增加Cloudreve的运维复杂度？

不会，S3兼容存储的底层运维工作全部由服务商负责，包括磁盘备份、硬件故障修复、带宽扩容、DDoS防护等，你只需要定期核对存储用量和账单即可，整体运维成本比维护本地存储或自建MinIO低70%以上。

4. 测试存储源性能的时候需要重点关注哪些指标？

核心关注三个指标即可：一是100KB以下小文件的上传延迟，低于100ms属于优秀水平；二是大文件的下载速度，需要匹配你站点用户的平均带宽水平；三是100并发请求的访问成功率，达到99.9%以上属于合格水平，你可以用Cloudreve自带的连接测试功能结合第三方测速工具联合测试。

八、总结

Cloudreve选择存储源的核心逻辑是先结合自身业务场景和用户分布，对不同类型的存储源进行实际性能测试，优先选择低延迟、高带宽稳定性的存储方案。接入S3兼容类存储源的流程非常简单，仅需准备好对应的接入参数，在Cloudreve后台填写并测试通过即可上线使用。个人小站点、测试环境可以选择本地存储或自建MinIO降低成本，用户量较大、有稳定文件分发需求的生产站点，优先选择成熟的S3兼容云存储服务，能够大幅降低运维成本，提升用户的文件访问体验。