awinterstein/habitica-client

Habitica自托管Web组件

镜像概述

本容器用于自托管Habitica实例，包含Web组件（客户端）。使用时需配合https://hub.docker.com/repository/docker/awinterstein/habitica-server/%E5%8F%8AMongoDB%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

源代码

自托管相关适配及Docker容器声明托管于https://github.com/awinterstein/habitica%E3%80%82%E5%BB%BA%E8%AE%AE%E6%9F%A5%E7%9C%8B%E8%AF%A5%E4%BB%93%E5%BA%93%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E6%96%87%E6%A1%A3%E5%8F%8A%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E4%BF%A1%E6%81%AF%E3%80%82

Docker Compose配置示例

以下是完整的Docker Compose部署配置，包含服务器、客户端及MongoDB组件：

yaml
version: "3"
services:
  server:
    image: docker.io/awinterstein/habitica-server:latest
    restart: unless-stopped
    depends_on:
      - mongo
    environment:
      - NODE_DB_URI=mongodb://mongo/habitica  # 仅在使用独立数据库时需修改
      - BASE_URL=http://127.0.0.1:3000       # 修改为实例可访问的URL
      - INVITE_ONLY=false                    # 初始用户注册后可改为`true`以限制后续注册
      - EMAIL_SERVER_URL=mail.example.com    # 邮件服务器地址
      - EMAIL_SERVER_PORT=587                # 邮件服务器端口
      - EMAIL_SERVER_AUTH_USER=mail_user     # 邮件服务器认证用户名
      - EMAIL_SERVER_AUTH_PASSWORD=mail_password  # 邮件服务器认证密码
    ports:
      - "3000:3000"
    networks:
      - habitica
  client:
    image: docker.io/awinterstein/habitica-client:latest
    restart: unless-stopped
    depends_on:
      - server
    networks:
      - habitica
    ports:
      - "8080:80"
  mongo:
    image: docker.io/mongo:5.0
    restart: unless-stopped
    hostname: mongo
    command: ["--replSet", "rs", "--bind_ip_all", "--port", "27017"]
    healthcheck:
      test: echo "try { rs.status() } catch (err) { rs.initiate() }" | mongosh --port 27017 --quiet
      interval: 10s
      timeout: 30s
      start_period: 0s
      start_interval: 1s
      retries: 30
    volumes:
      - ./db:/data/db:rw
      - ./dbconf:/data/configdb
    networks:
      habitica:
        aliases:
          - mongo
networks:
  habitica:
    driver: bridge

配置说明

核心组件说明

• client: 本镜像，提供Habitica Web界面，依赖server组件
• server: Habitica服务器组件，处理业务逻辑，依赖MongoDB
• mongo: MongoDB数据库，存储Habitica数据

关键环境变量

访问方式

部署后，Habitica可通过http://localhost:8080访问（客户端端口映射为8080:80）。

使用场景

适用于需要私有部署Habitica、控制数据隐私的场景，如个人自托管、团队内部使用等。通过INVITE_ONLY参数可限制注册，确保实例访问可控。