部署指南

环境要求

后端环境

软件	版本要求
Python	3.9 - 3.10
MySQL	5.7+ / 8.0
Redis	5.0+
Nginx	1.18+

前端环境

软件	版本要求
Node.js	18.0+
pnpm	9.0+

后端部署

1. 环境准备

# 安装 Python 依赖管理工具
pip install poetry

# 进入后端目录
cd salted-fish-api

# 安装依赖
poetry install

# 激活虚拟环境
poetry shell

2. 数据库配置

# SaltedFish/settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'salted_fish',
        'USER': 'your_username',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '3306',
        'OPTIONS': {
            'charset': 'utf8mb4',
        }
    }
}

-- 创建数据库
CREATE DATABASE salted_fish CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. Redis 配置

# settings.py
CACHES = {
    'default': {
        'BACKEND': 'django_redis.cache.RedisCache',
        'LOCATION': 'redis://127.0.0.1:6379/0',
        'OPTIONS': {
            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
        }
    }
}

# Celery 配置
CELERY_BROKER_URL = 'redis://127.0.0.1:6379/1'
CELERY_RESULT_BACKEND = 'django-db'

4. 数据库迁移

# 创建迁移文件
python manage.py makemigrations

# 执行迁移
python manage.py migrate

# 创建超级用户
python manage.py createsuperuser

# 收集静态文件
python manage.py collectstatic

5. Gunicorn 配置

# 安装 Gunicorn
pip install gunicorn

# 启动服务
gunicorn SaltedFish.wsgi:application \
    --bind 0.0.0.0:8000 \
    --workers 4 \
    --timeout 120 \
    --access-logfile logs/access.log \
    --error-logfile logs/error.log

6. Celery 启动

# 启动 Beat (定时任务调度)
celery -A SaltedFish beat -l info \
    --logfile=Log/CeleryTask/celery_beat.log

# 启动 Worker (任务执行)
celery -A SaltedFish worker -l info \
    --logfile=Log/CeleryTask/celery_worker.log \
    -P eventlet

7. Supervisor 配置

; /etc/supervisor/conf.d/salted-fish.conf

[program:salted-fish-api]
command=/path/to/venv/bin/gunicorn SaltedFish.wsgi:application --bind 0.0.0.0:8000 --workers 4
directory=/path/to/salted-fish-api
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/salted-fish-api.log

[program:celery-worker]
command=/path/to/venv/bin/celery -A SaltedFish worker -l info -P eventlet
directory=/path/to/salted-fish-api
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/celery-worker.log

[program:celery-beat]
command=/path/to/venv/bin/celery -A SaltedFish beat -l info
directory=/path/to/salted-fish-api
user=www-data
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/celery-beat.log

# 重新加载配置
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start all

前端部署

PC 管理后台

# 进入目录
cd salted-fish-web

# 安装依赖
pnpm install

# 构建生产版本
pnpm build

# 构建产物在 apps/web-antd/dist 目录

移动端应用

# 进入目录
cd salted-fish-mobile

# 安装依赖
npm install

# 构建生产版本
npm run build

# 构建产物在 dist 目录

Nginx 配置

# /etc/nginx/sites-available/salted-fish

# 后端 API
upstream salted_fish_api {
    server 127.0.0.1:8000;
}

# PC 管理后台
server {
    listen 80;
    server_name admin.example.com;

    root /var/www/salted-fish-web/apps/web-antd/dist;
    index index.html;

    # Gzip 压缩
    gzip on;
    gzip_types text/plain text/css application/json application/javascript;

    # 静态资源缓存
    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # SPA 路由
    location / {
        try_files $uri $uri/ /index.html;
    }

    # API 代理
    location /api/ {
        proxy_pass http://salted_fish_api;
        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;
    }

    # 媒体文件
    location /media/ {
        alias /var/www/salted-fish-api/media/;
        expires 7d;
    }
}

