campus-imaotai：茅台酒自动预约系统部署与实践指南

释放自动化价值：构建智能预约解决方案

campus-imaotai是一款专注于茅台酒自动预约的开源应用，通过Docker容器化技术实现一键部署，将传统手动预约流程转化为自动化任务。该系统采用前后端分离架构，后端服务处理预约逻辑与数据存储，前端界面提供直观的用户管理与任务监控功能，核心依赖MySQL（关系型数据库）和Redis（缓存服务）保障数据处理效率。

图1：系统用户管理界面，支持多账号配置与预约状态监控

适配环境：3步完成系统兼容性配置

环境校验清单

依赖项	最低版本要求	验证命令
Docker	20.10.0+	docker --version
Docker Compose（容器编排工具）	2.0.0+	docker compose version
可用内存	2GB+	free -h
磁盘空间	10GB+	df -h /

环境准备流程

准备：更新系统包管理器并安装依赖

sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

执行：添加Docker官方GPG密钥并安装Docker引擎

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

验证：启动Docker服务并验证运行状态

sudo systemctl enable --now docker
docker run --rm hello-world  # 出现"Hello from Docker!"即表示环境正常

执行部署：从镜像拉取到服务验证的全流程

执行流程图解

graph TD
    A[拉取镜像] --> B[准备配置文件]
    B --> C[启动容器服务]
    C --> D[验证服务状态]
    D --> E[访问管理界面]

镜像拉取与容器启动

准备：创建配置文件存储目录

mkdir -p /docker/server/conf && chmod 777 /docker/server/conf

执行：拉取镜像并启动容器

# 拉取最新镜像
docker pull oddfar/campus-imaotai:latest

# 启动容器（参数说明见表2）
docker run -d \
  --name campus-imaotai \
  --restart=always \
  --net=host \
  -v /docker/server/conf:/home/campus/conf \
  -e TZ=Asia/Shanghai \
  -e SERVER_PORT=8160 \
  -e spring.config.additional-location=/home/campus/conf/application-prod.yml \
  --privileged \
  oddfar/campus-imaotai:latest

表2：容器启动参数说明

参数	含义	可选值
--name	容器名称	自定义字符串
--restart	重启策略	always/on-failure/no
-v	目录挂载	宿主机路径:容器路径
-e TZ	时区设置	Asia/Shanghai等时区标识
-e SERVER_PORT	服务端口	1024-65535间未占用端口
--privileged	特权模式	true/false

验证：检查容器运行状态

docker ps | grep campus-imaotai  # 应显示Up状态
curl http://localhost:8160/actuator/health  # 返回{"status":"UP"}表示服务正常

配置文件部署

准备：获取默认配置文件

# 从容器中复制默认配置
docker cp campus-imaotai:/home/campus/conf/application-prod.yml /docker/server/conf/

执行：修改生产环境配置（关键配置对比见表3）

vi /docker/server/conf/application-prod.yml

表3：默认配置与生产环境推荐配置对比

配置项	默认值	生产环境推荐值	说明
spring.datasource.url	jdbc:mysql://localhost:3306/...	jdbc:mysql://mysql-host:3306/...	需替换为实际MySQL地址
spring.redis.host	localhost	redis-host	需替换为实际Redis地址
logging.level.root	INFO	WARN	生产环境降低日志级别
scheduler.enabled	false	true	启用定时预约任务

验证：重启容器使配置生效

docker restart campus-imaotai

场景拓展：从基础使用到问题诊断

核心功能演示

用户管理：添加预约账号

1. 访问系统管理界面（http://localhost:8160）
2. 进入"用户管理"模块，点击"添加账号"
3. 输入手机号并获取验证码，完成登录验证
   
   图2：用户添加界面，支持手机号验证码登录

门店管理：配置预约地点

1. 进入"门店列表"模块
2. 通过城市筛选功能查找目标门店
3. 记录商品ID与门店信息用于预约配置
   
   图3：门店列表界面，支持多维度筛选与地址定位

任务监控：查看预约记录

1. 进入"操作日志"模块
2. 筛选"茅台预约"类型日志
3. 查看预约状态与详细信息
   
   图4：操作日志界面，展示预约任务执行结果

常见失败场景诊断

场景1：容器启动后立即退出

• 症状：docker ps -a显示容器状态为Exited
• 诊断：查看日志docker logs campus-imaotai，常见原因为配置文件格式错误
• 解决方案：使用yamllint检查配置文件语法，确保缩进一致、冒号后有空格

场景2：预约任务无执行记录

• 症状：操作日志无预约相关记录
• 诊断：检查配置文件中scheduler.enabled是否设为true，以及cron表达式是否正确
• 解决方案：修改配置scheduler.cron=0 0 9 * * ?（每日9点执行），重启容器

场景3：数据库连接失败

• 症状：日志中出现Could not get JDBC Connection
• 诊断：检查MySQL服务是否正常、网络是否可达、账号密码是否正确
• 解决方案：使用telnet mysql-host 3306测试网络连通性，重置数据库密码

项目局限性说明

1. 算法时效性：采用已淘汰的预约算法，可能无法应对最新的预约规则变更，需定期关注项目更新
2. 环境依赖性：强依赖MySQL和Redis服务，未提供内置数据库方案，增加了部署复杂度
3. 功能单一性：仅支持茅台酒预约场景，不具备扩展其他商品预约的能力

社区支持渠道

• 问题反馈：项目Issue系统（需通过项目仓库提交）
• 配置咨询：Discord社区（搜索"campus-imaotai"群组）
• 功能建议：通过项目仓库的Feature Request模板提交

通过本文档的指引，您可以快速部署campus-imaotai系统并实现茅台酒自动预约功能。建议定期关注项目更新以获取算法优化和功能增强，同时做好配置备份与服务监控，确保系统稳定运行。