宝塔面板二进制文件部署 Cloudreve V4

## 前言

Cloudreve 本身是一款 *网盘*，而非 *其他网盘的管理器* ，它所支持的存储提供商大多为公有云的存储专用产品，而非针对普通用户的网盘。

若您属于一下情况，则证明您并不适合使用 Cloudreve：

* 我需要用 Cloudreve 管理多个网盘上的文件.
* 对于 Cloudreve 存储的文件, 我同时也会使用其他文件管理器一起管理.
* 我想把其他网盘存储服务“再分发”给我的用户使用.

如果你需要将其他云盘(百度、115、123 云盘等)作为存储来搭建私有云盘，[OpenList](https://doc.oplist.org.cn/)项目可能更适合你。

Cloudreve 官网: [https://cloudreve.org/](https://cloudreve.org/)
Cloudreve 文档: [https://docs.cloudreve.org/zh/](https://docs.cloudreve.org/zh/)
Cloudreve 仓库: [cloudreve/cloudreve](https://github.com/cloudreve/cloudreve)

## 教程开始

本教程使用 Debian 12。

推荐使用 Debian 12 / Ubuntu 22，并通过 SSH 连接至服务器。如果没有 SSH 工具，可以在 Windows cmd 中通过 `ssh root@服务器的ip` 进行连接。

> 本篇教程不使用 Docker 部署, Docker 部署后续会出教程

### 安装宝塔

养成好习惯，先更新一下软件包。

```
apt update
```

安装几个常用的软件包

```
apt install curl wget sudo vim -y
```

在 [宝塔官网](https://www.bt.cn/new/download.html) 复制安装命令，然后在 SSH 终端中输入。教程演示使用 `正式版 11.8.0`。

```
wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec
```

安装完成后，复制登录信息，在浏览器中登录宝塔面板。

提示绑定宝塔官网账号，可以点击暂不绑定。

在弹出的初始化推荐配置中安装 `Nginx` 和 `MySQL`, 推荐使用 `Nginx 1.28` 和 `MySQL 5.7`。生产环境下推荐编译安装

### 下载 Cloudreve 二进制文件

> Cloudreve-Pro版本
>
> Cloudreve Pro版可以在 [Cloudreve授权中心](https://cloudreve.org/manage) 获取二进制文件

从 [Github Releases](https://github.com/cloudreve/cloudreve/releases) 下载社区版的 Cloudreve。

先查看 VPS 或机器的硬件架构，然后下载对应架构的二进制文件。
在 SSH 中输入：

```
uname -m
```

如果返回的是 `x86_64`，就下载 `linux_amd64.tar.gz`。其他架构可以自行查资料或者问 AI，大多数情况下都是 `x86_64` / `amd64`。

右键复制链接

![右键复制链接](https://blog.chario.cn/usr/uploads/2026/06/2394292961.png)

返回宝塔面板，在侧边栏中选择 `文件`，再选择一个存放文件的目录。这里以 `/www/wwwroot/Cloudreve` 作为部署演示路径。

使用 URL 下载功能，输入刚刚在 Github 复制的链接进行下载。
下载慢的可以使用[https://gh-proxy.com/](https://gh-proxy.com/)将下载链接转换为加速链接、

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/815392721.png)

下载完成后，双击进行解压。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2927861438.png)

解压后, 目录结构大致如下。只需要保留 `cloudreve` 二进制文件，其他文件可以删除。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1549982205.png)

### 配置守护进程

使用 Systemd 配置守护进程

返回 SSH 终端，输入：

```
sudo vim /etc/systemd/system/cloudreve.service
```

将会出现如下页面

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3424791574.png)

将输入法切换为英文，按下 i 键/Insert 键 进入编辑模式。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3066479784.png)

```
[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/PATH_TO_CLOUDREVE
ExecStart=/PATH_TO_CLOUDREVE/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=你的授权密钥"

# 日志输出
StandardOutput=/var/log/cloudreve.log
StandardError=syslog

[Install]
WantedBy=multi-user.target
```

将 `/PATH_TO_CLOUDREVE` 修改为 Cloudreve 二进制文件所在的目录, 然后粘贴到 SSH 终端中.

例如, 我的 Cloudreve 二进制文件所在目录是 `/www/wwwroot/Cloudreve`, 配置文件如下:

```
[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/www/wwwroot/Cloudreve
ExecStart=/www/wwwroot/Cloudreve/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=你的授权密钥"

# 日志输出
StandardOutput=/var/log/cloudreve.log
StandardError=syslog

[Install]
WantedBy=multi-user.target
```

如果你是 Pro 版本，将 `你的授权密钥` 修改为你在 [Cloudreve 授权中心](https://cloudreve.org/manage) 获取的授权密钥。
例如：

```
# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=123456"
```

如果没有购买 Pro 版本，无需修改此处。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1400811642.png)

完成编辑后，按下键盘上的 ESC，然后输入 `:wq` 保存并退出。

接下来，需要重新加载 systemctl 配置文件，并配置 Cloudreve 开机自启。

```
# 重新加载 systemctl 配置文件
sudo systemctl daemon-reload

# 设置 Cloudreve 开启自启
sudo systemctl enable cloudreve

# 启动 Cloudreve
systemctl start cloudreve
```

下面是管理 Cloudreve 的命令

```
# 停止 Cloudreve
sudo systemctl stop cloudreve

# 启动 Cloudreve
sudo systemctl start cloudreve

# 重启 Cloudreve
sudo systemctl restart cloudreve

# 查看 Cloudreve 状态
sudo systemctl status cloudreve
```

### 配置数据库

接下来我们还需要将数据库改为 MySQL，Cloudreve 默认使用 SQLite 作为数据库（SQLite 不支持高并发写入）。

启动后，Cloudreve 所在目录下会生成一个 `data` 目录，其中包含 `conf.ini` 和 `cloudreve.db` 两个文件。

---

我们先在宝塔中创建数据库。数据库名和用户名可以自定义，但建议使用较复杂的名称，密码可以直接使用随机密码，然后点击确定。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2975333941.png)

通过宝塔面板 双击 `conf.ini` 文件 修改 Cloudreve 配置文件。

添加数据库配置，修改 `User`、`Password`、`Name` 的值。

* User：用户名
* Password：密码
* Name：数据库名

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

```

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/447485149.png)

最后点击保存，然后在 SSH 终端中重启 Cloudreve。

```
# 重启 Cloudreve
sudo systemctl restart cloudreve
```

完成后，可以删除 `cloudreve.db` 文件。

### 配置 Redis

配置 Redis 作为缓存，可以加快 Cloudreve 的速度。

在宝塔面板的应用商店中安装 Redis 应用。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1760017020.png)

安装完成后, 点击 `配置 → 性能调整`，为 Redis 配置连接密码，最后点击保存(建议顺手重启一次 Redis)。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/159098877.png)

再次修改 conf.ini 文件，为 Cloudreve 添加 Redis 配置。

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

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1153741930.png)

### 配置反向代理

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/406861482.png)

在宝塔面板的网站页面中添加站点。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2994516403.png)

点击网站名，选择网站配置文件，删除里面的两个`location` 块。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3069373351.png)

添加反代内容，点击保存。

```
location / {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host; # 重要，必须呈递 Host 头才能让 Cloudreve 的某些功能正常工作。
    proxy_redirect off;
    proxy_pass http://127.0.0.1:5212; # 请将此行替换为你的 Cloudreve 实例的实际地址。

# 设置最大文件上传大小，如需设置清取消注释。
    # 理论上后续本机存储策略的分片大小、WebDAV 最大上传大小、中转服务最大上传大小不得大于这里的设定。
    # client_max_body_size 20000m;
}
```

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3268339006.png)

现在，就可以通过 `http://域名` 访问你的 Cloudreve 了。

### 配置SSL证书

在网站配置中点击 SSL，进入 SSL 配置，然后在 免费证书 中点击 申请证书。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3247371414.png)

勾选域名，点击 `申请证书`，等待签发完成。LiteSSL 和 Let's Encrypt选哪个都可以

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1149847251.png)

推荐开启强制 HTTPS，然后点击保存。

至此，Cloudreve 就完成搭建了。

访问 `https://域名` 创建第一个网盘账号，第一个网盘账号将自动成为管理员账户。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3025547901.png)

