Beer list App Docker镜像文档

概述

Beer list App 是一款专注于啤酒信息管理的应用程序，旨在为用户提供便捷的啤酒列表管理功能。该应用支持啤酒信息的添加、编辑、删除与查询，可帮助啤酒爱好者记录个人品鉴经历，或协助酒吧、餐厅等场所维护数字化酒水清单。

核心功能与特性

• 啤酒信息管理：支持录入啤酒名称、类型（如IPA、 stout、 lager等）、产地、酒精度、口感描述等详细信息，并可对信息进行增删改查操作
• 列表展示与排序：以列表形式清晰展示所有啤酒信息，支持按名称、酒精度、添加时间等维度排序
• 搜索与筛选：提供关键词搜索功能，可按啤酒类型、产地等条件快速筛选目标啤酒
• 数据持久化：支持本地文件存储或外部数据库连接（如SQLite、MySQL），确保数据不丢失
• 响应式界面：适配桌面端与移动端，提供简洁直观的用户操作体验

使用场景与适用范围

• 个人用户：啤酒爱好者用于记录个人品鉴过的啤酒信息，建立个人啤酒收藏清单
• 商业场所：酒吧、餐厅、精酿啤酒馆等作为数字化酒水单，供顾客查看啤酒详情
• 活动场景：啤酒品鉴会、啤酒节等活动中，用于展示活动涉及的啤酒列表及介绍

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10及以上）
• （可选）Docker Compose（用于多容器部署场景）

快速部署（Docker Run）

通过以下命令拉取并启动容器：

docker run -d \
  -p 8080:80 \
  --name beer-list-app \
  -v ./beer-data:/app/data \
  beer-list-app:latest

参数说明：

• -d：后台运行容器
• -p 8080:80：将容器内80端口映射至主机8080端口（主机端口可根据需求修改）
• --name beer-list-app：指定容器名称为beer-list-app
• -v ./beer-data:/app/data：挂载主机目录./beer-data至容器内/app/data目录，用于数据持久化

Docker Compose部署

创建docker-compose.yml文件，内容如下：

version: '3.8'
services:
  beer-list-app:
    image: beer-list-app:latest
    container_name: beer-list-app
    ports:
      - "8080:80"
    volumes:
      - ./beer-data:/app/data
    restart: unless-stopped
    environment:
      - LANG=zh_CN.UTF-8  # 设置应用语言为中文

执行以下命令启动服务：

docker-compose up -d

配置参数

应用支持通过环境变量进行个性化配置，常用配置参数如下：

配置示例（MySQL数据库连接）

docker run -d \
  -p 8080:80 \
  --name beer-list-app \
  -e DB_TYPE=mysql \
  -e MYSQL_HOST=mysql-server \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=beeruser \
  -e MYSQL_PASSWORD=beerpass \
  -e MYSQL_DB=beer_list \
  beer-list-app:latest

访问应用

容器启动后，通过浏览器访问 http://<主机IP>:8080（若修改了端口，则使用自定义端口）即可打开应用界面，开始使用啤酒列表管理功能。