项目概述
Cloudreve 是一个功能强大的自托管文件管理和分享系统，致力于帮助用户以更灵活、安全和高效的方式管理个人或团队的文件数据。随着多云存储和远程办公需求的快速增长，传统的文件管理方式已难以满足个性化和多样化的场景。Cloudreve 以强大的多云兼容能力为核心，支持本地存储、远程节点，以及主流公有云服务如 OneDrive、S3、七牛、阿里云 OSS、腾讯云 COS 和又拍云等，让用户能够统一管理和高效分发不同存储平台的文件资源。
在实际使用中，Cloudreve 提供了便捷的文件上传、下载体验，支持数据直接在客户端与存储服务间快速传输，大幅降低服务器压力。同时，项目还原生集成了如 Aria2、qBittorrent 等下载工具，满足复杂的文件获取需求。得益于清晰的界面与丰富的权限管理功能，无论是个人备份、文件分发，还是小型团队协作，Cloudreve 都能提供安全、私有且易用的解决方案，为用户带来前所未有的灵活和掌控力。
项目统计
项目概况
24345 Stars | 
3639 Forks | 
24345 Watchers | 
208 Issues
开源协议: GNU General Public License v3.0 | 
创建于: 2018-02-04 | 
更新于: 2025-07-31
技术栈
该项目主要使用 Go 开发，占代码库的 99.9%。此外还包含 Dockerfile (0.0%)、Shell (0.0%)
核心功能
Cloudreve 是一款让你轻松拥有个人或团队专属云盘的自托管文件管理神器。无论是本地存储还是市面上主流云服务，Cloudreve 都能一站式搞定：支持本地、远程节点，以及 OneDrive、S3 兼容云、七牛、阿里云 OSS、腾讯云 COS、又拍云等多种存储方案，给文件找家再也不受限制！
文件的上传与下载采用直传模式，数据直达云端，无需流经服务器，大幅提升了传输效率和安全性。对于追求自动化的进阶用户，Cloudreve 还可无缝集成 Aria2 和 qBittorrent，实现离线下载与自动归档，让资源管理更高效。
不仅如此，细致的权限管理让你可以为不同用户分配专属空间和访问权限，无论是团队协作还是私人云存储都能灵活应对。文件分享功能更是便捷，生成分享链接，用于与小伙伴轻松共享大文件、照片或整个文件夹。
界面简洁美观，多端适配，随时随地通过浏览器访问和管理你的文件。API 支持也能够满足高级用户的自动化需求。更多功能特性正在不断完善中，为你的文件生活持续加码！
技术架构
Cloudreve 采用现代化的分层架构，核心后端以 Go 语言开发，凭借其高并发处理能力和出色的资源效率，确保了系统在多用户高负载下的稳定性与可扩展性。前端采用 React 构建，辅以 RESTful API 与后端通讯，实现了快速响应和优良的用户体验。
在存储层，Cloudreve 通过灵活的适配器模式，支持本地存储、远程节点和多种云存储服务（如 OneDrive、S3 兼容 API、七牛云、阿里云 OSS、腾讯云 COS、又拍云等），用户可根据自身需求动态配置。文件直传机制（直连客户端与存储服务）大幅降低了服务器带宽压力，提高了上传/下载效率。此外，Cloudreve 集成 Aria2 和 qBittorrent 等离线下载引擎，为海量文件管理提供更丰富的场景适配。
系统采用模块化设计，各功能板块（用户管理、文件处理、存储接口、安全控制等）解耦独立，便于定制与扩展。权限系统保证多租户及分级管理安全。RESTful API 设计为二次开发和系统集成提供便利。结合 Docker 部署方式，Cloudreve 可高效运行于各种主流平台，适应云原生和容器化趋势。整体架构设计兼顾性能、灵活性与可维护性，适合多样化的私有云和文件共享场景。
使用指南
要快速开始使用 Cloudreve，你可以选择通过 Docker 或直接运行二进制文件进行安装。推荐新手使用 Docker 部署，操作简单且易于维护。
Docker 安装方法：
- 创建配置与数据目录（假设当前目录为
~/cloudreve）：mkdir -p ~/cloudreve/{uploads,conf} - 拉取并运行 Cloudreve 容器：
docker run -d \ -p 5212:5212 \ -v ~/cloudreve/uploads:/cloudreve/uploads \ -v ~/cloudreve/conf:/cloudreve/conf \ --name cloudreve \ cloudreve/cloudreve - 首次启动后，容器日志会输出初始管理员账号及密码，可用如下命令查看：
docker logs cloudreve - 在浏览器访问
http://YOUR_SERVER_IP:5212，用管理员账户登录后台。
二进制安装方法：
- 前往 Releases 页面 下载适用于你系统的发布包并解压。
- 进入软件目录，首次运行自动生成配置文件：
./cloudreve - 查看控制台信息以获取初始管理员用户名和密码。
- 访问
http://localhost:5212登录后台。
配置说明与存储挂载：
- 在「设置」→「储存策略」中新建储存策略，可选择本地、本地节点、S3 兼容 API、阿里云 OSS 等云存储。需填写相应的 Bucket、Access Key 等信息。
- 可绑定 Aria2/qBittorrent，实现离线下载和自动上传。
- 支持 HTTPS，编辑
conf.ini配置端口与证书路径。
完成上述步骤后，即可上传、分享或管理文件，也可邀请用户协作使用。更多高级用法参见官方文档。
总结评价
Cloudreve 以自托管文件管理与多云存储支持为核心，满足了用户对数据灵活管理和私有化部署的需求。该项目以 Go 语言开发，拥有超两万星标及活跃的社区，显示了其受欢迎程度和广泛关注。从本地到包括 S3、阿里云 OSS、腾讯 COS 等在内的多种云存储接入，以及与 Aria2/qBittorrent 集成下载等特性，体现出较强的实用性与扩展性。社区的活跃讨论和文档完善，为新手和进阶用户都提供了良好支持。需要注意的是，部署和维护过程对部分初学者存在一定技术门槛，且高度自定义环境下安全性依赖用户正确配置。整体来看，Cloudreve 适合有一定技术基础、注重数据主权及多云接入的个人和团队，未来若能进一步简化部署体验与增强安全指导，将具备更广阔的发展前景。