自托管服务
ulsklyc/yuvomi avatar
ulsklyc/yuvomi

Yuvomi:把家务、账目和日历收进一个自托管容器的家庭服务器方案

项目速览:自托管家庭计划 - 任务、日历、购物、膳食、预算。您的数据,您的服务器。

1,506 个 Star141 个 ForkJavaScriptMIT

秒懂

它是什么?
Yuvomi 是一个包含 19 个模块的自托管家庭管理应用,覆盖任务、购物、餐饮、预算和健康等场景。它强调模块间联动和本地数据控制,但部署与维护需要一定的服务器基础。
适合谁用?
Yuvomi 适合已经熟悉 Docker 和 NAS 操作、希望摆脱多个订阅制家庭应用的家庭用户或技术爱好者。它不适合完全不懂服务器管理、只想开箱即用的人群,因为你需要自己处理容器、备份和可能的故障。
能商用吗?
可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库在最近一天内有新的提交。
用什么语言写的?
主要是 JavaScript(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

一个容器代替十多个订阅

大多数家庭把生活工具拆散在十几个应用里,每个都有自己的账号、订阅和服务器。Yuvomi 试图把这些收拢到一个自托管容器中。根据 README,它包含 19 个模块,涵盖任务、日历、共享支出、预算、餐饮、购物、食品储藏室、文档、库存、笔记和联系人等。每个模块独立,可以按需开启或关闭。这个项目面向的是愿意自己运行服务器的人群,比如家庭、情侣或单身用户。它不只是一个任务清单,而是一个家庭数据的中枢。

模块联动是核心卖点

Yuvomi 的关键差异在于模块之间会互相通信。README 给出的例子很具体:一周的餐食计划会自动写入购物清单;从储藏室取出的最后一瓶果酱会出现在购物列表上;购物后勾选的项目会按数量回填到储藏室。任务完成可以获得积分,积分进入成员账户,并可通过奖励目录消费。上传的收据可以同时关联到交易、共享支出和库存项目。这种联动意味着数据不是孤立存放,而是形成一条家庭管理的工作流。对于习惯了单独应用的用户来说,这种集成省去了手动同步的麻烦。

部署与运行:Docker 容器与配置

根据仓库信息,Yuvomi 以容器形式分发,支持任何家庭服务器或 NAS。安装方式在 README 中称为“Install in minutes”,但具体命令没有在提供的材料中列出。文档链接指向 yuvomi.cloud 和 CHANGELOG.md,但这里没有详细步骤。这意味着你需要参考官方文档来获取 docker run 或 docker-compose 配置。项目使用 JavaScript 编写,主分支是 main,最新发布版本是 v2.52.1。部署时你需要准备一个持久化卷来存储数据库和上传的文件。由于没有提供默认端口或环境变量,建议查看官方仓库的安装章节。

数据同步与加密:隐私的边界

Yuvomi 强调“唯一离开服务器的是一次版本检查”,并支持可选的 AES-256 数据库加密。这听起来很吸引人,但要注意,加密是可选的,意味着默认情况下数据库可能未加密。同步方面,日历支持与 Google 和 CalDAV 双向同步,Outlook 通过 Microsoft Graph 单向推送。联系人支持 CardDAV 同步。这些功能意味着你的数据会与第三方服务交互,所以“完全私有”的说法需要打折扣。文档存储也可以配置为 WebDAV 或 Google Drive,这进一步扩展了数据流。如果你追求绝对隐私,需要仔细配置这些选项,而不是默认信任。

局限性与潜在失败模式

Yuvomi 的模块数量多,但并非所有模块都适合每个家庭。比如 Housekeeping 模块(管理家政人员)和 Schedule(轮班模式)默认关闭,显然针对特定需求。另一个限制是,项目没有提供内置的移动客户端,界面是 Web 应用,虽然支持壁挂模式用于厨房平板,但离线使用可能受限。同步功能是双向的,这可能带来冲突风险,比如在 Google Calendar 中修改事件,同时在 Yuvomi 中修改,需要处理冲突。文档没有提到冲突解决策略,这在实际使用中是一个未知数。此外,项目只有 MIT 许可,没有商业支持,遇到 bug 需要依赖社区或自行修复。

替代方案与差异

与 Yuvomi 类似的替代品包括 Home Assistant 和 Nextcloud,但它们的侧重点不同。Home Assistant 是一个家庭自动化平台,专注于设备控制和自动化,虽然也有任务和日历集成,但核心是物联网,而不是家庭事务管理。Nextcloud 则是一个文件同步和协作套件,提供日历、联系人、任务等应用,但模块间的联动不如 Yuvomi 紧密,比如餐食计划与购物清单的自动关联在 Nextcloud 中需要额外插件或手动配置。Yuvomi 的优势在于它专门为家庭场景设计,模块之间的数据流是内置的。如果你已经使用 Home Assistant 或 Nextcloud,可能不需要迁移,但如果你想要一个开箱即用的家庭管理集成,Yuvomi 可能更直接。

维护成本与许可考量

Yuvomi 采用 MIT 许可,允许自由使用、修改和分发,但没有提供法律建议。维护成本方面,你需要定期更新容器镜像以获取新版本,比如 v2.52.1 是最近的发布。项目提供了备份模块,支持手动和定时备份,以及恢复前的回滚,这有助于降低升级风险。但备份和恢复功能是内置的,意味着你需要配置存储位置,可能包括云上传。如果你使用 Google 或 CalDAV 同步,还需要管理 API 凭证和令牌。总体而言,维护工作量取决于你对模块的依赖程度。如果你只使用核心模块,维护负担较小,但如果你启用所有 19 个模块,需要关注每个模块的更新和兼容性。

编辑结论

Yuvomi 适合已经熟悉 Docker 和 NAS 操作、希望摆脱多个订阅制家庭应用的家庭用户或技术爱好者。它不适合完全不懂服务器管理、只想开箱即用的人群,因为你需要自己处理容器、备份和可能的故障。在采用前,先确认你的服务器能满足 Node.js 运行环境,并规划好备份策略,尤其是如果你依赖 Google Calendar 或 CalDAV 双向同步,务必测试同步冲突时的行为。该项目的 MIT 许可允许自由使用和修改,但如果你需要商业支持或 SLA,它并不提供。总体而言,Yuvomi 是一个功能密度高、模块联动设计出色的自托管选项,但它的价值完全取决于你愿意投入多少维护精力。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记