portainer/pri-fidoiot

FIDO Device Onboard (FDO) 规范 Docker 镜像

镜像概述和主要用途

本Docker镜像基于FIDO Device Onboard (FDO) 规范构建，提供符合FDO标准的设备安全注册与管理环境。FDO是由FIDO联盟制定的设备身份验证与注册标准，旨在简化物联网（IoT）及边缘设备的安全注册流程，确保设备从生产到部署全生命周期的身份可信。该镜像封装了FDO协议栈核心组件，支持设备身份生成、安全凭证交换、远程配置部署等功能，适用于快速部署FDO兼容的设备注册服务。

核心功能和特性

• 符合FDO规范：严格遵循FIDO Device Onboard v1.1及以上标准，支持FDO协议定义的注册流程（如设备初始化、所有者委托、凭证激活等）。
• 容器化部署：通过Docker容器化设计，简化依赖管理，支持跨平台快速部署（Linux、Windows、macOS）。
• 安全注册流程：内置FDO安全注册协议实现，支持基于公钥加密的设备身份验证，防止设备伪造与中间人***。
• 设备身份管理：提供设备身份凭证生成、存储与验证功能，支持设备生命周期内的身份状态追踪。
• 灵活配置：支持通过环境变量或配置文件自定义FDO服务参数（如服务器地址、证书路径、超时设置等）。
• 轻量级架构：基于Alpine Linux构建，镜像体积小，资源占用低，适合边缘计算与嵌入式环境部署。

使用场景和适用范围

适用场景

• 物联网（IoT）设备制造商：为智能家电、工业传感器等设备提供出厂前安全注册环境。
• 企业IT基础设施：在企业内网中部署FDO服务，实现办公设备（如打印机、终端）的自动化安全注册。
• 边缘计算环境：在边缘节点部署FDO组件，支持边缘设备的远程安全配置与身份验证。
• 设备管理平台：作为设备管理系统的核心组件，提供标准化的设备注册接口。

适用范围

• 需符合FDO规范的设备注册场景
• 对设备身份安全要求高的行业（如***、***、工业控制）
• 物联网、边缘计算、嵌入式系统等设备密集型环境

详细使用方法和配置说明

1. 获取镜像

从Docker Hub或私有仓库拉取镜像：

bash
docker pull docker.xuanyuan.run/fido/fdo-image:latest

2. 基本运行命令

2.1 以默认配置启动FDO服务容器

bash
docker run -d \
  --name fdo-service \
  -p 8080:8080 \  # FDO服务端口
  -p 4433:4433 \  # 安全通信端口（TLS）
  fido/fdo-image:latest

2.2 自定义配置启动（通过环境变量）

bash
docker run -d \
  --name fdo-service \
  -p 8080:8080 \
  -p 4433:4433 \
  -e FDO_MODE="server" \  # 运行模式：server（服务端）/client（客户端）
  -e FDO_SERVER_URL="https://fdo.example.com:4433" \  # FDO服务器地址
  -e LOG_LEVEL="info" \  # 日志级别：debug/info/warn/error
  -v /host/certs:/app/certs \  # 挂载本地证书目录
  fido/fdo-image:latest

3. Docker Compose 部署示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  fdo-service:
    image: docker.xuanyuan.run/fido/fdo-image:latest
    container_name: fdo-service
    ports:
      - "8080:8080"
      - "4433:4433"
    environment:
      - FDO_MODE=server
      - FDO_SERVER_URL=https://fdo.example.com:4433
      - LOG_LEVEL=info
      - CERTIFICATE_PATH=/app/certs/server.crt
      - PRIVATE_KEY_PATH=/app/certs/server.key
    volumes:
      - ./certs:/app/certs  # 本地证书目录挂载
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

4. 核心配置参数说明

注意事项

• 证书管理：生产环境中需使用可信CA签发的TLS证书，避免使用自签名证书（仅测试环境可用）。
• 数据持久化：设备注册记录等关键数据需通过Docker Volume挂载至宿主机，防止容器重启后数据丢失。
• 网络安全：建议限制容器端口访问范围，仅允许授权设备或服务访问FDO端口（如4433）。
• 版本兼容性：使用前需确认镜像版本与目标FDO规范版本匹配（如v1.1镜像仅支持FDO v1.1协议）。