开源食谱管理器Mealie：打造你的数字厨房助手

还在为散落的食谱卡片发愁？想让家人共享美食创意却找不到合适工具？试试 Mealie（食谱管理系统）—— 这款开源工具能帮你轻松收纳家传秘方、规划每周餐单，让烹饪从此告别混乱 🍽️

一、认识Mealie：厨房里的数字管家

Mealie是一款自托管食谱管理器（Self-hosted Recipe Manager），采用Python后端与Vue.js前端构建，专为家庭用户设计。它就像你的私人美食图书馆，既能自动抓取网页食谱，也能手动录入奶奶的手写秘方，还能生成智能购物清单，让烹饪规划变得简单高效。

图1：Mealie直观的食谱管理界面，让美食灵感一目了然

核心功能速览

• 📝 智能食谱管理：支持URL自动导入、Markdown编辑、步骤图片嵌入
• 🍽️ 餐单规划系统：拖拽式周计划，自动统计食材需求
• 🔍 多维度分类：按食材、烹饪时间、难度等级等灵活筛选
• 👨‍👩‍👧‍👦 家庭共享：多用户权限管理，支持评论与评分互动
• 📱 响应式设计：从电脑到手机，随时随地查看食谱

二、快速部署：10分钟搭建私人食谱库

2.1 准备工作

硬件要求：

• 最低配置：1GB内存，10GB存储空间
• 推荐配置：2GB内存（多用户同时访问更流畅）

软件依赖：

• Docker Engine 20.10+
• Docker Compose v2+

2.2 安装步骤

[Ubuntu]

# 更新系统并安装依赖
sudo apt update && sudo apt install -y docker.io docker-compose-plugin

# 克隆代码仓库
git clone https://gitcode.com/GitHub_Trending/me/mealie
cd mealie

# 启动服务（后台运行）
docker compose up -d

[macOS]

# 使用Homebrew安装Docker工具链
brew install docker docker-compose

# 克隆代码仓库
git clone https://gitcode.com/GitHub_Trending/me/mealie
cd mealie

# 启动服务（后台运行）
docker-compose up -d

2.3 首次访问

服务启动后，在浏览器访问：

http://localhost:8080

首次登录需完成初始化设置：

1. 创建管理员账户
2. 设置默认语言与计量单位
3. 选择数据存储位置

三、使用指南：从入门到精通

3.1 新手入门：3步添加你的第一道食谱

1. 创建食谱
   点击左侧「Create」按钮，填写基本信息：

   • 食谱名称、烹饪时间、 servings（份数）
   • 上传成品图片（支持拖拽上传）

2. 添加食材与步骤
   在编辑器中输入配料清单，支持自动单位转换：

   1 根 香肠（约150g）
   2 汤匙 香菜（切碎）
   

   步骤部分可添加图片说明，让烹饪过程更清晰。

   图2：直观的编辑界面，轻松管理食材与步骤

3. 分类与标签
   为食谱添加分类（如「早餐」「素食」）和标签（如「快手菜」「低碳水」），方便日后查找。

3.2 进阶玩法：释放Mealie全部潜力

智能购物清单：

1. 在餐单规划页面勾选一周想吃的食谱
2. 系统自动汇总所有食材，生成可打印清单
3. 勾选已购买项，自动同步到所有设备

家庭协作：

• 邀请家人加入家庭组（Household）
• 设置权限：查看者/编辑者/管理员
• 通过评论区交流烹饪心得

营养分析：

高级功能：在「设置>实验室」中启用营养计算，自动分析蛋白质、碳水等关键指标

四、生态整合：让Mealie融入你的数字生活

4.1 自动化工具链

Renovate：自动监控依赖更新，保持Mealie核心组件最新。配置文件位于项目根目录的renovate.json。

Crowdin：参与多语言翻译协作，支持70+种语言，翻译文件存储在frontend/lang/locales/目录。

4.2 智能家居联动

通过Webhook功能与家庭自动化系统集成：

• 烹饪提醒：结合智能家居定时发送烹饪提醒
• 购物清单同步：将食材需求推送到手机购物APP
• 营养数据导出：对接健康管理软件，跟踪饮食摄入

五、常见问题解决

🤔 服务启动后无法访问？

• 检查容器状态：docker ps | grep mealie
• 查看日志排查：docker logs mealie
• 确认端口占用：netstat -tulpn | grep 8080

📁 如何备份我的食谱数据？

默认备份路径：mealie/data/backups/，可通过「设置>系统>备份」手动创建快照，或配置自动备份计划。

🌐 如何从外部网络访问？

需配置端口转发并设置HTTPS，推荐使用Nginx反向代理或Cloudflare Tunnel加密访问。

六、结语

Mealie不仅是一款工具，更是连接家人与美食的桥梁。无论是记录外婆的拿手菜，还是与伴侣共同规划健康饮食，它都能让烹饪这件事变得更有乐趣。现在就动手搭建你的数字厨房，让每一道家常菜都有迹可循，让每一餐都充满期待 🍳

完整功能文档可参考项目内的docs/目录，开发者指南位于docs/docs/contributors/developers-guide/。