知识与效率

Mealie:自建菜谱与购物清单

  • 0 次阅读
  • 0 条评论
文章摘要

Mealie 用于收集菜谱、安排餐食和维护购物清单,适合把分散在网页与笔记里的做饭资料集中保存。下面采用当前官方文档的 SQLite 部署方案,适合先建立一个小型家庭实例。 菜谱描述食材与步骤,餐食计划安排日期,购物清单汇总所需材料。单位与份数一致才能正确合并。 适合家庭菜谱集中管理。先手工录入一份,再尝试网页导入并修正解析。

项目介绍

Mealie 用于收集菜谱、安排餐食和维护购物清单,适合把分散在网页与笔记里的做饭资料集中保存。下面采用当前官方文档的 SQLite 部署方案,适合先建立一个小型家庭实例。

菜谱描述食材与步骤,餐食计划安排日期,购物清单汇总所需材料。单位与份数一致才能正确合并。

适合家庭菜谱集中管理。先手工录入一份,再尝试网页导入并修正解析。

核心功能

功能

作用与使用方式

菜谱管理

保存步骤与图片

网页导入

检查食材解析

餐食计划

安排一周菜单

购物清单

汇总与调整数量

家庭账号

分开设置使用者

功能示意

Mealie 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目

说明

类型

Docker

分类

知识与效率

项目仓库

mealie-recipes/mealie

官方入口或文档

直接访问

整理日期

2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 按下方准备命令创建项目目录并生成局域网访问地址。PUID、PGID 已写为 0,无需查询账号编号。

  2. 按下面配置启动后打开访问地址,按所用版本的官方首次登录说明完成初始化,立即更换初始账号凭据。

  3. 先手工录入一份菜谱,检查食材、单位、份数和制作步骤。再尝试从一个公开菜谱地址导入,逐项纠正自动解析结果。

  4. 建立一周餐食计划并生成购物清单,检查相同食材的单位是否可合并;家庭成员通过独立账号使用。

  5. 完成基础测试后执行一次导出与恢复验证,再批量导入自己的菜谱。

首次使用与操作检查

录入菜谱后改份数,观察食材变化,再加入计划生成购物清单。

同一食材不同单位先统一。批量迁移前测试导出恢复,数据库与附件一起备份。

Docker Compose

依据本次读取的官方 SQLite 安装文档整理,固定其示例版本 v3.31.0,时区与运行账号按自己的环境设置。已有其他版本实例应先看升级说明。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/mealie/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/mealie
cd /volume1/docker/mealie
umask 077
touch .env
NAS_ADDR=$(ip -4 route get 1.1.1.1 | sed -n "s/.* src \([^ ]*\).*/\1/p" | head -n 1)
test -n "$NAS_ADDR" || { echo "未能识别 NAS 地址,请检查默认路由"; exit 1; }
if ! grep -q "^MEALIE_BASE_URL=." .env; then
  printf 'MEALIE_BASE_URL=http://%s:9925\n' "$NAS_ADDR" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/mealie

首次准备会根据 NAS 默认路由生成局域网访问地址。使用其他网卡或 HTTPS 域名时,修改项目 .env 中对应 URL 后重建服务。

本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。

配置中的命名卷由 Docker 创建并管理,不需要手动填写 UID/GID。备份时同时保存这些数据卷,不能只备份项目目录。

services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.31.0
    restart: unless-stopped
    ports:
      - "9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    environment:
      ALLOW_SIGNUP: "false"
      PUID: "0"
      PGID: "0"
      TZ: Asia/Shanghai
      BASE_URL: "${MEALIE_BASE_URL}"
    volumes:
      - mealie_data:/app/data
volumes:
  mealie_data:

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 示例使用命名卷保存 SQLite 与应用数据,重建容器不会自动删除卷,但删除卷会影响资料。

  • 原站点版式变化可能导致菜谱导入失败,手工录入是独立可用路径。

  • 内存限制采用官方示例的 1000M,批量导入或其他功能需按实际资源评估。

  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。

  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

定期通过应用备份功能导出,同时保存命名卷与 Compose;食材图片和附件应包含在恢复检查中。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料