## 更多

### 配置缩略图生成

在管理后台中，点击 `参数设置 → 媒体处理`。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2582767059.png)

推荐开启 `生成完成后立即回收内存`。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3419529223.png)

#### 安装 LibreOffice

养成好习惯，先更新软件源。

```
sudo apt update
```

```
sudo apt install libreoffice -y
```

#### 安装 LibRaw

```
sudo apt install libraw-bin libraw20 -y
```

#### 安装 libvips

```
sudo apt install libvips-tools -y
```

#### 安装 FFmpeg

```
sudo apt install ffmpeg -y
```

## 后续更新

先停止cloudreve

```
sudo systemctl stop cloudreve
```

然后下载新版本压缩包 解压后 替换`cloudreve`这单个文件。

教程中的路径是 `/www/wwwroot/Cloudreve/cloudreve` 以实际为准。

最后重新启动 Cloudreve。

```
sudo systemctl start cloudreve
```

---

参考资料：

[Cloudreve官方文档](https://docs.cloudreve.org/zh/)

## 前言

Cloudreve 本身是一款 *网盘*，而非 *其他网盘的管理器* ，它所支持的存储提供商大多为公有云的存储专用产品，而非针对普通用户的网盘。

若您属于一下情况，则证明您并不适合使用 Cloudreve：

如果你需要将其他云盘(百度、115、123 云盘等)作为存储来搭建私有云盘，[OpenList](https://doc.oplist.org.cn/)项目可能更适合你。

## 教程开始

本教程使用 Debian 12。

推荐使用 Debian 12 / Ubuntu 22，并通过 SSH 连接至服务器。如果没有 SSH 工具，可以在 Windows cmd 中通过 `ssh root@服务器的ip` 进行连接。

> 本篇教程不使用 Docker 部署, Docker 部署后续会出教程

### 安装宝塔

养成好习惯，先更新一下软件包。

```
apt update
```

安装几个常用的软件包

```
apt install curl wget sudo vim -y
```

在 [宝塔官网](https://www.bt.cn/new/download.html) 复制安装命令，然后在 SSH 终端中输入。教程演示使用 `正式版 11.8.0`。

```
wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh && bash install_panel.sh ed8484bec
```

安装完成后，复制登录信息，在浏览器中登录宝塔面板。

提示绑定宝塔官网账号，可以点击暂不绑定。

在弹出的初始化推荐配置中安装 `Nginx` 和 `MySQL`, 推荐使用 `Nginx 1.28` 和 `MySQL 5.7`。生产环境下推荐编译安装

### 下载 Cloudreve 二进制文件

> Cloudreve-Pro版本
>
> Cloudreve Pro版可以在 [Cloudreve授权中心](https://cloudreve.org/manage) 获取二进制文件

从 [Github Releases](https://github.com/cloudreve/cloudreve/releases) 下载社区版的 Cloudreve。

先查看 VPS 或机器的硬件架构，然后下载对应架构的二进制文件。
在 SSH 中输入：

```
uname -m
```

如果返回的是 `x86_64`，就下载 `linux_amd64.tar.gz`。其他架构可以自行查资料或者问 AI，大多数情况下都是 `x86_64` / `amd64`。

右键复制链接

![右键复制链接](https://blog.chario.cn/usr/uploads/2026/06/2394292961.png)

返回宝塔面板，在侧边栏中选择 `文件`，再选择一个存放文件的目录。这里以 `/www/wwwroot/Cloudreve` 作为部署演示路径。

使用 URL 下载功能，输入刚刚在 Github 复制的链接进行下载。
下载慢的可以使用[https://gh-proxy.com/](https://gh-proxy.com/)将下载链接转换为加速链接、

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/815392721.png)

下载完成后，双击进行解压。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2927861438.png)

解压后, 目录结构大致如下。只需要保留 `cloudreve` 二进制文件，其他文件可以删除。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1549982205.png)

### 配置守护进程

使用 Systemd 配置守护进程

返回 SSH 终端，输入：

```
sudo vim /etc/systemd/system/cloudreve.service
```

将会出现如下页面

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3424791574.png)

将输入法切换为英文，按下 i 键/Insert 键 进入编辑模式。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3066479784.png)

```
[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/PATH_TO_CLOUDREVE
ExecStart=/PATH_TO_CLOUDREVE/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=你的授权密钥"

# 日志输出
StandardOutput=/var/log/cloudreve.log
StandardError=syslog

[Install]
WantedBy=multi-user.target
```

将 `/PATH_TO_CLOUDREVE` 修改为 Cloudreve 二进制文件所在的目录, 然后粘贴到 SSH 终端中.

例如, 我的 Cloudreve 二进制文件所在目录是 `/www/wwwroot/Cloudreve`, 配置文件如下:

```
[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/www/wwwroot/Cloudreve
ExecStart=/www/wwwroot/Cloudreve/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=你的授权密钥"

# 日志输出
StandardOutput=/var/log/cloudreve.log
StandardError=syslog

[Install]
WantedBy=multi-user.target
```

如果你是 Pro 版本，将 `你的授权密钥` 修改为你在 [Cloudreve 授权中心](https://cloudreve.org/manage) 获取的授权密钥。
例如：

```
# Pro 版本授权密钥
Environment="CR_LICENSE_KEY=123456"
```

如果没有购买 Pro 版本，无需修改此处。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1400811642.png)

完成编辑后，按下键盘上的 ESC，然后输入 `:wq` 保存并退出。

接下来，需要重新加载 systemctl 配置文件，并配置 Cloudreve 开机自启。

```
# 重新加载 systemctl 配置文件
sudo systemctl daemon-reload

# 设置 Cloudreve 开启自启
sudo systemctl enable cloudreve

# 启动 Cloudreve
systemctl start cloudreve
```

下面是管理 Cloudreve 的命令

```
# 停止 Cloudreve
sudo systemctl stop cloudreve

# 启动 Cloudreve
sudo systemctl start cloudreve

# 重启 Cloudreve
sudo systemctl restart cloudreve

# 查看 Cloudreve 状态
sudo systemctl status cloudreve
```

### 配置数据库

接下来我们还需要将数据库改为 MySQL，Cloudreve 默认使用 SQLite 作为数据库（SQLite 不支持高并发写入）。

启动后，Cloudreve 所在目录下会生成一个 `data` 目录，其中包含 `conf.ini` 和 `cloudreve.db` 两个文件。

---

我们先在宝塔中创建数据库。数据库名和用户名可以自定义，但建议使用较复杂的名称，密码可以直接使用随机密码，然后点击确定。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2975333941.png)

通过宝塔面板 双击 `conf.ini` 文件 修改 Cloudreve 配置文件。

添加数据库配置，修改 `User`、`Password`、`Name` 的值。

* User：用户名
* Password：密码
* Name：数据库名

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

```

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/447485149.png)

最后点击保存，然后在 SSH 终端中重启 Cloudreve。

```
# 重启 Cloudreve
sudo systemctl restart cloudreve
```

完成后，可以删除 `cloudreve.db` 文件。

### 配置 Redis

配置 Redis 作为缓存，可以加快 Cloudreve 的速度。

在宝塔面板的应用商店中安装 Redis 应用。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1760017020.png)

安装完成后, 点击 `配置 → 性能调整`，为 Redis 配置连接密码，最后点击保存(建议顺手重启一次 Redis)。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/159098877.png)

再次修改 conf.ini 文件，为 Cloudreve 添加 Redis 配置。

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

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1153741930.png)

### 配置反向代理

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/406861482.png)

在宝塔面板的网站页面中添加站点。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2994516403.png)

点击网站名，选择网站配置文件，删除里面的两个`location` 块。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3069373351.png)

添加反代内容，点击保存。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3268339006.png)

现在，就可以通过 `http://域名` 访问你的 Cloudreve 了。

### 配置SSL证书

在网站配置中点击 SSL，进入 SSL 配置，然后在 免费证书 中点击 申请证书。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3247371414.png)

