thethingsindustries/lorawan-stack-dev

LoRaWAN Stack 开发构建镜像

镜像概述

本镜像为LoRaWAN Stack的开发构建版本，基于项目最新开发分支代码持续构建，提供LoRaWAN网络服务器核心功能，包括设备接入、数据转发、协议解析、网络管理及设备生命周期管理等能力。该镜像专注于开发与测试场景，集成最新未正式发布的功能特性及调试工具，适用于开发团队进行功能迭代、集成测试及新特性验证。

核心功能与特性

• 最新开发特性：集成开发分支最新代码，包含未正式发布的功能改进与新特性，支持抢先体验与验证
• 开发调试支持：内置调试工具链与日志增强模块，支持详细日志输出（DEBUG级别）及运行时状态监控
• 快速迭代能力：基于开发分支持续构建，支持开发团队通过拉取最新镜像快速获取代码更新
• 灵活配置体系：提供丰富的环境变量与配置文件选项，支持开发环境定制（如数据库连接、端口映射、功能模块开关等）
• 协议兼容性：兼容LoRaWAN 1.0.x/1.1协议标准，支持Class A/B/C设备接入及多区域频段配置

使用场景与适用范围

适用场景

• LoRaWAN Stack核心功能开发与代码调试
• 新特性功能验证与集成测试
• 设备端与网络服务器的联调验证
• 开发环境下的LoRaWAN网络模拟部署

不适用场景

• 生产环境部署（缺乏生产级稳定性与安全加固）
• 大规模设备接入场景（性能未针对生产负载优化）
• 关键业务系统依赖（功能稳定性未经长期验证）

使用方法与配置说明

基础部署命令

bash
docker run -d \
  --name lorawan-stack-dev \
  -p 8080:8080 \  # HTTP API端口（设备管理/数据查询）
  -p 8883:8883 \  # WebSocket端口（实时数据推送）
  -p 44158:44158/udp \  # LoRaWAN协议端口（设备接入）
  -e LOG_LEVEL=debug \  # 启用调试级别日志
  -e DEV_MODE=true \    # 启用开发模式（开启调试工具）
  -e DB_PATH=/var/lib/lorawan-stack/db \  # 数据库存储路径
  -v ./local-config:/etc/lorawan-stack \  # 挂载本地配置文件目录
  -v ./local-data:/var/lib/lorawan-stack \  # 挂载数据持久化目录
  lorawan-stack:dev

配置说明

核心环境变量

端口映射说明

数据持久化配置

通过挂载本地目录实现开发环境数据持久化，建议挂载以下路径：

bash
# 配置文件目录（存放自定义配置）
-v ./local-config:/etc/lorawan-stack  

# 数据存储目录（含数据库文件、设备数据、日志等）
-v ./local-data:/var/lib/lorawan-stack  

# 日志目录（独立存储调试日志）
-v ./local-logs:/var/log/lorawan-stack  

注意事项

• 本镜像为开发构建版本，功能稳定性未经生产环境验证，禁止用于生产环境
• 开发模式下可能输出敏感调试信息，需确保开发环境网络隔离与访问控制
• 建议定期执行docker pull docker.xuanyuan.run/lorawan-stack:dev拉取最新镜像以同步开发分支更新
• 调试工具端口（9000）默认仅监听本地回环地址，如需远程访问需通过配置文件修改监听地址

常见问题

• 镜像启动失败：检查本地挂载目录权限（建议设置755权限）及端口占用情况（使用netstat -tulpn排查）
• 日志无输出：确认LOG_LEVEL已设置为debug且DEV_MODE=true，检查日志目录挂载是否正确
• 设备无法接入：检查LoRaWAN协议端口（44158/UDP）映射是否正确，频段配置是否匹配设备端参数