TailRouter
TailRouter es un gateway de alto rendimiento y gestor web ligero que corre directamente en hardware sin dependencias externas. Permite exponer servicios locales (3D printers, home automation, apps web) a Tailnet o internet público mediante Tailscale Serve y Funnel.
Ficha actualizada 23 sept 2026, 8:06 · upstream 23 sept 2026, 7:18 · release v1.2.0
Qué es TailRouter
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
TailRouter es una solución de puerta de enlace de nivel bajo (bare-metal gateway) que se ejecuta directamente en el hardware del host sin necesidad de máquinas virtuales pesadas ni configuraciones complejas como Nginx, Traefik o Node.js. Su arquitectura está construida con Python 3 y la librería estándar de módulos (`asyncio`, `urllib`, `json`, `subprocess`), lo que garantiza un rendimiento mínimo de ~15 MB de RAM y una inicialización en menos de 50 ms.
El sistema se integra nativamente con Tailscale mediante el servicio Serve (acceso seguro dentro del Tailnet) y Funnel (ruta HTTPS pública accesible para todo el mundo). Incluye un panel web responsivo en modo oscuro, escaneo automático de puertos TCP y contenedores Docker, gestión multiidioma (Vietnamita, Inglés, Chino, Japonés), y soporte cross-platform para Linux, macOS y Windows.
La arquitectura se basa en una red de mesh Tailscale con MagicDNS, donde TailRouter actúa como proxy inverso seguro. Los servicios locales pueden ser accesibles desde el Tailnet mediante rutas mágicas o directamente a través del Funnel público.
- Exponer servicios locales (3D printers, impresoras 3D) a la red Tailscale con acceso seguro y cifrado
- Alojar aplicaciones web personalizadas en un servidor local accesible desde Tailnet o internet público
- Gestionar múltiples servicios de forma centralizada mediante el panel web sin necesidad de configurar servidores Nginx o Traefik
- Automatizar la configuración de puertos y contenedores Docker a través del panel de administración
- Soporte multiidioma para usuarios con necesidades lingüísticas específicas (Vietnamita, Inglés, Chino, Japonés)
- Integración con herramientas de home automation como NoMachine o servicios remotos
- Zero external dependencies: Se construye completamente con Python estándar sin necesidad de pip, virtualenvs o Node.js
- Direct bare-metal performance: Corre directamente en el hardware del host para maximizar la throughput de I/O y reducir latencia
- Tailscale Serve & Funnel integration: Acceso cifrado dentro del Tailnet y ruta pública completa sin port forwarding
- Web dashboard responsive: Panel SPA en modo oscuro accesible desde localhost, Tailnet o mediante Tailscale Serve
- Auto port scanner: Detecta puertos TCP abiertos y contenedores Docker con inspección de encabezados HTTP
- Multi-language i18n: Soporte nativo para Vietnamita, Inglés, Chino y Japonés con persistencia en localStorage
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.
Para Linux/macOS: ejecutar `./start.sh` como servicio de sistema (requiere permisos root) o usar el script de inicio automático. Para Windows: doble clic en `start.bat`. Se recomienda mantener la configuración de persistencia del servicio para que arranque al reiniciar el sistema. En Docker, se puede usar `docker compose up -d` con `network_mode: host` para acceder directamente a los puertos 8080 y 3000.
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.