ddsdocker/django-nginx-kkvet

K&K Vet Supply 网站 Docker 镜像

镜像概述

K&K Vet Supply网站Docker镜像是用于部署和运行K&K Vet Supply兽医用品供应网站的容器化解决方案。该镜像基于Django（Python Web后端框架）和Nginx（高性能Web服务器）构建，集成了两者的最佳实践配置，旨在简化网站的部署流程并确保运行稳定性。

核心功能与特性

• 技术栈集成：预配置Django后端与Nginx前端的协同工作环境，Nginx作为反向代理服务器，将HTTP请求转发至Django应用服务器
• 简化部署：无需手动配置Django与Nginx的复杂交互，镜像内置默认配置，开箱即可部署
• 静态资源处理：Nginx负责高效处理网站静态文件（如图片、CSS、JavaScript），提升页面加载速度
• 环境一致性：容器化设计确保网站在开发、测试和生产环境中运行行为一致，减少"环境差异"问题

使用场景

• 开发环境：快速搭建本地开发环境，无需手动配置完整的Django-Nginx开发栈
• 测试环境：在测试服务器上部署镜像，验证网站新功能或更新的兼容性
• 生产环境：通过合理配置（如环境变量、持久化存储），在生产服务器上稳定运行网站服务

使用方法

基本部署（Docker Run）

通过以下命令启动容器，部署K&K Vet Supply网站：

bash
docker run -d -p 80:80 --name kk-vet-supply-web docker.xuanyuan.run/kk-vet-supply-website:latest

参数说明：

• -d：后台运行容器
• -p 80:80：将容器内的80端口（Nginx默认端口）映射到主机的80端口，允许外部访问网站
• --name kk-vet-supply-web：为容器指定名称，便于管理
• kk-vet-supply-website:latest：镜像名称及标签（请替换为实际镜像名称）

环境变量配置

可通过-e参数自定义环境变量，覆盖默认配置。常用环境变量包括：

示例（生产环境配置）：

bash
docker run -d \
  -p 80:80 \
  -e SECRET_KEY="your-secure-production-key" \
  -e ALLOWED_HOSTS="example.com,www.example.com" \
  -e DATABASE_URL="postgres://user:password@db-host:5432/kk_vet_supply" \
  --name kk-vet-supply-web \
  docker.xuanyuan.run/kk-vet-supply-website:latest

Docker Compose 配置

对于需要关联其他服务（如数据库）的场景，推荐使用docker-compose.yml配置文件：

yaml
version: '3'

services:
  web:
    image: docker.xuanyuan.run/kk-vet-supply-website:latest
    ports:
      - "80:80"
    environment:
      - SECRET_KEY="your-secure-secret-key"
      - ALLOWED_HOSTS="example.com"
      - DATABASE_URL="postgres://user:password@db:5432/kk_vet_supply"
    depends_on:
      - db  # 依赖数据库服务
    restart: always  # 容器异常退出时自动重启

  db:
    image: docker.xuanyuan.run/postgres:14  # PostgreSQL数据库镜像
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=kk_vet_supply
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 持久化存储数据库数据

volumes:
  postgres_data:  # 定义持久化卷，保存数据库数据

启动命令：

bash
docker-compose up -d

访问网站

部署完成后，通过浏览器访问主机IP或绑定的域名（如http://localhost或http://example.com）即可打开K&K Vet Supply网站。

注意事项

• 生产环境安全：务必修改SECRET_KEY为强随机字符串，避免使用默认密钥；建议通过HTTPS访问（可配合Nginx配置SSL证书）
• 数据持久化：若网站使用文件存储（如用户上传的图片），需通过-v参数挂载主机目录到容器内的文件存储路径，避免容器删除导致数据丢失
• 资源限制：生产环境建议通过--memory和--cpus参数限制容器资源使用，避免过度占用主机资源