tsbridge
tsbridge es un proxy inverso ligero basado en tsnet de Tailscale para exponer múltiples servicios HTTPS desde una única instancia en un Tailnet. Ideal para homelabs y desarrollo.
Ficha actualizada 18 sept 2026, 21:20 · upstream 14 sept 2026, 0:57 · release v0.15.1
Qué es tsbridge
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
tsbridge actúa como un proxy inverso impulsado por tsnet, permitiendo exponer múltiples servicios backend en su Tailnet desde un único proceso. Está diseñado específicamente para entornos de homelab y desarrollo donde se desea la magia de Tailscale sin la molestia de ejecutar un sidecar separado para cada servicio.
Inspirado en Traefik, puede configurarse mediante un archivo TOML simple o observando Docker para etiquetas de contenedor. Resuelve el problema de tener que iniciar una nueva instancia tsnsrv para cada servicio, eliminando la necesidad de múltiples servicios systemd y configuraciones individuales. Soporta tanto configuración estática como dinámica vía labels de Docker.
El proyecto está escrito en Go, tiene soporte Docker (Dockerfile presente) pero no incluye archivos compose. Utiliza los puertos 8080 para servicios backend y 9090 para métricas Prometheus. La complejidad es baja, requiriendo aproximadamente 1 núcleo CPU y 1GB de RAM.
- Gestión centralizada de múltiples servicios en Tailnet sin necesidad de sidecars individuales
- Integración con Docker mediante labels estilo Traefik para descubrimiento automático
- Soporte para Headscale con autenticación por keys y TLS desactivado
- Exposición de métricas Prometheus para monitorización de la infraestructura
- Arquitectura modular: cada servicio ejecuta su propia instancia tsnet con estado aislado
- Compatibilidad nativa con MagicDNS de Tailscale para nombres amigables
- Soporte dual: configuración vía archivo TOML o provider Docker con labels
- Bajo consumo de recursos: 1 núcleo CPU y 1GB RAM estimados
- No está hardening ni probado en batalla para cargas de trabajo de producción crítica
- Requiere configuración manual de credenciales OAuth o auth keys para Headscale
- Dependencia de la librería tsnet que puede tener restricciones específicas del kernel
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.
Usar imagen ghcr.io/jtdowney/tsbridge:latest. Configurar TS_OAUTH_CLIENT_ID y TS_OAUTH_SECRET antes de iniciar. Asegurar que default_tags sea propiedad del OAuth client o configurarlo manualmente. Exponer endpoint de métricas solo en redes seguras.
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.