Cloudreve 全能公私合营云盘系统，打造你的专属存储中心

在云端存储需求爆炸的今天，你是选择忍受限速的公有云盘，还是折腾复杂的私有云？Cloudreve 给你第三种选择。它不仅能把你服务器的硬盘变身云盘，还能将 OneDrive、Google Drive、七牛云等众多存储后端“收编”，提供统一的 Material Design 极简管理界面。

✨ 核心特性：它为何能成为“国产云盘之光”？

• 多存储后端支持：本地存储、从机存储、七牛、OSS、COS、又拍云、OneDrive、S3。
• 极致部署体验：得益于 Go 语言，全平台仅需一个单一的可执行文件即可运行。
• 离线下载支持：内置 Aria2 接口，让你的服务器化身下载机。
• 文件在线预览：支持视频、音乐、文档（PDF/Office）、代码、图片的在线查看与播放。
• 用户系统完善：支持多用户、多角色、注册审批及用户组权限分配。
• 响应式 UI：完美适配手机/平板端，支持日间与暗黑模式切换。

🏗️ 主流部署方案

方案 A：二进制部署（极速、轻量）

适合希望快速上手、一下是Linux上运行的用户。

1. 下载源码：前往 GitHub Releases 下载对应架构的压缩包。
2. 启动程序：解压程序包 tar -zxvf cloudreve_VERSION_OS_ARCH.tar.gz 赋予执行权限 chmod +x ./cloudreve 启动Cloudreve程序 ./cloudreve
3. 记录密码：请注册一个账户，首个注册的账户会被设置为管理员。
4. 进程守护：建议使用 Systemd 或 Supervisor 维持后台运行。

Cloudreve 默认会监听 5212 端口。你可以在浏览器中访问 http://localhost:5212进入 Cloudreve。请注册一个账户，首个注册的账户会被设置为管理员。

高阶配置（可忽略）

在首次成功启动 Cloudreve 后，会在 Cloudreve 主程序所在目录/data/conf.ini 生成一份默认的配置文件，在此文件中中增加数据库配置：

配置教程：

[Database]
Type = mysql
Port = 3306
User = 数据库用户名
Password = 数据库密码
Host = 127.0.0.1
Name = 数据库名称

[Redis]
Server = 127.0.0.1:6379
Password = your_redis_password
DB = 0

图文教程：目前宝塔为例

更具自己的架构选择我这里是 Linux系统 宝塔面板 所以我这里选择的是 linux_amd64.tar.gz 结尾的包

将包上传到服务器然后进行解压

在当前目录下右击调出终端并输入一下命 解压程序包 tar -zxvf cloudreve_VERSION_OS_ARCH.tar.gz（这里以及解压过了所以可跳过解压命令） 赋予执行权限 chmod +x ./cloudreve（可有可无）启动Cloudreve程序 ./cloudreve

代码跑完看到暴露端口即可进入 访问：http://localhost:5212 （因为目前没配置守护进行所以关闭窗口后会无法访问）如果无法打开请检查端口或者服务器是否启用了5212端口 修改端口在文件目录-data-conf.ini 即可修改

注册账号（首个注册的账户会被设置为管理员。）

守护进程

在宝塔-软件商店-搜索进程守护管理器 进行安装

启动命令就是自己的运行目录地址后面加入一个/cloudreve 例如 /www/wwwroot/程序地址/cloudreve

进阶教程

在首次成功启动 Cloudreve 后，会在 Cloudreve 主程序所在目录/data/conf.ini 生成一份默认的配置文件，在此文件中中增加数据库、Redis配置：找到conf.ini文件并写入一下代码

[Database]
Type = mysql
Port = 3306
User = 数据库用户名
Password = 数据库密码
Host = 127.0.0.1
Name = 数据库名称

[Redis]
Server = 127.0.0.1:6379
Password = 填入密码#如果没自定义密码则为空
DB = 0

方案 B：Docker 部署（推荐、整洁、简单）

如果你追求环境隔离和一键迁移，Docker 是最佳选择：

