目录
1.在命令窗口测试
2.mosquitto 语法
3.新建用户和密码
4.订阅 $SYS 层的主题来获取 broker 的信息
5.linux 环境 测试代码
1.在命令窗口测试
1)订阅端
mosquitto_sub -h localhost -t test -v
用 -h 参数指定服务器 IP ,用 -t 参数指定订阅的话题。( localhost 和 127.0.0.1 代表本地IP的意思 )
例如:在阿里云搭建的MQTT服务器IP为
mosquitto_sub -h 106.xxx.xxx.xxx -t test -v
2)发布端
mosquitto_pub -h localhost -t test -m "Hello world"
用 -m 参数指定要发布的信息内容,然后在订阅者的终端就可以看到由 发布者 推送的信息
测试效果如下:
2.mosquitto 语法
mosquitto [-c config file] [ -d | --daemon ] [-p port number] [-v]
- -c 是指定配置文件的路径,默认不需要配置文件。
- -d 表示作为守护进程运行在后台。
- -p 用来指定监听的端口,默认是 1883 ,使用 TCP 连接,如果要使用 UDP 连接,需要设为 1884。
- -v 表示生成详细的运行日志,等价于配置文件中将 log_type 设为 all 。
3.新建用户和密码
mosquitto 默认是不需要配置文件的,它会对所有的选项采用默认值,比如用户名和密码。
默认不需要用户名和密码,如果需要,可以用 mosquitto_passwd 新建用户和密码,并管理,语法是:
- mosquitto_passwd [ -c | -D ] passwordfile username
- mosquitto_passwd -b passwordfile username password
- mosquitto_passwd -U passwordfile
- -c 表示新建一个密码文件,如果文件已经存在,会被覆盖,用户名中不能包含冒号,因为密码文件中用户名和密码是用冒号隔开的。执行之后会要求设置密码,输入内容不可见,密码以加密 hash 值的方式存储在密码文件中。
- -D 表示删除用户名。
- -b 表示在命令行中,以明文方式设置密码。
- -U 用来将密码文件中的明文密码改成加密格式。如果文件中的密码已经是 hash 值,千万不要用这个选项,否则它会对 hash 值再做一次运算,然后修改密码文件。
例如,新建一个密码文件
设好密码后,在配置文件中设置 allow_anonymous false
再用 password_file
指定密码文件的路径就可以使用了。配置文件可以放在任何位置,只要 mosquitt 能找到它。配置文件中,每一行设置一个选项,选项名称和值用空格隔开,用井号可以注释。安装好的 mosquitto 在 /etc/mosquitto/ 目录下有配置文件和密码文件的例子,复制一份皆可使用:
注:默认情况下,mosquitto 不需要任何验证,用户可以匿名连接。如果设置了 allow_anonymous false ,客户端必须提供正确的用户名和密码进行验证,连接时应该将用户名和密码加密传输,否则有被拦截的危险。
4.订阅 $SYS 层的主题来获取 broker 的信息
客户端可以通过订阅 $SYS 层的主题来获取 broker 的信息,这些主题每 sys_interval 秒更新一次,如果 sys_interval 设为 0 则不会发送,标记为 static 的主题只会为每个订阅者发送一次。如果是在命令行中使用,要用反斜杠把 $SYS 作为普通字符串传递给客户端,否则 $SYS 会被当做环境变量来处理。
$SYS/broker/bytes/received ,broker 从启动开始收到的总字节数。
$SYS/broker/bytes/sent ,broker 从启动开始发送的总字节数。
$SYS/broker/clients/connected, $SYS/broker/clients/active (不建议使用),当前连接的客户端数目。
$SYS/broker/clients/expired ,由于 persistent_client_expiration 选项过期而断开的客户端数量。
$SYS/broker/clients/disconnected, $SYS/broker/clients/inactive (不建议使用),所有断开的已注册客户端(包括清除进程)的数量。
$SYS/broker/clients/maximum ,过去所有时间所连接的最大客户端数量(从服务器开机开始)。
$SYS/broker/clients/total ,所有连接过的客户端数量(包括活跃的客户端和已经断开的客户端数量)。
$SYS/broker/connection/# ,当代理服务器被配置为桥接模式的时候, 通常做法是提供一种状态话题来只是连接的状态,这个话题默认为 $SYS/broker/connection/, 如果数值为1,证明连接是活跃的,为0证明连接不活跃. 查看桥接一节来获取更多信息。
$SYS/broker/heap/current size ,mosquitto 当前使用的最大内存,请注意,由于编译时候的选择这个话题可能不可用。
$SYS/broker/heap/maximum size ,mosquitto 曾经使用的最大内存,请注意,由于编译时候的选择这个话题可能不可用。
$SYS/broker/load/connections/+ ,不同的时间间隔内代理服务器收到连接数据包的平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/bytes/received/+ ,不同的时间间隔内代理服务器收到的平均比特数, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/bytes/sent/+ ,不同的时间间隔内代理服务器发送的平均比特数, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/messages/received/+ ,不同的时间间隔内代理服务器收到各种类型数据包的平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/messages/sent/+ ,不同的时间间隔内代理服务器发送各种类型数据包的平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/publish/dropped/+ ,不同的时间间隔内代理服务器发布数据包丢失的数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/publish/received/+ ,不同的时间间隔内代理服务器发布数据包被收到的平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/publish/sent/+ ,不同的时间间隔内代理服务器发布的数据包被发送的平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/load/sockets/+ ,不同的时间间隔内代理服务器打开socket连接平均数量, 最后的+可以为 5分钟、10分钟、15分钟。
$SYS/broker/messages/inflight ,具有QoS>0正在等待的确认消息的数量。
$SYS/broker/messages/received ,从代理服务器开机开始收到的消息总数。
$SYS/broker/messages/sent ,从服务器开机开始所发送的各种类型消息的总数。
$SYS/broker/messages/stored ,在消息存储机制中保留的消息总数,包括客户端保留消息和持久客户端的队列消息。
$SYS/broker/publish/messages/dropped , 由于队列机制或者传输限制所丢弃数据包的数量. 参照mosquitto.conf 的 max_inflight_messages 和 max_queued_messages 选项获取更多解释。
$SYS/broker/publish/messages/received ,从代理服务器开机开始发布的信息被收到总数。
$SYS/broker/publish/messages/sent ,从代理服务器开机开始发布的信息总数。
$SYS/broker/retained messages/count ,代理服务器中活跃的保留消息的总数。
$SYS/broker/subscriptions/count ,代理服务器中活跃的订阅的总数。
$SYS/broker/timestamp ,代理服务器编译的时间戳. Static.
$SYS/broker/uptime ,服务器合计在线时间(以秒计)。
$SYS/broker/version ,代理服务器版本. Static.
5.linux 环境 测试代码
客户端(订阅消息)
#include <stdio.h>
#include <stdlib.h>
#include <mosquitto.h>
#include <string.h>
#define HOST "localhost" //可以改为自己MQTT的服务器地址 如:#define HOST "106.xxx.xxx.xxx"
#define PORT 1883 //端口号
#define KEEP_ALIVE 60
bool session = true;
void my_message_callback(struct mosquitto *mosq, void *userdata, const struct mosquitto_message *message)
{
if(message->payloadlen){
printf("%s %s", message->topic, message->payload);
}else{
printf("%s (null)\n", message->topic);
}
fflush(stdout);
}
void my_connect_callback(struct mosquitto *mosq, void *userdata, int result)
{
int i;
if(!result){
/* Subscribe to broker information topics on successful connect. */
mosquitto_subscribe(mosq, NULL, "pu", 2); //topic 主题:"pu"
}else{
fprintf(stderr, "Connect failed\n");
}
}
void my_subscribe_callback(struct mosquitto *mosq, void *userdata, int mid, int qos_count, const int *granted_qos)
{
int i;
printf("Subscribed (mid: %d): %d", mid, granted_qos[0]);
for(i=1; i<qos_count; i++){
printf(", %d", granted_qos[i]);
}
printf("\n");
}
void my_log_callback(struct mosquitto *mosq, void *userdata, int level, const char *str)
{
/* Pring all log messages regardless of level. */
printf("%s\n", str);
}
int main()
{
struct mosquitto *mosq = NULL;
//libmosquitto 库初始化
mosquitto_lib_init();
//创建mosquitto客户端
mosq = mosquitto_new(NULL,session,NULL);
if(!mosq){
printf("create client failed..\n");
mosquitto_lib_cleanup();
return 1;
}
//设置回调函数,需要时可使用
//mosquitto_log_callback_set(mosq, my_log_callback);
mosquitto_connect_callback_set(mosq, my_connect_callback);
mosquitto_message_callback_set(mosq, my_message_callback);
//mosquitto_subscribe_callback_set(mosq, my_subscribe_callback);
//客户端连接服务器
if(mosquitto_connect(mosq, HOST, PORT, KEEP_ALIVE)){
fprintf(stderr, "Unable to connect.\n");
return 1;
}
//循环处理网络消息
mosquitto_loop_forever(mosq, -1, 1);
mosquitto_destroy(mosq);
mosquitto_lib_cleanup();
return 0;
}
客户端(发布消息)
#include <stdio.h>
#include <stdlib.h>
#include <mosquitto.h>
#include <string.h>
#define HOST "localhost" //可以改为自己MQTT的服务器地址 如:#define HOST "l06.xxx.xxx.xxx"
#define PORT 1883 //端口号
#define KEEP_ALIVE 60
#define MSG_MAX_SIZE 512
bool session = true;
int main()
{
char buff[MSG_MAX_SIZE];
struct mosquitto *mosq = NULL;
//libmosquitto 库初始化
mosquitto_lib_init();
//创建mosquitto客户端
mosq = mosquitto_new(NULL,session,NULL);
if(!mosq){
printf("create client failed..\n");
mosquitto_lib_cleanup();
return 1;
}
//连接服务器
if(mosquitto_connect(mosq, HOST, PORT, KEEP_ALIVE)){
fprintf(stderr, "Unable to connect.\n");
return 1;
}
//开启一个线程,在线程里不停的调用 mosquitto_loop() 来处理网络信息
int loop = mosquitto_loop_start(mosq);
if(loop != MOSQ_ERR_SUCCESS)
{
printf("mosquitto loop error\n");
return 1;
}
while(fgets(buff, MSG_MAX_SIZE, stdin) != NULL)
{
/*发布消息*/
mosquitto_publish(mosq,NULL,"pu",strlen(buff)+1,buff,0,0);
//topic 主题:"pu"
memset(buff,0,sizeof(buff));
}
mosquitto_destroy(mosq);
mosquitto_lib_cleanup();
return 0;
}
注意
在编译程序时需加上-lmosquitto链接。如:
gcc -o mosquitto_client_sub mosquitto_client_sub.c -lmosquitto
希望对你有帮助。