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

ChirpStack是一个开源的LoRaWAN(R)网络服务器，可用于设置LoRaWAN网络。ChirpStack提供网关、设备和租户管理的Web界面，以及与主要云提供商、数据库和服务的数据集成设置。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启动了开发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。