[Brave]

Brave

在数字化浪潮席卷生活方方面面的今天，你是否曾想过，厨房里的食谱收藏、每周的膳食规划，乃至于采购清单，都可以被一个优雅而高效的工具统一管理？Mealie，一个功能强大且开源的自托管食谱管理和膳食计划平台，正是为此而生。它不仅是一个简单的食谱记录工具，更是一个能部署在你自己的NAS或服务器上，让整个家庭都乐在其中的智能厨房中枢。

什么是Mealie

Mealie是一个基于Web的应用程序，你可以将其部署在自己的服务器或NAS（如群晖、威联通）设备上。这意味着你的所有烹饪数据——那些珍贵的家庭秘方和从网上搜罗的美食创意——都将完全由你自己掌控，无需依赖任何第三方云服务，保障了数据的私密性与所有权。

该项目采用现代化的技术栈，后端基于强大的FastAPI，前端则使用Vue.js构建，为用户带来了流畅且响应迅速的交互体验。作为一个在GitHub上非常活跃的开源项目，Mealie遵循AGPL-3.0许可协议，任何人都可以免费使用、修改和分发。

核心功能：让厨房生活井井有条

Mealie凭借其丰富而实用的功能，旨在成为现代家庭的终极食谱管理解决方案。

• 一键导入食谱：这是Mealie最受欢迎的功能之一。当你在网上发现一个诱人的食谱时，只需将其网址复制到Mealie中，它便能自动抓取并解析食谱的标题、图片、食材、步骤等关键信息，省去了手动输入的繁琐。
• 强大的食谱管理与合集：你可以轻松创建和编辑自己的食谱，添加详细的描述、烹饪时间、营养信息等。通过灵活的标签和分类系统，你可以将海量的食谱整理得井井有条。此外，还可以创建“食谱合集”（Cookbooks），根据自己的标准将食谱分组，方便快速查找。
• 智能膳食计划：Mealie内置了直观的膳食计划器。你可以轻松地将食谱拖拽到日历中，为未来一周、一个月甚至更长时间安排好每日三餐。这个功能对于希望规律饮食和提前备餐的用户来说极为有用。
• 自动生成购物清单：在你制定好膳食计划后，Mealie可以根据所选食谱自动生成一份详尽的购物清单。系统会自动合并相同的食材并进行分类，你甚至可以按照常去的超市布局来管理清单，让采购过程更加高效，避免遗漏。
• 家庭共享与多用户支持：Mealie从设计之初就考虑到了家庭使用的场景。你可以为家庭成员创建不同的用户账户，并建立群组来共享食谱和膳食计划，让烹饪成为一项有趣的家庭协作活动。
• 出色的移动端体验（PWA）：Mealie支持PWA（渐进式网络应用）。这意味着你可以将其直接“添加”到手机或平板的桌面上，获得类似原生App的沉浸式体验，界面完美适配移动端屏幕。
• 自动备份与数据安全：你可以通过设定的模板，轻松地自动备份所有菜谱和计划数据，确保你的美食收藏万无一失。
• 广泛的本地化支持：Meali社区已将其翻译成超过35种语言，对中文的支持非常完整，界面和功能都已完全汉化。
• 开放的API与强大集成：对于技术爱好者和智能家居玩家来说，Mealie的开放API提供了无限的可能性。你可以创建API令牌，将Mealie与Home Assistant等智能家居平台集成，实现烹饪流程的自动化。此外，API还支持与Trello、Alexa等第三方服务同步购物清单。

安装Mealie：NAS上的Docker部署实战

得益于Docker技术，安装和部署Mealie变得异常简单。以下是使用Docker Compose在您的NAS或服务器上部署Mealie的详细步骤。

前提条件：请确保你的设备（如群晖、威联通NAS或任何Linux服务器）已正确安装Docker和Docker Compose。

1️⃣ 创建 compose.yml 文件

首先，创建一个名为 compose.yml 的文件，并将以下内容粘贴进去。这是一个官方推荐的、功能完整的配置。

version: "3.9"
services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v1.10.2 # 建议定期检查并更新到最新稳定版镜像
    container_name: mealie
    restart: unless-stopped
    network_mode: bridge
    ports:
      - "9925:9000" # 将容器的9000端口映射到主机的9925端口，左侧可按需修改
    volumes:
      - /share/Container/mealie/data:/app/data/ # 将数据目录挂载到主机，左侧请修改为您自己的路径
    environment:
      # --- 后端环境变量 ---
      ALLOW_SIGNUP: true # 首次部署建议设为true，允许注册管理员账户，之后可改为false
      PUID: 1000 # 运行服务的用户ID，请修改为您自己的UID
      PGID: 100  # 运行服务的组ID，请修改为您自己的GID
      TZ: Asia/Shanghai # 设置时区
      # --- 性能与URL配置 ---
      MAX_WORKERS: 1
      WEB_CONCURRENCY: 1
      BASE_URL: http://your-nas-ip:9925 # 设置您的访问地址，可以是IP或域名

参数说明：

• ports: 冒号左边的 9925 是您访问Mealie时使用的端口，可以根据喜好和端口占用情况修改为其他端口。
• volumes: 冒号左边的 /share/Container/mealie/data 是Mealie数据在你主机上存放的路径，请务必修改为你自己规划的路径，例如在群晖中可能是 /volume1/docker/mealie。
• PUID 和 PGID: 这是为了避免文件权限问题。请通过SSH登录您的设备，执行 id 命令查看并替换成你自己的 uid 和 gid。
• ALLOW_SIGNUP: 首次部署时必须设为 true 以便注册管理员。注册完成后，为了安全，可以修改此文件，将值改为 false 并重启容器。
• BASE_URL: 请修改为你实际访问Mealie的URL，格式为 http://IP地址:端口 或你配置好的域名。

2️⃣ 启动Docker容器

将上述 compose.yml 文件保存好后，通过SSH进入该文件所在的目录，执行以下命令来启动Mealie：

docker compose up -d

如果你使用的是群晖或威联通等带有图形化Docker套件的NAS，操作更简单：打开套件（如Container Manager），选择“应用程序”或“项目”，新建一个，将上面 compose.yml 文件的全部内容粘贴进去，然后启动即可。

等待片刻，容器启动成功后，在浏览器中打开你设置的地址（例如 http://你的NAS-IP:9925），即可看到Mealie的欢迎界面。

界面一览与初次使用

1. 注册与登录：首次打开系统，由于你设置了 ALLOW_SIGNUP: true，页面会提示你注册一个管理员账户。请按照界面提示创建您的账户并登录。
2. 主页：登录后，你将看到一个清爽的仪表盘。左侧是功能菜单，包括饮食计划、购物清单、时间轴、食谱合集、管理器等核心功能，右侧则是你的菜谱展示区。
3. 设置：点击左下角的“设定”菜单，可以进入强大的后台设置界面。在这里，你可以管理用户和群组、配置自动备份、查看维护日志、管理API令牌等。

总结

Mealie功能完善，对中文支持友好，并且得益于PWA技术，其移动端体验几乎可以媲美原生App。它不仅仅是一个食谱管理器，更是通过将食谱收藏、膳食规划、购物清单和智能家居集成融为一体，为美食爱好者和注重生活品质的家庭提供了一个功能全面、高度可定制且数据私有的数字化厨房解决方案。

如果你正被杂乱的食谱和无序的膳食安排所困扰，不妨花点时间在您的NAS或HomeLab上部署Mealie，为家人的饮食与健康添砖加瓦。