首頁 資訊 EinVault開源自托管寵物健康管理平臺(tái):本地化部署與群暉Docker安裝指南

EinVault開源自托管寵物健康管理平臺(tái):本地化部署與群暉Docker安裝指南

來源:泰然健康網(wǎng) 時(shí)間:2026年04月07日 23:10

CodeStacker

4781

積分

0

好友

655

主題 發(fā)消息 什么是EinVault?安裝部署運(yùn)行與配置注意事項(xiàng)與最佳實(shí)踐參考文檔

樓主

發(fā)表于 19 小時(shí)前 | 查看: 11| 回復(fù): 0

什么是EinVault?

EinVault 是一個(gè)專為 homelabs 設(shè)計(jì)的開源寵物健康和護(hù)理追蹤器。它可以幫助用戶記錄寵物的健康檔案、每日活動(dòng)、護(hù)理日程,所有數(shù)據(jù)都保存在本地硬件上,不依賴云服務(wù),無需注冊(cè)外部賬號(hào)。

主要特點(diǎn) 寵物檔案:支持記錄品種、簡(jiǎn)介、獸醫(yī)信息、緊急聯(lián)系人和頭像照片。 每日日記:為每只寵物創(chuàng)建日記條目,支持心情追蹤和每日最多 5 張照片。 健康追蹤:記錄就診、疫苗接種、藥物、程序和體重歷史。 活動(dòng)日志:追蹤散步、餐食、排泄、零食、玩耍和美容記錄。 提醒功能:支持 recurring 和一次性提醒,覆蓋藥物、疫苗、美容等場(chǎng)景。 護(hù)理輪班:安排工作輪班并導(dǎo)出為 iCalendar(.ics)格式。 角色權(quán)限:管理員管理應(yīng)用,成員跟蹤健康,護(hù)理人員記錄活動(dòng)。 自包含部署:?jiǎn)?Docker 容器 + SQLite 數(shù)據(jù)庫,無外部依賴。 多語言支持:英語、德語、西班牙語、法語、意大利語和葡萄牙語。 響應(yīng)式 UI:支持桌面和移動(dòng)端,暗色和亮色主題。 應(yīng)用場(chǎng)景 家庭寵物管理:為家中寵物建立完整的健康檔案和日常記錄。 多寵物家庭:同時(shí)管理多只寵物的健康和活動(dòng)。 寵物寄養(yǎng):護(hù)理人員可以記錄寵物日常情況。 獸醫(yī)記錄:保存就診歷史和疫苗接種記錄。 輪班看護(hù):家庭成員輪流照顧寵物時(shí)共享信息。

EinVault 是一個(gè)功能全面的寵物健康和護(hù)理管理工具,適合有寵物且希望本地管理寵物數(shù)據(jù)的用戶。

安裝部署

在群暉上以 Docker 方式安裝。該鏡像托管在 ghcr.io,如果使用群暉的 Docker 圖形界面可能無法直接搜索到,需要通過命令行來部署。

Docker CLI 安裝

如果你熟悉命令行,使用 docker cli 可能會(huì)更快捷。

# 新建文件夾 einvault 和 子目錄 mkdir -p /volume1/docker/einvault/data # 進(jìn)入 einvault 目錄 cd /volume1/docker/einvault # 修改目錄權(quán)限 chmod a+rw data # 運(yùn)行容器 docker run -d   --name=EinVault   --restart=unless-stopped   -p 3608:3000   -v $(pwd)/data:/data   -e ORIGIN=http://192.168.0.197:3608   -e TZ=Asia/Shanghai   -e NODE_ENV=production   -e DATABASE_URL=/data/einvault.db   -e BODY_SIZE_LIMIT=10M   -e UPLOAD_MAX_MB=10   -e user=1000:1000   ghcr.io/davefatkin/einvault:latest

關(guān)于環(huán)境變量的說明:

可變 值 說明 ORIGIN http://群暉IP:端口 必填,公共訪問地址,用于 CSRF 保護(hù) TZ Asia/Shanghai 時(shí)區(qū)設(shè)置,確保日期和時(shí)間正確顯示 NODE_ENV production 生產(chǎn)環(huán)境模式 DATABASE_URL /data/einvault.db 數(shù)據(jù)庫路徑 BODY_SIZE_LIMIT 10M 請(qǐng)求體大小限制 UPLOAD_MAX_MB 10 上傳文件大小限制(MB) user 1000:1000 容器運(yùn)行的用戶 UID:GID Docker Compose 安裝

