阿里云服务器部署 Cloudreve 完整教程
- null
- 一、环境准备
- 1.1 阿里云服务器要求
- 1.2 安全组配置
- 二、服务器初始化配置
- 2.1 连接到服务器
- 2.2 更新系统
- 2.3 创建专用用户（推荐）
- 2.4 配置防火墙
- 三、安装必要软件
- 3.1 安装 Nginx
- 3.2 安装 MariaDB/MySQL（可选，用于持久化存储）
- 3.3 安装其他工具
- 四、下载并配置 Cloudreve
- 4.1 下载 Cloudreve
- 4.2 首次运行
- 4.3 配置 Cloudreve
- 4.4 创建数据目录
- 4.5 测试运行
- 五、配置反向代理（Nginx）
- 5.1 创建 Nginx 配置文件
- 5.2 启用配置
- 六、配置 HTTPS（可选但推荐）
- 6.1 使用 Let's Encrypt 免费证书
- 6.2 自动续期
- 七、设置开机自启
- 7.1 创建 Systemd 服务文件
- 7.2 启用服务
- 八、访问与管理
- 8.1 首次访问
- 8.2 基本配置
- 8.3 创建普通用户
- 8.4 配置对象存储（推荐）
- 九、常见问题排查
- 9.1 Cloudreve 无法启动
- 9.2 Nginx 502 Bad Gateway
- 9.3 上传文件失败
- 9.4 HTTPS 证书问题
- 9.5 数据库连接错误
- 9.6 性能优化建议
- 十、备份与恢复
- 10.1 备份数据
- 10.2 恢复数据
- 十一、安全建议
一、环境准备
1.1 阿里云服务器要求
*最低配置建议：*
- CPU: 1核
- 内存: 1GB
- 硬盘: 20GB+
- 操作系统: Ubuntu 20.04 LTS / CentOS 7+ / Debian 10+
*推荐配置：*
- CPU: 2核
- 内存: 2GB+
- 硬盘: 50GB+ SSD
- 带宽: 3Mbps+
1.2 安全组配置
在阿里云控制台配置安全组规则，开放以下端口：
| 端口 | 协议 | 用途 | 授权对象 |
|---|---|---|---|
| 22 | TCP | SSH 远程连接 | 0.0.0.0/0 或指定IP |
| 80 | TCP | HTTP 访问 | 0.0.0.0/0 |
| 443 | TCP | HTTPS 访问 | 0.0.0.0/0 |
| 5212 | TCP | Cloudreve 默认端口 | 127.0.0.1（仅本地） |
*配置步骤：*
\1. 登录阿里云控制台
\2. 进入 ECS 实例详情
\3. 点击"安全组" -> "配置规则"
\4. 添加入方向规则，按上表配置
---
二、服务器初始化配置
2.1 连接到服务器
```bash
ssh root@your_server_ip
```
2.2 更新系统
*Ubuntu/Debian:*
```bash
apt update && apt upgrade -y
```
*CentOS:*
```bash
yum update -y
```
2.3 创建专用用户（推荐）
```bash
# 创建新用户
adduser cloudreve
# 添加到 sudo 组
usermod -aG sudo cloudreve # Ubuntu/Debian
# 或
usermod -aG wheel cloudreve # CentOS
# 切换到新用户
su - cloudreve
```
2.4 配置防火墙
*Ubuntu (UFW)😗
```bash
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status
```
*CentOS (firewalld)😗
```bash
firewall-cmd --permanent --add-service=ssh
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload
```
---
三、安装必要软件
3.1 安装 Nginx
*Ubuntu/Debian:*
```bash
apt install nginx -y
```
*CentOS:*
```bash
yum install epel-release -y
yum install nginx -y
```
启动 Nginx：
```bash
systemctl start nginx
systemctl enable nginx
systemctl status nginx
```
验证安装：浏览器访问 http://your_server_ip，应看到 Nginx 欢迎页面。
3.2 安装 MariaDB/MySQL（可选，用于持久化存储）
*Ubuntu/Debian:*
```bash
apt install mariadb-server mariadb-client -y
```
*CentOS:*
```bash
yum install mariadb-server mariadb-client -y
```
配置数据库：
```bash
systemctl start mariadb
systemctl enable mariadb
mysql_secure_installation
```
创建数据库和用户：
```sql
mysql -u root -p
CREATE DATABASE cloudreve CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'cloudreve'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON cloudreve.* TO 'cloudreve'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```
3.3 安装其他工具
```bash
# 安装 wget/curl
apt install wget curl unzip -y # Ubuntu/Debian
# 或
yum install wget curl unzip -y # CentOS
# 安装 systemd 服务管理工具（通常已预装）
apt install systemd -y
```
---
四、下载并配置 Cloudreve
4.1 下载 Cloudreve
访问 Cloudreve GitHub Releases 获取最新版本。
```bash
# 创建工作目录
mkdir -p ~/cloudreve
cd ~/cloudreve
# 下载最新版本（替换为实际版本号）
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
# 赋予执行权限
chmod +x cloudreve
```
4.2 首次运行
```bash
# 首次运行，生成配置文件和初始管理员账号
./cloudreve
```
*重要：* 首次运行后会显示管理员账号和密码，请妥善保存！
```
[Info] 2024-01-01 12:00:00 初始管理员账号：admin@cloudreve.org
[Info] 2024-01-01 12:00:00 初始管理员密码：xxxxxx
```
按 Ctrl+C 停止运行。
4.3 配置 Cloudreve
编辑配置文件 conf.ini：
```bash
nano conf.ini
```
*基础配置示例：*
```ini
[System]
Mode = master
Listen = :5212
Debug = false
SessionSecret = your_random_secret_key_here
HashIDSalt = another_random_salt_here
[Database]
Type = mysql
Port = 3306
User = cloudreve
Password = your_strong_password
Host = 127.0.0.1
Name = cloudreve
TablePrefix = cd_
Charset = utf8mb4
[Redis]
Server = 127.0.0.1:6379
Password =
DB = 0
[SSL]
Listen = :443
CertPath = /etc/nginx/ssl/your_domain.crt
KeyPath = /etc/nginx/ssl/your_domain.key
[UnixSocket]
Listen = /run/cloudreve/cloudreve.sock
Perm = 0660
[Proxy]
UseProxy = false
ProxyURL =
[Advanced]
TempPath = temp
Version = 3.8.3
```
*简化配置（使用 SQLite，无需数据库）：*
```ini
[System]
Mode = master
Listen = :5212
Debug = false
[Database]
Type = sqlite3
DBFile = cloudreve.db
```
4.4 创建数据目录
```bash
# 创建上传文件存储目录
mkdir -p ~/cloudreve/uploads
mkdir -p ~/cloudreve/avatar
# 设置权限
chmod 755 ~/cloudreve/uploads
chmod 755 ~/cloudreve/avatar
```
4.5 测试运行
```bash
./cloudreve
```
如果无错误输出，按 Ctrl+C 停止，继续下一步配置开机自启。
---
五、配置反向代理（Nginx）
5.1 创建 Nginx 配置文件
```bash
sudo nano /etc/nginx/sites-available/cloudreve
```
*HTTP 配置示例：*
```nginx
server {
listen 80;
server_name your_domain.com www.your_domain.com;
# 日志文件
access_log /var/log/nginx/cloudreve_access.log;
error_log /var/log/nginx/cloudreve_error.log;
# 客户端最大上传大小
client_max_body_size 10G;
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_redirect off;
proxy_pass http://127.0.0.1:5212;
# WebSocket 支持
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
```
*HTTPS 配置示例（推荐）：*
```nginx
server {
listen 80;
server_name your_domain.com www.your_domain.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name your_domain.com www.your_domain.com;
# SSL 证书
ssl_certificate /etc/nginx/ssl/your_domain.crt;
ssl_certificate_key /etc/nginx/ssl/your_domain.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
ssl_prefer_server_ciphers on;
# 日志文件
access_log /var/log/nginx/cloudreve_access.log;
error_log /var/log/nginx/cloudreve_error.log;
# 客户端最大上传大小
client_max_body_size 10G;
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_redirect off;
proxy_pass http://127.0.0.1:5212;
# WebSocket 支持
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
```
5.2 启用配置
```bash
# 创建符号链接
sudo ln -s /etc/nginx/sites-available/cloudreve /etc/nginx/sites-enabled/
# 删除默认配置（可选）
sudo rm /etc/nginx/sites-enabled/default
# 测试配置
sudo nginx -t
# 重启 Nginx
sudo systemctl restart nginx
```
---
六、配置 HTTPS（可选但推荐）
6.1 使用 Let's Encrypt 免费证书
安装 Certbot：
*Ubuntu/Debian:*
```bash
apt install certbot python3-certbot-nginx -y
```
*CentOS:*
```bash
yum install certbot python3-certbot-nginx -y
```
获取证书：
```bash
sudo certbot --nginx -d your_domain.com -d www.your_domain.com
```
按照提示完成验证，Certbot 会自动配置 Nginx。
6.2 自动续期
```bash
# 测试自动续期
sudo certbot renew --dry-run
# 添加定时任务
sudo crontab -e
```
添加以下内容：
```cron
0 3 * * 1 certbot renew --quiet && systemctl reload nginx
```
---
七、设置开机自启
7.1 创建 Systemd 服务文件
```bash
sudo nano /etc/systemd/system/cloudreve.service
```
写入以下内容：
```ini
[Unit]
Description=Cloudreve File Manager
Documentation=https://docs.cloudreve.org
After=network.target
After=mariadb.service
Wants=mariadb.service
[Service]
User=cloudreve
Group=cloudreve
WorkingDirectory=/home/cloudreve/cloudreve
ExecStart=/home/cloudreve/cloudreve/cloudreve
Restart=on-failure
RestartSec=5s
# 安全增强
NoNewPrivileges=true
ProtectSystem=strict
ReadWritePaths=/home/cloudreve/cloudreve/uploads
ReadWritePaths=/home/cloudreve/cloudreve/avatar
[Install]
WantedBy=multi-user.target
```
7.2 启用服务
```bash
# 重新加载 systemd
sudo systemctl daemon-reload
# 启动 Cloudreve
sudo systemctl start cloudreve
# 设置开机自启
sudo systemctl enable cloudreve
# 查看状态
sudo systemctl status cloudreve
# 查看日志
sudo journalctl -u cloudreve -f
```
---
八、访问与管理
8.1 首次访问
\1. 浏览器访问：http://your_domain.com 或 https://your_domain.com
\2. 使用首次运行时生成的管理员账号登录
\3. 立即修改默认密码
8.2 基本配置
登录后进行以下配置：
\1. *站点设置*
- 站点名称
- 站点描述
- Logo 上传
\2. *存储策略*
- 本地存储（默认）
- 对象存储（阿里云 OSS、腾讯云 COS、七牛云等）
\3. *用户注册*
- 是否允许公开注册
- 注册邮箱验证
- 初始容量设置
\4. *分享设置*
- 分享有效期
- 分享密码要求
8.3 创建普通用户
\1. 进入管理面板 -> 用户管理
\2. 点击"新建用户"
\3. 填写用户信息
\4. 设置存储空间配额
8.4 配置对象存储（推荐）
以阿里云 OSS 为例：
\1. 进入管理面板 -> 存储策略
\2. 点击"新建存储策略"
\3. 选择"阿里云 OSS"
\4. 填写配置：
- Endpoint: oss-cn-hangzhou.aliyuncs.com
- Bucket: 你的 bucket 名称
- AccessKey ID
- AccessKey Secret
- 访问域名
---
九、常见问题排查
9.1 Cloudreve 无法启动
*检查日志：*
```bash
sudo journalctl -u cloudreve -n 50 --no-pager
```
*常见原因：*
- 端口被占用：修改 conf.ini 中的监听端口
- 权限问题：确保用户对目录有读写权限
- 数据库连接失败：检查数据库配置和连接信息
9.2 Nginx 502 Bad Gateway
*检查 Cloudreve 是否运行：*
```bash
sudo systemctl status cloudreve
```
*检查端口监听：*
```bash
netstat -tlnp | grep 5212
```
*检查 Nginx 错误日志：*
```bash
sudo tail -f /var/log/nginx/cloudreve_error.log
```
9.3 上传文件失败
*检查目录权限：*
```bash
ls -la ~/cloudreve/uploads
chmod 755 ~/cloudreve/uploads
chown -R cloudreve:cloudreve ~/cloudreve/uploads
```
*检查 Nginx 配置：*
确保 client_max_body_size 设置足够大。
*检查 PHP/后端限制：*
如果使用对象存储，检查 OSS 配置。
9.4 HTTPS 证书问题
*检查证书路径：*
```bash
ls -la /etc/nginx/ssl/
```
*检查证书有效期：*
```bash
openssl x509 -in /etc/nginx/ssl/your_domain.crt -noout -dates
```
*手动续期：*
```bash
sudo certbot renew
sudo systemctl reload nginx
```
9.5 数据库连接错误
*检查 MariaDB 状态：*
```bash
sudo systemctl status mariadb
```
*测试数据库连接：*
```bash
mysql -u cloudreve -p cloudreve
```
*检查配置文件：*
确认 conf.ini 中的数据库配置正确。
9.6 性能优化建议
\1. *启用 Redis 缓存*
```bash
apt install redis-server -y
systemctl enable redis-server
```
在 conf.ini 中配置 Redis。
\2. *调整 Nginx 配置*
```nginx
# 启用 gzip 压缩
gzip on;
gzip_types text/plain text/css application/json application/javascript;
# 静态文件缓存
location ~* .(jpg|jpeg|png|gif|ico|css|js)$ {
expires 30d;
add_header Cache-Control "public, immutable";
}
```
\3. *使用 CDN*
将静态资源通过 CDN 分发，提升访问速度。
---
十、备份与恢复
10.1 备份数据
*备份数据库：*
```bash
mysqldump -u cloudreve -p cloudreve > cloudreve_backup_$(date +%Y%m%d).sql
```
*备份上传文件：*
```bash
tar -czf uploads_backup_$(date +%Y%m%d).tar.gz ~/cloudreve/uploads
```
*备份配置文件：*
```bash
cp ~/cloudreve/conf.ini conf.ini.backup
```
10.2 恢复数据
*恢复数据库：*
```bash
mysql -u cloudreve -p cloudreve < cloudreve_backup_20240101.sql
```
*恢复上传文件：*
```bash
tar -xzf uploads_backup_20240101.tar.gz -C ~/cloudreve/
```
---
十一、安全建议
\1. *定期更新系统*
```bash
apt update && apt upgrade -y
```
\2. *使用强密码*
- 管理员密码
- 数据库密码
- SSH 密钥认证
\3. *配置 Fail2Ban*
```bash
apt install fail2ban -y
systemctl enable fail2ban
```
\4. *限制 SSH 访问*
编辑 /etc/ssh/sshd_config：
```
PermitRootLogin no
PasswordAuthentication no
AllowUsers cloudreve
```
\5. *定期备份*
设置自动化备份脚本和异地备份。
\6. *监控日志*
定期检查系统和服务日志，发现异常及时处理。
---
## 附录
### A. 常用命令速查
```bash
# 服务管理
sudo systemctl start cloudreve # 启动
sudo systemctl stop cloudreve # 停止
sudo systemctl restart cloudreve # 重启
sudo systemctl status cloudreve # 状态
sudo systemctl enable cloudreve # 开机自启
# 日志查看
sudo journalctl -u cloudreve -f # 实时日志
sudo journalctl -u cloudreve -n 100 # 最近100行
# Nginx 管理
sudo nginx -t # 测试配置
sudo systemctl restart nginx # 重启
# 数据库管理
sudo systemctl status mariadb # 状态
mysqldump -u cloudreve -p cloudreve > backup.sql # 备份
```
### B. 参考资源
- Cloudreve 官方文档
- Cloudreve GitHub
- Nginx 官方文档
- Let's Encrypt
### C. 版本信息
- 教程适用版本：Cloudreve 3.x
- 最后更新：2026-04-30
---
*祝你部署顺利！如有问题，欢迎查阅官方文档或社区讨论。*