simeononsecurity/chirpstack-packet-multiplexer

ChirpStack Packet Multiplexer

镜像概述

ChirpStack Packet Multiplexer是ChirpStack生态的核心组件之一，专注于转发Semtech packet-forwarder发送的UDP数据到多个后端端点，解决单个LoRa网关无法同时连接多个网络的痛点，助力LoRa网络的灵活扩展与数据共享。

核心功能

• 多后端转发：将网关数据同步发送至多个指定的网络平台或服务
• 网关ID过滤：仅转发特定网关ID的数据流，满足精细化管理需求
• 上下行控制：支持配置后端是否仅接收上行数据（不处理下行回传）
• 日志分级：可根据需求设置不同的日志级别，便于调试与监控

使用场景

• 多平台同步：单个LoRa网关同时向ChirpStack、第三方LoRa平台发送数据
• 环境并行测试：网关数据同时流向测试环境与生产环境，加速功能验证
• 团队协作共享：不同业务团队共享同一网关数据，支持各自的分析与应用开发

配置说明

配置模板示例

执行chirpstack-packet-multiplexer configfile可生成默认配置模板，关键配置项如下：

toml
[general]
# 日志级别：debug=5, info=4, warning=3, error=2, fatal=1, panic=0
log_level=4

[packet_multiplexer]
# 绑定端口：接收packet-forwarder数据的接口与端口
bind="0.0.0.0:1700"

# 后端列表配置
[[packet_multiplexer.backend]]
# 后端地址（格式：主机IP:端口）
host="192.168.0.10:1700"
# 是否仅接收上行数据（关闭下行回传）
uplink_only=false
# 需要转发的网关ID集合
gateway_ids = [
  "0101010101010101",
  "0202020202020202"
]

Docker部署示例

Docker Run快速启动

bash
docker run -d \
  --name chirpstack-multiplexer \
  -p 1700:1700/udp \
  -v ./config/chirpstack-packet-multiplexer.toml:/etc/chirpstack-packet-multiplexer/chirpstack-packet-multiplexer.toml:ro \
  docker.xuanyuan.run/simeononsecurity/chirpstack-packet-multiplexer

Docker Compose配置

yaml
version: "3"
services:
  chirpstack-packet-multiplexer:
    image: docker.xuanyuan.run/simeononsecurity/chirpstack-packet-multiplexer
    container_name: chirpstack-multiplexer
    ports:
      - "1700:1700/udp"
    volumes:
      - ./config:/etc/chirpstack-packet-multiplexer:ro
    restart: unless-stopped

将自定义配置文件放入./config目录后，执行docker-compose up -d启动服务。