chirpstack/chirpstack-gateway-bridge

ChirpStack Gateway Bridge

镜像概述和主要用途

ChirpStack Gateway Bridge 是一款协议转换服务，用于将 LoRa® Packet Forwarder 协议转换为 ChirpStack Network Server 通用数据格式（JSON 和 Protobuf）。该组件是 ChirpStack 开源 LoRaWAN® 网络服务器栈的重要组成部分，旨在实现不同网关协议与网络服务器之间的标准化数据交互。

核心功能和特性

支持的 Packet Forwarder 后端（Backends）

• Semtech UDP packet-forwarder：支持基于 UDP 协议的 Semtech 标准 packet-forwarder（如 LoRa 网关常用的 packet_forwarder 软件）。
• Basic Station packet-forwarder：支持 LoRa Basics Station 协议，适用于符合最新 LoRaWAN 网关规范的设备。

支持的集成方式（Integrations）

• 通用 MQTT broker：可与任意 MQTT 消息代理集成，实现数据转发。
• GCP Cloud IoT Core MQTT Bridge：支持与 Google Cloud IoT Core 服务的 MQTT 桥接集成，适用于云端部署场景。

架构

ChirpStack Gateway Bridge 作为网关与网络服务器之间的中间层，架构示意如下：
!ChirpStack 架构图

相关组件链接

• ChirpStack Gateway Bridge
• ChirpStack Network Server
• ChirpStack Application Server

使用场景和适用范围

适用场景

• LoRaWAN 网络中，需将不同类型网关（如基于 Semtech UDP 或 Basic Station 协议的网关）的原始数据统一转换为 ChirpStack Network Server 兼容格式的场景。
• 需要通过 MQTT 协议将网关数据转发至网络服务器或云端服务（如 GCP Cloud IoT Core）的部署场景。

适用范围

• LoRaWAN 网关运营商、物联网解决方案提供商。
• 基于 ChirpStack 开源栈构建的 LoRaWAN 网络基础设施。

使用方法和配置说明

Docker 镜像获取

Docker 镜像地址：https://hub.docker.com/r/chirpstack/chirpstack-gateway-bridge/

基础部署示例（docker run）

bash
docker run -d \
  --name chirpstack-gateway-bridge \
  -p 1700:1700/udp \  # UDP 端口（Semtech packet-forwarder 通信）
  -v $(pwd)/configuration:/etc/chirpstack-gateway-bridge \  # 挂载配置文件目录
  chirpstack/chirpstack-gateway-bridge:latest

说明：默认配置文件路径为 /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml，可通过挂载本地目录自定义配置。

Docker Compose 部署示例

创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  chirpstack-gateway-bridge:
    image: chirpstack/chirpstack-gateway-bridge:latest
    container_name: chirpstack-gateway-bridge
    ports:
      - "1700:1700/udp"  # Semtech UDP packet-forwarder 端口
    volumes:
      - ./configuration:/etc/chirpstack-gateway-bridge  # 挂载配置目录
    restart: always
    environment:
      - TZ=Asia/Shanghai  # 设置时区（可选）

启动服务：

bash
docker-compose up -d

配置说明

ChirpStack Gateway Bridge 的核心配置通过 chirpstack-gateway-bridge.toml 文件定义，主要配置项包括：

• 后端配置：指定支持的 packet-forwarder 类型（如 semtech_udp 或 basic_station）及监听端口。
• 集成配置：MQTT broker 地址、认证信息（如 mqtt.server、mqtt.username、mqtt.password），或 GCP Cloud IoT Core 连接参数。
• 日志配置：日志级别（如 info、debug）及输出格式。

详细配置说明可参考 官方文档。

相关链接

• 下载地址
• https://hub.docker.com/r/chirpstack/chirpstack-gateway-bridge/
• 官方文档
• 源码构建
• 贡献指南
• 支持
  • 社区论坛
  • https://github.com/brocaar/chirpstack-gateway-bridge/issues

许可证

ChirpStack Gateway Bridge 基于 MIT 许可证分发，详见 https://github.com/brocaar/chirpstack-gateway-bridge/blob/master/LICENSE%E3%80%82