Saltar a contenido

Mosquitto

Broker MQTT del homelab (Eclipse Mosquitto).

Resumen

Bus de mensajería entre Zigbee2MQTT, Home Assistant y Frigate. Corre en k3s con autenticación obligatoria (allow_anonymous false) y persistencia en Longhorn. Sustituyó al contenedor de lebron el 2026-11-01.

Estado

Campo Valor
Estado Operativo
Argo CD Application mosquitto
Namespace mosquitto

Despliegue

Campo Valor
Método Manifests propios
Chart / imagen eclipse-mosquitto:2.0.22
Origen clusters/luka/apps/mosquitto/, clusters/luka/config/mosquitto/
Config en el repo clusters/luka/config/mosquitto/

Red

Campo Valor
Service mosquitto (LoadBalancer)
IP 192.168.20.63
Puertos 1883 (MQTT)
URL interna mqtt.local.gorkarevilla.com:1883
URL externa — (sin túnel ni Traefik)
TLS — (tráfico interno en VLAN Servidores)

Acceso y usuarios

  • Usuarios/roles: un solo usuario MQTT (ramuh) para los tres consumidores.
  • Credenciales: Secret mosquitto-passwd (hashes) y zigbee2mqtt-mqtt, sincronizados desde VKS. Nunca en claro aquí.

Configuración

  • 1 réplica, strategy: Recreate, UID/GID 1883.
  • allow_anonymous false, persistence true, logs a stdout.
  • Firewall: Internal → 192.168.20.63:1883 para Home Assistant.

Almacenamiento

  • PVC mosquitto-data (1Gi, Longhorn, Prune=false,Delete=false) → /mosquitto/data: sesiones y mensajes retenidos.

Dependencias

  • Depende de: Longhorn, MetalLB.
  • Usado por: Zigbee2MQTT, Home Assistant, Frigate.

Backup y recuperación

  • Sin backup automático (el estado útil vive en Zigbee2MQTT y HA). Restore: re-desplegar y volver a conectar consumidores.

Monitorización

  • No expone métricas Prometheus nativas; no hay ServiceMonitor.
  • Disponibilidad vía Uptime Kuma (monitor TCP a mqtt.local:1883).

Referencias

Notas / TODO

  • Evaluar mosquitto-exporter si se quieren métricas de conexiones.
  • ACLs por usuario si aparecen más consumidores.