dogmatic69/glass-isc-dhcp

Glass Docker镜像文档

镜像概述和主要用途

Glass是一个独立的Node.js应用程序，提供Web界面用于管理ISC DHCP服务器。本Docker镜像为Glass的容器化版本，不包含DHCP服务本身，专注于提供DHCP服务器的监控、配置管理、日志分析和告警功能。适用于需要集中管理和监控ISC DHCP服务器的网络管理员，支持实时数据统计、配置编辑与快照、日志流查看及API数据访问。

核心功能和特性

主要功能

• 实时监控仪表盘：展示DHCP服务器关键指标，包括每秒/每分钟租约数、活跃租约总数、CPU利用率、网络利用率等
• DHCP配置编辑：基于Ace编辑器的Web配置界面，支持语法检查和配置快照
• 配置快照管理：自动保存配置修改历史，支持快速回滚
• 服务器控制：通过Web界面执行DHCP服务器的启动、停止和重启操作
• 统计分析：提供共享网络利用率、子网利用率、厂商MAC分布等统计数据
• 日志流实时查看：通过WebSockets实时流式传输DHCP日志，支持实时过滤和MAC厂商解析
• REST API：提供丰富的API接口，支持第三方系统集成

告警功能

• 子网利用率告警：可自定义警告（默认80%）和严重（默认95%）阈值
• 租约活动告警：监控每分钟租约数，检测异常活动（默认阈值50）
• 多渠道告警：支持通过邮件、Slack和SMS发送告警通知（0值可禁用告警）

其他特性

• 完整OUI数据库：包含MAC地址厂商映射，支持实时更新
• 移动设备支持：响应式设计，适配移动设备访问
• 管理员认证：对管理操作（重启/配置修改/设置）强制执行身份验证
• 安全访问控制：支持IP访问限制

使用场景和适用范围

• 企业DHCP服务器管理：集中监控和管理ISC DHCP服务器集群
• 网络故障排查：通过实时日志流和租约数据快速定位网络问题
• 容量规划：基于子网利用率统计进行IP地址资源规划
• 第三方系统集成：通过API将DHCP数据集成到监控系统（如Grafana）或网络管理平台
• 自动化运维：利用API实现DHCP配置的自动化管理和监控

使用方法和配置说明

Docker部署示例

基本运行命令

bash
docker run -d \
  --name glass \
  -p 3000:3000 \
  -v /path/to/glass_config.json:/opt/glass-isc-dhcp/config/glass_config.json \
  -v /var/lib/dhcp/dhcpd.leases:/var/lib/dhcp/dhcpd.leases \
  -v /var/log/dhcp.log:/var/log/dhcp.log \
  -v /etc/dhcp/dhcpd.conf:/etc/dhcp/dhcpd.conf \
  docker.xuanyuan.run/glass-isc-dhcp

Docker Compose配置

yaml
version: '3'
services:
  glass:
    image: docker.xuanyuan.run/glass-isc-dhcp
    container_name: glass
    ports:
      - "3000:3000"
    volumes:
      - ./glass_config.json:/opt/glass-isc-dhcp/config/glass_config.json
      - /var/lib/dhcp/dhcpd.leases:/var/lib/dhcp/dhcpd.leases
      - /var/log/dhcp.log:/var/log/dhcp.log
      - /etc/dhcp/dhcpd.conf:/etc/dhcp/dhcpd.conf
    restart: always

配置说明

配置文件（glass_config.json）

配置文件需通过卷挂载到容器内，主要配置项包括：

json
{
  "admin_user": "glassadmin",          // 管理员用户名
  "admin_password": "glassadmin",      // 管理员密码
  "leases_file": "/var/lib/dhcp/dhcpd.leases",  // DHCP租约文件路径
  "log_file": "/var/log/dhcp.log",     // DHCP日志文件路径
  "config_file": "/etc/dhcp/dhcpd.conf",  // DHCP配置文件路径
  "shared_network_critical_threshold": "95",  // 子网严重告警阈值
  "shared_network_warning_threshold": "80",   // 子网警告告警阈值
  "slack_webhook_url": "",             // Slack告警Webhook URL
  "slack_alert_channel": "",           // Slack告警频道
  "leases_per_minute_threshold": "50", // 每分钟租约数告警阈值
  "ip_ranges_to_allow": ["192.168.1.0/24"],  // 允许访问的IP范围
  "email_alert_to": "",                // 邮件告警接收地址
  "sms_alert_to": ""                   // SMS告警接收号码
}

访问Glass

启动容器后，通过浏览器访问 http://<服务器IP>:3000，使用配置文件中的管理员账号密码登录。

Glass API

使用场景

• 集成到第三方监控系统（如Grafana）
• 批量查询多个DHCP服务器的租约信息
• 自动化IP地址管理和分配
• 网络设备追踪和资产盘点

示例API调用

GET: /api/get_active_leases

获取活跃租约列表，支持搜索参数：

GET /api/get_active_leases?search=Cisco

响应示例（部分）：

json
{
  "64.90.X.X": {
    "start": 1507177832,
    "end": 1507181432,
    "mac": "14:91:82:6e:77:0a",
    "mac_oui_vendor": "Belkin International Inc.",
    "options": {
      "ClientMac": "14:91:82:6e:77:a",
      "ClientIP": "64.90.X.X",
      "vendor-class-identifier": "udhcp 1.19.4"
    },
    "host": "Vargo"
  }
}

GET: /api/get_subnet_details

获取子网详细信息：

GET /api/get_subnet_details

响应示例（部分）：

json
{
  "subnets": [
    {
      "location": "69.168.x.x/26",
      "range": "69.168.x.x - 69.168.x.x",
      "defined": 55,
      "used": 0,
      "touched": 0,
      "free": 55
    }
  ]
}

GET: /api/get_server_info

获取服务器状态信息：

GET /api/get_server_info

响应示例：

json
{
  "cpu_utilization": 3.1,
  "leases_per_second": 4,
  "leases_per_minute": 310,
  "host_name": "DHCP-Server"
}

其他API端点

• /api/get_mac_oui_list：获取MAC OUI厂商列表
• /api/get_vendor_count：获取厂商设备数量统计
• /api/get_mac_oui_count_by_vendor：获取按厂商分组的MAC前缀统计
• /api/get_dhcp_requests：获取DHCP请求统计