# 菜谱到冰箱：7个开源家庭管家，把日子过成一条流水线 ## 概述 连续几轮挖下来，AI 编程、自托管影音、终端工具都翻了个遍，这一轮换个思路：开发者工具看腻了，家里最古老的基础设施——厨房和储物间——反而是开源世界的洼地。本期 7 个仓库串成一条完整的「家庭运营」流水线：菜谱抓得进来（recipe-scrapers）、晚饭安排得明白（Mealie）、东西买得齐（KitchenOwl）、库存管得住（Grocy）、扫码枪都能接入（Barcode Buddy）、家里每件物品有台账（Homebox），最后连酒柜都能算出「现在能调哪杯」（Bar Assistant）。其中两个是千星以下的小而美，还有一个「原作者跑路、社区接管重生」的开源治理活案例。对自托管玩家和家庭用户来说，这一套拼起来，就是给日子装上了 ERP。 --- ## 逐个拆解 ### 1. Mealie：把全家的菜谱搬进一个 Docker 容器 **[mealie-recipes/mealie](https://github.com/mealie-recipes/mealie)** ｜ Star 约 1 万量级 ｜ 持续活跃 一句话定位：自托管菜谱中枢，解决「菜谱散落在收藏夹、截图、聊天记录里，想做饭时永远找不到」的痛点。 核心拆解：Mealie 是这个品类的事实标准。后端 Python FastAPI、前端 Vue，默认 SQLite、可选 Postgres，一条 docker run 就能跑起来。最有杀伤力的是 URL 导入——贴一个菜谱网页链接，标题、食材、步骤、图片自动结构化入库，底层正是本期第 2 个仓库 recipe-scrapers 在干活。再往上是膳食计划：按周排菜谱，一键把本周食材汇总成购物清单；多用户家庭分组，谁加的菜谱、谁改的步骤都有记录；开放 REST API，支持 OIDC/LDAP 单点登录，接到家庭导航页里毫无违和。2022 年的 1.0 版把整个项目重写过一次，之后由社区组织接手维护，是 r/selfhosted 社区常年霸榜的项目。 上手难度：⭐⭐ 适用人群：想给全家建一本「数字传家菜谱」的人；爸妈也会用的那种。二开方向：接入语音助手做「今晚吃什么」，或者叠加营养计算与控糖控卡的派生服务。老牌同类 Tandoor（TandoorRecipes/recipes）也值得对照一看。 ### 2. recipe-scrapers：所有菜谱软件脚下的轴承 **[hhursev/recipe-scrapers](https://github.com/hhursev/recipe-scrapers)** ｜ Star 数千星量级 ｜ 持续活跃 一句话定位：一个 Python 库，从全球数百个菜谱网站里把结构化菜谱抓出来，是整个自托管菜谱生态的隐形地基。 核心拆解：它的设计极其朴素——每个网站对应一个刮削类，统一接口返回标题、食材列表、步骤、时长等字段；对支持 schema.org Recipe 结构化数据的站点，则直接解析 JSON-LD 兜底，命中率高、维护成本低。纯 Python、几乎没有重依赖，pip 装完即用，单测用真实网页 HTML 做夹具，质量在同类抓取项目里相当扎实。它的价值在于「生态位」：Mealie、Tandoor 这些面向用户的应用，导入功能全都踩在它肩上。做产品的人常说要去「轮子下面找轴承」，这就是教科书级的例子——不直接面向用户，却决定了所有菜谱应用「贴个链接就能用」的体验下限。 上手难度：⭐⭐（作为库使用几乎零门槛） 适用人群：想做菜谱类产品、聚合工具或个人数据处理脚本的开发者。商业角度：任何「帮用户从全网导入菜谱」的服务，第一批基础设施成本它已经帮你付了。 ### 3. KitchenOwl：一张全家人实时同步的购物清单 **[TomBursch/kitchenowl](https://github.com/TomBursch/kitchenowl)** ｜ Star 数千星量级 ｜ 持续活跃 一句话定位：自托管的购物清单 + 食谱 + 家庭记账应用，解决「谁去买、买什么、家里谁补了货」永远对不齐的家庭协作痛点。 核心拆解：它最聪明的地方是端的选择——Flutter 写的 App 同时覆盖 iOS、Android、桌面和网页，后端自托管，出门买菜手机离线照常记账，回家自动同步。清单是实时协作的：你在家加一条「酱油」，超市里的人下拉就刷新出来，打勾即完成，还会按品类归组。后来陆续长出了食谱管理和家庭花费分摊，从纯清单工具演化成小型家庭财务入口。整个项目由一位个人开发者在业余时间长期维护多年，版本节奏稳定，是这个领域「小团队也能做出可靠基础设施」的代表。Docker Compose 一把梭，反向代理后面挂上就能全家用。 上手难度：⭐⭐ 适用人群：合租、小家庭、和父母异地但共用一张采购单的人。二开方向：社区团购的接龙清单、小型 B2B 的补货工具，都是同一套数据模型换个皮。 ### 4. Grocy：给冰箱装上 ERP 的鼻祖 **[grocy/grocy](https://github.com/grocy/grocy)** ｜ Star 数千星量级 ｜ 维护节奏平缓 一句话定位：「ERP beyond your fridge」——把制造业库存管理的整套思维搬进厨房，用条码管理冰箱里每一颗鸡蛋。 核心拆解：Grocy 是这个品类的定义者，2016 年前后就开始迭代，PHP + SQLite 的单体应用，树莓派都能流畅跑。它的概念体系极为完整：库存（保质期倒计时、开封后保质期）、条码扫描出入库、家务排班（谁该刷碗了）、电池更换记录、任务、日历、膳食计划，模块之间互相咬合，是真正的「家庭 ERP」而不是玩具。开放 REST API，配套的安卓 App 让你站在冰箱前拿手机扫码就能完成出入库。要提醒的是，近年它更新节奏明显放缓，社区时有「鼻祖是不是累了」的讨论，但迄今为止它定义的这套概念模型，仍然是后来者绕不开的蓝本。 上手难度：⭐⭐⭐（概念多，需要花一个晚上理解库存模型） 适用人群：重度囤货家庭、有保质期焦虑的人、开源硬件玩家（社区里有大量拿 ESP32 自制扫码终端的玩法）。二开方向：民宿布草耗材管理、小店的物料进出存，直接换一套术语就能用。 ### 5. Barcode Buddy：给 Grocy 外挂一个扫码大脑 **[Forceu/barcodebuddy](https://github.com/Forceu/barcodebuddy)** ｜ Star 三位数 ｜ 本期小而美之一 一句话定位：几十块钱的 dumb 扫码枪 + 它，就等于一台智能入库终端——专为 Grocy 设计的条码中间层。 核心拆解：家庭库存的真正瓶颈不在软件，在录入：每买一样东西都要手动建品、填保质期，坚持不过两周就会弃坑。Barcode Buddy 干的就是这件事的自动化：它监听 USB 扫码枪的键盘输入（扫码枪本质上就是个键盘），也支持网页里用手机摄像头扫码；扫到一个 Grocy 里不认识的条码，自动去 Open Food Facts 这类开放商品库查询，查到了直接带出商品名，查不到就进入「学习模式」让你补一次信息，下次自动识别。识别结果通过 Grocy 的 API 写入库存。整个项目体量很小，PHP 单应用，却是把「硬件 + 开放数据 + 家庭 ERP」三件事缝在一起的典型微型精品——这种别人懒得做的小胶水，往往才是自托管体验的胜负手。 上手难度：⭐⭐ 适用人群：已经在用 Grocy 且想坚持记库存的人；二手扫码枪淘到 30 块一把，配上它性价比拉满。二开方向：给小店、仓库做低成本出入库终端，改造空间很大。 ### 6. Homebox：家里每件物品的二维码台账 **[sysadminsmedia/homebox](https://github.com/sysadminsmedia/homebox)** ｜ Star 数千星量级 ｜ 持续活跃 一句话定位：家庭资产库存系统，给每件家当拍照、贴二维码标签，保修、位置、价值一目了然。 核心拆解：Grocy 管「会被吃掉的东西」，Homebox 管「不会被吃掉的东西」：电器、工具、乐器、行李箱。按「位置—物品—标签」组织，给每个物件附照片、发票、说明书附件，自动生成可打印的二维码标签，贴在收纳箱上，手机一扫就知道里面是什么、保修到几号、当初多少钱买的。搬家清点、报修、出二手、保险理赔，全都拿得出证据。技术上 Go 编写、SQLite 存储，资源占用极低。这个项目还有一段值得单独记住的历史：2024 年中原仓库一度停止维护，社区不甘心资产就此归零，在 sysadminsmedia 组织下接管继续开发并持续发版——它在自托管社区被广泛讨论，是一次教科书式的「开源项目断更、社区 fork 重生」治理案例，如今的表现甚至好过很多原生项目。 上手难度：⭐⭐ 适用人群：物品多到记不住的家庭、租房搬家频繁的人、做家庭财产清单给保险用的人。二开方向：二手租赁、仓储寄存小生意的管理系统，几乎没有距离。 ### 7. Bar Assistant：把家里的酒柜变成一台调酒计算机 **[karlomikus/bar-assistant](https://github.com/karlomikus/bar-assistant)** ｜ Star 千余星量级 ｜ 持续活跃 ｜ 本期小而美之二 一句话定位：自托管的家庭酒吧管理系统，录入你的酒柜库存后，它能实时回答那个终极问题——「我现在能调哪杯？」 核心拆解：这是本期最有性格的项目。后端是 PHP 写的 API 服务，配套的 Web 前端叫 Salt，界面做得很讲究。数据模型围绕鸡尾酒展开：基酒、利口酒、苦精、装饰物层层拆解，配料之间还能定义替代关系——家里没有金巴利，它会告诉你能用什么顶上。最核心的「酒架」功能：把你实际拥有的每瓶酒录进去，列表页立刻把上千种鸡尾酒筛成「现在就能调 / 差一瓶 / 差两杯」三档，酒精度核算、用量换算都在后台完成。还提供官方鸡尾酒数据包，一键导入上千个经典配方起步。项目由一位克罗地亚开发者在业余时间维护，API 优先的架构让它天然适合做各种客户端。 上手难度：⭐⭐⭐ 适用人群：在家调酒的爱好者、精酿与威士忌玩家。商业潜力是本期最清晰的：小酒馆的酒单与库存管理、调酒培训机构的课程工具、酒类电商的「买了能调什么」推荐引擎，全都能从这套数据模型长出来。 --- ## 本期横向对比 | 仓库 | 定位 | Star 量级 | 上手难度 | 适合场景 | |------|------|-----------|----------|----------| | Mealie | 菜谱中枢 | 约 1 万 | ⭐⭐ | 全家菜谱本 + 膳食计划 | | recipe-scrapers | 菜谱抓取库 | 数千星 | ⭐⭐ | 二次开发的地基 | | KitchenOwl | 采购清单 | 数千星 | ⭐⭐ | 全家实时同步购物 | | Grocy | 家庭 ERP | 数千星 | ⭐⭐⭐ | 囤货库存 + 家务管理 | | Barcode Buddy | 扫码外挂 | 三位数 | ⭐⭐ | 扫码枪接入库存 | | Homebox | 资产台账 | 数千星 | ⭐⭐ | 家当清点 + 保修管理 | | Bar Assistant | 家庭酒吧 | 千余星 | ⭐⭐⭐ | 酒柜管理 + 调酒推荐 | > 注：以上 Star 数为写作时的量级参考，非精确值，请以各仓库页面实时数据为准。 ## 全家流水线一图流 ```mermaid mindmap root((开源家庭管家)) 菜谱中枢 Mealie recipe-scrapers 采购协同 KitchenOwl 库存台账 Grocy Barcode Buddy Homebox 家庭酒吧 Bar Assistant ``` ```mermaid flowchart LR A[菜谱网站] -->|一键导入| B[Mealie] B -->|周计划生成| C[购物清单 KitchenOwl] C -->|买齐到家| D[扫码入库 Barcode Buddy] D -->|写入库存| E[Grocy 冰箱台账] E -->|库存不足提醒| C E -->|家里有什么酒| F[Bar Assistant 决定今晚喝什么] ``` ## 本期之最 - **最值得立即尝试：Mealie**。一条 Docker 命令、一次 URL 导入就能体验到价值，家庭接受度最高，周末两小时全家能用起来。 - **最有商业潜力：Bar Assistant**。数据模型专业、API 优先，向小酒馆 SaaS、调酒教育、酒类电商推荐引擎三个方向延展都不需要推翻重来；Homebox 的资产台账模型做二手租赁与寄存生意同样顺手。 - **最被低估：recipe-scrapers**。它不面向任何终端用户，却决定了整个品类「贴个链接就能导入」的体验下限——做产品的人应该在这种项目身上学会看生态位。 彩蛋：如果你想把菜谱当代码写，可以关注 CookLang——一种用纯文本描述菜谱的标记语言，和本期「菜谱即数据」的思路一脉相承。 ## 参考来源 1. [mealie-recipes/mealie](https://github.com/mealie-recipes/mealie) — 自托管菜谱中枢主仓库 2. [grocy/grocy](https://github.com/grocy/grocy) — 家庭 ERP 鼻祖主仓库 3. [sysadminsmedia/homebox](https://github.com/sysadminsmedia/homebox) — 社区接管维护的家庭资产台账 4. [karlomikus/bar-assistant](https://github.com/karlomikus/bar-assistant) — 家庭酒吧管理系统主仓库 5. [hhursev/recipe-scrapers](https://github.com/hhursev/recipe-scrapers) — 菜谱抓取基础库 > [!tip] 51学通信知识星球 > **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 > **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 > **当前规模**：5200 篇主题 / 990 个回答，198 元/年。 > **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 > **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。