企业官网建设流程全解析

Yuvomi 是一款免费开源的自托管家庭管理中心（self-hosted family planner），把任务、日历、购物清单、餐食计划和家庭预算装进一个容器。它官方支持 arm64 架构，在树莓派上运行最低只需256 MB 内存和 1 个端口，你的数据就躺在自家硬盘里。本文用 4 步带你在树莓派上完成部署。

为什么家庭管理中心要选 Yuvomi？

很多家庭用十几个付费 App 拼凑生活管理：一个管待办、一个管日历、一个管买菜、一个管记账，每个都有订阅费，数据都散在别人的服务器上。Yuvomi 的思路是一个家庭，一个家：

• 📋任务：看板 + 截止日期 + 重复任务 + 多人指派
• 📅日历：支持 Google / CalDAV 双向同步、节假日、按事件控制可见性
• 🛒购物：按超市通道分组的共享清单，支持滑动勾选
• 🍽️餐食与食谱：拖拽式周计划，一键把食材导出到购物清单
• 💶预算：收入、支出、账户、订阅和 AA 分摊（带债务简化）
• 📁文档 / 健康 / 生日 / 奖励积分等共 20 个模块，不用的可以直接关掉

最关键的是模块之间会互相说话：一周的菜单导入后自动生成购物清单；勾选家务任务自动发放积分，孩子可以在你控制的奖励目录里"消费"。这是十几个独立 App 做不到的。

树莓派硬件要求清单：够不够跑得动？

先说结论：官方明确支持树莓派 4 / 5（arm64 镜像），内存门槛极低。

几个让树莓派用户放心的细节：

• 官方发布amd64与arm64双架构 Docker 镜像（见 docs/installation.md 的系统要求章节），docker pull时会自动匹配树莓派架构；
• 项目对低性能设备做了专门优化，比如文档上传以二进制 BLOB 存储进 SQLite，省去 Base64 开销，官方说明中点名"在树莓派这类低性能设备上最明显"；server/db.js 里还有针对小内存设备的分页收集逻辑；
• 所有数据就一个 SQLite 文件（/data/yuvomi.db），可选 AES-256 加密（SQLCipher），备份时"拷贝整个文件"即可。

树莓派 4 步安装 Yuvomi（Docker）

前提：树莓派已刷好 Raspberry Pi OS（64 位），并能 SSH 或本地操作。

第 1 步：安装 Docker 与 Compose

树莓派 OS 基于 Debian，一条命令搞定：

sudo apt update && sudo apt install -y docker.io docker-compose-v2

第 2 步：获取项目文件

git clone https://gitcode.com/gh_mirrors/oi/yuvomi && cd yuvomi

克隆下来的 docker-compose.yml 已配置好端口映射（默认 3000）、数据卷挂载和容器健康检查。

第 3 步：生成密钥并配置.env

cp .env.example .env openssl rand -hex 32 # 生成 SESSION_SECRET openssl rand -hex 32 # 生成 DB_ENCRYPTION_KEY

打开.env，把两个占位符依次替换为刚生成的值。⚠️第二个是数据库加密密钥，务必抄写在安全的地方——它一旦丢失，数据库将无法再打开；若想不加密，则把DB_ENCRYPTION_KEY一行留空。

第 4 步：启动并访问

docker compose up -d

在任意设备的浏览器打开http://<树莓派IP>:3000，首次访问会进入引导向导，创建你的管理员账户。若页面打不开，docker compose logs通常会直接告诉你原因。

嫌手动步骤麻烦？仓库还内置了浏览器安装向导：git clone后运行node tools/installer/install-server.js，打开http://localhost:8090即可按 26 种语言的图文向导完成配置（需要主机装 Node.js 22+，见 tools/installer/install-server.js）；或直接用命令行安装器 install.sh。

全家上手：3 个让树莓派变成家庭中枢的用法

1️⃣ 邀请链接，家人一键加入

每个成员通过邀请链接加入并自行设置密码；没有手机的孩子也可以由家长直接创建账户。按家庭角色分配权限，每个模块对每个人可以是"完全 / 只读 / 不可见"三档——孩子账号看预算？关掉就行。

2️⃣ 厨房平板"墙模式"

把一块闲置平板架在厨房墙上，开启墙模式：大号时钟、今日任务与用药、"今天谁值班"、天气，隔着一间厨房都看得清。它有自己的独立账户——点一下任务就能记录"是谁干的活"，积分自动归属。平板闲置时还能接 Immich 做照片屏保（见 docs/immich-screensaver.md）。

3️⃣ 手机加到主屏幕，推送提醒不错过

Yuvomi 是标准 PWA：手机浏览器打开后"添加到主屏幕"，效果堪比原生 App，不需要任何应用商店。任务到期、购物清单更新、生日临近，都能以推送通知送达（需为树莓派配置 HTTPS 反向代理，nginx.conf.example 提供了参考配置）。

日常维护：更新与备份只要各一行命令

更新：

git pull && docker compose pull && docker compose up -d

备份：数据卷中backups目录存放可恢复的备份归档，支持计划任务自动备份 + WebDAV 上传；跨设备迁移时，甚至可以直接在浏览器里恢复其他实例的备份文件。完整备份与故障排查流程见 docs/installation.md。

常见问题

Q：树莓派 4/5 的 1GB 内存够用吗？够。官方最低要求就是 256 MB 内存，1GB 以上的树莓派可以很舒服地跑，还能同时给家里塞几个别的容器。

Q：家人在外面能访问吗？可以。在树莓派前面加一层 Nginx 反向代理 + HTTPS 证书，就能从外网安全访问，同时解锁推送通知功能。每个账户还可加 TOTP 双因素认证。

Q：项目停更了怎么办？Yuvomi 是 MIT 协议、纯自托管——不存在任何官方服务器，你 pull 下来的容器照常运行，数据永远在你自己的盘上。

写在最后

一块 30 块钱的闲置树莓派 + 一个 Yuvomi 容器，你就拥有了一个不花订阅费、数据完全自持的全家共享中枢。从docker compose up -d到全家用起来，通常不会超过一个下午。

📖 延伸阅读：README.md · docs/installation.md · CHANGELOG.md