intel/oact-mps

Open AMT Cloud Toolkit - Management Presence Server (MPS) 技术文档

一、镜像概述与主要用途

Management Presence Server (MPS) 是 Open AMT Cloud Toolkit 的核心组件，用于实现基于 Intel vPro® 平台设备的远程边缘管理。其核心功能是通过 Intel vPro® 平台的 Client Initiated Remote Access (CIRA) 技术，与被管理设备建立并维持持久连接，从而提供带外（Out-of-Band）管理能力，包括设备电源控制、键盘-视频-鼠标（KVM）远程控制等关键功能。作为云无关的微服务，MPS 可灵活部署于各类云环境或本地数据中心，支持大规模设备的集中化远程管理。

二、核心功能与特性

2.1 核心功能

• 远程边缘管理：支持对搭载 Intel vPro® 技术的终端设备进行全生命周期远程管理，不受设备操作系统状态限制（带外管理）。
• CIRA 持久连接：基于 Client Initiated Remote Access (CIRA) 技术，由被管理设备主动发起并维持与 MPS 的加密连接，确保网络防火墙环境下的稳定通信。
• 带外管理能力：提供设备电源控制（开机、关机、重启）、KVM 远程控制、设备硬件信息采集等核心带外管理功能。

2.2 关键特性

• 云环境无关性：采用微服务架构设计，可部署于公有云（如 AWS、Azure、GCP）、私有云或本地服务器，无特定云平台依赖。
• 持久连接维持：通过 CIRA 技术自动处理网络波动，确保设备离线后重连，保障管理链路的高可用性。
• 轻量化部署：以容器化方式交付，支持 Docker 部署，便于快速集成到现有 IT 管理系统。

三、使用场景与适用范围

3.1 典型使用场景

• 企业 IT 远程管理：适用于企业对分支机构、远程办公设备的集中化管理，降低现场运维成本。
• 远程设备监控与维护：支持无人值守设备（如零售终端、工业控制设备）的远程故障排查与配置更新。
• 数据中心设备管理：对服务器、网络设备等基础设施进行带外电源控制和 KVM 远程操作，提升机房管理效率。

3.2 适用范围

• 硬件要求：仅支持搭载 Intel vPro® 技术且启用 AMT 功能的设备（需在设备 BIOS 中配置 AMT 参数）。
• 网络环境：需确保 MPS 服务端与被管理设备之间的网络连通性，支持通过互联网或私有网络通信（依赖 CIRA 端口配置）。

四、使用方法与部署说明

4.1 Docker 快速部署（单节点）

4.1.1 前提条件

• 已安装 Docker Engine（20.10+）。
• 被管理设备已启用 Intel AMT 并配置 CIRA 策略（需提前设置 CIRA 服务器地址指向 MPS 服务 IP/域名）。

4.1.2 Docker Run 命令示例

bash
docker run -d \
  --name mps \
  -p 443:443 \  # CIRA 通信端口（默认 HTTPS）
  -p 8080:8080 \ # API 端口（可选，用于管理界面或第三方集成）
  -v /local/config:/mps/config \  # 挂载本地配置文件目录
  --restart always \
  openamt/mps:latest  # 镜像名称（以官方实际镜像为准）

4.1.3 Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  mps:
    image: openamt/mps:latest
    container_name: mps
    ports:
      - "443:443"   # CIRA 通信端口
      - "8080:8080" # API 端口
    volumes:
      - ./mps-config:/mps/config  # 本地配置文件目录映射
    environment:
      - MPS_LOG_LEVEL=info        # 日志级别（可选：debug/info/warn/error）
      - TLS_CERT_PATH=/mps/config/cert.pem  # TLS 证书路径（CIRA 通信需配置）
      - TLS_KEY_PATH=/mps/config/key.pem    # TLS 私钥路径
    restart: always

启动服务：

bash
docker-compose up -d

4.2 服务启动与验证

1. 部署完成后，通过日志确认服务启动状态：

   bash
   docker logs -f mps
   

2. 验证 CIRA 连接：被管理设备配置 CIRA 后，应在 MPS 日志中显示“CIRA connection established”等连接成功信息。

五、配置说明

5.1 核心配置项

MPS 配置通过配置文件（如 config.json）或环境变量实现，关键配置项包括：

5.2 配置文件示例

挂载的 /mps/config 目录中需包含核心配置文件（如 config.json），示例结构：

json
{
  "server": {
    "port": 443,
    "tls": {
      "cert": "/mps/config/cert.pem",
      "key": "/mps/config/key.pem"
    }
  },
  "api": {
    "port": 8080,
    "auth": {
      "jwtSecret": "your-jwt-secret-key"
    }
  },
  "device": {
    "connectionTimeout": 300  # 设备连接超时时间（秒）
  }
}

六、注意事项

• TLS 证书配置：CIRA 通信需使用有效 TLS 证书（自签名或 CA 签发），证书域名/IP 需与被管理设备配置的 CIRA 服务器地址一致。
• 性能调优：大规模设备管理场景下，需根据设备数量调整容器资源（CPU/内存）及连接池配置。
• 详细文档：关于 MPS 的初始化配置、API 接口、故障排查等详细内容，参见官方文档：https://open-amt-cloud-toolkit.github.io/docs%E3%80%82