勾选域名，点击 `申请证书`，等待签发完成。LiteSSL 和 Let's Encrypt选哪个都可以

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/1149847251.png)

推荐开启强制 HTTPS，然后点击保存。

至此，Cloudreve 就完成搭建了。

访问 `https://域名` 创建第一个网盘账号，第一个网盘账号将自动成为管理员账户。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3025547901.png)

## 更多

### 配置缩略图生成

在管理后台中，点击 `参数设置 → 媒体处理`。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/2582767059.png)

推荐开启 `生成完成后立即回收内存`。

![请输入图片描述](https://blog.chario.cn/usr/uploads/2026/06/3419529223.png)

#### 安装 LibreOffice

养成好习惯，先更新软件源。

```
sudo apt update
```

```
sudo apt install libreoffice -y
```

#### 安装 LibRaw

```
sudo apt install libraw-bin libraw20 -y
```

#### 安装 libvips

```
sudo apt install libvips-tools -y
```

#### 安装 FFmpeg

```
sudo apt install ffmpeg -y
```

## 后续更新

先停止cloudreve

```
sudo systemctl stop cloudreve
```

然后下载新版本压缩包 解压后 替换`cloudreve`这单个文件。

教程中的路径是 `/www/wwwroot/Cloudreve/cloudreve` 以实际为准。

最后重新启动 Cloudreve。

```
sudo systemctl start cloudreve
```

---

参考资料：

[Cloudreve官方文档](https://docs.cloudreve.org/zh/)

Last modification：June 10, 2026

如果觉得我的文章对你有用，请随意赞赏

宝塔面板二进制文件部署 Cloudreve V4

Leave a Comment Cancel reply
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Typecho优化

子比主题V8.8开心修复版

想离职了

Handsome主题美化：10.1.0最新版

《杀死那个石家庄人》

手持两把锟斤拷口中疾呼烫烫烫脚踏千朵屯屯屯笑看万物锘锘锘

宝塔面板二进制文件部署 Cloudreve V4

1Panel 面板安装 PHP XLoader 扩展踩坑实录

《一骑红尘妃子笑》背后的残酷真相：他拼了命送的，不只是荔枝

1Panel部署Halo容器反复重启问题解决

宝塔面板二进制文件部署 Cloudreve V4

Leave a Comment Cancel reply 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

宝塔面板二进制文件部署 Cloudreve V4

Leave a Comment Cancel reply
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款