jt196/vanilla-cookbook

这是什么？

核心功能

• 01将食材文本解析为用量、单位和食材，并支持按份量缩放
• 02美制体积单位可换算为公制和英制重量
• 03通过书签工具或粘贴网址导入食谱，并支持文件导入导出
• 04以结构化表格展示营养成分信息
• 05提供购物清单和带日历视图的烹饪记录
• 06以 Docker 容器运行，使用 SQLite 并支持自动备份
• 07可选的 LLM 辅助功能，用于抓取、翻译和语义搜索

适用场景

• 在自己的服务器上统一管理家庭食谱
• 从菜谱网站导入食谱并整理杂乱的食材列表
• 根据计划的菜单生成购物清单
• 通过公开食谱与家人或朋友分享菜谱集

快速上手

1. 1

   从模板创建 .env 文件

   curl -o .env https://raw.githubusercontent.com/jt196/vanilla-cookbook/main/.env.template
2. 2

   从模板创建 docker-compose.yml 文件

   curl -o docker-compose.yml https://raw.githubusercontent.com/jt196/vanilla-cookbook/main/docker-compose.yml.template
3. 3

   创建用于持久化的 db 和 uploads 文件夹

   mkdir -p ./db ./uploads
4. 4

   使用 Docker Compose 启动容器，首次运行时创建管理员用户

   docker-compose up -d

使用前须知

• !本地开发需要安装构建工具以编译 better-sqlite3 原生模块。
• !部分功能（如 LLM 辅助）需要受支持服务商的 API 密钥。

收录于专题

标签

常见问题

vanilla-cookbook 是什么？

一款自托管的食谱管理工具，支持从网址导入食谱、单位换算、食材缩放和烹饪记录。 Vanilla Cookbook 是一款自托管的食谱管理工具，界面力求简洁。它会将杂乱的食材文本解析为用量、单位和食材三部分，无需手动录入即可缩放和换算。美制体积单位可换算为公制或英制重量，同时保留原始文本。

vanilla-cookbook 可以免费使用吗？用的什么许可证？

vanilla-cookbook 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

vanilla-cookbook 还在维护吗？

活跃维护中。vanilla-cookbook 最近一次提交是在 2026年11月5日。

vanilla-cookbook 适合用来做什么？

在自己的服务器上统一管理家庭食谱 从菜谱网站导入食谱并整理杂乱的食材列表 根据计划的菜单生成购物清单 通过公开食谱与家人或朋友分享菜谱集

vanilla-cookbook 怎么安装和运行？

从模板创建 .env 文件: curl -o .env https://raw.githubusercontent.com/jt196/vanilla-cookbook/main/.env.template 从模板创建 docker-compose.yml 文件: curl -o docker-compose.yml https://raw.githubusercontent.com/jt196/vanilla-cookbook/main/docker-compose.yml.template 创建用于持久化的 db 和 uploads 文件夹: mkdir -p ./db ./uploads 使用 Docker Compose 启动容器，首次运行时创建管理员用户: docker-compose up -d

在哪里获取 vanilla-cookbook？

源代码和安装说明在 GitHub 上：https://github.com/jt196/vanilla-cookbook