sashalevo/geyin-az

Geyin.az电商平台Docker镜像文档

镜像概述

Geyin.az电商平台Docker镜像是将Geyin.az在线电商系统进行容器化封装的部署方案，集成了应用服务、依赖组件和配置模板，旨在简化Geyin.az电商网站的搭建流程，降低部署复杂度，支持快速在开发、测试及生产环境中部署和运行。

核心功能与特性

• 商品管理系统：支持商品上架、分类管理、库存监控、价格调整及商品详情页自定义。
• 订单处理流程：包含订单创建、支付确认、发货跟踪、退款处理等全流程管理。
• 用户认证与授权：提供用户注册、登录、权限管理及个人中心功能，支持多角色权限控制。
• 支付集成：支持主流支付方式（如***、电子***等）的接口集成，确保交易安全。
• 响应式前端：适配PC、移动端等多终端设备，提供良好的用户购物体验。
• 数据统计与分析：内置销售数据、用户行为等统计功能，辅助运营决策。

使用场景

• 企业电商网站部署：适用于中小企业快速搭建自有品牌电商平台，降低基础设施投入。
• 开发与测试环境：为开发团队提供一致的本地开发环境，简化功能测试与迭代流程。
• 生产环境运行：支持高可用性配置，可配合负载均衡、数据库集群等组件构建稳定的生产系统。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Geyin.az电商平台容器：

bash
docker run -d \
  --name geyin-az-ecommerce \
  -p 80:80 \
  -p 443:443 \
  -e DB_HOST=your-db-host \
  -e DB_USER=db-username \
  -e DB_PASSWORD=db-password \
  -e DB_NAME=geyin_az_db \
  -e ADMIN_EMAIL=admin@example.com \
  -e ADMIN_PASSWORD=secure-admin-pass \
  geyinaz/ecommerce:latest

环境变量配置

容器运行时支持以下关键环境变量配置（必选参数需根据实际环境填写）：

• DB_HOST：数据库主机地址（必填）
• DB_USER：数据库用户名（必填）
• DB_PASSWORD：数据库密码（必填）
• DB_NAME：数据库名称（默认：geyin_az_db）
• DB_PORT：数据库端口（默认：3306，适用于MySQL）
• ADMIN_EMAIL：管理员***（用于初始登录，必填）
• ADMIN_PASSWORD：管理员密码（用于初始登录，必填）
• APP_ENV：运行环境（可选：dev/test/prod，默认：prod）
• HTTPS_ENABLED：是否启用HTTPS（可选：true/false，默认：true）
• LOG_LEVEL：日志级别（可选：debug/info/warn/error，默认：info）

Docker Compose 部署（推荐生产环境）

使用docker-compose.yml配置文件可简化多容器部署（如搭配独立数据库容器）：

yaml
version: '3.8'

services:
  ecommerce:
    image: geyinaz/ecommerce:latest
    ports:
      - "80:80"
      - "443:443"
    environment:
      - DB_HOST=mysql
      - DB_USER=root
      - DB_PASSWORD=mysql-root-pass
      - DB_NAME=geyin_az_db
      - ADMIN_EMAIL=admin@example.com
      - ADMIN_PASSWORD=secure-admin-pass
      - APP_ENV=prod
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=mysql-root-pass
      - MYSQL_DATABASE=geyin_az_db
    restart: always

volumes:
  mysql-data:

数据持久化

为确保数据不丢失，建议通过Docker卷（Volumes）挂载以下目录：

• /app/data：应用数据（如上传的商品图片、配置文件等）
• /app/logs：应用日志文件

可在docker run命令中添加 -v /host/path/to/data:/app/data 和 -v /host/path/to/logs:/app/logs 实现。

注意事项

• 首次启动时，容器会自动初始化数据库结构，需确保数据库连接正常且用户具有创建表权限。
• 生产环境中建议启用HTTPS，并配置有效的SSL证书（可通过挂载证书文件至容器/app/certs目录实现）。
• 定期备份数据库及挂载的卷数据，以防数据丢失。