本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

rakwireless/udp-packet-forwarder

用于部署支持UDP Packet Forwarder协议的LoRaWAN网关Docker镜像，支持AMD64、ARMv7/8架构及SX1301/02/03/08、SX1280集中器，兼容TTSv3和ChirpStackv4，实现自动发现和配置。

0 次下载activerakwireless镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

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接口。

使用方法

基本部署流程

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

docker pull rakwireless/udp-packet-forwarder:latest

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

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集中器。

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

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

高级配置

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

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文档。