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 许可证发布。请参阅许可证。