开源宠物健康护理追踪器EinVault

发表于 2026-04-06 分类于各种折腾 Waline：阅读次数：本文字数： 3.4k 阅读时长 ≈ 3 分钟

EinVault 是一个开源的宠物健康和护理追踪器，支持记录日记、健康档案、活动日志和提醒功能。

简介

什么是 EinVault ？

EinVault 是一个专为 homelabs 设计的开源的宠物健康和护理追踪器。它可以帮助用户记录宠物的健康档案、每日活动、护理日程，所有数据都保存在本地硬件上，不依赖云服务，无需注册外部账号。

主要特点

宠物档案：支持记录品种、简介、兽医信息、紧急联系人和头像照片
每日日记：为每只宠物创建日记条目，支持心情追踪和每日最多 5 张照片
健康追踪：记录就诊、疫苗接种、药物、程序和体重历史
活动日志：追踪散步、餐食、排泄、零食、玩耍和美容记录
提醒功能：支持 recurring 和一次性提醒，覆盖药物、疫苗、美容等场景
护理轮班：安排工作轮班并导出为 iCalendar（.ics）格式
角色权限：管理员管理应用，成员跟踪健康，护理人员记录活动
自包含部署：单 Docker 容器 + SQLite 数据库，无外部依赖
多语言支持：英语、德语、西班牙语、法语、意大利语和葡萄牙语
响应式 UI：支持桌面和移动端，暗色和亮色主题

应用场景

家庭宠物管理：为家中宠物建立完整的健康档案和日常记录
多宠物家庭：同时管理多只宠物的健康和活动
宠物寄养：护理人员可以记录宠物日常情况
兽医记录：保存就诊历史和疫苗接种记录
轮班看护：家庭成员轮流照顾宠物时共享信息

EinVault 是一个功能全面的宠物健康和护理管理工具，适合有宠物且希望本地管理宠物数据的用户。

安装

在群晖上以 Docker 方式安装。

该镜像托管在 ghcr.io，群晖 Docker 套件无法直接搜索，需要通过命令行部署

docker cli 安装

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

# 新建文件夹 einvault 和 子目录
mkdir -p /volume1/docker/einvault/data

# 进入 einvault 目录
cd /volume1/docker/einvault

# 修改目录权限
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

关于环境变量的说明

可变	值	说明
`ORIGIN`	`http://群晖IP:端口`	必填，公共访问地址，用于 `CSRF` 保护
`TZ`	`Asia/Shanghai`	时区设置，确保日期和时间正确显示
`NODE_ENV`	`production`	生产环境模式
`DATABASE_URL`	`/data/einvault.db`	数据库路径
`BODY_SIZE_LIMIT`	`10M`	请求体大小限制
`UPLOAD_MAX_MB`	`10`	上传文件大小限制（`MB`）
`user`	`1000:1000`	容器运行的用户 `UID:GID`

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 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 登录到您的群晖，执行下面的命令：

# 新建文件夹 einvault 和 子目录
mkdir -p /volume1/docker/einvault/data

# 进入 einvault 目录
cd /volume1/docker/einvault

# 修改目录权限
chmod a+rw data

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d