Mosquitto简要教程

共计 4131 个字符，预计需要花费 11 分钟才能阅读完成。

一、获取、安装

Mosquitto 提供了 Windows、Linux 以及 qnx 系统的版本，安装文件可从 http://mosquitto.org/files/binary/ 获取。Windows 系统下的安装过程非常简单，甚至可以把 Mosquitto 直接安装成为系统服务；但是，在实际应用中更倾向于使用 Linux 系统的服务器。在 Linux 系统上安装 Mosquitto，建议使用源码安装模式，最新的源码可从 http://mosquitto.org/files/source/ 获取。解压之后，可以在源码目录里面找到主要的配置文件 config.mk，其中包含了所有 Mosquitto 的安装选项，详细的参数说明如下：

# 是否支持 tcpd/libwrap 功能.

#WITH_WRAP:=yes

# 是否开启 SSL/TLS 支持

#WITH_TLS:=yes

# 是否开启 TLS/PSK 支持

#WITH_TLS_PSK:=yes

# Comment out to disable client client threading support.

#WITH_THREADING:=yes

# 是否使用严格的协议版本（老版本兼容会有点问题）

#WITH_STRICT_PROTOCOL:=yes

# 是否开启桥接模式

#WITH_BRIDGE:=yes

# 是否开启持久化功能

#WITH_PERSISTENCE:=yes

# 是否监控运行状态

#WITH_MEMORY_TRACKING:=yes

      这里需要注意的是，默认情况下 Mosquitto 的安装需要 OpenSSL 的支持；如果不需要 SSL，则需要关闭 config.mk 里面的某些与 SSL 功能有关的选项（WITH_TLS、WITH_TLS_PSK）。接着，就是运行 make install 进行安装，完成之后会在系统命令行里发现 mosquitto、mosquitto_passwd、mosquitto_pub 和 mosquitto_sub 四个工具，分别用于启动代理、管理密码、发布消息和订阅消息。

二、配置、运行

安装完成之后，所有配置文件会被放置于 /etc/mosquitto/ 目录下，其中最重要的就是 Mosquitto 的配置文件，即 mosquitto.conf，以下是详细的配置参数说明。

# =================================================================

# General configuration

# =================================================================

# 客户端心跳的间隔时间

#retry_interval 20

# 系统状态的刷新时间

#sys_interval 10

# 系统资源的回收时间，0 表示尽快处理

#store_clean_interval 10

# 服务进程的 PID

#pid_file /var/run/mosquitto.pid

# 服务进程的系统用户

#user mosquitto

# 客户端心跳消息的最大并发数

#max_inflight_messages 10

# 客户端心跳消息缓存队列

#max_queued_messages 100

# 用于设置客户端长连接的过期时间，默认永不过期

#persistent_client_expiration

# =================================================================

# Default listener

# =================================================================

# 服务绑定的 IP 地址

#bind_address

# 服务绑定的端口号

#port 1883

# 允许的最大连接数，- 1 表示没有限制

#max_connections -1

# cafile：CA 证书文件

# capath：CA 证书目录

# certfile：PEM 证书文件

# keyfile：PEM 密钥文件

#cafile

#capath

#certfile

#keyfile

# 必须提供证书以保证数据安全性

#require_certificate false

# 若 require_certificate 值为 true，use_identity_as_username 也必须为 true

#use_identity_as_username false

# 启用 PSK（Pre-shared-key）支持

#psk_hint

# SSL/TSL 加密算法，可以使用“openssl ciphers”命令获取

# as the output of that command.

#ciphers

# =================================================================

# Persistence

# =================================================================

# 消息自动保存的间隔时间

#autosave_interval 1800

# 消息自动保存功能的开关

#autosave_on_changes false

# 持久化功能的开关

persistence true

# 持久化 DB 文件

#persistence_file mosquitto.db

# 持久化 DB 文件目录

#persistence_location /var/lib/mosquitto/

# =================================================================

# Logging

# =================================================================

# 4 种日志模式：stdout、stderr、syslog、topic

# none 则表示不记日志，此配置可以提升些许性能

log_dest none

# 选择日志的级别（可设置多项）

#log_type error

#log_type warning

#log_type notice

#log_type information

# 是否记录客户端连接信息

#connection_messages true

# 是否记录日志时间

#log_timestamp true

# =================================================================

# Security

# =================================================================

# 客户端 ID 的前缀限制，可用于保证安全性

#clientid_prefixes

# 允许匿名用户

#allow_anonymous true

# 用户 / 密码文件，默认格式：username:password

#password_file

# PSK 格式密码文件，默认格式：identity:key

#psk_file

# pattern write sensor/%u/data

# ACL 权限配置，常用语法如下：

# 用户限制：user <username>

# 话题限制：topic [read|write] <topic>

# 正则限制：pattern write sensor/%u/data

#acl_file

# =================================================================

# Bridges

# =================================================================

# 允许服务之间使用“桥接”模式（可用于分布式部署）

#connection <name>

#address <host>[:<port>]

#topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix]

# 设置桥接的客户端 ID

#clientid

# 桥接断开时，是否清除远程服务器中的消息

#cleansession false

# 是否发布桥接的状态信息

#notifications true

# 设置桥接模式下，消息将会发布到的话题地址

# $SYS/broker/connection/<clientid>/state

#notification_topic

# 设置桥接的 keepalive 数值

#keepalive_interval 60

# 桥接模式，目前有三种：automatic、lazy、once

#start_type automatic

# 桥接模式 automatic 的超时时间

#restart_timeout 30

# 桥接模式 lazy 的超时时间

#idle_timeout 60

# 桥接客户端的用户名

#username

# 桥接客户端的密码

#password

# bridge_cafile：桥接客户端的 CA 证书文件

# bridge_capath：桥接客户端的 CA 证书目录

# bridge_certfile：桥接客户端的 PEM 证书文件

# bridge_keyfile：桥接客户端的 PEM 密钥文件

#bridge_cafile

#bridge_capath

#bridge_certfile

#bridge_keyfile

# 自己的配置可以放到以下目录中

include_dir /etc/mosquitto/conf.d

启动 Mosquitto 服务很简单，直接运行命令行“mosquitto -c /etc/mosquitto/mosquitto.conf -d”即可。另外，Mosquitto 是个纯异步 IO 框架，经测试可以轻松处理 20000 个以上的客户端连接。当然，实际的最大承载量还和业务的复杂度有比较大的关系。测试的时候不要忘记调整系统的最大连接数和栈大小，比如 Linux 上可用 ulimit -n20000 -s512 命令设置你需要的系统参数。

本文永久更新链接地址 ：http://www.linuxidc.com/Linux/2016-03/128860.htm