local_roborock_server
Emulador local HTTPS/MQTT para aspiradoras Roborock sin root ni modificaciones de hardware. Implementado con Next.js, FastAPI y Python. Requiere Docker o Home Assistant. Soporta certificados SSL automáticos (ZeroSSL/Actalis) y gestión segura de dispositivos en red privada.
Ficha actualizada 28 sept 2026, 2:12 · upstream 28 sept 2026, 1:57 · release v1.2.0
Qué es local_roborock_server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una implementación local del servidor para aspiradoras Roborock, emulando la API HTTPS y MQTT de la nube oficial sin necesidad de rootear el dispositivo ni realizar modificaciones de hardware. Está construido sobre Next.js y FastAPI, permitiendo ejecutar la pila completa en tu propia infraestructura mediante Docker Compose o como add-on en Home Assistant. La instalación requiere un dominio propio para gestionar certificados SSL válidos y una configuración DNS adecuada (LAN o Cloudflare).
El servicio está diseñado para operar de forma privada dentro de tu red local, permitiendo el control total sobre los datos y la automatización sin depender de servicios externos. Para acceso externo, incluye autenticación y controles para evitar conexiones no autorizadas, aunque se advierte sobre los riesgos de seguridad al exponer servicios autoalojados públicamente.
La documentación cubre desde la instalación inicial hasta la configuración de certificados SSL (ZeroSSL o Actalis), el emparejamiento de dispositivos mediante una segunda máquina y la integración con ecosistemas como Home Assistant. Es crucial seguir las guías de actualización y compatibilidad de modelos para asegurar un funcionamiento estable.
- Control local sin dependencia de nube
- Integración nativa en Home Assistant
- Automatización doméstica (IFTTT, Node-RED)
- Gestión segura de datos personales
- Emulación de API para desarrolladores
- Ejecución sin rootear el hardware
- Soporte Docker y Home Assistant Add-on
- Certificados SSL automáticos con ZeroSSL/Actalis
- Documentación detallada de instalación y actualización
- Compatibilidad con modelos específicos verificados
- Requiere dominio propio para HTTPS válido
- Riesgo de seguridad si se expone públicamente sin protección
- Algunos modelos antiguos requieren certificados específicos (Actalis)
- Necesita segunda máquina para emparejamiento inicial
- Sin garantía oficial por parte del fabricante
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega en red privada con Docker Compose o Home Assistant. Usa ZeroSSL por defecto; Cloudflare DNS-01 para renovación automática. No expongas el puerto 555/8881 al internet público sin autenticación robusta. Verifica compatibilidad del modelo antes de instalar.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.