manueldebway/mjc-hotspots-backend

manueldebway/mjc-hotspots-backend

描述： MJC-Hotspots管理系统的核心Node.js/Express API服务。

概述

该后端作为Web仪表板与**MikroTik RouterOS v7（用户管理器）**之间的桥梁，在PostgreSQL数据库中管理状态，并通过MikroTik二进制API确保与路由器的实时同步。

核心功能

• 双同步引擎： 原子化将用户/配置文件变更“推送”至MikroTik，定期“拉取”会话/使用数据。
• 用户管理： 处理注册、认证（CHAP/Web）及自助门户逻辑。
• 套餐与凭证系统： 管理ISP计费计划、带宽限制及自动凭证生成。
• 健康监控： 内置数据库与路由器连接的健康检查功能。

使用场景

适用于小型ISP、咖啡馆、酒店等场所的热点网络管理，实现用户认证、带宽控制、计费管理及设备状态监控。

配置说明

暴露端口 3000。

必需环境变量

yaml
NODE_ENV=production
DB_HOST=db
DB_USER=admin_user
DB_PASSWORD=strong_password_123
MIKROTIK_HOST=192.168.88.1
MIKROTIK_USER=admin
MIKROTIK_PASSWORD=password

Docker Compose示例

该服务需与PostgreSQL数据库配合运行，以下为参考compose.yaml配置：

yaml
services:
  db:
    image: docker.xuanyuan.run/postgres:16.3
    container_name: mjc_hotspot_db
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${DB_USER:-admin_user}
      POSTGRES_PASSWORD: ${DB_PASSWORD:-strong_password_123}
      POSTGRES_DB: ${DB_NAME:-my_production_db}
      TZ: ${TZ:-Africa/Nairobi}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "${DB_PORT:-5435}:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-admin_user} -d ${DB_NAME:-my_production_db}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    networks:
      - app_network

  backend:
    image: docker.xuanyuan.run/mjc-hotspot-backend:latest
    container_name: mjc_hotspot_backend
    restart: unless-stopped
    ports:
      - "3001:3000"
    env_file:
      - .env
    environment:
      - NODE_ENV=production
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=${DB_USER:-admin_user}
      - DB_PASSWORD=${DB_PASSWORD:-strong_password_123}
      - DB_NAME=${DB_NAME:-my_production_db}
      - TZ=${TZ:-Africa/Nairobi}
    depends_on:
      db:
        condition: service_healthy
    networks:
      - app_network

  frontend:
    image: docker.xuanyuan.run/mjc-hotspot-frontend:latest
    container_name: mjc_hotspot_frontend
    restart: unless-stopped
    ports:
      - "8081:80"
    environment:
      - TZ=${TZ:-Africa/Nairobi}
    depends_on:
      - backend
    networks:
      - app_network

  pgadmin:
    image: docker.xuanyuan.run/dpage/pgadmin4
    container_name: mjc_hotspot_pgadmin
    restart: always
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@admin.com
      PGADMIN_DEFAULT_PASSWORD: root
      TZ: ${TZ:-Africa/Nairobi}
    ports:
      - "5052:80"
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

volumes:
  postgres_data:

技术栈

• 基础镜像： node:20-alpine
• 数据库： PostgreSQL 16
• 集成工具： node-routeros（二进制API）