gotthardp/lorawan-server

私有LoRaWAN网络紧凑型服务器

镜像概述和主要用途

本镜像是一个开源的LoRaWAN服务器，集成了网络服务器和应用服务器功能。适用于运营自有LoRaWAN网络的应用提供商，或设备与应用开发者。它旨在成为小型私有LoRaWAN网络的一体化软件包，可直接将LoRaWAN网络与后端IT系统集成。

警告：当前为开发版本0.7.0，建议使用稳定版0.6.x。 major版本升级后，必须先检查并完成配置，再连接任何网关或设备！

• 迁移至0.7.x后，需从“服务器”->“管理URL”中移除/admin后缀
• 确保所有网关都分配到指定了区域的区域（Area）中
• 从0.5.x迁移至0.6.x时，需为组分配配置文件（Profile），为区域分配网关
• 从0.4.x迁移至0.5.x时，设备/节点地址和安全密钥将保留，但许多ADR参数会被删除（已移至配置文件设置）

核心功能和特性

• 协议支持：实现LoRaWAN规范v1.0.3
• 网关兼容性：
  • 支持基于https://github.com/Lora-net/packet_forwarder%E7%9A%84%E7%BD%91%E5%85%B3%EF%BC%8C%E5%A6%82Semtech LoRa演示套件、LoRa Lite Gateway、LORANK-8、MultiConnect Conduit、Kerlink Wirnet Stations等
  • 支持使用Basic Station LNS协议的网关
• 安全特性：执行所有必要的加密和完整性检查，支持简单ABP设备的宽松帧计数器检查
• 应用逻辑：提供内部模块调用示例，支持Semtech/IMST LoRaMote、Microchip LoRa技术Mote（通过外部插件）
• 数据解析：自动解析知名载荷格式，包括Cayenne低功耗载荷、CBOR（Concise Binary Object Representation）
• 数据存储：直接将上行数据存储到MongoDB集合
• 外部应用集成：支持多种连接协议：
  • WebSocket协议（RFC6455）
  • HTTP/1.1和HTTP/2协议（REST API）
  • MQTT v3.1/v3.1.1，可与Amazon AWS IoT、IBM Watson IoT Platform、MathWorks ThingSpeak、Microsoft Azure IoT Hub、ThingsBoard开源IoT平台、Adafruit IO、Orange Live Objects等集成
  • AMQP 0-9-1（与RabbitMQ连接）
• 设备管理：
  • 支持任意数量的Class A或Class C设备
  • 支持ABP（个人化激活）和OTAA（空中激活）两种激活方式
  • 支持未确认和已确认的数据上行与下行
  • 支持用户定义组的多播
  • 支持LoRaWAN 1.0.3区域参数中标准化的所有区域（欧洲、美国、中国、澳大利亚、亚洲、韩国、印度和俄罗斯）
• 网络管理界面：
  • 支持手动和自动配置数据速率（ADR）及其他参数
  • 监控服务器、网关和节点健康状态，显示设备电池和连接质量指标
  • 可通过电子邮件或Slack发送健康警报
• 跨平台运行：支持Windows、Linux、OS X和Solaris等主要操作系统，可在嵌入式系统（如Raspbian、mLinux、Yocto/OpenEmbedded系统、OpenWrt）或Docker容器中运行
• 高可用性：可建立集群（Clusters）
• 容错性：基于Erlang构建，专为容错系统设计，不易崩溃
• 开源许可：免费，基于MIT许可证分发

使用场景和适用范围

• 应用提供商运营私有LoRaWAN网络
• 设备开发者测试和开发LoRaWAN设备
• 应用开发者构建基于LoRaWAN的物联网应用
• 小型企业或机构部署本地LoRaWAN网络
• 需要将LoRaWAN数据与后端系统（如AWS、Azure等云平台）集成的场景

注意：使用本服务器仍需自行购买LoRaWAN网关，并负责部署和维护；它可能永远不会支持商业级网络服务器的复杂管理功能。服务器支持的网关、设备和节点数量取决于服务器负载和硬件性能，没有硬性限制。

使用方法和配置说明

系统要求

需安装Erlang/OTP 21.0或更高版本

安装与运行

手动运行

bash
cd lorawan-server
bin/lorawan-server

停止服务器

bash
bin/lorawanctl stop

Docker部署

参考Docker文档获取详细部署说明

网关配置

需在LoRaWAN网关中设置服务器地址和端口（默认1680）

配置说明

1. 初始配置：服务器提供单一配置文件和管理工具，需按照配置指南进行设置
2. 管理界面访问：默认通过[***]"admin"
3. 必要配置步骤：
   • 修改默认密码为更安全的密码
   • 设置网络参数并添加要使用的LoRaWAN网关
   • 为每种设备类型定义设备配置文件（Profile）
   • 配置每个设备：作为个人化节点（ABP）或空中激活（OTAA）的已授权设备

集成指南

外部应用集成

可使用后端处理器和连接器将lorawan-server与外部应用集成。集成指南提供了与AWS、Azure等主要云平台的集成说明。

自定义应用开发

可使用内部Web服务器开发内部应用，提供自定义REST API。服务器设计为高度可扩展，可通过创建实现lorawan_application行为的新模块来开发内部应用，详见自定义应用指南和开发指南。

故障排除

1. 查看文档：首先阅读完整文档
2. 检查日志：如服务器行为不符合预期，查看服务器日志并参考故障排除指南
3. 升级版本：建议使用https://github.com/gotthardp/lorawan-server/releases%EF%BC%8C%E5%A6%82%E4%BD%BF%E7%94%A8%E6%9C%80%E6%96%B0%E6%BA%90%E7%A0%81%EF%BC%8C%E7%A1%AE%E4%BF%9D%E6%9E%84%E5%BB%BA%E7%8A%B6%E6%80%81%E4%B8%BA%E7%BB%BF%E8%89%B2%EF%BC%88Travis CI），升级命令：

bash
cd lorawan-server
git pull
make upgrade
make release

4. 获取支持：如问题仍存在，可联系lorawan-server邮件列表或查看现有https://github.com/gotthardp/lorawan-server/issues%EF%BC%8C%E7%A1%AE%E8%AE%A4%E9%97%AE%E9%A2%98%E6%9C%AA%E8%A2%AB%E6%8A%A5%E5%91%8A%E5%90%8E%E5%8F%AFhttps://github.com/gotthardp/lorawan-server/issues/new

版权和许可

lorawan-server基于MIT许可证分发，详见LICENSE。

版权所有 (c) 2016-2019 Petr Gotthard

赞助商

Softline：全球领先的信息技术解决方案和服务提供商，专注于东欧、中亚、美洲和亚洲等新兴市场。