corelight/fleet

Fleet 镜像技术文档

1. 镜像概述与主要用途

Fleet 是一款基于 Docker 镜像的集中式管理平台，专为 Corelight Sensors 设备设计。其核心功能是提供对多台 Corelight Sensors 的统一管理、配置与更新能力，旨在简化分布式传感器集群的运维流程，提升设备管理效率、配置一致性及安全合规性。

2. 核心功能与特性

2.1 集中式设备管理

• 自动发现与注册网络中的 Corelight Sensors，支持批量添加设备
• 实时监控设备在线状态、资源使用率（CPU/内存/存储）及运行健康度
• 提供设备分组管理，支持按区域、功能或业务线分类

2.2 配置管理

• 统一配置下发：支持向单台或多台传感器批量推送配置（如流量采集规则、过滤策略）
• 配置模板化：内置常用场景模板，支持自定义模板创建与版本控制
• 配置审计：记录配置变更历史，支持回溯与对比

2.3 固件更新

• 批量固件升级：支持跨设备固件版本统一更新，降低人工操作成本
• 进度监控与回滚：实时展示更新进度，支持异常情况下的一键回滚
• 灰度发布：支持按比例或分组逐步推送更新，降低全量更新风险

2.4 日志与告警

• 集中日志收集：聚合传感器生成的运行日志、流量日志及异常事件
• 智能告警：基于设备状态、配置变更或性能阈值触发告警（支持邮件、Slack 等渠道）
• 审计跟踪：记录管理员操作日志，满足合规审计需求

2.5 开放集成能力

• 提供 RESTful API：支持与 SIEM、SOAR 等安全运维平台集成
• 兼容 Corelight 生态：无缝对接 Corelight 传感器数据采集与分析能力

3. 使用场景与适用范围

3.1 典型使用场景

• 企业级多传感器管理：跨区域部署的 Corelight Sensors（如分支机构、远程办公点）需统一监控与配置
• 安全运营中心（SOC）：通过集中管理确保传感器持续稳定运行，保障流量数据采集的完整性（用于威胁检测与溯源）
• 数据中心网络监控：在数据中心环境中管理多台传感器，优化网络流量可见性与异常流量识别

3.2 适用范围

• 组织规模：拥有 2 台及以上 Corelight Sensors 的企业或机构
• 用户角色：网络运维工程师、安全运营人员、数据中心管理员
• 部署环境：物理服务器、虚拟机或容器化平台（如 Kubernetes）

4. 使用方法与配置说明

4.1 前置依赖

• Docker 版本 ≥ 20.10.x
• Docker Compose 版本 ≥ 2.10.x（如需容器编排）
• 网络要求：Fleet 需与 Corelight Sensors 网络互通，且开放 8080 端口（Web 管理界面）及 443 端口（HTTPS 通信）

4.2 Docker Run 快速部署

通过以下命令启动 Fleet 单容器实例（需提前准备 PostgreSQL 数据库，用于存储设备数据与配置）：

bash
docker run -d \
  --name fleet \
  --restart unless-stopped \
  -p 8080:8080 \  # Web 管理界面端口
  -p 443:443 \    # 传感器通信端口
  -v /path/to/fleet/data:/var/lib/fleet \  # 持久化存储配置与设备数据
  -e DB_HOST=your-postgres-host \         # PostgreSQL 数据库主机地址
  -e DB_PORT=5432 \                       # PostgreSQL 端口（默认5432）
  -e DB_USER=fleet_admin \                # 数据库用户名
  -e DB_PASSWORD=your-secure-password \   # 数据库密码
  -e DB_NAME=fleet \                      # 数据库名称（默认fleet）
  -e ADMIN_USER=admin \                   # 初始管理员用户名
  -e ADMIN_PASSWORD=admin-password \      # 初始管理员密码
  corelight/fleet:latest

注意：替换 /path/to/fleet/data 为本地实际目录，your-postgres-host 等参数需根据实际数据库环境调整。

4.3 Docker Compose 编排部署

如需简化依赖管理（如集成 PostgreSQL），可使用 docker-compose.yml 一键部署：

yaml
version: '3.8'

services:
  fleet:
    image: corelight/fleet:latest
    container_name: fleet
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "443:443"
    volumes:
      - fleet_data:/var/lib/fleet
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=fleet_admin
      - DB_PASSWORD=secure-db-pass  # 建议使用环境变量文件或密钥管理工具
      - DB_NAME=fleet
      - ADMIN_USER=admin
      - ADMIN_PASSWORD=secure-admin-pass
    depends_on:
      - postgres
    networks:
      - fleet-network

  postgres:
    image: postgres:14-alpine
    container_name: fleet-postgres
    restart: unless-stopped
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=fleet_admin
      - POSTGRES_PASSWORD=secure-db-pass
      - POSTGRES_DB=fleet
    networks:
      - fleet-network

volumes:
  fleet_data:
  postgres_data:

networks:
  fleet-network:
    driver: bridge

部署命令：

bash
docker-compose up -d

4.4 环境变量说明

4.5 持久化存储配置

Fleet 需持久化存储以下数据，建议通过 Docker 数据卷挂载实现：

• 设备配置与状态数据：挂载路径 /var/lib/fleet，存储传感器列表、配置模板、更新记录等
• 数据库数据：若使用外部 PostgreSQL，需确保数据库自身数据持久化（如示例中 postgres_data 卷）

5. 访问与验证

部署完成后，通过以下步骤验证服务可用性：

1. 访问 Web 管理界面：http://<主机IP>:8080（若启用 TLS 则为 https://<主机IP>:443）
2. 使用 ADMIN_USER 和 ADMIN_PASSWORD 登录
3. 导航至「设备管理」页面，点击「添加设备」，输入 Corelight Sensors 的 IP 与认证信息，验证设备是否可正常接入
4. 检查「系统状态」页面，确认服务、数据库连接及资源使用率正常

注：首次登录后建议立即修改管理员密码，并配置防火墙策略限制 Web 界面访问来源，提升安全性。