Cloudreve：自托管多云存储网盘系统部署与使用指南

一、项目官方信息

Cloudreve 是一套自托管文件管理系统（self-hosted file management system），支持多云存储。

核心特性：

• 支持把文件存到本地、远程节点、OneDrive、S3 兼容 API、七牛 Kodo、阿里云 OSS、腾讯云 COS、华为云 OBS、金山云 KS3、又拍云；
• 上传/下载直传，客户端到存储方直连；
• 集成 Aria2/qBittorrent 后台离线下载，多下载节点分担；
• 压缩/解压/预览压缩包、批量下载；
• 全存储端支持 WebDAV；
• 拖拽上传文件夹，并行断点续传；
• 提取媒体元数据、按元数据或标签搜索；
• 多用户多用户组、分享链接（带过期时间）；
• 在线预览视频/图片/音频/ePub，在线编辑文本/图表/Markdown/图片/Office；
• 自定义主题色、深色模式、PWA、SPA、多语言；All-in-one 打包开箱即用。

技术栈：Go + Gin + ent；React + Redux + Material-UI。

二、官方图片

• 上图为 Cloudreve 官方 README 中的产品界面截图（homepage）。
• 另附项目 Logo。

三、环境要求

• 服务端：Linux（推荐 Debian/Ubuntu/CentOS）；
• 可选用 SQLite（默认轻量）或 MySQL；
• 可选用 Docker 部署；
• 反向代理（Nginx）用于 HTTPS 与域名绑定；
• 内存建议 512MB 以上。

四、部署步骤

1. 获取程序

Cloudreve 为 All-in-one 单二进制。从 Releases 下载对应平台的程序：https://github.com/cloudreve/cloudreve/releases

2. 首次运行

chmod +x cloudreve
./cloudreve

首次启动会初始化配置并在控制台输出初始管理员账号密码。

3. 配置数据库（可选）

默认使用 SQLite。如需 MySQL，编辑生成的 conf.ini，把数据库切换为 MySQL 并填入连接信息。

4. Nginx 反向代理 + HTTPS

把域名解析到服务器，Nginx 反向代理到 Cloudreve 端口（默认 5212），并配置 SSL 证书。

5. 验证

浏览器访问 http://服务器IP:5212 或绑定域名，用首次启动输出的管理员账号登录，进入后台管理。

详细本地部署见官方 Quickstart：https://docs.cloudreve.org/overview/quickstart；生产部署见 https://docs.cloudreve.org/overview/deploy/。

五、使用方法

• 后台管理：站点设置、用户组、存储策略、站点通知、邮件等。
• 存储策略：添加本地/OSS/S3/OneDrive 等存储策略，再分配给用户组；文件实际落到对应存储。
• 文件上传：前台拖拽上传，支持断点续传、直传 OSS。
• 离线下载：集成 Aria2/qBittorrent，粘贴任务链接后台下载。
• 分享：对文件/文件夹生成带过期时间的分享链接。
• WebDAV：在存储端开启后，可用 WebDAV 客户端挂载。
• 在线预览/编辑：视频、图片、文档、Markdown 在线预览与编辑。

六、常见问题 FAQ

1. 首次启动的管理员密码在哪？ 第一次运行 ./cloudreve 时控制台会打印初始账号密码，请及时登录并修改。

2. 支持哪些存储后端？ 本地、远程节点、OneDrive、S3 兼容 API、七牛、阿里云 OSS、腾讯云 COS、华为云 OBS、金山云 KS3、又拍云。

3. 用什么数据库？ 默认 SQLite，轻量即可；生产可切 MySQL。

4. 怎么配置 HTTPS？ 用 Nginx 反向代理到 Cloudreve 端口并配置 SSL 证书，官方部署文档有完整示例。

5. 离线下载怎么用？ 后台集成 Aria2/qBittorrent，配置后在前台粘贴链接即可后台下载。

6. 想从源码构建？ 参考官方 Build 文档：https://docs.cloudreve.org/overview/build/。

七、跳转链接

• GitHub 仓库：https://github.com/cloudreve/cloudreve
• 官网：https://cloudreve.org
• 官方文档：https://docs.cloudreve.org
• Releases：https://github.com/cloudreve/cloudreve/releases