### [Cloudreve 全能公私合营云盘系统，打造你的专属存储中心](https://www.qiqiwa.com/article/247)

**Published:** 2026-02-18T08:52:40

**Author:** Hello

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

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218165213.png)

* * *

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

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

* * *

## 🏗️ 主流部署方案

看不懂可以直接看图文部署

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

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

1.  **下载源码**：前往 [GitHub Releases](https://github.com/cloudreve/Cloudreve/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` 生成一份默认的配置文件，在此文件中中增加数据库配置：

#### 配置教程：

-   [配置数据库](javascript:;)
-   [配置 Redis](javascript:;)

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

其中可用的配置项为：

| 设置名 | 说明  |
| --- | --- |
| `Type` | 数据库类型，支持 `postgres`、`mysql`、`sqlite`、`mariadb` |
| `Host` | 数据库地址 |
| `Port` | 数据库端口 |
| `User` | 数据库用户名 |
| `Password` | 数据库密码 |
| `Name` | 数据库名称 |
| `DBFile` | 可选，SQLite 数据库文件路径 |
| `UnixSocket` | 可选，`true` 或 `false`，是否使用 Unix Socket 连接数据库 |
| `DatabaseURL` | 可选，数据库连接字符串，如果设置，其他数据库配置将忽略，但 Type 仍需设置。 |

修改配置文件后，需要重启 Cloudreve。

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

其中可用的配置变量为：

| 设置名 | 说明  |
| --- | --- |
| `Server` | Redis 地址 |
| `Password` | 连接密码 |
| `DB` | 数据库编号, 默认为 `0` |
| `Network` | 网络类型，默认为`tcp`，可选 `tcp`, `tcp4` (IPv4-only), `tcp6` (IPv6-only), `udp`, `udp4` (IPv4-only), `udp6` (IPv6-only), `ip`, `ip4` (IPv4-only), `ip6` (IPv6-only), `unix`, `unixgram`, `unixpacket` |
| `User` | Redis ACL 用户名 |
| `UseTLS` | 可选，是否使用 TLS 连接到 Redis，默认为 `false` |
| `TLSSkipVerify` | 可选，是否跳过 TLS 验证，默认为 `false` |

修改配置文件后，需要重启 Cloudreve。

## 图文教程：目前宝塔为例

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218155321.png)

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218161111.png)

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218161750.png)

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218161833.png)

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218162901.png)

### 守护进程

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218163033.png)

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218163346.png)

### 进阶教程

在切换数据库中会导致原有设置失效！解决方法需将就数据库文件导入至新的即可

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218173342.png)

