intel/oact-rpc-go

Open AMT Cloud Toolkit - Remote Provisioning Client Go (RPC) 镜像文档

镜像概述和主要用途

Remote Provisioning Client (RPC) 是 Open AMT Cloud Toolkit 的核心组件之一，是一款用于启用 Intel® AMT (Active Management Technology) 远程管理功能的客户端应用。其主要用途是通过与 Remote Provisioning Server (RPS) 通信，实现对搭载 Intel® AMT 技术的边缘设备的远程激活、配置及连接管理，支持设备在分布式环境下的集中化远程管控。

核心功能和特性

• Intel® AMT 远程激活：支持通过网络远程激活设备的 Intel® AMT 功能，无需本地操作。
• 设备配置管理：可远程配置 Intel® AMT 设备参数，包括网络设置、认证方式、电源管理策略等。
• RPS 通信交互：与 Remote Provisioning Server (RPS) 建立安全连接，接收激活指令并上报设备状态。
• 边缘设备连接：实现边缘设备与管理平台的稳定连接，支持设备注册、状态同步及远程控制触发。

使用场景和适用范围

典型使用场景

• 企业 IT 远程设备管理：对分布在不同地理位置的办公设备（如台式机、工作站）进行远程激活和配置，降低现场运维成本。
• 边缘计算设备部署：在工业物联网、智能零售等场景中，对边缘节点设备进行批量远程激活和初始化配置。
• 分布式设备网络管控：在跨区域设备网络中，通过集中化平台（搭配 RPS）实现设备状态监控和远程操作。

适用范围

• 硬件要求：搭载 Intel® AMT 技术的 x86 架构设备（需支持 vPro 或 AMT 功能）。
• 软件环境：需配合 Open AMT Cloud Toolkit 的 RPS 服务使用，支持 Docker 容器化部署环境。

详细使用方法和配置说明

前置条件

• 已部署并运行 Open AMT Cloud Toolkit 的 Remote Provisioning Server (RPS)，获取 RPS 服务地址及认证信息。
• 目标设备已启用 Intel® AMT 功能（需在 BIOS 中配置 AMT 支持）。
• 运行环境需支持 Docker 或 Docker Compose。

Docker 快速运行

通过 docker run 命令直接启动 RPC 容器，需配置必要的环境变量以连接 RPS 并指定设备信息：

bash
docker run -d \
  --name rpc-client \
  -e RPS_URL="https://rps.example.com:8080" \  # RPS 服务地址（需替换为实际地址）
  -e RPS_USERNAME="admin" \                     # RPS 认证用户名
  -e RPS_PASSWORD="secure-password" \           # RPS 认证密码
  -e AMT_PASSWORD="amt-device-password" \       # 设备 AMT 密码（BIOS 中配置的 AMT 密码）
  -e DEVICE_UUID="123e4567-e89b-12d3-a456-426614174000" \  # 设备唯一标识符（可选，自动生成或手动指定）
  --restart unless-stopped \
  openamt/rpc-go:latest

Docker Compose 配置

通过 docker-compose.yml 配置文件管理 RPC 容器，适用于需要持久化配置或与其他服务（如 RPS、数据库）协同部署的场景：

yaml
version: '3.8'

services:
  rpc-client:
    image: openamt/rpc-go:latest
    container_name: rpc-client
    restart: unless-stopped
    environment:
      - RPS_URL="https://rps.example.com:8080"          # RPS 服务地址
      - RPS_USERNAME="admin"                            # RPS 认证用户名
      - RPS_PASSWORD="secure-password"                  # RPS 认证密码
      - AMT_PASSWORD="amt-device-password"              # 设备 AMT 密码
      - DEVICE_UUID="123e4567-e89b-12d3-a456-426614174000"  # 设备 UUID
      - LOG_LEVEL="info"                                # 日志级别（debug/info/warn/error）
      - RETRY_INTERVAL=30                               # 连接 RPS 失败后的重试间隔（秒）
    network_mode: "host"  # 可选，部分网络环境下需使用 host 网络确保 AMT 通信正常

启动命令：

bash
docker-compose up -d

配置参数说明（环境变量）

参考文档

如需更详细的 RPC 功能说明、配置选项或 Open AMT Cloud Toolkit 其他组件信息，请参见官方文档：
https://open-amt-cloud-toolkit.github.io/docs/