ChirpStack Docker 项目教程

ChirpStack Docker 项目教程

chirpstack-docker 项目地址: https://gitcode.com/gh_mirrors/chir/chirpstack-docker

1. 项目的目录结构及介绍

ChirpStack Docker 项目的目录结构如下：

chirpstack-docker/
├── configuration/
│   ├── chirpstack/
│   ├── chirpstack-gateway-bridge/
│   ├── mosquitto/
│   └── postgresql/
│       └── initdb/
├── docker-compose.yml
├── LICENSE
├── Makefile
└── README.md

目录结构介绍

• configuration/: 包含 ChirpStack 及其相关组件的配置文件。

  • chirpstack/: ChirpStack 的配置文件。
  • chirpstack-gateway-bridge/: ChirpStack Gateway Bridge 的配置文件。
  • mosquitto/: Mosquitto (MQTT broker) 的配置文件。
  • postgresql/initdb/: PostgreSQL 数据库的初始化脚本。

• docker-compose.yml: Docker Compose 文件，用于定义和运行多个 Docker 容器。

• LICENSE: 项目的许可证文件。

• Makefile: 包含一些常用的命令，例如导入 LoRaWAN 设备库。

• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件是 docker-compose.yml，它定义了 ChirpStack 及其依赖服务的配置和启动方式。

docker-compose.yml 文件介绍

docker-compose.yml 文件的主要内容包括：

• services: 定义了多个服务，包括 ChirpStack、ChirpStack Gateway Bridge、Mosquitto、PostgreSQL 等。
• volumes: 定义了 Docker 卷，用于持久化 PostgreSQL 和 Redis 的数据。
• networks: 定义了 Docker 网络，用于服务之间的通信。

启动 ChirpStack

要启动 ChirpStack 及其依赖服务，请在项目根目录下执行以下命令：

docker-compose up

启动后，可以通过浏览器访问 http://localhost:8080 来访问 ChirpStack 的 Web 界面。

3. 项目的配置文件介绍

项目的配置文件主要位于 configuration/ 目录下，每个子目录对应一个服务的配置文件。

ChirpStack 配置文件

• configuration/chirpstack/chirpstack.toml: ChirpStack 的主要配置文件，包含区域配置、MQTT 主题前缀等信息。

ChirpStack Gateway Bridge 配置文件

• configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml: ChirpStack Gateway Bridge 的配置文件，包含 UDP 和 Basics Station 的配置。

Mosquitto 配置文件

• configuration/mosquitto/mosquitto.conf: Mosquitto MQTT broker 的配置文件。

PostgreSQL 初始化脚本

• configuration/postgresql/initdb/: 包含 PostgreSQL 数据库的初始化脚本，用于创建数据库和用户。

配置文件示例

以下是 chirpstack.toml 配置文件的部分内容示例：

[general]
log_level="info"

[postgresql]
dsn="postgres://chirpstack:chirpstack@postgresql:5432/chirpstack?sslmode=disable"

[network_server]
net_id="000000"

[network_server.band]
name="EU_863_870"

通过修改这些配置文件，可以自定义 ChirpStack 及其相关服务的配置，以满足不同的需求。

chirpstack-docker 项目地址: https://gitcode.com/gh_mirrors/chir/chirpstack-docker