alfio/alf.io

开源票务预订系统 Docker 镜像文档

镜像概述

本镜像基于开源票务预订系统构建，用于管理票券的全生命周期流程，包括票券创建、分类、销售、预订、验证及订单管理等。系统采用模块化设计，支持自定义配置和第三方服务集成，适用于各类需要票务管理功能的场景，且完全开源可扩展。

核心功能与特性

1. 票券管理

• 支持多种票券类型创建（如普通票、VIP票、团体票、折扣票等）
• 票券信息自定义（名称、价格、数量、有效期、描述、图片等）
• 票券分类与标签管理，支持多维度筛选

2. 预订与销售流程

• 在线选座/购票流程，支持座位图可视化选座（需配置场地信息）
• 多支付方式集成接口（如***、***、***等，需额外配置支付网关）
• 预订超时自动取消机制，释放未支付票券库存

3. 用户与权限管理

• 用户注册、登录及身份验证功能
• 角色权限控制（管理员、售票员、普通用户等）
• 用户订单历史与个人中心（查看订单、下载电子票、申请退款等）

4. 订单与库存管理

• 实时订单创建、状态跟踪（待支付、已支付、已取消、已验证等）
• 库存动态管理，支持超售控制与库存预警
• 订单取消、退款流程管理，支持部分退款与全额退款

5. 票券验证与安全

• 电子票生成（***/条形码）及扫码验证功能
• 防黄牛机制（限购、身份绑定、票券转赠限制等）
• 订单数据加密存储，支付信息安全处理

6. 数据统计与报表

• 销售数据实时统计（销售额、销售量、热门票种等）
• 多维度报表生成（按时间、票种、渠道等）
• 导出功能（支持CSV、Excel格式）

使用场景与适用范围

本镜像适用于需要高效管理票务流程的各类场景，包括但不限于：

• 文化娱乐：音乐会、演唱会、剧院演出、电影节等
• 体育赛事：足球赛、篮球赛、马拉松等体育活动
• 交通出行：火车/汽车票、景区门票、轮渡票等
• 展览活动：商业展览、学术会议、招聘会、艺术展等
• 企业内部：员工活动、培训报名、会议室预订等内部票务管理

使用方法与配置说明

环境要求

• Docker Engine 19.03+
• Docker Compose 2.0+（推荐用于多容器部署）
• 至少 2GB 内存，10GB 磁盘空间
• 网络环境：需开放 HTTP/HTTPS 端口，若集成外部服务（支付网关、数据库）需确保网络连通性

基本部署（Docker Run）

docker
docker run -d \
  --name ticket-reservation-system \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/ticket_system \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD=your-db-password \
  -e SERVER_PORT=8080 \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=admin123 \
  -v /path/to/local/data:/app/data \
  docker.xuanyuan.run/opensource-ticket-reservation-system:latest

参数说明：

• -p 8080:8080：端口映射，将容器内 8080 端口映射到宿主机 8080 端口
• -e SPRING_DATASOURCE_URL：数据库连接 URL（支持 MySQL/PostgreSQL）
• -e SPRING_DATASOURCE_USERNAME：数据库用户名
• -e SPRING_DATASOURCE_PASSWORD：数据库密码
• -e SERVER_PORT：容器内服务端口（默认 8080）
• -e ADMIN_USERNAME：初始管理员用户名（默认 admin）
• -e ADMIN_PASSWORD：初始管理员密码（首次登录需修改）
• -v /path/to/local/data:/app/data：数据卷挂载，用于持久化配置文件、日志及临时数据

Docker Compose 部署（推荐）

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  ticket-system:
    image: docker.xuanyuan.run/opensource-ticket-reservation-system:latest
    container_name: ticket-system
    ports:
      - "8080:8080"
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/ticket_system?useSSL=false&serverTimezone=UTC
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=db-password
      - SERVER_PORT=8080
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=admin123
      - LOG_LEVEL=INFO
    volumes:
      - ./data:/app/data
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: ticket-mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=db-password
      - MYSQL_DATABASE=ticket_system
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql-data:

启动服务：

bash
docker-compose up -d

环境变量配置

初始化与访问

1. 部署完成后，访问 http://localhost:8080 进入系统首页
2. 使用初始管理员账号（ADMIN_USERNAME 和 ADMIN_PASSWORD）登录后台（路径：/admin）
3. 初始化配置：
   • 创建票券类型与活动信息
   • 配置支付网关（若需集成第三方支付）
   • 设置用户角色与权限
   • 导入/创建场地座位图（如适用）
4. 普通用户可通过前台页面注册账号并进行票务预订

数据持久化

为避免容器重启导致数据丢失，建议通过 -v 参数挂载以下目录：

• /app/data：存储配置文件、上传图片、日志等
• 数据库数据（通过单独的数据库容器挂载数据卷，如 Docker Compose 示例中的 mysql-data）

升级与维护

• 升级镜像：停止旧容器，拉取新版本镜像后重新部署（需确保数据库结构兼容）
• 数据备份：定期备份挂载的 /app/data 目录及数据库数据
• 日志查看：通过 docker logs ticket-reservation-system 查看服务日志