使用 docker-compose 進(jìn)行管理也是不錯(cuò)的選擇,尤其方便后續(xù)的維護(hù)和配置變更。將下面的內(nèi)容保存為 docker-compose.yml 文件。

services:   einvault:     image: ghcr.io/davefatkin/einvault:latest     container_name: einvault     restart: unless-stopped     # Option A (default): host-level proxy (Nginx, Caddy, Traefik on the host)     ports:       - '3608:3000'     # Option B: Docker-network proxy (Traefik, Caddy running in Docker)     # Comment out ports above and uncomment below, then add your proxy labels/config.     # expose:     #   - "3000"     # networks:     #   - proxy     volumes:       - ./data:/data     user: '1000:1000'     environment:       # Your public URL — must match the address you access EinVault from.       # Used for CSRF protection; the app will reject form submissions without it.       ORIGIN: http://192.168.0.197:3608       NODE_ENV: production       DATABASE_URL: /data/einvault.db       BODY_SIZE_LIMIT: 10M       UPLOAD_MAX_MB: 10       # Set to your local timezone so dates and times display correctly.       # Defaults to UTC if omitted. Example: America/New_York, Europe/London       # TZ: America/New_York     security_opt:       - no-new-privileges:true     cap_drop:       - ALL     read_only: true     tmpfs:       - /tmp:mode=1777,size=64m     deploy:       resources:         limits:           #  cpus: '0.5'           memory: 256M         reservations:           memory: 64M     healthcheck:       test: ['CMD', 'wget', '-qO-', 'http://127.0.0.1:3000/api/health']       interval: 30s       timeout: 5s       retries: 3       start_period: 15s     # Uncomment if using Option B     # networks:     #   proxy:     #     external: true

然后通過 SSH 登錄到您的群暉,執(zhí)行下面的命令:

# 新建文件夾 einvault 和 子目錄 mkdir -p /volume1/docker/einvault/data # 進(jìn)入 einvault 目錄 cd /volume1/docker/einvault # 修改目錄權(quán)限 chmod a+rw data # 將 docker-compose.yml 放入當(dāng)前目錄 # 一鍵啟動(dòng) docker-compose up -d

運(yùn)行與配置

在瀏覽器中訪問 http://<群暉IP>:3608 ,首次運(yùn)行需要?jiǎng)?chuàng)建管理員賬戶。頁面底部支持多語言切換,但目前暫無中文選項(xiàng)。

接著就可以開始添加你的寵物伙伴了。你需要填寫的信息包括:

Name:名字 Breed:品種 Sex:性別 Date of birth:出生日期 Weight unit:重量單位 Microchip number:芯片編號(hào) Bio / notes:簡(jiǎn)介 / 注釋

添加完成后,你會(huì)進(jìn)入主界面。左側(cè)的導(dǎo)航菜單是核心功能入口:

Dashboard:儀表板,概覽所有信息。 Journal:每日日記,為每個(gè)寵物記錄日常點(diǎn)滴,支持情緒追蹤,每天最多可上傳 5 張照片。 Health:健康追蹤,管理獸醫(yī)就診、疫苗接種、用藥、手術(shù)及體重歷史記錄。 Reminders:提醒事項(xiàng),設(shè)置藥物、疫苗接種、美容等周期性或一次性提醒。

如果你有多只寵物,可以在 Settings 設(shè)置頁面中點(diǎn)擊 Add Companion 按鈕繼續(xù)添加。

注意事項(xiàng)與最佳實(shí)踐

