portainer/fido-client

FDO设备初始化与所有权转移准备镜像

镜像概述

本Docker镜像专为设备初始化及基于FDO（Device Ownership Transfer，设备所有权转移）协议的所有权交接准备流程设计。它提供标准化的设备初始化流程，支持FDO协议规范，能够自动完成设备所有权转移前的必要配置与凭证生成，简化物联网及企业设备的所有权管理流程。

核心功能特性

• 设备初始化自动化：集成设备基础配置、硬件信息采集、网络参数初始化等流程，减少手动操作
• FDO协议标准支持：兼容FDO（Device Ownership Transfer）协议规范，实现与FDO服务器的标准化交互
• 所有权转移准备：自动生成所有权转移所需凭证（如设备凭证、所有者信息），完成预注册流程
• 灵活配置：支持通过环境变量自定义FDO服务器地址、设备标识、超时参数等关键配置

使用场景

• 物联网设备批量部署：在工厂或仓库环境中，对新出厂物联网设备进行初始化并准备所有权转移至客户
• 企业设备管理：企业内部设备在部门间转移时，快速完成所有权变更前的初始化配置
• 设备生命周期管理：设备维修、二次销售或回收前，标准化执行所有权交接准备流程

使用方法

前提条件

• 已部署FDO服务器（如Eclipse FDO服务器）并获取服务器URL
• 设备需具备网络连接能力，且Docker环境已安装

基础运行命令

bash
docker run -d \
  --name fdo-device-initializer \
  -e FDO_SERVER_URL="https://fdo-server.example.com:8080" \
  -e DEVICE_ID="iot-device-001" \
  -e OWNER_INFO='{"owner_id":"company-x","contact":"admin@company-x.com"}' \
  -e TIMEOUT=300 \
  fdo-device-initializer:latest

环境变量配置

数据持久化（可选）

如需保留初始化生成的凭证文件，可挂载本地目录至容器内/fdo-data路径：

bash
docker run -d \
  --name fdo-device-initializer \
  -e FDO_SERVER_URL="https://fdo-server.example.com:8080" \
  -e DEVICE_ID="iot-device-001" \
  -v /local/fdo-data:/fdo-data \
  fdo-device-initializer:latest

容器会将生成的所有权凭证文件存储至/fdo-data/credentials.json路径

运行流程说明

1. 容器启动后，首先验证环境变量配置及网络连接
2. 连接FDO服务器，完成设备预注册并获取初始化参数
3. 执行设备硬件信息采集、网络配置初始化
4. 生成所有权转移凭证并存储（本地挂载时保存至宿主机）
5. 输出初始化结果日志（成功/失败原因），成功时返回凭证文件路径

状态查看

通过容器日志查看初始化进度及结果：

bash
docker logs fdo-device-initializer