CodeStacker

4781

積分

0

好友

655

主題 發(fā)消息 什么是EinVault？安裝部署運行與配置注意事項與最佳實踐參考文檔

樓主

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

什么是EinVault？

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

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

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

安裝部署

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

Docker CLI 安裝

如果你熟悉命令行，使用 docker cli 可能會更快捷。

# 新建文件夾 einvault 和 子目錄 mkdir -p /volume1/docker/einvault/data # 進入 einvault 目錄 cd /volume1/docker/einvault # 修改目錄權(quán)限 chmod a+rw data # 運行容器 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 保護 TZ Asia/Shanghai 時區(qū)設(shè)置，確保日期和時間正確顯示 NODE_ENV production 生產(chǎn)環(huán)境模式 DATABASE_URL /data/einvault.db 數(shù)據(jù)庫路徑 BODY_SIZE_LIMIT 10M 請求體大小限制 UPLOAD_MAX_MB 10 上傳文件大小限制（MB） user 1000:1000 容器運行的用戶 UID:GID Docker Compose 安裝

使用 docker-compose 進行管理也是不錯的選擇，尤其方便后續(xù)的維護和配置變更。將下面的內(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 # 進入 einvault 目錄 cd /volume1/docker/einvault # 修改目錄權(quán)限 chmod a+rw data # 將 docker-compose.yml 放入當(dāng)前目錄 # 一鍵啟動 docker-compose up -d

運行與配置

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

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

Name：名字 Breed：品種 Sex：性別 Date of birth：出生日期 Weight unit：重量單位 Microchip number：芯片編號 Bio / notes：簡介 / 注釋

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

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

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

注意事項與最佳實踐

數(shù)據(jù)備份：所有數(shù)據(jù)都保存在你掛載的 ./data 目錄（即容器內(nèi)的 /data 路徑）。定期備份這個目錄即可完整備份你的 EinVault 數(shù)據(jù)。結(jié)合 Docker 的部署方式，遷移和恢復(fù)也會非常方便。 ORIGIN 設(shè)置：這是最重要的環(huán)境變量之一，必須與你從外部瀏覽器訪問 EinVault 的地址（包括協(xié)議、域名/IP、端口）完全一致，否則會導(dǎo)致 CSRF 驗證失敗，無法提交表單。 端口占用：確保你指定的本地端口（示例中是 3608）沒有被其他服務(wù)占用。 HTTPS 訪問：如果你希望通過 HTTPS 安全訪問，需要在 EinVault 容器前配置反向代理，例如使用 Caddy、Nginx 或 Traefik。此時，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
項目地址：https://github.com/davefatkin/EinVault

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

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

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

0

0

0

長按一鍵三連

給UP主投 10枚算力

添加到我的收藏

相關(guān)帖子

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

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

相關(guān)知識

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

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