dj-rest-auth部署实战：Docker、Nginx与生产环境配置

【免费下载链接】dj-rest-auth Authentication for Django Rest Framework 项目地址: https://gitcode.com/gh_mirrors/dj/dj-rest-auth

什么是dj-rest-auth？

dj-rest-auth是一个为Django Rest Framework提供身份验证功能的强大工具，它能够帮助开发者快速实现用户认证、授权等功能，是构建现代Web应用的理想选择。本文将详细介绍如何使用Docker和Nginx部署dj-rest-auth到生产环境，确保应用安全、高效地运行。

准备工作

在开始部署之前，我们需要确保系统中已经安装了Docker和Docker Compose。如果尚未安装，可以参考官方文档进行安装。

首先，克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/dj/dj-rest-auth
cd dj-rest-auth

Docker部署方案

Docker Compose配置

项目中已经提供了docker-compose.yml文件，我们可以直接使用它来部署应用。该文件位于项目根目录下，定义了应用的服务组合。

以下是docker-compose.yml的主要内容：

version: '3'

services:
  db:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    env_file:
      - ./.env
    environment:
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_USER=${DB_USER}
      - POSTGRES_DB=${DB_NAME}
    restart: always

  backend:
    build: ./demo/backend
    command: gunicorn demo.wsgi:application --bind 0.0.0.0:8000
    volumes:
      - static_volume:/app/staticfiles
      - media_volume:/app/media
    env_file:
      - ./.env
    depends_on:
      - db
    restart: always

  frontend:
    build: ./demo/spa-client
    volumes:
      - frontend_build:/app/.next
    env_file:
      - ./.env
    restart: always

  nginx:
    image: nginx:1.21
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./demo/nginx/conf.d:/etc/nginx/conf.d
      - static_volume:/var/www/static
      - media_volume:/var/www/media
      - frontend_build:/var/www/frontend
      - ./demo/nginx/certbot/conf:/etc/letsencrypt
      - ./demo/nginx/certbot/www:/var/www/certbot
    depends_on:
      - backend
      - frontend
    restart: always

volumes:
  postgres_data:
  static_volume:
  media_volume:
  frontend_build:

环境变量配置

在部署之前，我们需要创建.env文件来配置环境变量。可以参考项目中的.env.example文件，根据实际情况修改以下关键配置：

# Django settings
DEBUG=False
SECRET_KEY=your_secure_secret_key
ALLOWED_HOSTS=your_domain.com,www.your_domain.com

# Database settings
DB_NAME=dj_rest_auth
DB_USER=db_user
DB_PASSWORD=secure_password
DB_HOST=db
DB_PORT=5432

# Email settings
EMAIL_HOST=smtp.your-email-provider.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER=your_email@example.com
EMAIL_HOST_PASSWORD=your_email_password

生产环境配置

Django设置优化

为了确保生产环境的安全性和性能，我们需要对Django设置进行优化。关键设置位于demo/backend/demo/settings.py文件中：

# 生产环境安全设置
DEBUG = False
ALLOWED_HOSTS = os.environ.get('ALLOWED_HOSTS', '').split(',')

# HTTPS设置
SECURE_SSL_REDIRECT = True
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
SECURE_HSTS_SECONDS = 31536000  # 1 year
SECURE_HSTS_INCLUDE_SUBDOMAINS = True
SECURE_HSTS_PRELOAD = True

# 静态文件配置
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
STATIC_URL = '/static/'

# 媒体文件配置
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

# REST Framework设置
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'dj_rest_auth.jwt_auth.JWTCookieAuthentication',
    ],
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.IsAuthenticated',
    ],
}

# JWT设置
SIMPLE_JWT = {
    'ACCESS_TOKEN_LIFETIME': timedelta(minutes=60),
    'REFRESH_TOKEN_LIFETIME': timedelta(days=14),
    'ROTATE_REFRESH_TOKENS': True,
    'BLACKLIST_AFTER_ROTATION': True,
}

Nginx配置

Nginx作为反向代理服务器，可以提高应用的性能和安全性。项目中提供了Nginx配置文件，位于demo/nginx/conf.d/default.conf：

server {
    listen 80;
    server_name your_domain.com www.your_domain.com;
    
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
    }
    
    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    server_name your_domain.com www.your_domain.com;
    
    ssl_certificate /etc/letsencrypt/live/your_domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your_domain.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
    
    # 前端应用
    location / {
        root /var/www/frontend;
        try_files $uri $uri.html $uri/ /index.html;
    }
    
    # 后端API
    location /api/ {
        proxy_pass http://backend:8000;
        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 /static/ {
        alias /var/www/static/;
        expires 30d;
    }
    
    # 媒体文件
    location /media/ {
        alias /var/www/media/;
        expires 30d;
    }
}

启动服务

完成以上配置后，我们可以使用以下命令启动服务：

docker-compose up -d

这个命令会构建并启动所有服务。第一次运行时，可能需要下载镜像和安装依赖，需要一些时间。

数据库迁移

服务启动后，我们需要执行数据库迁移：

docker-compose exec backend python manage.py migrate

同时，创建超级用户：

docker-compose exec backend python manage.py createsuperuser

监控与维护

日志查看

可以使用以下命令查看服务日志：

docker-compose logs -f

备份数据库

定期备份数据库是非常重要的，可以使用以下命令：

docker-compose exec db pg_dump -U $DB_USER $DB_NAME > backup_$(date +%Y%m%d).sql

更新应用

当需要更新应用时，可以执行以下步骤：

1. 拉取最新代码：

git pull

2. 重新构建并启动服务：

docker-compose down
docker-compose up -d --build

总结

通过本文的指南，你已经成功地使用Docker和Nginx部署了dj-rest-auth到生产环境。这种部署方案不仅简化了部署过程，还提高了应用的可维护性和扩展性。如果需要进一步优化，可以考虑添加负载均衡、CDN等服务。

更多关于dj-rest-auth的详细配置和使用方法，可以参考项目中的官方文档：docs/index.md。祝你使用愉快！

【免费下载链接】dj-rest-auth Authentication for Django Rest Framework 项目地址: https://gitcode.com/gh_mirrors/dj/dj-rest-auth