Mealie项目数据备份与恢复完全指南

Mealie项目数据备份与恢复完全指南

mealie Mealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor 项目地址: https://gitcode.com/gh_mirrors/me/mealie

前言

作为一款优秀的食谱管理工具，Mealie为用户提供了完善的数据备份与恢复功能。本文将全面解析Mealie的备份机制，帮助用户安全可靠地管理自己的食谱数据。

备份功能概述

Mealie内置了完整的数据库备份解决方案，用户可以通过两种方式访问备份功能：

1. 通过界面导航：设置 > 备份
2. 直接访问管理后台的备份页面

备份系统提供以下核心功能：

• 查看现有备份列表
• 创建新备份
• 上传备份文件
• 删除备份（需确认）
• 下载备份
• 执行恢复操作

备份策略详解

SQLite数据库备份

对于使用SQLite作为数据库的用户（这是Mealie的默认配置），所有数据都存储在容器内的/app/data/目录中。我们推荐以下最佳实践：

1. 停止Mealie容器
2. 使用您熟悉的工具（如rsync、tar等）备份整个/data目录
3. 这种全量备份方式最为可靠，能够完整保留所有数据

这种方法比单独备份数据库更全面，因为它不仅包含数据库文件，还包括用户上传的图片等附件。

数据恢复操作指南

恢复前准备

1. 上传备份文件至Mealie实例
2. 选择要恢复的备份文件（可以是新上传的或已有列表中的）

重要注意事项

执行恢复前，必须了解以下关键信息：

1. 恢复操作是破坏性的 - 将清除当前数据库中的所有数据
2. 操作不可逆 - 一旦执行无法撤销
3. 成功恢复后系统会自动登出，需重新登录完成恢复过程

故障排除技巧

若恢复失败，可采取以下步骤排查：

1. 检查日志文件定位具体问题
2. 下载备份ZIP文件
3. 编辑其中的database.json文件
   • 例如遇到购物清单恢复错误，可删除相关部分内容
   • 保留其他可恢复的数据部分

PostgreSQL数据库特别说明

使用PostgreSQL作为后端数据库时，恢复操作需要特殊配置：

1. Mealie必须使用PostgreSQL超级用户账户
2. 恢复过程中需要临时授予超级用户权限

具体SQL命令如下：

-- 恢复前执行
ALTER USER mealie WITH SUPERUSER;

-- 恢复完成后撤销权限
ALTER USER mealie WITH NOSUPERUSER;

版本兼容性提示

在beta-v5版本前，使用不匹配的数据库备份版本会导致严重错误，可能需完全重新安装。beta-v5及以后版本会明确提示版本不匹配错误，避免系统不可用的情况。

最佳实践建议

1. 定期执行备份操作，建议每周至少一次
2. 重要更新前创建手动备份
3. 将备份文件存储在安全位置（如加密云存储）
4. 对于生产环境，考虑设置自动化备份脚本
5. 测试恢复流程，确保备份文件有效

通过遵循这些指南，您可以确保Mealie中的宝贵食谱数据得到妥善保护，在需要时能够快速恢复。

mealie Mealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor 项目地址: https://gitcode.com/gh_mirrors/me/mealie