dijkstrasolutions/stork-server

ISC Stork Server镜像说明

镜像概述

本镜像为ISC Stork Server的容器化版本，需搭配已部署的Postgres数据库使用，用于监控和管理ISC Kea DHCP4服务，支持通过Stork Agent收集DHCP服务运行数据，提供REST API接口进行服务交互。

核心功能

1. 实时监控Kea DHCP4服务的运行状态
2. 通过Stork Agent采集DHCP服务的配置与统计数据
3. 提供REST API接口（默认端口80）用于服务管理与数据查询
4. 支持自定义数据库连接参数与服务端口配置

使用场景

1. 企业或机构内部DHCP服务的集中监控与管理
2. 网络运维中对Kea DHCP4服务的状态跟踪与故障排查
3. 基于Kea DHCP4的网络环境部署与自动化运维

配置说明

需通过环境变量配置Postgres数据库连接信息：

• STORK_DATABASE_HOST：数据库主机地址
• STORK_DATABASE_PORT：数据库端口（默认5432）
• STORK_DATABASE_NAME：数据库名称（默认stork）
• STORK_DATABASE_USER_NAME：数据库用户名
• STORK_DATABASE_PASSWORD：数据库密码
• STORK_REST_PORT：REST服务端口（默认80）

部署示例

完整部署Compose文件（compose.all.yml）

yaml
services:
  # DHCP/Agents主机
  kea-dhcp4:
    image: docker.xuanyuan.run/dijkstrasolutions/kea-dhcp4:${KEA_DHCP4_TAG:-latest}
    container_name: kea-dhcp
    profiles: ["dhcp-node"]
    network_mode: host
    cap_add: [ NET_ADMIN ]
    volumes:
      - /opt/kea/config:/kea/etc/kea
      - /opt/kea/logs:/var/log
      - kea-run:/var/run/kea
    command: ["/usr/sbin/kea-dhcp4", "-c", "/kea/etc/kea/kea-dhcp4.conf"]
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "pgrep", "-f", "kea-dhcp4"]
      interval: 10s
      timeout:5s
      retries:5
      start_period:5s

  kea-ctrl-stork:
    image: docker.xuanyuan.run/dijkstrasolutions/kea-ctrl-stork-agents:${KEA_AGENTS_TAG:-latest}
    container_name: kea-ctrl-stork
    profiles: ["dhcp-node"]
    environment:
      ENABLE_CTRL_AGENT: "true"
      ENABLE_STORK_AGENT: "true"
    volumes:
      - /opt/kea/config:/kea/etc/kea:ro
      - /opt/kea/logs:/var/log/kea
      - /opt/stork:/etc/stork
      - /opt/stork/server-agent/hooks:/usr/lib/stork-agent/hooks
      - /opt/stork/logs:/var/log/stork-agent
      - /opt/stork/agent:/var/lib/stork-agent
      - kea-run:/var/run/kea
    ports:
      - "8000:8000"
      - "8081:8081"
    restart: unless-stopped
    depends_on:
      - kea-dhcp4
    healthcheck:
      test: ["CMD", "pgrep", "-f", "stork-agent"]
      interval:10s
      timeout:5s
      retries:5
      start_period:5s

  # Stork Server主机
  stork-server:
    image: docker.xuanyuan.run/dijkstrasolutions/stork-server:${STORK_SERVER_TAG:-latest}
    container_name: stork-server
    profiles: ["stork-server"]
    environment:
      STORK_DATABASE_HOST: ${STORK_DB_HOST}
      STORK_DATABASE_PORT: ${STORK_DB_PORT:-5432}
      STORK_DATABASE_NAME: ${STORK_DB_NAME:-stork}
      STORK_DATABASE_USER_NAME: ${STORK_DB_USER}
      STORK_DATABASE_PASSWORD: ${STORK_DB_PASSWORD}
      STORK_REST_PORT:80
    volumes:
      - /opt/stork/server/hooks:/usr/lib/stork-server/hooks
      - /opt/stork:/etc/stork
    ports:
      - "80:80"
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost"]
      interval:10s
      timeout:5s
      retries:5
      start_period:5s

volumes:
  kea-run:

环境变量配置文件（kea.env）

bash
cat > kea.env <<'EOF'
# 镜像标签
KEA_DHCP4_TAG=latest
KEA_AGENTS_TAG=latest
STORK_SERVER_TAG=2.2.1

# Stork数据库配置（用于Stork Server主机）
STORK_DB_HOST=192.168.100.230
STORK_DB_PORT=5432
STORK_DB_NAME=stork
STORK_DB_USER=kea
STORK_DB_PASSWORD=change_me
EOF

启动命令

启动DHCP节点服务：

bash
COMPOSE_PROFILES=dhcp-node docker compose -f compose.all.yml --env-file kea.env up -d

启动Stork Server服务：

bash
COMPOSE_PROFILES=stork-server docker compose -f compose.all.yml --env-file kea.env up -d

注意事项

• 需提前部署Postgres数据库，并初始化Stork所需的数据库（参考ISC官方文档）。
• 镜像默认将REST服务端口改为80（而非默认的8080）。