docker run -d --name cloudreve \
    -p 5212:5212 \
    -p 6888:6888 \
    -p 6888:6888/udp \
    -v ~/cloudreve/data:/cloudreve/data \
    cloudreve/cloudreve:latest

上述命令额外暴露了 6888 端口，用于给 Aria2 离线下载使用。

容器 Volume

在上面的例子中，我们使用 -v ~/cloudreve/data:/cloudreve/data 挂载了宿主机的 ~/cloudreve/data 目录到容器内的 /cloudreve/data 目录，以便于在宿主机修改 Cloudreve 配置文件。所有 Cloudreve 额外产生的文件（头像、配置文件、临时目录）等，默认都会存储到此目录。

配置数据库

在以上启动命令中，我们没有配置数据库，Cloudreve 会使用 SQLite 存储数据。如果需要让 Cloudreve 连接其他数据库，你可以选择下面任一方式：在容器启动时配置在容器启动后配置

在启动容器时，你可以通过环境变量传入数据库配置：

docker run -d --name cloudreve \
    -p 5212:5212 \
    -p 6888:6888 \
    -p 6888:6888/udp \
    -v ~/cloudreve/data:/cloudreve/data \
    -e CR_CONF_Database.Type=postgres \
    -e CR_CONF_Database.Host=127.0.0.1 \
    -e CR_CONF_Database.Port=5432 \
    -e CR_CONF_Database.User=cloudreve \
    -e CR_CONF_Database.Password=cloudreve \
    -e CR_CONF_Database.Name=cloudreve \
    .....

[System]
Mode = master
Listen = :5212

[Database]
Type = mysql
Port = 3306
User = cloudreve
Password = cloudreve
Host = 127.0.0.1
Name = cloudreve

配置 Redis

在以上启动命令中，我们没有配置 Redis，Cloudreve 会使用内置内存存储。如果需要让 Cloudreve 连接 Redis，你可以选择下面任一方式：

docker run -d --name cloudreve \
    -p 5212:5212 \
    -p 6888:6888 \
    -p 6888:6888/udp \
    -v ~/cloudreve/data:/cloudreve/data \
    -e CR_CONF_Redis.Server=127.0.0.1:6379 \
    -e CR_CONF_Redis.Password=your_redis_password \
    -e CR_CONF_Redis.DB=0 \
    cloudreve/cloudreve:latest

[System]
Mode = master
Listen = :5212

[Redis]
Server = 127.0.0.1:6379
Password = your_redis_password
DB = 0

Cloudreve 默认会监听 5212 端口。（如有防火墙记得开放）你可以在浏览器中访问 http://localhost:5212 进入 Cloudreve。请注册一个账户，首个注册的账户会被设置为管理员。

至此，Cloudreve 已经启动成功并监听 5212 端口。

📂 存储后端对比：选哪个更好？

🛠️ 部署后的关键优化建议

1. 反向代理与 SSL：强烈建议使用 Nginx 进行反代，并配置 SSL 证书。不仅是为了安全，也是为了在浏览器中正常启用上传功能。
2. Aria2 离线下载：部署 Aria2 后，在 Cloudreve 后台填入 RPC 地址和 Token，即可享受服务器全速离线下片。
3. 数据库迁移：Cloudreve 默认使用 SQLite。如果你的用户量较大，建议在配置文件中将其迁移至 MySQL 以及启用Redis 以获得更好的并发性能。

⚖️ 优缺点总结

• ✅ 优点：单文件运行极简、界面极其美观、支持后端多、国人开发（中文支持完美）。
• ⚠️ 缺点：相比 Nextcloud，它的协作办公功能（如日历、联系人）较弱，更偏向纯粹的“存储与分享”。

🎯 总结：谁最适合 Cloudreve？

如果你厌倦了某盘的限速，手里又正好有一台吃灰的 VPS，或者想把吃灰的 OneDrive 5T 空间利用起来，Cloudreve 绝对是目前门槛最低、颜值最高、功能最均衡的解决方案。