Cloudreve V4 私有云网盘搭建全攻略｜从 0 到 1 部署 + 性能优化，解决存储 & 访问痛点

https://docs.vps.town/guide/how-to-install-cloudreve-v4-vps-town

Cloudreve V4 程序简介

Cloudreve 可以让您快速搭建起公私兼备的网盘系统。Cloudreve 在底层支持不同的云存储平台，用户在实际使用时无须关心物理存储方式。你可以使用 Cloudreve 搭建个人用网盘、文件分享系统，亦或是针对大小团体的公有云系统。

Cloudreve 本身是一款“网盘”而非“其他网盘的管理器”，其所支持的存储提供商大多为公有云的存储专用产品，而非针对个人消费者的网盘。

文档：https://docsv4.cloudreve.org/zh/

准备工作

本教程基于 VPS.Town debian12 系统（推荐）

下载 cloudreve 的本体文件 这里用捐赠版进行演示说明

下载 linux amd64 https://github.com/cloudreve/Cloudreve/releases

安装 cloudreve

通过ssh上传文件

此处使用finalshell 把cloudreve上传到了/root目录

首次运行

首次运行需要初始化数据库、配置文件等

cd /home
chmod +x ./cloudreve
./cloudreve

如果是捐赠版 则需要使用以下命令

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

然后ctrl+c退出即可

配置进程守护

安装vim 配置进程守护

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

按i进入编辑模式

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

[Service]
WorkingDirectory=/root
ExecStart=/root/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

按：wq 保存并退出

通过 Systemd 启动 Cloudreve

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

日后管理 Cloudreve：

# 停止 Cloudreve
sudo systemctl stop cloudreve

# 启动 Cloudreve
sudo systemctl start cloudreve

# 重启 Cloudreve
sudo systemctl restart cloudreve

# 查看 Cloudreve 状态
sudo systemctl status cloudreve

配置conf.ini

首先说明一下这里面东西都是干什么用的，按需修改

建议

1. 修改数据库，改成mysql（默认的性能太烂了）
2. 新增Redis，可以增加多用户的效率和使用体验
3. 修改日志到error，减少日志数量

[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

修改完配置文件，保存后重启cloureve即可生效

使用 1panel 配置反向代理到 80/443 上

安装1panel

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

安装openresty

配置反向代理

配置443证书

访问网站

添加存储

大功告成！

番外

配置离线下载

见下文从机节点部分

使用docker安装

安装docker

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

复制登录命令

启动容器

docker run -d --name cloudreve -p 5212:5212 \
    -v ~/cloudreve/data:/cloudreve/data \
    -e CR_LICENSE_KEY=你的授权密钥 \
    cloudreve.azurecr.io/cloudreve/pro:latest

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

部署从机节点

从机节点可以干什么：解压缩 创建压缩文件 离线下载

可以大幅度分担主节点压力，把多余操作分散进行

配置方式同上
唯一需要修改的就是conf.ini

我们只需要把生成的conf配置复制进去即可，无需多余修改

配置离线下载

使用 Aria2 配置离线下载

安装aria2

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

输入1安装。
安装完会有配置信息

可能需要修改一下配置文件

sudo vim /root/.aria2c/aria2.conf

主要需要修改以下信息

1. 把最大同时下载任务数改大一点
2. 把最大连接数改大一点
3. 把下载目录改到存储盘，防止爆盘

完成后记得重启！！！要不然不生效

#修改参考信息
dir=/home/aria2/downloads
max-concurrent-downloads=500
max-connection-per-server=320
split=640

安装qbittorrent 4.3.9

wget https://raw.githubusercontent.com/networkdu/qb439/refs/heads/main/install.sh && chmod +x install.sh && ./install.sh

修改下载路径到存储盘

测试一下即可使用