# 移动端应用
server {
    listen 80;
    server_name m.example.com;

    root /var/www/salted-fish-mobile/dist;
    index index.html;

    gzip on;
    gzip_types text/plain text/css application/json application/javascript;

    location /assets/ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://salted_fish_api;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

# 启用站点
sudo ln -s /etc/nginx/sites-available/salted-fish /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重新加载
sudo systemctl reload nginx

Docker 部署

docker-compose.yml

version: '3.8'

services:
  # MySQL
  mysql:
    image: mysql:8.0
    container_name: salted-fish-mysql
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: salted_fish
      MYSQL_USER: salted_fish
      MYSQL_PASSWORD: your_password
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3306:3306"
    restart: always

  # Redis
  redis:
    image: redis:7-alpine
    container_name: salted-fish-redis
    volumes:
      - redis_data:/data
    ports:
      - "6379:6379"
    restart: always

  # Django API
  api:
    build:
      context: ./salted-fish-api
      dockerfile: Dockerfile
    container_name: salted-fish-api
    depends_on:
      - mysql
      - redis
    environment:
      - DEBUG=False
      - DATABASE_URL=mysql://salted_fish:your_password@mysql:3306/salted_fish
      - REDIS_URL=redis://redis:6379/0
    volumes:
      - ./salted-fish-api/media:/app/media
      - ./salted-fish-api/Log:/app/Log
    ports:
      - "8000:8000"
    restart: always

  # Celery Worker
  celery-worker:
    build:
      context: ./salted-fish-api
      dockerfile: Dockerfile
    container_name: salted-fish-celery-worker
    command: celery -A SaltedFish worker -l info -P eventlet
    depends_on:
      - api
      - redis
    environment:
      - DEBUG=False
      - DATABASE_URL=mysql://salted_fish:your_password@mysql:3306/salted_fish
      - REDIS_URL=redis://redis:6379/0
    volumes:
      - ./salted-fish-api/Log:/app/Log
    restart: always

  # Celery Beat
  celery-beat:
    build:
      context: ./salted-fish-api
      dockerfile: Dockerfile
    container_name: salted-fish-celery-beat
    command: celery -A SaltedFish beat -l info
    depends_on:
      - api
      - redis
    environment:
      - DEBUG=False
      - DATABASE_URL=mysql://salted_fish:your_password@mysql:3306/salted_fish
      - REDIS_URL=redis://redis:6379/0
    restart: always

  # Nginx
  nginx:
    image: nginx:alpine
    container_name: salted-fish-nginx
    depends_on:
      - api
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./salted-fish-web/apps/web-antd/dist:/var/www/web
      - ./salted-fish-mobile/dist:/var/www/mobile
      - ./salted-fish-api/media:/var/www/media
    ports:
      - "80:80"
      - "443:443"
    restart: always

volumes:
  mysql_data:
  redis_data:

后端 Dockerfile

# salted-fish-api/Dockerfile
FROM python:3.10-slim

WORKDIR /app

# 安装系统依赖
RUN apt-get update && apt-get install -y \
    gcc \
    default-libmysqlclient-dev \
    pkg-config \
    && rm -rf /var/lib/apt/lists/*

# 安装 Poetry
RUN pip install poetry

# 复制依赖文件
COPY pyproject.toml poetry.lock ./

# 安装依赖
RUN poetry config virtualenvs.create false \
    && poetry install --no-dev --no-interaction --no-ansi

# 复制代码
COPY . .

# 收集静态文件
RUN python manage.py collectstatic --noinput

# 启动命令
CMD ["gunicorn", "SaltedFish.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]

启动服务

# 构建并启动
docker-compose up -d --build

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

SSL 证书配置

Let's Encrypt

# 安装 Certbot
sudo apt install certbot python3-certbot-nginx

# 获取证书
sudo certbot --nginx -d admin.example.com -d m.example.com

# 自动续期
sudo certbot renew --dry-run

监控与日志

日志位置

/var/log/nginx/              # Nginx 日志
/var/log/supervisor/         # Supervisor 日志
/path/to/salted-fish-api/Log/
├── RunLog/                  # 应用运行日志
└── CeleryTask/              # Celery 任务日志

日志轮转

# /etc/logrotate.d/salted-fish
/path/to/salted-fish-api/Log/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 www-data www-data
}

常用运维命令

# 查看服务状态
sudo supervisorctl status

# 重启 API 服务
sudo supervisorctl restart salted-fish-api

# 查看 Nginx 错误日志
tail -f /var/log/nginx/error.log

# 查看 Celery 日志
tail -f /path/to/salted-fish-api/Log/CeleryTask/celery_worker.log

# 清理过期会话
python manage.py clearsessions

# 数据库备份
mysqldump -u root -p salted_fish > backup_$(date +%Y%m%d).sql