校园茅台API项目Docker镜像版本更新指南

校园茅台API项目是一个用于校园场景下茅台相关业务的开源API服务。该项目提供了Docker镜像以便快速部署，但在使用过程中需要注意镜像版本的选择和更新。

Docker镜像版本差异问题

近期有用户反馈，按照官方文档中的Docker命令拉取的镜像版本停留在1.0.11，而项目实际上已经更新到了1.0.13版本。这种版本滞后问题会导致用户无法使用最新的功能更新和bug修复。

正确的Docker运行命令

经过验证，正确的Docker运行命令应使用GitHub Container Registry(ghcr.io)中的镜像源而非其他公共仓库。以下是推荐的完整运行命令：

docker run --net host -d \
  --restart=always \
  --name campus-imaotai \
  -v /docker/server/conf:/home/campus/conf \
  --privileged \
  -e TZ=Asia/Shanghai \
  -e SERVER_PORT=8160 \
  -e spring.config.additional-location=/home/campus/conf/application-prod.yml \
  ghcr.io/oddfar/campus-imaotai-api

关键参数解析

1. --net host：使用主机网络模式，简化容器网络配置
2. -v /docker/server/conf:/home/campus/conf：将宿主机配置文件目录挂载到容器内
3. -e SERVER_PORT=8160：设置服务监听端口
4. spring.config.additional-location：指定额外的Spring配置文件位置

版本管理建议

对于开源项目的Docker镜像管理，建议开发者：

1. 保持各镜像仓库的版本同步更新
2. 在文档中明确标注各镜像源的更新策略
3. 提供版本更新日志和升级指南
4. 考虑使用latest标签简化用户获取最新版本的流程

最佳实践

用户在实际部署时应当：

1. 定期检查项目更新情况
2. 优先使用项目推荐的镜像源
3. 在升级前备份配置和数据
4. 测试新版本兼容性后再投入生产环境

通过遵循这些实践，可以确保校园茅台API服务的稳定运行，并及时获取最新的功能改进。