项目简介

Cloudreve 是一款由国内团队使用 Go 语言开发的自托管文件管理与分享系统，常被开发者称作"会魔法的私有网盘"。和 Nextcloud、Seafile 这类传统私有云不同，Cloudreve 的核心设计思路是 聚合多种存储后端：你可以把文件放在本地磁盘，也可以直接挂载 OneDrive、AWS S3、阿里云 OSS、腾讯云 COS、七牛云 Kodo、华为云 OBS、又拍云、金山云 KS3 等十几种对象存储。对用户来说，只有一个统一的 Web 界面；对管理员来说，却能在后台灵活选择成本最低、速度最快的存储通道。

截至目前，Cloudreve 在 GitHub 上已获得超过 2.7 万 Star，社区维护活跃，文档站（docs.cloudreve.org）也有中文版本。无论你是想给团队搭一个内部文件协作平台，还是想给自己做一个不限速的私人网盘，亦或是要给学校、社团搭建资源分享站，Cloudreve 都是值得优先考虑的开源方案。

核心功能与架构

技术栈与整体架构

Cloudreve 采用前后端分离的设计：后端基于 Go + Gin 框架，负责鉴权、存储适配、任务调度、文件索引等核心逻辑；前端使用 React + Redux + Material-UI 构建，界面接近 Google Drive 的交互体验。这种架构带来三个直接好处——单文件部署即可运行、并发上传性能强、跨平台无依赖（Linux、Windows、macOS 都能跑）。

多存储后端适配

这是 Cloudreve 最核心的卖点。它抽象出了一层统一的存储策略接口（Storage Policy），每一种存储后端都被封装成一个独立的 driver：

• 本地存储：文件落在服务器磁盘，适合小规模自用。
• 远程从机：可以把多台服务器组成一个分布式存储集群，按策略分片上传。
• 云存储直传：上传和下载流量不经过 Cloudreve 服务器，客户端直接与对象存储通信，极大节省服务器带宽。这也是它区别于传统网盘的关键。

上传、下载与离线下载

Cloudreve 原生支持 拖拽上传、断点续传、文件夹上传、分片并行上传。在文件管理上，内置了在线压缩/解压、批量打包下载、图片/音视频/EPUB 文档预览。更实用的是，它可以通过 WebSocket 接入 Aria2 或 qBittorrent，把磁链和种子任务交给后端的下载器执行，完成后再自动入库到指定目录——非常适合做影视资源站。

用户、分享与 WebDAV

权限模型支持 用户组（Group） 和 存储策略 的灵活绑定，可以为不同成员分配不同的空间配额、存储后端和分享权限。文件分享链接支持设置过期时间、提取码、访问次数上限。Cloudreve 还实现了 WebDAV 协议服务端，让 macOS Finder、Windows 资源管理器、Mobirise、RaiDrive 等客户端都能像挂载本地硬盘一样访问网盘。

快速上手

使用 Docker 一键部署（推荐）

对大多数人来说，Docker 是最省心的部署方式。先在服务器上准备好目录：

mkdir -p /opt/cloudreve/{conf,data,db}

然后编写 docker-compose.yml：

```yaml
version: "3.8"
services:
cloudreve:

项目信息

参考链接

• GitHub 仓库
• 项目主页