![](https://www.qiqiwa.com/wp-content/uploads/2026/02/d2b5ca33bd20260218173431.png)

配置完毕后记得重启进程，我这里用的是守护进程所以直接程序守护进程中的程序即可

-   [配置数据库](javascript:;)
-   [配置 Redis](javascript:;)

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

其中可用的配置项为：

| 设置名 | 说明  |
| --- | --- |
| `Type` | 数据库类型，支持 `postgres`、`mysql`、`sqlite`、`mariadb` |
| `Host` | 数据库地址 |
| `Port` | 数据库端口 |
| `User` | 数据库用户名 |
| `Password` | 数据库密码 |
| `Name` | 数据库名称 |
| `DBFile` | 可选，SQLite 数据库文件路径 |
| `UnixSocket` | 可选，`true` 或 `false`，是否使用 Unix Socket 连接数据库 |
| `DatabaseURL` | 可选，数据库连接字符串，如果设置，其他数据库配置将忽略，但 Type 仍需设置。 |

修改配置文件后，需要重启 Cloudreve。

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

其中可用的配置变量为：

| 设置名 | 说明  |
| --- | --- |
| `Server` | Redis 地址 |
| `Password` | 连接密码 |
| `DB` | 数据库编号, 默认为 `0` |
| `Network` | 网络类型，默认为`tcp`，可选 `tcp`, `tcp4` (IPv4-only), `tcp6` (IPv6-only), `udp`, `udp4` (IPv4-only), `udp6` (IPv6-only), `ip`, `ip4` (IPv4-only), `ip6` (IPv6-only), `unix`, `unixgram`, `unixpacket` |
| `User` | Redis ACL 用户名 |
| `UseTLS` | 可选，是否使用 TLS 连接到 Redis，默认为 `false` |
| `TLSSkipVerify` | 可选，是否跳过 TLS 验证，默认为 `false` |

修改配置文件后，需要重启 Cloudreve。

### 方案 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 连接其他数据库，你可以选择下面任一方式：在容器启动时配置在容器启动后配置

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

-   [在容器启动时配置](javascript:;)
-   [在容器启动后配置](javascript:;)

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

```
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 \
    .....
```

其中可用的配置变量为：

| 变量名 | 说明  |
| --- | --- |
| `CR_CONF_Database.Type` | 数据库类型，支持 `postgres`、`mysql`、`sqlite`、`mariadb` |
| `CR_CONF_Database.Host` | 数据库地址 |
| `CR_CONF_Database.Port` | 数据库端口 |
| `CR_CONF_Database.User` | 数据库用户名 |
| `CR_CONF_Database.Password` | 数据库密码 |
| `CR_CONF_Database.Name` | 数据库名称 |
| `CR_CONF_Database.DBFile` | 可选，SQLite 数据库文件路径 |
| `CR_CONF_Database.UnixSocket` | 可选，`true` 或 `false`，是否使用 Unix Socket 连接数据库 |
| `CR_CONF_Database.DatabaseURL` | 可选，数据库连接字符串，如果设置，其他数据库配置将忽略，但 Type 仍需设置。 |

在容器启动后，你可以通过修改宿主机上挂载的 `~/cloudreve/data/conf.ini` 文件来增加数据库配置：

```
[System]
Mode = master
Listen = :5212

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

其中可用的配置项为：

| 设置名 | 说明  |
| --- | --- |
| `Type` | 数据库类型，支持 `postgres`、`mysql`、`sqlite`、`mariadb` |
| `Host` | 数据库地址 |
| `Port` | 数据库端口 |
| `User` | 数据库用户名 |
| `Password` | 数据库密码 |
| `Name` | 数据库名称 |
| `DBFile` | 可选，SQLite 数据库文件路径 |
| `UnixSocket` | 可选，`true` 或 `false`，是否使用 Unix Socket 连接数据库 |
| `DatabaseURL` | 可选，数据库连接字符串，如果设置，其他数据库配置将忽略，但 Type 仍需设置。 |

修改配置文件后，需要重启容器生效。

#### 配置 Redis

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

-   [在容器启动时配置](javascript:;)
-   [在容器启动后配置](javascript:;)

在启动容器时，你可以通过环境变量传入 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
```

其中可用的配置变量为：

| 变量名 | 说明  |
| --- | --- |
| `CR_CONF_Redis.Server` | Redis 地址 |
| `CR_CONF_Redis.Password` | 连接密码 |
| `CR_CONF_Redis.DB` | 数据库编号，默认为 `0` |
| `CR_CONF_Redis.Network` | 网络类型，默认为`tcp`，可选 `tcp`, `tcp4` (IPv4-only), `tcp6` (IPv6-only), `udp`, `udp4` (IPv4-only), `udp6` (IPv6-only), `ip`, `ip4` (IPv4-only), `ip6` (IPv6-only), `unix`, `unixgram`, `unixpacket` |
| `CR_CONF_Redis.User` | Redis ACL 用户名 |
| `CR_CONF_Redis.UseTLS` | 可选，是否使用 TLS 连接到 Redis，默认为 `false` |
| `CR_CONF_Redis.TLSSkipVerify` | 可选，是否跳过 TLS 验证，默认为 `false` |

在容器启动后，你可以通过修改宿主机上挂载的 `~/cloudreve/data/conf.ini` 文件来增加 Redis 配置：

```
[System]
Mode = master
Listen = :5212

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

其中可用的配置项为：

| 设置名 | 说明  |
| --- | --- |
| `Server` | Redis 地址 |
| `Password` | 连接密码 |
| `DB` | 数据库编号, 默认为 `0` |
| `Network` | 网络类型，默认为`tcp`，可选 `tcp`, `tcp4` (IPv4-only), `tcp6` (IPv6-only), `udp`, `udp4` (IPv4-only), `udp6` (IPv6-only), `ip`, `ip4` (IPv4-only), `ip6` (IPv6-only), `unix`, `unixgram`, `unixpacket` |
| `User` | Redis ACL 用户名 |
| `UseTLS` | 可选，是否使用 TLS 连接到 Redis，默认为 `false` |
| `TLSSkipVerify` | 可选，是否跳过 TLS 验证，默认为 `false` |

修改配置文件后，需要重启容器生效。

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

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

* * *

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

| **后端类型** | **优势** | **适用场景** |
| --- | --- | --- |
| **本地存储** | 速度快，受限于服务器硬盘 | 个人私密资料、小规模分享 |
| **OneDrive** | 空间巨大（E3/E5 计划），不占服务器流量 | 影视库、大文件冷备份 |
| **对象存储 (OSS/S3)** | 极速分发，高可靠性 | 商业站点附件、专业图床 |
| **从机存储** | 分布式架构，多服务器扩容 | 多节点下载/上传加速 |

* * *

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

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

* * *

## ⚖️ 优缺点总结

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

* * *

## 🎯 总结：谁最适合 Cloudreve？

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

| Github | 官方文档 | 下载  |
| --- | --- | --- |
| [Cloudreve](https://github.com/cloudreve/cloudreve) | [docs.cloudreve.org/zh](https://docs.cloudreve.org/zh) | [Releases · cloudreve](https://github.com/cloudreve/Cloudreve/releases) |

**Tags:** 开源项目, 网盘程序

**Categories:** 图床程序

---