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

#📦 项目简介

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

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

为什么选择 linux_amd64 ？

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

#📦 安装命令示例：

cd /root
chmod +x cloudreve

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

#📸 安装文件示意：

#🚀 首次运行与激活

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

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

首次运行需要初始化数据库、配置文件等 （如果直接退出了，则说明有地方没有配置对）

#🔁 配置守护进程 systemd

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

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

填入的内容如下：

[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 启动 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 详解

请按照需要修改：

[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：

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

控制台界面：

设置反代：

配置 HTTPS：

#📁 添加存储策略

后台 → 存储策略 → 添加

#🐳 使用 Docker 安装（可选）

安装 docker

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

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

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

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

从机节点：

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

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

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

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

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

#📌 部署说明

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

部署命令示例：

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

#Aria2 配置：

Cloudreve 内的配置内容

VPS 上的配置内容

#📦 安装 Aria2

执行以下命令安装：

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

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

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

#⚙️ 修改 Aria2 配置文件

执行命令打开配置文件：

sudo vim /root/.aria2c/aria2.conf

建议修改以下参数：

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

###📄 配置修改参考：

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

#⚠️ 注意：

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

./aria2.sh

#qBittorrent 安装设置：

#安装 qBittorrent 4.3.9

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

修改下载路径到存储盘

进入网盘后台配置 qb 离线下载

测试一下即可使用

#❓ 常见问题 FAQ

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

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

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

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