colota-forwarder
Servicio Node.js que recibe actualizaciones de ubicación desde Colota u OwnTracks y las reenvía a múltiples destinos como Home Assistant, Traccar o Dawarich. Opera detrás de un proxy inverso con autenticación API para garantizar la integridad de los datos.
Ficha actualizada 22 sept 2026, 15:29 · upstream 21 sept 2026, 20:12 · release v0.4.5
Qué es colota-forwarder
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
colota-forwarder es una herramienta de reenvío multi-destino escrita en Node.js, diseñada para centralizar actualizaciones de ubicación desde aplicaciones móviles como Colota o clientes OwnTracks HTTP. El servicio recibe las peticiones y distribuye los datos a varios destinos simultáneamente, convirtiendo el formato del payload según sea necesario para cada receptor.
La seguridad es crítica: el servicio no termina TLS y debe exponerse únicamente a través de un proxy inverso que gestione la terminación segura. Se requiere una API_KEY fuerte en todos los endpoints de recepción para prevenir la inyección de datos falsos desde cualquier cliente que pueda alcanzar el puerto 3000.
Soporta manejo de lotes (Overland) y ofrece un endpoint /health para monitorizar el estado de entrega por destino. La configuración se realiza mediante variables de entorno en un archivo .env, permitiendo añadir hasta 20 destinos consecutivos con tipos específicos como owntracks, traccar o raw.
- Centralizar ubicación en Home Assistant desde múltiples apps móviles sin cambiar la app del usuario.
- Enviar telemetría a Traccar para seguimiento vehicular y gestión de flotas.
- Integración con Dawarich para visualización de rutas y puntos de interés.
- Agregar datos a GeoPulse o Reitti sin modificar la configuración de la aplicación móvil.
- Soporte nativo para formatos Colota y OwnTracks HTTP en un solo servicio.
- Manejo automático de lotes (Overland) sin saturar el cliente con múltiples peticiones.
- Endpoint /health para monitorizar el estado de entrega por destino individual.
- Configuración flexible vía variables de entorno .env para hasta 20 destinos.
- No termina TLS; requiere proxy inverso que gestione la terminación segura y certificados.
- Requiere API_KEY fuerte en todos los endpoints para evitar inyección de datos falsos.
- Límites de concurrencia y tamaño de lote configurables por defecto pueden requerir ajuste.
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 con Docker Compose. Expón el puerto 3000 solo a través de un proxy inverso (nginx/caddy) que maneje TLS. Configura API_KEY en .env y define los destinos TARGET_n_URL/TARGET_n_TYPE. Si usas certificados propios, monta NODE_EXTRA_CA_CERTS. Usa /health para verificar entregas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.