ChirpStack开源LoRaWAN(R)网络服务器

ChirpStack是一个开源的LoRaWAN(R)网络服务器，可用于建立LoRaWAN网络。ChirpStack提供网关、设备和租户的网页管理界面，以及与主要云提供商、数据库和服务的数据集成，这些通常用于处理设备数据。ChirpStack提供基于gRPC的API，可用于集成或扩展ChirpStack。

文档和二进制文件

请参阅ChirpStack网站以获取文档和预编译的二进制文件。

从源码构建

需求

构建ChirpStack需要

• Nix (推荐) 和
• Docker

Nix

Nix用于设置开发环境，该环境用于本地开发和创建二进制文件。

如果您没有安装Nix且不想安装它，则可以使用提供的基于Docker Compose的Nix环境。要启动此环境，请执行以下命令

make docker-devshell

注意：您将能够运行测试命令并运行cargo build，但在此环境中无法进行交叉编译（因为它会尝试在Docker中启动Docker）。

Docker

Docker由cross-rs用于交叉编译，以及一些make命令。

启动开发shell

运行以下命令以启动开发shell

nix-shell

如果您没有安装Nix，请执行以下命令

make docker-devshell

构建UI

要构建ChirpStack UI，请执行以下命令

make build-ui

运行ChirpStack测试

启动所需服务

ChirpStack 运行测试前需要先启动几个服务，如 PostgresQL、Redis、Mosquitto 等。如果您使用 nix-shell 启动了开发外壳，则需要手动启动这些服务。

docker compose up -d

运行测试

运行以下命令来运行 ChirpStack 测试：

make test

构建 ChirpStack 二进制文件

在编译二进制文件之前，您需要安装一些额外的开发工具（用于交叉编译、打包等）。执行以下命令：

make dev-dependencies

在 ./chirpstack 子目录下运行以下命令：

# Build AMD64 debug build (optimized for build speed)
make debug-amd64

# Build AMD64 release build (optimized for performance and binary size)
make release-amd64

# Build all packages (all targets, .deb, .rpm and .tar.gz files)
make dist

许可证

ChirpStack 网络服务器遵循 MIT 许可证发布。也请参阅 LICENSE。