Docker 搭個家庭管家：日程、賬單、任務全能管，Yuvomi使用與搭建

家裏的事情一多，大家會不會碰到以下情況？

週末有什麼安排，臨時才發現彼此時間衝突；水電、物業、訂閱什麼時候續費，總要等到提醒彈出來纔想起；家庭開支記在不同地方，想覆盤時又很難找全；常用資料、保修記錄和重要日期，也散落在手機備忘錄、日曆和文件夾裏。

有沒有一個平臺，能把家庭日程、任務、預算、購物、菜譜、文件和提醒統一管理，並且讓家人共同使用？本期要介紹的 Yuvomi 就是這樣一套家庭生活管理工具。部署 NAS 後，全家人手機和電腦都能訪問，數據也由自己保存和管理。

項目介紹

完整項目名：ulsklyc/yuvomi，可於GitHub直接搜索。

Yuvomi 是一款開源、自託管的家庭生活管理平臺，可以把日曆、任務、購物清單、家庭預算、菜譜、文件、健康記錄和提醒等功能集中到一個界面中。

它支持多成員共同使用，每位家庭成員都可以擁有獨立賬號、權限和個人數據，同時也能共享日程、任務和家庭事務。Yuvomi 採用手機優先的界面設計，支持 PWA 安裝，部署完成後可以直接通過手機、平板或電腦訪問。

項目特點

功能集中 將家庭日曆、任務、購物清單、菜譜、預算、文件、健康記錄、生日和提醒等功能整合到一個平臺中，不需要在多個 App 之間來回切換。
支持多人共同使用 每位家庭成員都可以擁有獨立賬號、頭像和權限，既能共享家庭事務，也能保留個人內容。
手機和電腦都能訪問 採用響應式界面設計，支持手機、平板和電腦瀏覽，還可以作爲 PWA 添加到手機桌面，使用體驗更接近普通 App。
數據保存在自己手中 所有數據都運行在自己的 NAS 上，不依賴第三方雲平臺，也沒有訂閱費用和廣告追蹤。
支持數據加密與自動備份 可啓用數據庫加密，並設置定時備份、備份保留數量和 WebDAV 遠程備份，降低數據丟失風險。
模塊可自由啓用 Yuvomi 的各項功能相互獨立，可以根據家庭實際需求開啓或關閉，不需要使用全部模塊。
擴展能力豐富 支持 Google 日曆、CalDAV、CardDAV、WebDAV、Gotify、ntfy、OIDC 單點登錄以及 MCP 接口，後續可繼續與其他服務聯動。
官方提供 Docker 鏡像 支持 x86 和 ARM 架構，可直接通過 Container Station 部署，適配大多數威聯通 NAS。

部署流程

以威聯通NAS爲例，通過Docker Compose的方式進行部署。

部署代碼如下：

services: yuvomi: image: ghcr.io/ulsklyc/yuvomi:latest container_name: yuvomi restart: unless-stopped ports: - "3847:3000" volumes: - /share/Container/yuvomi/data:/data # 應用數據及數據庫 - /share/Container/yuvomi/backups:/backups # 數據庫備份 - /share/Container/yuvomi/modules:/app/modules # 自定義擴展模塊 - /share/Container/yuvomi/documents:/documents # 家庭文檔存儲 environment: TZ: Asia/Shanghai NODE_ENV: production DB_PATH: /data/yuvomi.db # 數據庫 SESSION_SECRET: "請替換爲至少64位隨機字符串" DB_ENCRYPTION_KEY: "請替換爲至少64位隨機字符串" # 直接通過 NAS IP 和端口訪問 SESSION_SECURE: "false" TRUST_PROXY: "loopback" # 自動備份 BACKUP_DIR: /backups BACKUP_ENABLED: "true" BACKUP_SCHEDULE: "0 2 * * *" BACKUP_KEEP: "7" # 將上傳的文檔保存到 NAS 目錄 DOCUMENT_STORAGE_LOCAL_ENABLED: "true" DOCUMENT_STORAGE_LOCAL_PATH: /documents # 日曆和聯繫人同步間隔，單位爲分鐘 SYNC_INTERVAL_MINUTES: "15" # 登錄保護 RATE_LIMIT_WINDOW_MS: "60000" RATE_LIMIT_MAX_ATTEMPTS: "5" RATE_LIMIT_BLOCK_DURATION_MS: "900000"

建議複製後用AI進行排版。

打開威聯通的Container Station創建新的應用程序。

使用一覽

部署完畢後，瀏覽器輸入NAS_IP:3847即可訪問服務。首次訪問會進入初始化頁面，根據提示創建管理員賬號即可。

後續還可以繼續添加家庭成員，讓每個人使用自己的賬號登錄，並分別設置頭像、角色和可訪問內容。

