Deploy and Host Tailscale VPN (Userspace) on Railway

Esta plantilla despliega una instancia de Tailscale en un contenedor Docker ultraligero basado en Alpine Linux. Está específicamente optimizada para entornos como Railway, utilizando userspace networking para funcionar sin necesidad de acceso al dispositivo /dev/net/tun del host.

About Hosting Tailscale VPN

Hospedar esta solución te permite integrar tu proyecto de Railway en tu red privada de Tailscale (Tailnet) en cuestión de segundos. El contenedor maneja automáticamente la conexión, la reconexión y el enrutamiento.

Al desplegarlo, este servicio actúa como un nodo completo que puede servir como Exit Node (para enrutar tu tráfico de internet a través de Railway) y exponer un Proxy SOCKS5. Incluye scripts de gestión de procesos robustos para evitar caídas y asegurar que el túnel se mantenga estable.

Common Use Cases

• Exit Node Seguro: Navega por internet de forma segura desde cualquier lugar utilizando la dirección IP estática de tu servicio en Railway, ideal para evitar geobloqueos o asegurar conexiones en redes Wi-Fi públicas.
• Acceso a Infraestructura Privada: Conecta tu entorno de desarrollo local directamente a tus bases de datos o microservicios privados en Railway sin exponer puertos a la internet pública.
• Proxy SOCKS5: Utiliza el proxy integrado en el puerto 1055 para enrutar selectivamente el tráfico de ciertas aplicaciones a través de tu red VPN.

Dependencies for Tailscale VPN Hosting

• Una cuenta activa en Tailscale.
• Una Auth Key de Tailscale.

Deployment Dependencies

• Tailscale Admin Console - Keys: Necesitarás generar una clave aquí. Se recomienda crear una clave Reutilizable y Etiquetada (ej. tag:server) para evitar que expire la clave de autenticación.

Implementation Details

Esta imagen utiliza un enfoque optimizado para contenedores sin privilegios:

• Base Alpine: Imagen mínima para reducir la superficie de ataque y consumo de recursos.
• Userspace Networking: Utiliza --tun=userspace-networking para evitar errores de permisos de kernel típicos en entornos PaaS.
• Gestión de PID: Un script de inicio personalizado (start.sh) gestiona el ciclo de vida del proceso tailscaled, asegurando que el contenedor se detenga correctamente si la VPN falla, permitiendo a Railway reiniciarlo automáticamente.
• Persistencia: Soporta el montaje de volúmenes en /var/lib/tailscale para mantener la identidad del dispositivo (IP y configuración) entre despliegues.

Why Deploy Tailscale VPN on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying this Tailscale VPN template on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.