device-agent Docker 镜像下载 - 轩辕镜像

FlowFuse Device Agent镜像文档

镜像概述

FlowFuse Device Agent是用于在Docker环境中启动FlowFuse设备的容器化工具。该镜像需配合已在FlowFuse实例上注册的设备使用，通过挂载外部配置YAML文件提供设备运行参数，实现设备与FlowFuse平台的连接和管理。

核心功能与特性

• 设备启动：提供FlowFuse设备运行的基础环境，支持设备初始化与启动
• 配置挂载：支持外部YAML配置文件（device.yml）挂载，灵活注入设备配置参数
• 日志调试：可通过命令参数启用详细日志模式，便于设备运行状态监控与问题排查
• 端口映射：默认映射1880端口，保障设备网络通信能力

使用场景

适用于需要在Docker环境中部署FlowFuse设备的场景，包括但不限于：

• 边缘计算节点的设备管理
• IoT设备与FlowFuse平台的集成
• 分布式设备监控与数据采集

使用方法与配置说明

前提条件

1. 设备已通过FlowFuse实例完成注册（注册流程参见FlowFuse设备注册文档）
2. 本地已准备设备配置文件device.yml

配置文件要求

需将设备配置文件device.yml挂载至容器内固定路径：/opt/flowfuse-device/device.yml

启动参数说明

• -v：启用详细日志模式（需在启动命令中作为参数传递）

Docker部署示例

基本运行命令

bash
docker run -v /path/to/device.yml:/opt/flowfuse-device/device.yml -p 1880:1880 flowfuse/device-agent:latest

参数说明：

• -v /path/to/device.yml:/opt/flowfuse-device/device.yml：本地配置文件与容器内路径的挂载映射
• -p 1880:1880：容器1880端口与主机端口的映射，用于设备网络通信

启用详细日志运行

bash
docker run -v /path/to/device.yml:/opt/flowfuse-device/device.yml -p 1880:1880 flowfuse/device-agent:latest flowfuse-device-agent -v

说明：通过在镜像标签后追加flowfuse-device-agent -v，启动设备代理并启用详细日志输出。