Mealie 家庭菜谱部署:菜单、清单与冷备恢复
使用固定版本 Mealie 与本地 SQLite 整理家庭菜谱、菜单和购物清单,配置私有访问,并用冷备与空目录副本验证数据恢复。
想把家里常做的菜、下周菜单和买菜清单放在一起,可以用 Mealie。先录入几道自己熟悉的菜,排一次真实会做的菜单,再检查清单里的份量与单位;比一次导入几百个网址更容易判断它是否适合家里。
本文用固定的 Mealie 3.29.0、SQLite 和本地数据目录部署一个家庭实例,先通过 SSH 隧道初始化,再安排家人访问。菜谱网页导入、邮件邀请和公网 HTTPS 都有各自的条件;安装成功不代表这些环节已经可用。
家庭小规模使用,可以先采用 SQLite
官方将 SQLite 用于少量用户、写入并发不高的场景,并明确提醒不要把 SQLite 数据目录放在 NAS 网络文件系统。这里把 /app/data 映射到 VPS 的本地目录,数据库、图片与应用数据一起保护;需要多人高并发或 PostgreSQL 专属功能时,再按官方方案另配数据库。
已有 Linux VPS 如果能留出内存和本地磁盘,可以先复用。整机 2 GiB 内存、20 GiB 本地磁盘可作为小家庭试用起点,图片多时另留空间;这是配置建议,不是本站测得的最低规格。示例给容器设 1000M 上限,采用官方安装示例的量级,整台机器还需给系统与其他服务留余量。选择机房时看家人日常访问是否顺畅,不需要住宅 IP。
需要购买时,可查看雨云 RCS 的机房与配置,先比较月付、续费、磁盘和备份条件,再决定是否长期使用。已有机器够用就不必另买。VPS 费用以外,域名、异地备份和邮件发送服务可能单独收费。购买前核对结算页费用,厂商快照另需验证是否能恢复 Mealie 数据。
按当前镜像配置一个独立实例
在已安装 Docker Engine 与 Compose 插件的 Linux 服务器上操作。以下使用有 Docker 权限的 root shell;/srv/mealie 应是新实例目录,不覆盖已有数据库。容器按 1000:1000 写入,提前设置数据目录的属主。
umask 077
mkdir -p /srv/mealie/data
chmod 700 /srv/mealie /srv/mealie/data
chown 1000:1000 /srv/mealie/data
cd /srv/mealie
保存 compose.yaml:
services:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.29.0@sha256:78eb28b8776d0bad40c5e605c72b3f4f5976793e491558c7dcbdfc04c835d4bc
restart: unless-stopped
ports:
- "127.0.0.1:${MEALIE_PORT:-9925}:9000"
environment:
ALLOW_SIGNUP: "false"
DB_ENGINE: sqlite
PUID: "1000"
PGID: "1000"
TZ: Asia/Shanghai
BASE_URL: "${MEALIE_URL:-http://127.0.0.1:9925}"
volumes:
- ./data:/app/data
mem_limit: 1000m
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=80 mealie
curl -I http://127.0.0.1:9925/
在 Docker 实际配置中确认内存上限与回环端口绑定。随后在自己的电脑另开终端,替换用户与服务器地址:
ssh -N -L 9925:127.0.0.1:9925 user@your-server
浏览器打开 http://127.0.0.1:9925。官方安装检查表的初始账号为 changeme@example.com、密码为 MyPassword。先修改默认账号信息和密码,再建立家庭成员账号。此时不开放公网端口,避免在默认凭据仍有效时就暴露登录入口。
域名可用以后,再邀请家人
家人没有你的 SSH 隧道。长期共同使用时,可用已有反向代理为独立域名提供 HTTPS,转发到服务器回环地址的 9925 端口;不要用子路径 /mealie 代替独立域名。将下面的示例地址换成自己的实际地址,保存到 /srv/mealie/.env:
MEALIE_URL=https://recipes.example.com
重新执行 docker compose up -d 应用环境。反向代理的配置可参照本站 Caddy 教程。如果代理也运行在另一个容器中,它的 127.0.0.1 指向代理容器自己,不能直接照搬宿主机地址;要按现有 Docker 网络连接应用,别为了连通而把 Mealie 端口公开。
关闭开放注册只限制注册途径,不证明所有菜谱、分享和日历链接都私密。先核对群组、家庭与菜谱的可见性,用未登录窗口检查,再邀请家人。仅限家庭访问时,可把整个站点放在已有的私有网络或访问控制之后。没有配置邮件服务时,不能承诺邮件邀请、找回密码已经可用;应按自己现有 SMTP 服务完成配置并实际测试。邮件邀请所含的令牌、分享 URL 和日历订阅链接按私密信息保管,不贴进公共日志。
导入网页只是整理的第一步
先手工创建一道菜,保存名称、份量、配料、步骤与图片,再试导入有权使用的公开菜谱。导入失败时核对原网页是否存在、是否提供结构化菜谱以及 VPS 能否正常读取;遇到访问限制就改为手工录入,不把验证码服务或付费代理当作安装的必需组件。
导入后逐项核对配料数量和单位。原文的“适量”、一勺或一个包装,不会自动变成可靠的克数;不同来源的份量也不能直接相加。自己修改过的做法留在菜谱中,避免只保存一个以后可能失效的网址。
一周菜单不要排得比现实复杂
先选两三道本周确实要做的菜,安排到菜单里,再将需要采购的配料加入清单。查看同一种食材是否因名称或单位不同分成多行,确认放大份量后数量是否符合实际做法。应用能计算字段,不等于能替你判断家里还剩多少食材。
拿家人的普通账号完成一遍“找到菜谱—查看份量—勾选购物清单”的流程,再调整权限和录入方式。管理员能操作全部功能,不能证明普通账号也能完成这些步骤。
图片与手工记录也需要恢复
后台 /admin/backups 可以创建并下载应用备份;不要因为菜单里有备份按钮,就认为已经定时异地备份。这里另保留一次完整冷备:停止 Mealie 后,归档整个本地 data、Compose 配置和 .env,再启动原实例。缺少 .env 时,命令会创建空文件;已有普通文件保留内容,并设为仅当前账户可读写。遇到符号链接、目录等其他类型时先停止,核对实际配置位置后再备份:
set -eu
cd /srv/mealie
umask 077
if [ -L .env ] || { [ -e .env ] && [ ! -f .env ]; }; then
printf '%s\n' '.env 必须是当前目录中的普通文件,不能是符号链接或目录。' >&2
exit 1
fi
if [ ! -e .env ]; then
(set -C; : > .env)
fi
chmod 600 .env
mkdir -p /srv/mealie-backups
snapshot=$(mktemp -d /srv/mealie-backups/cold-XXXXXX)
cid=$(docker compose ps -q mealie)
test -n "$cid"
trap 'docker compose start mealie >/dev/null' EXIT
docker compose stop -t 60 mealie
state=$(docker inspect --format '{{.State.Status}} {{.State.OOMKilled}} {{.State.ExitCode}}' "$cid")
case "$state" in
"exited false 0"|"exited false 143") ;;
*) printf '未确认正常停止,拒绝归档:%s\n' "$state" >&2; exit 1 ;;
esac
tar --numeric-owner -czpf "$snapshot/instance.tar.gz.partial" \
-C /srv/mealie compose.yaml .env data
tar -tzf "$snapshot/instance.tar.gz.partial" >/dev/null
mv "$snapshot/instance.tar.gz.partial" "$snapshot/instance.tar.gz"
(cd "$snapshot" && sha256sum instance.tar.gz > SHA256SUMS)
docker compose start mealie
trap - EXIT
printf '备份目录:%s\n' "$snapshot"
将完成的归档和校验文件加密放到另一台设备。它可能含有家庭数据、密码相关状态和邮件配置,不放在网页可访问目录。校验文件只能确认归档字节一致,不能代替恢复。
第一次验证时,用自己创建的可信归档恢复到新空目录,并使用相同版本镜像。先确认主机能容纳两个实例;余量不足就在维护窗口停下原实例,或使用已有的隔离测试机器。把 snapshot 换成实际目录,恢复副本使用无网络配置,防止邮件、Webhook 等集成向外重复执行:
set -eu
snapshot=/srv/mealie-backups/cold-实际后缀
(cd "$snapshot" && sha256sum -c SHA256SUMS)
restore=$(mktemp -d /srv/mealie-restore.XXXXXX)
tar --numeric-owner -xzpf "$snapshot/instance.tar.gz" -C "$restore"
cd "$restore"
cat > compose.restore.yaml <<'YAML'
services:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.29.0@sha256:78eb28b8776d0bad40c5e605c72b3f4f5976793e491558c7dcbdfc04c835d4bc
network_mode: none
restart: "no"
environment:
ALLOW_SIGNUP: "false"
DB_ENGINE: sqlite
PUID: "1000"
PGID: "1000"
TZ: Asia/Shanghai
BASE_URL: http://127.0.0.1:9000
volumes:
- ./data:/app/data
mem_limit: 1000m
YAML
docker compose -p mealie-restore -f compose.restore.yaml up -d
docker compose -p mealie-restore -f compose.restore.yaml \
exec -T mealie python -c \
'import urllib.request; print(urllib.request.urlopen("http://127.0.0.1:9000/", timeout=10).status)'
等启动日志显示服务已就绪,再运行内部 HTTP 检查。副本不发布端口,不能从电脑直接打开网页;这一步也只证明服务能启动,没有证明所有家庭数据都已恢复。完整验收还需要通过应用 API,或在有严格出站限制、允许管理员入站的测试环境中,核对原账号、手工菜谱、图片、份量、步骤、菜单和购物清单,再新增测试记录并重启确认保留。
如果只能完成内部 HTTP 检查,应保留“数据恢复待验”的状态。不要向正常使用的实例直接导入备份试验;官方说明应用内恢复会删除现有数据库内容。验完执行 docker compose -p mealie-restore -f compose.restore.yaml stop,保留副本数据。换机接管前先停止旧实例,确认只让一个实例继续处理任务。
菜谱与采购清单对不上,先查表达方式
同一种食材分成几行时,先检查名称、单位和份量字段,再判断是否需要整理食材条目。图片缺失时看 /app/data 的挂载与目录权限;SQLite 报锁时确认数据没有放在网络共享上,也没有两个进程共用同一目录。不要靠重建空卷解决数据问题。
容器反复退出时,查看日志、实际内存限制和主机剩余内存。本文的 1000M 限制不是成功保证,扩大上限前要确认整机和其他服务的余量。若只是导入某个网站失败,先处理该来源的读取条件,不急着换 VPS。
从手机端验收邀请与访问权限
在手机上用家庭成员账号打开一条完整菜谱,检查配料、长步骤和图片,再勾选购物清单并刷新确认状态。换到未登录窗口,检查哪些内容仍可访问。计划公开分享时,另外检查分享链接中的备注、照片与个人信息。
配置了 SMTP 才做真实邀请和找回密码测试,收件人应是自己或明确同意参与的家人。邮件到达、链接地址正确、新账号能登录是不同结果,分别确认。未配置邮件时,可以先完成受控的账号创建与登录,保留邮件功能为待办。
把恢复测试放进升级流程
升级前读目标版本的发布说明,下载应用备份,再完成整目录冷备与同版本空目录恢复。保留旧镜像完整标识和旧配置,修改 Compose 中的版本及 digest,再拉取并启动。逐项检查登录、已有菜谱图片、菜单、清单以及新增记录。
数据库迁移后,换回旧镜像不一定能读取新数据。需要退回时,使用升级前整套冷备和原镜像验证恢复。本文采用的 3.29.0 是这次核对的固定版本;新版本的迁移、ARM64 之外的平台、域名证书和邮件服务需按实际环境另验。
推荐码:KuZhuJi