登錄後首先進入 Yuvomi 的首頁儀表盤。近期日程、待辦任務、購物事項、用餐計劃等信息，都可以集中顯示在同一個頁面中，不需要分別打開日曆、備忘錄和記賬軟件查看。

左側導航欄則彙集了任務、購物、菜單、菜譜、日曆、文件、預算、健康、聯繫人、生日和提醒等功能。Yuvomi 採用模塊化設計，不準備使用的功能可以關閉，避免頁面顯得過於複雜。項目目前內置了 16 個主要模塊。

點擊右上角的佈局按鈕，還可以調整首頁卡片的顯示位置。比如將日曆、任務和購物清單放在前面，把不常用的功能隱藏起來，讓首頁更符合自己的使用習慣。

Yuvomi 支持多人共同使用，每位家庭成員都可以擁有獨立賬號、頭像和角色。添加完成後，創建日程或任務時可以直接指定參與成員，不必所有內容都混在同一個賬號裏。

例如，家庭共同出行的安排可以對所有成員可見；個人日程、健康記錄或私人預算則可以單獨保存。這樣既能共同管理家庭事務，也可以保留各自的個人空間。項目支持按內容設置“僅自己、指定成員或所有人可見”。

再看下「聯繫人」。需要注意，聯繫人和家庭成員不是同一個概念。聯繫人更接近家庭通訊錄，可以保存姓名、生日、電話和地址；家庭成員則可以登錄 Yuvomi，參與任務、日程、預算和其他家庭事務。

「任務」模塊可以用來記錄需要完成的事情，並通過看板查看進度。創建任務時可以設置截止時間、優先級、子任務、重複週期和負責人。

對於需要長期重複的事務，只需要設置一次重複週期，後續便會自動生成，不必每次重新添加。任務還可以關聯文件模塊中的合同、票據或說明文檔。

任務模塊還可以與「獎勵」功能配合。完成指定任務後獲得積分，再通過家庭成員共同設定的獎勵目錄兌換獎勵。是否使用這一功能，可以根據家庭實際需求決定，並不侷限於兒童家務場景～這個還是比較有趣的。

「日曆」模塊可以記錄家庭活動、繳費時間、紀念日、預約和其他重要安排。每個日程都可以指定參與成員和可見範圍，避免所有人的日曆混在一起。Yuvomi 還支持 Google Calendar、iCloud、CalDAV 和 ICS 日曆訂閱。如果原本已經在使用手機日曆，可以繼續同步到 Yuvomi，不需要從頭重新錄入。項目也支持重複日程、節假日覆蓋和只讀日曆訂閱。

「預算」模塊可以記錄收入、支出、賬戶餘額、貸款、儲蓄目標和每月預算，也可以單獨管理需要定期續費的訂閱服務。例如，家庭寬帶、手機套餐、視頻會員、雲服務和保險，都可以記錄金額與續費時間。到了設定日期前，系統會通過提醒中心通知，避免忘記續費或長期支付已經不再使用的服務。預算模塊還支持個人預算和家庭預算分開查看，並可以按照類別統計支出、查看趨勢和導出 CSV 文件。

「廚房」中的菜譜、菜單和購物清單並不是三個完全獨立的功能，而是可以連接使用。可以先在菜譜中保存常做的菜品和所需食材，再將菜譜拖入每週菜單。確定一週的用餐安排後，還可以把所需食材直接加入購物清單，減少重複整理的步驟。

健康模塊可以按成員記錄體重、血壓、用藥、檢查結果、運動和其他健康數據，並通過趨勢圖查看變化。由於這類數據比較敏感，Yuvomi 支持使用 SQLCipher 對數據庫進行加密。

生日模塊可以從聯繫人中選擇成員，並自動在日曆中建立生日事件和提醒。聯繫人還支持 CardDAV 同步以及 vCard 導入、導出，方便與其他通訊錄工具交換數據。

Yuvomi 採用手機優先的響應式設計，可以直接通過手機瀏覽器訪問，也可以作爲 PWA 添加到手機桌面。添加完成後，可以像普通 App 一樣從桌面打開，不需要經過應用商店安裝。在網絡暫時不可用時，PWA 還能以只讀方式查看最近打開過的日曆、任務、購物清單、聯繫人和首頁內容。

項目支持站內提醒、Web Push、Gotify 和 ntfy。任務到期、日程開始、訂閱續費或用藥時間臨近時，都可以通過相應渠道發送提醒。Web Push 需要通過 HTTPS 域名訪問。

Yuvomi 內置數據庫備份功能，可以手動備份，也可以按照設定的時間自動執行。本文的部署配置默認每天凌晨 2 點備份一次，並保留最近 7 份，備份文件保存在/share/Container/yuvomi/backups。備份模塊也支持將備份文件上傳到 WebDAV，並在恢復數據庫之前自動建立回滾備份。