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 命令。

启动开发外壳

运行以下命令以启动开发外壳

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。