zebpalmer/socket-mqtt

Socket转MQTT镜像

Docker化脚本，用于读取Socket端口输出的每行内容并转发至指定MQTT主题，专注于简洁高效的数据转发需求。

镜像概述

本镜像解决了将Socket数据转发至MQTT broker的场景需求，可部署于Docker、Docker Swarm、Kubernetes等环境。初始用于将dump1090的原始ADS-B数据发送至远程MQTT broker，功能简洁无冗余，错误场景下优先让容器退出，由编排工具重建实例。

核心功能

• 读取指定Socket主机和端口的每行文本输出
• 将数据转发至指定MQTT主题
• 全部配置通过环境变量实现
• 轻量无多余依赖，适配主流容器编排系统

使用场景

• ADS-B数据（如dump1090输出）转发至MQTT系统
• 其他基于Socket输出的文本数据转发至MQTT主题的场景
• 需要容器化数据转发工具的微服务架构

配置说明

所有配置通过环境变量传递：

必选参数

• SOCKET_HOST: Socket服务的主机地址
• SOCKET_PORT: Socket服务的端口
• MQTT_HOST: MQTT broker的主机地址
• MQTT_PORT: MQTT broker的端口
• MQTT_TOPIC: 数据转发的目标MQTT主题

可选参数

• MQTT_CLIENT_ID: MQTT客户端ID（默认：随机UUID）
• MQTT_TLS: 是否启用TLS加密（默认：False，启用时验证SSL证书）
• LOG_LEVEL: 日志级别（默认：INFO）

部署示例

Docker运行命令

bash
docker run -e SOCKET_HOST=piaware -e SOCKET_PORT="30003" -e MQTT_HOST="mqtt.example.com" -e MQTT_PORT="88883" -e MQTT_TOPIC="ADSB/adsb" -e MQTT_CLIENT_ID="adsb-consumer" -e MQTT_TLS="True" zebpalmer/socket-mqtt

Kubernetes配置示例

ConfigMap

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: adsb-to-mqtt
  namespace: default
data:
  SOCKET_HOST: "dump1090"
  SOCKET_PORT: "30003"
  MQTT_HOST: "mqtt.example.com"
  MQTT_PORT: "8883"
  MQTT_TOPIC: "ADSB/adsb"
  MQTT_CLIENT_ID: "adsb-to-mqtt"
  MQTT_TLS: "True"
  LOG_LEVEL: "INFO"

Deployment

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: adsb-to-mqtt
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: adsb-to-mqtt
  strategy:
    type: Recreate
  template:
    metadata:
      labels:
        app: adsb-to-mqtt
    spec:
      containers:
      - name: adsb-to-mqtt
        image: zebpalmer/socket-mqtt:latest
        imagePullPolicy: Always
        envFrom:
          - configMapRef:
              name: adsb-to-mqtt
      restartPolicy: Always