1.QuickStart

以下介绍通过源代码编译的方式, mqtt-server 默认不启用 SSL/TLS ,默认监听端口为 1883 , 因此请确保此端口未被占用, 服务器日志默认保存在构建目录下, 可以通过修改 config.yml 文件中的相关项修改配置文件保存路径

0. 前提

请先保证环境安装了 cmake 3.19+ 并且编译器支持 C++20 标准, 对于 Linux 要求 gcc11.2+, Windows 要求 msvc19+ 或者你也可以使用 mingw11.2+

1. 克隆源代码

git clone https://github.com/xukeawsl/mqtt-server.git
cd mqtt-server
mkdir build && cd build

2. Cmake 构建

# 默认 Release 级别, 也可以选择 Debug 级别构建
# cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake ..
cmake --build .

# 构建时可以选择日志级别, Release 构建默认日志级别是 Info
# Debug 构建默认日志级别是 Debug, 支持以下的日志级别
# Trace, Debug, Info, Warn, Error, Critical, Off
cmake -DLOG_LEVEL=Error ..

3. 运行 mqtt-server

• 如果希望程序在后台运行, 可以在命令后面加上 & 使其在后台运行, 或者也可以通过 Docker 部署为服务

# Linux
./mqtt-server

# Windows
.\mqtt-server.exe