如何使用 Yuvomi 在自己的服务器上搭建家庭指挥中心

你有多少个服务在运行，仅仅是为了处理基本的家务？购物清单一个单独的标签页，Google Calendar 用于预约，共享费用软件，几个习惯追踪器，还有一个任务管理订阅。每个服务都需要一个账户，把你的数据存在别人的服务器上，还要时不时地涨价。

Yuvomi 项目的作者从根本上解决了这个问题。他们编写了一个单一的自托管一体化解决方案，可以替代一堆订阅服务，只需一个 Docker 容器即可部署。

为什么需要一个统一的家庭服务器

家庭管理数字化的想法并不新鲜，但问题通常是碎片化。如果你在一个地方追踪预算，在另一个地方追踪每周菜单，它们之间就没有联系。你必须手动将食谱中的食材添加到购物清单，然后再对照收据。

Yuvomi 在一个界面中整合了十七个部分。日历、食品储藏室、财务、任务，甚至医疗记录都存在于一个系统中。每个家庭成员都有自己带隐私设置的个人资料。你可以只让自己看到某个日历事件，或者与他人共享某个任务。

整个系统在本地运行，不会向外部服务器发送遥测数据，并且可以通过 SQLCipher（AES-256）加密数据库。

日常生活中的实用功能

与其列出所有十七个模块，不如看看几个展示这个项目真正价值的组合。

厨房和食品储藏室自动化

餐饮规划器与你的食谱数据库、购物清单和家庭用品相关联。你可以通过从食谱数据库中拖拽菜品来制定每周菜单。只需按一下按钮，所有必要的食材就会直接进入你的购物清单。

在商店里，清单按部门分组。当你勾选已购买的奶酪或牛奶时，应用会提示你自动将其入库到食品储藏室模块。当产品接近保质期时，系统会发出警告。

预算和费用分摊

财务部分可以追踪的收入和周期性付款之外的更多内容。它包含一个共享预算模块。如果你和家人或朋友一起旅行，在不同的商店购物，Yuvomi 会重新计算债务，并显示谁欠谁多少钱需要转账。

还有一个专门的贷款和抵押贷款追踪器。该算法可以计算等额本息还款，考虑浮动利率，并清楚地显示已支付的总利息。

家务事的游戏化

孩子和青少年很少喜欢洗碗或倒垃圾。在 Yuvomi 中，你可以为完成看板上的任务奖励积分。

家长配置奖励目录：例如，一小时的游戏机时间、去电影院看电影，或者零花钱。孩子完成家务，积累积分，然后通过应用兑换。积分增加和扣除的记录会保存在历史中，所以余额不会有争议。

技术内幕

与现代充斥着前端框架的网络应用相比，Yuvomi 的技术方面简洁得令人耳目一新。

开发者抛弃了打包工具和转译器。前端使用原生 JavaScript（ES Modules）和标准 CSS 编写。项目中没有 Webpack、Vite 或 React。即使在低功耗设备上，页面也能即时加载。界面使用 Liquid Glass 样式，巧妙地适配手机屏幕，并可作为 PWA 运行。离线时，你仍然可以查看最后加载的任务和日历。

后端运行在 Node.js 22 和 Express 上。数据库使用 SQLite 或 SQLCipher。

另一个细节：Yuvomi 内置了 MCP（Model Context Protocol），并包含 OpenAPI 3.0 规范。这意味着你可以将 Claude Desktop 等 AI 代理连接到你的服务器。你可以要求神经网络"把四人份的红菜汤食材添加到购物清单"，它会直接通过 API 完成。

如何部署和试用

启动项目最简单的方式是通过现成的 Docker Compose。

创建文件 docker-compose.yml：

version: '3.8'

services:
  yuvomi:
    image: ghcr.io/ulsklyc/yuvomi:latest
    container_name: yuvomi
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - SESSION_SECRET=замените_на_случайную_строку
      - DB_ENCRYPTION_KEY=ключ_для_шифрования_базы
    volumes:
      - ./data:/app/data

启动后，命令 docker compose up -d 会在 3000 端口部署服务。第一次在浏览器中访问会打开一个分步向导来创建管理员账户。

对于运行 TrueNAS SCALE、Umbrel 或 Unraid 的 NAS 用户来说，甚至更简单：Yuvomi 在应用目录中可用，只需点击一下即可安装。顺便说一句，该项目之前名为 Oikos，因此在某些目录中可能以旧名称出现。

这个项目适合谁

Yuvomi 是自托管爱好者和希望将所有家庭流程整合到一个私有系统中的家庭的绝佳发现。如果你厌倦了不断上涨的订阅价格、广告以及对个人数据安全的担忧，它绝对值得一试。

最低的硬件要求和无重型依赖让你可以在老旧的 Raspberry Pi 或最便宜的 VPS 上舒适地运行该服务。