保姆级教程：在Ubuntu 24.04上从零部署Cloudreve私有网盘（含Nginx反代与HTTPS配置）-编程阁

在Ubuntu 24.04上构建企业级私有云盘：Cloudreve全栈部署指南

当数据主权成为数字时代的新命题，越来越多的技术团队开始重新审视公有云存储的边界。本文将带您从零构建一个支持多存储后端、具备生产级可靠性的私有云盘系统——基于开源项目Cloudreve的完整解决方案，特别针对Ubuntu 24.04 LTS的最新特性进行优化适配。

1. 环境准备与基础架构设计

在开始部署前，我们需要明确系统架构的核心组件。典型的生产环境部署包含以下层次：

应用层：Cloudreve主程序，提供Web界面和API服务
代理层：Nginx实现HTTPS卸载和负载均衡
存储层：支持本地存储、对象存储或混合模式
安全层：TLS加密、防火墙规则和系统服务隔离

1.1 系统初始化配置

首先确保您的Ubuntu 24.04系统已更新至最新状态：

sudo apt update && sudo apt upgrade -y sudo apt install -y wget curl gnupg2 software-properties-common

创建专用部署用户并设置权限：

sudo useradd -m -s /bin/bash cloudreve sudo usermod -aG sudo cloudreve sudo mkdir -p /opt/cloudreve/{uploads,avatar} sudo chown -R cloudreve:cloudreve /opt/cloudreve

1.2 依赖组件安装

Cloudreve需要的基础依赖包括：

数据库：MySQL/MariaDB或SQLite
缓存：Redis（推荐用于生产环境）
进程管理：systemd

以MySQL为例的安装配置：

sudo apt install -y mysql-server redis-server sudo mysql_secure_installation

创建专用数据库：

CREATE DATABASE cloudreve_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'cloudreve_user'@'localhost' IDENTIFIED BY 'StrongPassword123!'; GRANT ALL PRIVILEGES ON cloudreve_db.* TO 'cloudreve_user'@'localhost'; FLUSH PRIVILEGES;

2. Cloudreve核心部署

2.1 获取并安装最新版本

访问Cloudreve的GitHub发布页面获取最新稳定版（当前为3.8.3）：

cd /tmp wget https://github.com/cloudreve/Cloudreve/releases/download/3.8.3/cloudreve_3.8.3_linux_amd64.tar.gz tar -zxvf cloudreve_3.8.3_linux_amd64.tar.gz -C /opt/cloudreve chmod +x /opt/cloudreve/cloudreve

首次运行生成配置文件：

cd /opt/cloudreve ./cloudreve

程序会自动生成conf.ini和初始管理员密码，记录下密码后按Ctrl+C终止进程。

2.2 高级配置调优

编辑/opt/cloudreve/conf.ini进行生产环境优化：

[System] Mode = master Listen = :5212 Debug = false SessionSecret = 生成32位随机字符串 HashIDSalt = 生成另一组32位随机字符串 [Database] Type = mysql Host = 127.0.0.1 Port = 3306 User = cloudreve_user Password = StrongPassword123! Name = cloudreve_db Charset = utf8mb4 [Redis] Server = 127.0.0.1:6379 Password = DB = 0

提示：使用openssl rand -hex 16可生成高质量的随机密钥

3. 系统服务化与进程守护

创建systemd服务单元文件：

sudo tee /etc/systemd/system/cloudreve.service > /dev/null <<EOF [Unit] Description=Cloudreve Service After=network.target mysql.service redis-server.service [Service] User=cloudreve WorkingDirectory=/opt/cloudreve ExecStart=/opt/cloudreve/cloudreve Restart=always RestartSec=5s [Install] WantedBy=multi-user.target EOF

启用并启动服务：

sudo systemctl daemon-reload sudo systemctl enable --now cloudreve sudo systemctl status cloudreve # 验证状态

4. Nginx反向代理与HTTPS配置

4.1 安装Nginx与SSL证书

sudo apt install -y nginx sudo mkdir -p /etc/nginx/ssl

使用Let's Encrypt获取免费证书（需已配置域名）：

sudo apt install -y certbot python3-certbot-nginx sudo certbot --nginx -d yourdomain.com

或创建自签名证书（测试环境）：

sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \ -keyout /etc/nginx/ssl/selfsigned.key \ -out /etc/nginx/ssl/selfsigned.crt \ -subj "/CN=yourdomain.com/O=My Organization/C=US"

4.2 优化Nginx配置

创建专用配置文件/etc/nginx/sites-available/cloudreve：

server { listen 443 ssl http2; listen [::]:443 ssl http2; server_name yourdomain.com; ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key /etc/nginx/ssl/privkey.pem; ssl_session_timeout 1d; ssl_session_cache shared:MozSSL:10m; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256; ssl_prefer_server_ciphers on; client_max_body_size 10240M; # 允许大文件上传 location / { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_pass http://127.0.0.1:5212; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } } server { listen 80; server_name yourdomain.com; return 301 https://$server_name$request_uri; }

启用配置并测试：

sudo ln -s /etc/nginx/sites-available/cloudreve /etc/nginx/sites-enabled/ sudo nginx -t && sudo systemctl reload nginx

5. 高级功能扩展

5.1 对接对象存储

在conf.ini中添加阿里云OSS配置示例：

[OSS] Type = aliyun AccessKeyId = your_access_key AccessKeySecret = your_secret_key Endpoint = oss-cn-hangzhou.aliyuncs.com Bucket = your-bucket-name

5.2 性能调优参数

[System] MaxWorkerNum = 50 # 根据CPU核心数调整 TaskQueueWorkers = 10 TaskQueueMaxWorker = 20 [Redis] PoolSize = 30

5.3 定期维护脚本

创建数据库备份脚本/usr/local/bin/backup_cloudreve.sh：

#!/bin/bash DATE=$(date +%Y%m%d) BACKUP_DIR="/opt/backups" mkdir -p $BACKUP_DIR mysqldump -u cloudreve_user -p'StrongPassword123!' cloudreve_db > $BACKUP_DIR/cloudreve_db_$DATE.sql tar czf $BACKUP_DIR/cloudreve_data_$DATE.tar.gz /opt/cloudreve/{uploads,avatar,cloudreve.db} # 保留最近7天备份 find $BACKUP_DIR -type f -mtime +7 -delete

设置定时任务：

sudo chmod +x /usr/local/bin/backup_cloudreve.sh sudo crontab -e

添加以下内容：

0 3 * * * /usr/local/bin/backup_cloudreve.sh

6. 安全加固措施

6.1 防火墙配置

sudo ufw allow 22/tcp sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw enable

6.2 文件权限优化

sudo chmod 750 /opt/cloudreve sudo chmod 600 /opt/cloudreve/conf.ini

6.3 定期安全更新

设置自动安全更新：

sudo apt install -y unattended-upgrades sudo dpkg-reconfigure -plow unattended-upgrades

在测试环境中部署这套方案时，建议先使用虚拟机进行全流程验证。实际部署中遇到最多的问题往往是文件权限配置不当导致的写入失败，可以通过journalctl -u cloudreve -f实时查看服务日志进行排错。

保姆级教程：在Ubuntu 24.04上从零部署Cloudreve私有网盘（含Nginx反代与HTTPS配置）