mosquitto

Mosquito Eclipse

Mosquitto é uma implementação de código aberto de um servidor para as versões 5.0, 3.1.1 e 3.1 do protocolo MQTT. Também inclui uma biblioteca cliente C e C++ e os utilitários mosquitto_pub e mosquitto_sub para publicação e assinatura.

Ligações

Consulte os links a seguir para obter mais informações sobre MQTT:

• Página da comunidade: http://mqtt.org/
• Padrão MQTT v3.1.1: https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
• Padrão MQTT v5.0: https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html

As informações do projeto Mosquitto estão disponíveis nos seguintes locais:

• Página inicial principal: https://mosquitto.org/
• Encontre bugs existentes ou envie um novo bug: https://github.com/eclipse/mosquitto/issues
• Repositório de código-fonte: https://github.com/eclipse/mosquitto

Há também um servidor de teste público disponível em https://test.mosquitto.org/

Instalando

Consulte https://mosquitto.org/download/ para obter detalhes sobre a instalação de binários para várias plataformas.

Início rápido

Se você instalou um pacote binário, o broker deverá ter sido iniciado automaticamente. Caso contrário, pode ser iniciado com uma configuração bem básica:

 mosquitto

Em seguida, use mosquitto_sub para assinar um tópico:

 mosquitto_sub -t 'test/topic' -v

E para publicar uma mensagem:

 mosquitto_pub -t 'test/topic' -m 'hello world'

Observe que iniciar o corretor dessa forma permite acesso anônimo/não autenticado, mas apenas do computador local, portanto, é realmente útil apenas para testes iniciais.

Se quiser que clientes de outro computador se conectem, você precisará fornecer um arquivo de configuração. Se você instalou a partir de um pacote binário, provavelmente já terá um arquivo de configuração em algum lugar como /etc/mosquitto/mosquitto.conf . Se você compilou a partir do código-fonte, você pode escrever seu arquivo de configuração e executá-lo como mosquitto -c /path/to/mosquitto.conf .

Para iniciar seu arquivo de configuração você define um ouvinte e precisará pensar sobre qual autenticação você precisa. Não é aconselhável administrar seu corretor com acesso anônimo quando estiver disponível publicamente.

Para obter detalhes sobre como fazer isso, consulte os métodos de autenticação disponíveis e o plugin de segurança dinâmica.

Documentação

A documentação do corretor, dos clientes e da API da biblioteca do cliente pode ser encontrada nas páginas man, que estão disponíveis online em https://mosquitto.org/man/. Há também páginas com uma introdução aos recursos do MQTT, o utilitário mosquitto_passwd para lidar com nomes de usuário/senhas e uma descrição das opções do arquivo de configuração disponíveis para o broker.

A documentação detalhada da API da biblioteca cliente pode ser encontrada em https://mosquitto.org/api/

Construindo a partir da fonte

Para construir a partir da fonte, a rota recomendada para os usuários finais é baixar o arquivo em https://mosquitto.org/download/.

No Windows e Mac, use cmake para compilar. Em outras plataformas, basta executar make para construir. Para Windows, consulte também README-windows.md .

Se você estiver compilando a partir do repositório git, a documentação ainda não estará compilada. Use make binary para pular a construção das páginas de manual ou instale docbook-xsl em sistemas Debian/Ubuntu.

Construir dependências

• c-ares (libc-ares-dev em sistemas baseados em Debian) - somente quando compilado com make WITH_SRV=yes
• cJSON - para suporte de saída JSON do cliente. Desative com make WITH_CJSON=no detectado automaticamente com CMake.
• libwebsockets (libwebsockets-dev) - habilite com make WITH_WEBSOCKETS=yes
• openssl (libssl-dev em sistemas baseados em Debian) - desabilite com make WITH_TLS=no
• pthreads - para suporte a threads da biblioteca cliente. Isso é necessário para suportar as funções mosquitto_loop_start() e mosquitto_loop_stop() . Se compilada sem suporte a pthread, não há garantia de que a biblioteca seja segura para threads.
• uthash / utlist - são fornecidas versões agrupadas desses cabeçalhos, desative seu uso com make WITH_BUNDLED_DEPS=no
• xsltproc (xsltproc e docbook-xsl em sistemas baseados em Debian) - necessário apenas ao compilar a partir de fontes git - desabilite com make WITH_DOCS=no

Opções equivalentes para ativar/desativar recursos estão disponíveis ao usar a compilação CMake.

Créditos

Mosquitto foi escrito por Roger Light [email protected]