數(shù)據(jù)備份:所有數(shù)據(jù)都保存在你掛載的 ./data 目錄(即容器內(nèi)的 /data 路徑)。定期備份這個(gè)目錄即可完整備份你的 EinVault 數(shù)據(jù)。結(jié)合 Docker 的部署方式,遷移和恢復(fù)也會(huì)非常方便。 ORIGIN 設(shè)置:這是最重要的環(huán)境變量之一,必須與你從外部瀏覽器訪問 EinVault 的地址(包括協(xié)議、域名/IP、端口)完全一致,否則會(huì)導(dǎo)致 CSRF 驗(yàn)證失敗,無法提交表單。 端口占用:確保你指定的本地端口(示例中是 3608)沒有被其他服務(wù)占用。 HTTPS 訪問:如果你希望通過 HTTPS 安全訪問,需要在 EinVault 容器前配置反向代理,例如使用 Caddy、Nginx 或 Traefik。此時(shí),ORIGIN 環(huán)境變量也應(yīng)設(shè)置為你的 HTTPS 地址。示例中的 docker-compose.yml 已預(yù)留了相關(guān)配置注釋(Option B),可供參考。

參考文檔

EinVault: A private, self-hosted companion health and care tracker
項(xiàng)目地址:https://github.com/davefatkin/EinVault

這是一個(gè)典型的 “自托管” 解決方案,將數(shù)據(jù)控制權(quán)完全交還給用戶。如果你對(duì)類似的本地化部署和 開源實(shí)戰(zhàn) 項(xiàng)目感興趣,可以訪問 云棧社區(qū) 獲取更多部署經(jīng)驗(yàn)和技術(shù)討論。

上一篇:興業(yè)證券成交量分桶熵因子詳解:算法原理、Python實(shí)現(xiàn)與回測(cè)驗(yàn)證
下一篇:Cursor 3發(fā)布,智能體編程時(shí)代開啟:IDE的角色正被重新定義

Docker, Node.js, SQLite, 寵物管理, 健康追蹤

0

0

0

長(zhǎng)按一鍵三連

給UP主投 10枚算力

添加到我的收藏

相關(guān)帖子

? 如何在瀏覽器中直接運(yùn)行Python?Pyodide技術(shù)詳解與上手指南 ? Kubernetes 鏡像管理避坑指南:從拉取策略到私有倉庫認(rèn)證 ? Docker 一鍵部署 HolyClaude:集成了 Claude Code 等 7 大 AI 的編程工作站 ? Tentix開源AI客服系統(tǒng)評(píng)測(cè):不只是工單,歷史知識(shí)庫沉淀是關(guān)鍵 ? EMQX插件漏洞復(fù)現(xiàn)與利用分析:5.5.1版本后臺(tái)命令執(zhí)行 ? Claude Code TUI 高性能渲染引擎:五層架構(gòu)與零GC優(yōu)化深度解析 ? 朝鮮黑客UNC1069供應(yīng)鏈攻擊分析:通過Axios投毒滲透AI智能體OpenClaw ? GPT Code Interpreter技術(shù)解析:Python代碼執(zhí)行的三種實(shí)現(xiàn)方案與安全考量 ? Screego:基于WebRTC的瀏覽器屏幕共享工具,免安裝即用 ? 深入剖析Docker容器網(wǎng)絡(luò)原理:從veth pair、bridge到四種網(wǎng)絡(luò)模式實(shí)戰(zhàn)

收藏回復(fù) 只看該作者 舉報(bào)

相關(guān)知識(shí)

EinVault開源自托管寵物健康管理平臺(tái):本地化部署與群暉Docker安裝指南
開源智能家居管理平臺(tái)(Home Assistant)
寵物營養(yǎng)與健康管理智能平臺(tái)構(gòu)建
Docker安全性:最佳實(shí)踐和常見安全考慮
使用 docker 部署 AspNetCore 應(yīng)用:使用alpine鏡像并加入健康檢查和瘦身
咖啡壺(chemex)安裝
寵物AI能力開放平臺(tái)的最佳實(shí)踐:寵智靈如何驅(qū)動(dòng)行業(yè)智能化變革
8 個(gè)最佳的開源任務(wù)管理系統(tǒng)(附打分)
開源智能家居自動(dòng)化平臺(tái)(HomeGenie)
大健康產(chǎn)業(yè)遠(yuǎn)程健康管理與服務(wù)平臺(tái)開發(fā)案.doc

網(wǎng)址: EinVault開源自托管寵物健康管理平臺(tái):本地化部署與群暉Docker安裝指南 http://m.gysdgmq.cn/newsview1929620.html

推薦資訊