LoRaWAN UDP Packet Forwarder Docker镜像文档

概述

本项目提供在Docker容器中部署运行UDP Packet Forwarder协议的LoRaWAN网关解决方案，可在AMD64/x86_64 PC或Raspberry Pi 3/4、Compute Module 3/4、balenaFin等单板计算机(SBC)上运行，支持SX1301、SX1302、SX1303、SX1308及基于SX1280的2.4GHz LoRa集中器。该镜像兼容The Things Stack v3(TTSv3)、Chirpstack v4等LoRa网络服务器(LNS)，已通过The Things Stack社区版(TTSCE/TTNv3)和ChirpStack v4测试。项目源码及镜像分别托管于GitHub([] Hub([]

核心功能与特性

多架构支持

• 兼容AMD64(x86_64)、ARMv8及ARMv7架构设备

广泛的集中器兼容性

• 支持SX1301、SX1302、SX1303、SX1308 LoRa集中器
• 支持基于Semtech参考设计的2.4GHz LoRa集中器(SX1280)

灵活的接口支持

• 同时支持SPI和USB接口类型的集中器

智能化配置能力

• 自动发现Corecell、Picocell及2g4类型集中器
• 支持在TTSv3和ChirpStackv4上自动完成网关配置

易用性与可配置性平衡

• 结合自动发现与自动配置功能实现近一键部署
• 提供高度自定义配置选项满足复杂场景需求

适用场景与硬件要求

适用场景

• 物联网边缘网关部署
• 工业环境LoRaWAN网络构建
• 智慧城市、农业监测等低功耗广域网应用
• 基于SBC的低成本网关解决方案

硬件要求

主机设备

支持Docker容器运行的设备：

• AMD64架构：主流PC
• ARMv8架构：Raspberry Pi 3/4/5、Raspberry Pi 400、Compute Module 3/4、Zero 2 W等
• ARMv7架构：Raspberry Pi 2等

注意：主机需安装操作系统（如Raspberry Pi需刷写Raspberry Pi OS至SD卡）

支持的RAK网关产品

• RAK7243 & RAK7243C
• RAK7244 & RAK7244C
• RAK7246 & RAK7246G
• RAK7248 & RAK7248C
• RAK7271 & RAK7371

支持的RAK LoRa集中器模块

• SX1301系列：RAK831、RAK833、RAK2245、RAK2247
• SX1302系列：RAK2287
• SX1303系列：RAK5146、RAK5166、RAK5167
• SX1308系列：RAK2287、RAK2246
• SX1280系列：RAK5148

说明：本项目主要针对RAKwireless产品优化，其他厂商符合规格的集中器需手动配置集中器类型、接口及复位GPIO等参数。MiniPCIe形态的SPI集中器需专用转接板连接至SBC的SPI接口，MiniPCIe形态的USB集中器需USB转接器连接至SBC的USB2.0/3.0接口。

使用方法

基本部署流程

1. 获取镜像
   从Docker Hub拉取最新镜像：

bash
docker pull rakwireless/udp-packet-forwarder:latest

2. 运行容器
   根据硬件配置运行容器，需映射必要的设备接口（SPI/USB）及配置网络：

bash
docker run -d \
  --name lora-gateway \
  --privileged \
  --network host \
  -v /dev:/dev \
  rakwireless/udp-packet-forwarder:latest

参数说明：--privileged提供设备访问权限，--network host使用主机网络确保UDP通信正常，-v /dev:/dev映射设备节点以访问SPI/USB集中器。

3. 自定义配置
   通过环境变量或挂载配置文件实现自定义配置，例如指定LNS服务器地址：

bash
docker run -d \
  --name lora-gateway \
  --privileged \
  --network host \
  -v /dev:/dev \
  -e LNS_SERVER="eu1.cloud.thethings.network" \
  -e LNS_PORT=1700 \
  rakwireless/udp-packet-forwarder:latest

高级配置

对于复杂场景，可通过挂载本地配置文件覆盖默认配置：

bash
docker run -d \
  --name lora-gateway \
  --privileged \
  --network host \
  -v /dev:/dev \
  -v /local/path/to/global_conf.json:/app/global_conf.json \
  rakwireless/udp-packet-forwarder:latest

配置文件格式及参数说明请参考项目GitHub文档。