Mosquitto简要教程

最新推荐文章于 2025-02-11 18:09:20 发布

中下游国外我

最新推荐文章于 2025-02-11 18:09:20 发布

阅读量2.5k

点赞数

分类专栏： MQTT Mosquitto 文章标签： MQTT Mosquitto

MQTT 同时被 2 个专栏收录

4 篇文章

订阅专栏

Mosquitto

2 篇文章

订阅专栏

http://www.blog.chinaunix.net/uid-25885064-id-3539075.html

一、获取、安装

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命令设置你需要的系统参数。