如何用 Docker Compose 在 VPS 自托管 Mealie
在 VPS 上用 Docker Compose 部署 Mealie:粘贴食谱链接自动提取步骤,并配置膳食计划、购物清单、nginx、TLS 与备份。固定版本,避免迁移不兼容。
自托管食谱管理器的作用
自托管食谱管理器会将食谱存储在您拥有的服务器上的数据库中,而 Mealie 是多数家庭最终选择的应用。您粘贴食谱页面的地址,Mealie 会从页面中提取食材、步骤、份量和烹饪时间,并去除故事内容和广告。最终保存到食谱库中的只有菜谱内容。
应用的其余部分很简单。您可以将食谱拖入每周膳食计划,还可以根据该计划生成购物清单。每位下厨的人都可以使用自己的登录账号。整个应用运行在一个容器中,处理完请求后基本处于空闲状态,因此普通 VPS 也能轻松运行。
本指南使用 Docker Compose。如果您不熟悉 services: 和 volumes:,请先阅读Docker Compose 文件的组成方式,因为下面的内容就是一个 compose 文件和 4 条命令。
使用 Docker Compose 安装 Mealie
Mealie 将镜像发布到 GitHub 容器注册表。截至 18 November 2026,当前稳定标签为 v3.31.0,于 13 November 发布。此版本包含安全修复,项目建议所有用户更新。请固定版本,不要使用 latest:使用 latest 时,某天发生的 docker compose pull 可能会让您跨过尚未准备好的数据库迁移。
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
mealie:
image: ghcr.io/mealie-recipes/mealie:v3.31.0
container_name: mealie
restart: always
ports:
- "127.0.0.1:9925:9000"
deploy:
resources:
limits:
memory: 1000M
volumes:
- mealie-data:/app/data/
environment:
ALLOW_SIGNUP: "false"
PUID: 1000
PGID: 1000
TZ: Europe/Amsterdam
BASE_URL: https://recipes.example.com
volumes:
mealie-data:启动前,有两行配置值得检查。
端口应写为 127.0.0.1:9925:9000,而不是 9925:9000。容器内部监听 9000,主机将 9925 映射到该端口。将此映射绑定到回环地址后,nginx 可以访问 Mealie,而互联网无法访问。Docker 会自行向数据包过滤器写入规则,因此即使防火墙显示该端口已关闭,普通的 9925:9000 仍可能从外部访问。这个现象值得了解一次:参见 为什么已发布的 Docker 端口会绕过 ufw。
BASE_URL 必须是您实际使用的完整公网地址,包含 scheme,且末尾不能有斜杠。Mealie 会根据它生成密码重置链接和邀请链接。将其设置为 http://localhost:9925 后,您发送给伴侣的邀请将包含一个只能在服务器本身上使用的链接。
启动服务并观察首次启动过程。
sudo docker compose up -d
sudo docker compose logs -f mealie首次启动会创建 SQLite 数据库并执行迁移,这需要几秒钟。日志稳定下来且不再打印迁移信息后,在本地检查应用。
curl -I http://127.0.0.1:9925出现 200 OK 表示应用已启动。如果得到 Connection refused,请运行 sudo docker compose ps -a 查看容器的状态和退出码。以代码 137 停止的容器收到了 SIGKILL;仅凭该代码无法判断它是否超过了 1000M 内存限制。手动终止容器也会产生此代码。
首次登录并关闭开放注册
默认账户为 changeme@example.com,密码为 MyPassword。使用该账户登录后立即修改用户名和密码,因为这组凭据已印在文档中,因此所有扫描器都知道。
compose 文件中的 ALLOW_SIGNUP: "false" 是有意这样设置的。开启注册后,任何找到该地址的人都可以在您的菜谱盒中创建账户。关闭注册后,您可以从管理区域添加用户,系统会生成邀请链接,由您自行发送给对方。该链接根据 BASE_URL 生成,因此这个值很重要。如果您最终在同一台服务器上运行多个应用,并希望所有应用共用一个密码,Mealie 可以将登录交给外部身份提供商,例如自托管的 Authentik 实例。
Mealie 会将用户加入一个家庭,家庭则归属于一个组。同一家庭中的所有人共享用餐计划和购物清单,这正适合家庭使用。菜谱集合的共享范围更大:同一组中的所有家庭都会共享彼此的菜谱、标签和分类。因此,同一台服务器上的不同家庭可以保留各自的计划和清单,但仍使用同一套菜谱;这也适合合租者,因为没有人会同意是否加入凤尾鱼。如果用户需要完全独立的菜谱集合,请为他们创建不同的组,因为不同组之间不会共享任何内容。
导入器:运行 Mealie 的主要原因
打开菜谱集合,选择从 URL 创建菜谱,然后粘贴链接。Mealie 会抓取页面,并查找结构化菜谱数据。这是大多数菜谱网站为搜索引擎嵌入的机器可读数据块。存在该数据块时,导入过程干净且立即完成。
如果配置了 AI 提供商,还可以从图像或粘贴的纯文本导入菜谱。这也适用于食谱书页面的照片。图像导入需要支持图像识别的提供商。未配置提供商时,这些导入方式不可用。它们会经过较慢的处理流程,之后需要检查,因为手写分数很容易被误读。
批量导入也在同一页面中执行:粘贴地址列表,每行一个,Mealie 会在后台逐个处理。一组包含 two hundred 个书签的收藏可以一次性迁移。
膳食计划和购物清单
膳食计划器以日历形式显示。将食谱拖到某一天,即可安排该食谱。将已安排的食谱添加到购物清单,以汇总所需食材。若要合并重复项,先在“管理数据”中预置食材和单位,然后在每个食谱中启用食材用量,并将食材解析为这些食材和单位。这样,两个食谱都需要洋葱时,清单中会显示一行,而不是两行。
购物时,您可以在手机上打开实时更新的清单页面。由于清单存储在您自己的服务器上,家庭成员可同时看到同一份清单;一个人勾选牛奶后,牛奶也会从其他人的屏幕上移除。
在前面配置 nginx 和 TLS
在此配置中,Mealie 使用普通 HTTP;它也支持通过 TLS_CERTIFICATE_PATH 和 TLS_PRIVATE_KEY_PATH 使用 TLS。在 Mealie 前面的 nginx 中终止传输层安全性(TLS)。先将 DNS A 记录指向您的服务器,因为证书步骤会验证该域名。
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
listen 80;
server_name recipes.example.com;
client_max_body_size 64M;
location / {
proxy_pass http://127.0.0.1:9925;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginxnginx -t 输出 syntax is ok 和 test is successful 是关键步骤。只有检查通过后才能重新加载配置,因为重新加载错误配置会继续运行旧配置,并将错误隐藏到下次重启。
配置 client_max_body_size 64M 是因为 nginx 的默认值为 1 MB。通过浏览器上传菜谱图片或恢复备份时,请求体可能超过此大小。如果没有这一行,nginx 会返回 413 Request Entity Too Large,而不是 Mealie,因此应用日志中完全不会记录相关信息。
然后申请证书。该步骤及其续期计时器已在 使用 certbot 为 nginx 申请 Let's Encrypt 证书 中介绍。
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot 会重写 server block,使其监听 443 端口,并添加从 80 端口到 HTTPS 的重定向。通过 https:// 访问网站,并确认浏览器接受该证书。如果 Mealie 可以加载,但其中的链接将您重定向到 http://,则 BASE_URL 仍然设置为 http。请修正该值,然后运行 sudo docker compose up -d,以使用新值重新创建容器。
不要将 Mealie 放在 example.com/recipes 这类子路径下,因为前端无法从子路径提供服务。请使用子域名。
备份,以及恢复操作的实际行为
Mealie 的所有数据都位于容器内的 /app/data/,该目录属于 mealie-data 卷。复制此卷即可同时复制食谱、图片和数据库。Mealie 官方文档将停止容器并复制此目录称为备份 SQLite 安装的最佳方式。
sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealie卷名称会以项目名称作为前缀,项目名称就是存放 compose 文件的目录名。从 /srv/mealie 可以看到卷为 mealie_mealie-data,因此第一条命令是 docker volume ls:请使用它打印出的名称,而不是本指南中的名称。必须先停止容器,因为 SQLite 经常处于写入过程中,在线复制可能会导致恢复后无法读取。
Mealie 还在管理区域提供了专用备份页面,可将数据库写入 zip 归档中的 database.json。归档可以恢复到运行相同或更高版本 Mealie 的实例。要迁移到其他服务器,复制卷时请在新服务器上运行相同的固定版本;或者将归档恢复到相同或更高版本。恢复归档会有意破坏现有数据:它会先删除当前数据库,再加载归档,且无法撤销。恢复完成后,您会被注销。
无论哪种副本,只要仍保存在同一台服务器上,就不能算作备份。请按计划将归档推送到其他位置,这正是 使用 restic 执行加密的异机备份 的用途。
更新 Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie提高文件中固定的版本号,然后拉取镜像并重新创建容器。新镜像首次启动时会执行迁移。在升级主版本前备份卷,因为迁移中途失败会留下旧镜像无法再打开的数据库。阅读当前版本与新版本之间所有版本的发布说明。
导入器失败时
有些网站完全不发布结构化菜谱数据,因此 Mealie 导入的只有标题,食材列表为空。没有 AI 提供商时,这不是可以通过配置解决的问题,因此应改为手动粘贴菜谱文本。配置了提供商后,如果抓取器没有找到内容,Mealie 会将页面内容交给模型处理;生成结果仍需像其他 AI 导入结果一样与原始内容核对。
其他失败可能是因为菜谱网站前面部署了机器人防护系统,该系统向 Mealie 返回挑战页面,而不是菜谱内容。Mealie 已经会模拟浏览器并轮换 user agent,以降低这种情况的发生率。如果网站仍然拒绝访问,文档记录的选项包括:通过地址信誉更好的代理发送抓取请求,或运行 FlareSolverr 实例,在真实浏览器中解决挑战。两者都是可选项,均通过容器上的环境变量配置。
如果导入失败是因为服务器完全无法访问该网站,则属于不同的问题。在服务器上使用 curl -I https://the-site.example/recipe 测试,并先读取状态行,再判断是否是抓取器的问题。从 v3.26.0 开始,Mealie 还会拒绝从私有或内部地址获取内容。因此,托管在你自己网络中的菜谱页面必须先将其主机添加到 HTTP_ALLOW_LIST 环境变量,才能导入。
适用场景
Mealie 是家庭用户适合部署的第一个自托管应用,因为与您共同生活的人无需提醒就会使用它。它与运行自己的 Immich 照片库属于同一类用途,但轻量得多,也属于更广泛的今年值得自托管的服务。一台小型服务器即可同时运行这两者。Immich 并不是第二项用途的唯一选择;如果您仍在决定,PhotoPrism 和 Immich 的内存需求下限及备份命令差异足够明显,值得在用掉剩余磁盘空间前先阅读。如果家庭除了记录晚餐,还要记录计划和笔记,自托管 AFFiNE 工作区同样只需编写 compose 文件,但它需要4个容器,所需内存也比 Mealie 多得多,因此请先检查服务器剩余资源。如果家庭还想记录训练情况,openGym 会保存训练记录,并且同样需要您刚刚配置好的固定标签、compose 文件和证书。晚餐后的活动也有对应的选择:Halcyon 会将现有的 Jellyfin 媒体库重建为一间可以四处走动的1990年代录像带租赁店。它只是在您已经运行的服务前增加一个小型容器,而不是再增加一个需要备份的数据库。这个系列中的服务并不都是家庭应用。如果同样的习惯以后需要支持工作用途,自托管 Chatwoot 客服台同样需要固定标签和证书,并在后端配置 Postgres、Redis 以及可正常工作的出站邮件。与菜谱应用相比,它是负载重得多的租户,应部署在独立服务器上。
FAQ
为什么导入食谱 URL 会失败?
常见原因有两个。其一,网页没有发布结构化食谱数据,因此抓取器找不到内容;除非配置了 AI 提供商来读取网页,否则最终只会得到标题,没有配料。其二,网站前面的反机器人保护层返回的是验证页面,而不是食谱。对于第二种情况,可以让 Mealie 使用地址信誉更好的代理,或使用自行托管的 FlareSolverr 实例,让它在真实浏览器中完成验证。在修改任何配置前,请先使用 curl -I 确认服务器能够访问该网页。
我需要 PostgreSQL,还是 SQLite 就够了?
对于家庭使用,SQLite 足够,而且它是默认选项。当数据目录位于网络附加存储上时,请改用 PostgreSQL,因为 SQLite 在网络文件系统上运行会产生数据库锁定错误,并可能损坏文件。在 PostgreSQL 下恢复时,数据库用户必须是超级用户,因为恢复会先删除所有内容,再加载归档。
没有域名也能运行 Mealie 吗?
可以,在您自己的网络中运行即可。将 BASE_URL 设置为您实际输入的地址,例如 http://192.168.1.20:9925;使用服务器的 LAN 地址将端口映射改为 192.168.1.20:9925:9000,并跳过 nginx。运行 sudo docker compose up -d 应用这两项修改。原来的 127.0.0.1:9925:9000 映射只接受来自 Docker 主机的连接。邀请链接和密码重置链接会根据 BASE_URL 生成,因此值不正确会产生其他人无法打开的链接。不要通过普通 HTTP 将其暴露到互联网,因为这样登录信息会以明文传输。
如何为家人创建各自的登录账号?
保持 ALLOW_SIGNUP 为 "false",然后从管理区域添加用户,系统会生成邀请链接供您发送。将共用厨房的所有人加入同一个家庭,以便共享用餐计划和购物清单。无论如何,组内的每个家庭都会共享食谱;因此,需要独立收藏的用户必须使用不同的组。
停止运行 Mealie 后,我的食谱会怎样?
食谱仍然可以导出。管理区域的备份功能会将您的数据写入 JSON,Mealie 也可以将食谱导出为 JSON 文件;即使没有任何软件,也能在文本编辑器中读取这些文件。请在需要之前先执行一次导出,并确认能够打开导出的文件。