> For AI agents: the complete documentation index is available at https://docs.vps.town/llms.txt, the full documentation bundle is available at https://docs.vps.town/llms-full.txt.

# Cloudreve V4 私有云网盘搭建与优化全攻略

:::details 📖 本文目录

[](#-项目简介)[](#-环境准备)[](#-下载安装-cloudreve)[](#-安装命令示例)[](#-安装文件示意)[](#-首次运行与激活)[](#-配置守护进程-systemd)[](#日后管理-cloudreve)[](#停止-cloudreve)[](#启动-cloudreve)[](#重启-cloudreve)[](#查看-cloudreve-状态)[](#️-配置-confini-详解)[](#优化建议)[](#-1panel-图形化反向代理--ssl)[](#-添加存储策略)[](#-使用-docker-安装可选)[](#️-部署从机节点--离线下载)[](#-部署说明)[](#aria2-配置)[](#-安装-aria2)[](#️-修改-aria2-配置文件)[](#️-注意)[](#qbittorrent-安装设置)[](#安装-qbittorrent-439)[](#-常见问题-faq)
:::

## 📦 项目简介

Cloudreve 是一款开源网盘系统，支持多用户、多存储策略（本地、S3、Ali OSS、OneDrive 等），适合搭建私有云盘或文件分享服务。

✅ 特性：

- 多用户、多存储支持
- 分享系统、团队协作、离线下载
- Docker / 从机分布式部署
- 可接入 下载独立 CDN + 多个自定义域名

## 🧰 环境准备

推荐部署环境：VPS.Town A2 系列

注：这里用捐赠版进行演示说明

- **系统**：Debian 12 或 Ubuntu 22.04
- **CPU**：1 核以上
- **内存**：1 GB 以上
- **硬盘**：系统盘 SSD，推荐带 HHD 的独立数据盘 A2 系列
- **网络**：1 IPV4

必备工具：

- SSH 终端（FinalShell、XShell）
- 能上网的电脑
- 会仔细阅读理解的大脑

## 📥 下载安装 Cloudreve

前往官方 Release 页面下载 Cloudreve 程序：

👉 [Cloudreve Releases](https://github.com/cloudreve/Cloudreve/releases)

选择与你系统架构相符的版本（这里选择 linux_amd64），使用 FinalShell 等工具上传至服务器 `/root` 目录。

为什么选择 `linux_amd64` ？

`linux_amd64` 表示：
系统平台：Linux
CPU 架构：amd64，也叫 x86_64，常见于大多数主流云服务器、VPS 和普通电脑
只要你用的是 Linux 操作系统 + x86/64 架构的 CPU，就选 linux_amd64

### 📦 安装命令示例：

```bash
cd /root
chmod +x cloudreve
```

这代表了赋予 Cloudreve 可执行权限，如果无法打开 有可能就是这步出问题了。

### 📸 安装文件示意：

![Cloudreve下载](/assets/images/how-to-install-cloudreve-v4-vps-town/cloudreve-download.jpg)

## 🚀 首次运行与激活

```bash
./cloudreve
# 捐赠版则需要运行下面这个，需要授权的：
./cloudreve --license-key "你的授权密钥"
```

新版本在打开时需要进行 --license-key 授权，v3 版本的则不需要。
运行后按 `Ctrl + C` 停止程序，进入配置阶段。

![首次运行输出](/assets/images/how-to-install-cloudreve-v4-vps-town/first-run.jpg)
首次运行需要初始化数据库、配置文件等
（如果直接退出了，则说明有地方没有配置对）

## 🔁 配置守护进程 systemd

配置好进程守护才能保证进程的运行，至关重要。
新建服务文件：

```bash
apt update -y
apt install vim -y
sudo vim /etc/systemd/system/cloudreve.service
```

填入的内容如下：

```ini
[Unit]
Description=Cloudreve
After=network.target

[Service]
WorkingDirectory=/root
ExecStart=/root/cloudreve
Restart=on-failure
RestartSec=5
KillMode=mixed
Environment="CR_LICENSE_KEY=你的授权密钥"
StandardOutput=file:/var/log/cloudreve.log
StandardError=journal

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

![systemd配置](/assets/images/how-to-install-cloudreve-v4-vps-town/systemd-setup.jpg)

通过 Systemd 启动 Cloudreve

```bash
sudo systemctl daemon-reload
sudo systemctl enable cloudreve
sudo systemctl start cloudreve
```

## 日后管理 Cloudreve：

以后都从这里运行和关闭程序，非常方便

### 停止 Cloudreve

```bash
sudo systemctl stop cloudreve
```

### 启动 Cloudreve

```bash
sudo systemctl start cloudreve
```

### 重启 Cloudreve

```bash
sudo systemctl restart cloudreve
```

### 查看 Cloudreve 状态

```bash
sudo systemctl status cloudreve
```

## ⚙️ 配置 conf.ini 详解

请按照需要修改：

```ini
[System]
; 运行模式，可选值为 master/slave 无需修改，默认即可
Mode = master
; HTTP 监听端口，默认为 5212
; 如果没有其他服务，可以选择修改成80端口+cdn
Listen = :5212
; 是否开启 Debug 模式，默认为 false 无需修改，默认即可
Debug = false
; 呈递客户端 IP 时使用的 Header，默认为 X-Forwarded-For 无需修改，默认即可
ProxyHeader = X-Forwarded-For
; 进程安全退出的最长缓冲时间，默认为 0，不限制 无需修改，默认即可
GracePeriod = 0
; 日志级别，可选值为 debug/info/warning/error，默认为 info
; 可选修改成error 这样日志会少很多
LogLevel = info

; SSL 相关
; 如果配置反向代理或者加cdn 则无需添加ssl配置！
[SSL]
; SSL 监听端口，默认为 443
Listen = :443
; 证书路径，默认为空
CertPath =
; 私钥路径，默认为空
KeyPath =

; 启用 Unix Socket 监听
[Unix]
; Unix Socket 监听路径，默认为空
Listen = /run/cloudreve/cloudreve.sock
; 设置产生的 socket 文件的权限，默认为空
Perm = 0666

; 数据库相关，如果你只想使用内置的 SQLite 数据库，这一部分直接删去即可
[Database]
; 数据库类型，目前支持 sqlite/mysql/postgres，默认为 sqlite
Type = sqlite
; 数据库端口，默认为 3306
Port = 3306
; 用户名，默认为空
User =
; 密码，默认为空
Password =
; 数据库地址，默认为空
Host = 127.0.0.1
; 数据库名称，默认为空
Name = cloudreve
; 连接字符集，默认为 utf8mb4
Charset = utf8mb4
; SQLite 数据库文件路径，默认为 data/cloudreve.db
DBFile = cloudreve.db
; 使用 Unix Socket 连接到数据库, 默认为 false，如需开启，请在 Host 中指定 Unix Socket 路径
UnixSocket = false

; 从机模式下的配置
[Slave]
; 通信密钥，默认为空
Secret =
; 回调请求超时时间 (s)，默认为 20
CallbackTimeout = 20
; 签名有效期 (s)，默认为 600
SignatureTTL = 600

; 跨域配置
[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false

; Redis 相关
[Redis]
; 连接类型，默认为 tcp
Network = tcp
; 服务器地址，默认为空，不启用
Server = 127.0.0.1:6379
; 密码，默认为空
Password =
; 数据库，默认为 0
DB = 0
; 用户名，默认为空
User =

; 从机配置应用配置覆盖
[OptionOverwrite]
; 可直接使用 `设置名称 = 值` 的格式覆盖
queue_slave_worker_num = 50
```

## 优化建议

1. 开启 Redis 缓存
2. 独立数据库部署
3. 启用 CDN
4. 开启 HTTP/2 + GZIP
5. 日志等级改为 `error`
6. 上传目录挂载至独立数据盘

## 🌐 1Panel 图形化反向代理 + SSL

安装 1Panel：

```bash
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh | bash
```

控制台界面：

![安装 1Panel](/assets/images/how-to-install-cloudreve-v4-vps-town/7ac14a965c5ac170aa58ef0db58cd271.image.jpg)

设置反代：

![反向代理设置](/assets/images/how-to-install-cloudreve-v4-vps-town/reverse-proxy.jpg)

配置 HTTPS：

![SSL 配置](/assets/images/how-to-install-cloudreve-v4-vps-town/ssl-setup.jpg)

## 📁 添加存储策略

后台 → 存储策略 → 添加

![添加存储](/assets/images/how-to-install-cloudreve-v4-vps-town/add-storage.jpg)

## 🐳 使用 Docker 安装（可选）

安装 docker

```bash
curl -sSL https://get.docker.com/ | sh
```

```bash
docker run -d --name cloudreve -p 5212:5212 \
  -v /root/cloudreve:/cloudreve \
  -e CR_LICENSE_KEY=你的密钥 \
  cloudreve.azurecr.io/cloudreve/pro:latest
```

![docker 登录](/assets/images/how-to-install-cloudreve-v4-vps-town/docker-login.jpg)
![docker 登录](/assets/images/how-to-install-cloudreve-v4-vps-town/docker-login1.jpg)

剩下的内容请参考：前文的使用 1panel 反向代理

## 🛰️ 部署从机节点 & 离线下载

从机节点：

Cloudreve 除了主节点，还可以部署多个**从机节点**（Slave），用于**分担主节点压力、提升扩展性**。

- 📦 **解压缩**\
  解压缩非常占用 CPU，通过从机，将上传的压缩包（.zip/.rar/.7z）通过从机解压到指定目录。

- 🗜️ **创建压缩文件**\
  用户可在 Web 面板批量选择文件，生成压缩包。（耗费流量和 CPU）

- 🚀 **离线下载**\
  将磁力链接、BT 种子、HTTP 下载链接推送至从机节点，由从机执行下载任务，再同步到主节点存储。（耗费大量资源）

***

- 分担主节点 CPU 和 IO 压力
- 多个从机可同时解压、打包、下载，提升并发性能
- 远程离线下载，不占用主节点带宽

***

## 📌 部署说明

1. 安装 Cloudreve 至其他服务器 （参考上文安装流程）
2. 在后台里面 - 新建节点 - 自动单独生成从机 `conf.ini`
3. 粘贴到从机的`conf.ini` 文件内
4. 启动从机节点服务

部署命令示例：

```bash
./cloudreve --slave --license-key "你的授权密钥"
```

![从机节点](/assets/images/how-to-install-cloudreve-v4-vps-town/slave-setup.jpg)

## Aria2 配置：

Cloudreve 内的配置内容
![aria2 配置](/assets/images/how-to-install-cloudreve-v4-vps-town/aria2.jpg)

VPS 上的配置内容

### 📦 安装 Aria2

执行以下命令安装：

```bash
wget -N git.io/aria2.sh && chmod +x aria2.sh && ./aria2.sh
```

执行过程中，输入 1 确认安装。

安装完成后，终端会输出 Aria2 相关配置信息及默认下载路径。

### ⚙️ 修改 Aria2 配置文件

执行命令打开配置文件：

```bash
sudo vim /root/.aria2c/aria2.conf
```

***

建议修改以下参数：

将最大同时下载任务数调大
将单服务器最大连接数调大
将下载目录改为独立数据盘，防止主盘爆满

***

\###📄 配置修改参考：

```ini
dir=/home/aria2/downloads
max-concurrent-downloads=500
max-connection-per-server=320
split=640
```

### ⚠️ 注意：

修改完配置后，务必重启 Aria2 服务，否则配置不生效。

```bash
./aria2.sh
```

## qBittorrent 安装设置：

### 安装 qBittorrent 4.3.9

```bash title="bash"
wget https://raw.githubusercontent.com/networkdu/qb439/refs/heads/main/install.sh && chmod +x install.sh && ./install.sh
```

![qbittorrent](/assets/images/how-to-install-cloudreve-v4-vps-town/qb-setup.jpg)

修改下载路径到存储盘
![qbittorrent](/assets/images/how-to-install-cloudreve-v4-vps-town/qb2.jpg)

进入网盘后台配置 qb 离线下载
![qbittorrent](/assets/images/how-to-install-cloudreve-v4-vps-town/crqb.jpg)

测试一下即可使用
![qbittorrent](/assets/images/how-to-install-cloudreve-v4-vps-town/qbtest.jpg)

## ❓ 常见问题 FAQ

**Q: 上传失败？**\
A: 检查权限、磁盘空间、nginx 上传限制

**Q: 登录后台失败？**\
A: 检查端口监听、防火墙和授权密钥

**Q: 如何启用 HTTPS？**\
A: 推荐 1Panel 自动申请证书

**Q: 🚀 Docker 部署 vs 直接部署对比**

| 特性/维度      | Docker 部署                                      | 直接部署（本地二进制）                    |
| :--------- | :--------------------------------------------- | :----------------------------- |
| 📦 安装复杂度   | 简单，**一条命令搞定**，镜像自带环境                           | 稍复杂，需自己下载程序、授权、配置 systemd      |
| ⚙️ 环境隔离性   | **完全隔离**，程序与主机环境解耦，互不影响                        | 直接运行在主机环境，依赖主机本地环境             |
| 🔄 升级维护方便性 | **简单换镜像**，无缝更新                                 | 手动替换程序，改 systemd，重启            |
| 🐳 依赖管理    | 镜像内自带依赖，**不依赖宿主机安装额外组件**                       | 依赖本地环境，MySQL/Redis/Aria2 需自己部署 |
| 📁 数据持久化   | 需要**挂载卷（volume）**，否则容器重启数据丢失                   | 默认保存在本地目录，持久化简单                |
| 🚀 性能      | 稍有容器虚拟化开销（一般忽略不计）                              | **原生性能**，直接运行                  |
| 📚 配置文件管理  | 建议挂载配置文件目录，方便更新和备份                             | 本地直接编辑 `/root/conf.ini` 即可     |
| 📦 多节点部署   | **Docker Compose / Swarm / Kubernetes 集群化更方便** | 需手动维护多机 systemd 和环境            |
| 📄 日志管理    | 容器日志走 `docker logs`，或挂载日志目录                    | 写入本地文件或 systemd 日志             |
| 📱 运维习惯    | 偏 DevOps / 云原生，现代运维偏好                          | 传统 VPS、服务器部署方式                 |
| 🛑 出错恢复    | 重启容器即可恢复，镜像固定                                  | 手动排查、修改配置、重启 systemd           |

:::tip 💡 VPS.Town 大盘鸡解决方案

1. 最多可提供高达 **8TB 大容量存储** 的选项，非常适合存放大量项目代码与文档；
2. 同时也提供 **SSD & HDD** 混合方案，读写速度更快、成本更低；
3. 性价比高，适合个人开发者、小团队进行长期托管部署；
4. 抗 DMCA 版权投诉，可用于一些敏感项目；
5. ⚠️ 其中 1TB 存储大盘鸡续费仅需 260/年或 28.5/月，硬盘一次性买断最低仅需 ¥80/TiB
6. 服务器位于香港，距离大陆近，延迟低，速度快

无 AFF 购买链接：[点我一键直达](https://vps.town/cart/goodsList.htm?fid=3\&gid=1)

:::