食谱管理器 Docker 镜像文档

镜像概述

本镜像是一个轻量级、用户友好的食谱管理应用，旨在提供干净直观的界面和实用功能，帮助用户轻松管理、分享和组织各类食谱。其设计理念注重简洁性与功能性的平衡，适合家庭成员共同使用，无论是记录传统家庭食谱、整理日常烹饪灵感，还是共享烹饪心得，均能提供高效支持。

核心功能与特性

• 简洁直观的界面：无冗余设计，专注于食谱管理核心需求，新手用户也能快速上手
• 多用户支持：支持家庭多成员账号，可分别管理个人食谱或共享家庭公共食谱库
• 完整食谱管理：支持记录食谱名称、烹饪时间、难度等级、食材清单（含用量）、详细步骤、分类标签及成品图片
• 搜索与分类：支持按食材、烹饪方式、菜系等多维度筛选，快速定位所需食谱
• 响应式设计：适配桌面端、平板及移动端，方便在厨房、外出等场景随时查看
• 数据持久化：本地存储或可选云同步（视配置），确保食谱数据不丢失

使用场景与适用范围

• 家庭日常烹饪：统一管理全家常用食谱，避免纸质笔记散落或遗忘
• 多人协作共享：家庭成员可各自添加食谱并共享，形成家庭专属食谱库
• 传统食谱记录：数字化保存家族传统 recipes，附带图片和细节步骤，防止传承中断
• 烹饪爱好者工具：整理个人收藏的食谱，按季节、场合分类，提升烹饪效率

使用方法与配置说明

基本运行命令

通过以下命令快速启动容器（默认配置）：

docker run -d \
  --name recipe-manager \
  -p 8080:80 \
  -v ./recipe-data:/app/data \
  --restart unless-stopped \
  recipe-manager:latest

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口，通过 http://localhost:8080 访问
• -v ./recipe-data:/app/data：挂载数据卷，将食谱数据持久化到主机 ./recipe-data 目录
• --restart unless-stopped：容器退出时自动重启（除非手动停止）

Docker Compose 配置示例

创建 docker-compose.yml 文件，方便管理多容器或自定义配置：

version: '3'
services:
  recipe-manager:
    image: recipe-manager:latest
    container_name: recipe-manager
    ports:
      - "8080:80"
    volumes:
      - ./recipe-data:/app/data
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - MAX_UPLOAD_SIZE=10M  # 限制图片上传大小（默认5M）
    restart: unless-stopped

启动命令：docker-compose up -d

环境变量配置

通过环境变量自定义容器行为（以下为常用参数）：

访问与使用

1. 启动容器后，通过 http://<主机IP>:8080 访问应用
2. 首次使用：未启用认证时直接进入主页；启用认证后需使用 ADMIN_USER 和 ADMIN_PASSWORD 登录
3. 功能入口：通过顶部导航栏访问「添加食谱」「食谱库」「分类管理」等模块
4. 数据备份：定期备份主机挂载目录 ./recipe-data 即可保障数据安全

注意事项

• 数据卷挂载为推荐配置，避免容器删除导致食谱数据丢失
• 启用用户认证（ENABLE_AUTH=true）后，建议修改默认管理员密码（ADMIN_PASSWORD）
• 如需要外部访问，建议配合反向代理（如Nginx）并启用HTTPS，增强安全性
• 容器运行需确保主机端口（示例中8080）未被占用，或修改端口映射为其他可用端口