cavin/full-stack-doc

Fork 0

Files

peng 6e4e48fdd2 初次提交

2025-10-14 20:05:29 +08:00

6.1 KiB

Raw Blame History

云盘应用 Linux 环境部署指南

本文档介绍如何将云盘应用后端打包成 Docker 镜像并部署到 Linux 环境。

📋 部署前准备

1. 系统要求

Linux 操作系统（推荐 Ubuntu 20.04+ 或 CentOS 8+）
Docker 20.10+
Docker Compose 2.0+
至少 2GB 内存
至少 10GB 磁盘空间

2. 安装 Docker

Ubuntu/Debian:

# 更新包索引
sudo apt-get update

# 安装必要的包
sudo apt-get install ca-certificates curl gnupg lsb-release

# 添加 Docker 官方 GPG key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

CentOS/RHEL:

# 安装 yum-utils
sudo yum install -y yum-utils

# 添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 安装 Docker Engine
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

3. 启动 Docker 服务

sudo systemctl start docker
sudo systemctl enable docker

4. 将用户添加到 docker 组（可选）

sudo usermod -aG docker $USER
# 重新登录或执行
newgrp docker

🚀 快速部署

方法一：使用自动部署脚本（推荐）

将 backend 目录上传到服务器
进入 backend 目录
给脚本添加执行权限：
```
chmod +x build-docker.sh
```

运行部署脚本：

# 完整部署（构建镜像 + 运行容器）
./build-docker.sh

# 或者使用 Docker Compose 部署
./build-docker.sh compose

方法二：手动部署

构建镜像

docker build -t cloud-drive-backend:latest .

运行容器

docker run -d \
  --name cloud-drive-backend \
  --restart unless-stopped \
  -p 8002:8002 \
  -v $(pwd)/uploads:/app/uploads \
  -v $(pwd)/logs:/app/logs \
  -e ENVIRONMENT=production \
  cloud-drive-backend:latest

方法三：使用 Docker Compose

配置环境变量

cp .env.example .env
# 编辑 .env 文件，设置正确的配置

启动服务
```
docker-compose up -d
```

⚙️ 配置说明

环境变量配置

创建 .env 文件：

# 数据库配置
DATABASE_URL=mysql://username:password@mysql:3306/mytest_db
MYSQL_ROOT_PASSWORD=your_root_password
MYSQL_DATABASE=mytest_db
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password

# Redis 配置
REDIS_URL=redis://redis:6379/0

# 应用配置
SECRET_KEY=your-production-secret-key
CORS_ORIGINS=http://localhost:3003,https://yourdomain.com
ENVIRONMENT=production

端口配置

应用端口：8002
MySQL 端口：3306
Redis 端口：6379

数据持久化

./uploads - 文件上传目录
./logs - 应用日志目录
mysql_data - MySQL 数据目录
redis_data - Redis 数据目录

🛠️ 常用命令

容器管理

# 查看容器状态
./build-docker.sh status

# 查看容器日志
./build-docker.sh logs

# 重启容器
./build-docker.sh restart

# 停止容器
./build-docker.sh stop

# 清理资源
./build-docker.sh cleanup

Docker Compose 命令

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 更新并重启
docker-compose up -d --build

🔍 健康检查

应用包含内置的健康检查端点：

端点：http://localhost:8002/api/v1/health
检查间隔：30秒
超时时间：30秒
重试次数：3次

手动检查：

curl http://localhost:8002/api/v1/health

🔧 故障排除

1. 容器无法启动

# 查看容器日志
docker logs cloud-drive-backend

# 检查端口占用
netstat -tulpn | grep 8002

2. 数据库连接失败

检查数据库服务是否运行
验证连接字符串是否正确
确认网络连通性

3. 文件上传问题

检查 uploads 目录权限
确认磁盘空间充足
验证文件大小限制

4. 内存不足

# 检查内存使用
free -h

# 检查容器资源使用
docker stats

📊 监控

日志监控

# 实时查看日志
tail -f logs/app.log

# 查看错误日志
grep ERROR logs/app.log

性能监控

# 查看容器资源使用
docker stats cloud-drive-backend

# 查看系统资源
htop

🔒 安全配置

1. 防火墙设置

# Ubuntu UFW
sudo ufw allow 8002
sudo ufw allow 22
sudo ufw enable

# CentOS firewalld
sudo firewall-cmd --permanent --add-port=8002/tcp
sudo firewall-cmd --reload

2. SSL/TLS 配置

建议使用 Nginx 或 Caddy 作为反向代理来处理 HTTPS：

server {
    listen 443 ssl;
    server_name yourdomain.com;

    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private.key;

    location / {
        proxy_pass http://localhost:8002;
        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;
    }
}

📈 扩展部署

1. 负载均衡

使用多个容器实例配合负载均衡器：

# docker-compose.scale.yml
version: '3.8'
services:
  app:
    image: cloud-drive-backend:latest
    scale: 3
    # ... 其他配置

2. 集群部署

使用 Docker Swarm 或 Kubernetes 进行集群部署。

📞 支持

如遇到问题，请：

查看本文档的故障排除部分
检查应用日志和 Docker 日志
确认所有配置正确
验证系统资源是否充足

注意: 生产环境部署前请务必：

更改默认密码和密钥
配置适当的备份策略
设置监控和告警
进行充分的测试

6.1 KiB Raw Blame History Unescape Escape