fleetdm/fleet

Fleet Docker镜像文档

1. 镜像概述和主要用途

Fleet 是一款开源设备管理工具，旨在为各类用户提供简单、高效的设备集中管理能力。其官方 Docker 镜像托管于 Docker Hub，可直接用于部署和运行 Fleet 服务。该镜像封装了 Fleet 核心功能，简化了部署流程，适用于需要快速搭建设备管理平台的场景。

主要用途：

• 集中管理多平台设备（如 macOS、Linux、Windows 等）
• 执行设备监控、策略下发与合规检查
• 集成设备 inventory 管理与软件分发

官方资源：

• 镜像地址：https://hub.docker.com/r/fleetdm/fleet
• 完整文档：Fleet 官方文档

2. 核心功能和特性

核心功能

• 开源免费：基于 MIT 许可证，源代码完全开放，支持自定义扩展。
• 多平台兼容：支持管理 macOS、Linux、Windows 等主流操作系统设备。
• 集中化管理：提供 Web 控制台，统一查看设备状态、执行操作（如远程命令、重启等）。
• 策略与合规：定义设备安全策略（如加密要求、软件版本控制），自动检查合规性。
• 轻量级部署：通过 Docker 镜像简化部署流程，降低环境依赖。

关键特性

• 设备 inventory 自动采集（硬件信息、软件列表、网络配置等）
• 支持批量设备操作与任务调度
• 集成 osquery 实现细粒度设备数据查询
• 可扩展的 API 接口，支持第三方系统集成

3. 使用场景和适用范围

适用场景

• 企业 IT 管理：管理员工办公设备，确保安全策略执行与软件标准化。
• 教育机构：管控教学设备（如实验室电脑），统一软件部署与使用规范。
• 开发团队：管理开发环境设备，确保依赖一致性与版本控制。
• 小型组织：无需复杂基础设施，通过 Docker 快速搭建轻量级设备管理平台。

适用范围

• 设备规模：支持从数十台到数千台设备的管理需求
• 技术环境：需具备 Docker 运行环境，建议搭配数据库（如 PostgreSQL）使用

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker Engine（20.10+）或 Docker Desktop
• （可选）Docker Compose（用于多容器部署）
• 后端数据库（推荐 PostgreSQL，需提前部署并创建数据库）

4.2 Docker Run 命令示例

基本运行（需提前配置数据库）

bash
docker run -d \
  --name fleet \
  -p 8080:8080 \
  -e FLEET_MYSQL_URL="mysql://user:password@mysql:3306/fleet" \  # 数据库连接URL（支持MySQL/PostgreSQL）
  -e FLEET_SERVER_ADDRESS="0.0.0.0:8080" \  # 服务监听地址与端口
  -e FLEET_LOG_LEVEL="info" \  # 日志级别（debug/info/warn/error）
  fleetdm/fleet:latest

注：FLEET_MYSQL_URL 需替换为实际数据库连接信息，支持 MySQL 或 PostgreSQL（使用 FLEET_POSTGRES_URL）。

4.3 Docker Compose 配置示例

以下为包含 Fleet 与 PostgreSQL 的完整部署示例（docker-compose.yml）：

yaml
version: '3.8'

services:
  fleet:
    image: fleetdm/fleet:latest
    container_name: fleet
    ports:
      - "8080:8080"
    environment:
      - FLEET_POSTGRES_URL=postgres://fleetuser:fleetpass@postgres:5432/fleetdb
      - FLEET_SERVER_ADDRESS=0.0.0.0:8080
      - FLEET_LOG_LEVEL=info
      - FLEET_AUTH_JWT_SECRET=your-secure-jwt-secret  # JWT 密钥，建议使用随机字符串
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    container_name: fleet-postgres
    environment:
      - POSTGRES_USER=fleetuser
      - POSTGRES_PASSWORD=fleetpass
      - POSTGRES_DB=fleetdb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

启动命令：

bash
docker-compose up -d

4.4 核心配置参数（环境变量）

完整配置参数列表请参考 Fleet 官方文档。

5. 注意事项

• 技术支持：官方不监控镜像相关评论，使用中如需帮助，请访问 Fleet 官方支持页面。
• Kubernetes 部署：如需在 Kubernetes 集群中部署，可参考 Fleet Kubernetes 部署指南。
• 数据持久化：建议使用外部数据库（而非容器内置数据库），并配置数据卷确保数据持久化。
• 安全配置：生产环境中需启用 TLS 加密，并使用强密钥（如 FLEET_AUTH_JWT_SECRET）。