Dev.to technology 2h ago

Guía práctica: Tailscale 1.104.1 en un homelab paso a paso

Resumen

Esta guía recoge el procedimiento documentado para instalar Tailscale en un equipo Linux de un homelab, autenticarlo en tu tailnet y comprobar que funciona. Como referencia de versión usamos la release v1.104.1 de tailscale/tailscale: la página de GitHub la mostraba marcada como «Latest» en el momento en que se descargó, y remite al changelog oficial.

Importante: las fuentes consultadas no explican cómo fijar o instalar específicamente la versión 1.104.1 con el script de instalación. Tampoco se sabe qué cambia respecto a 1.104.2, cuya página de GitHub no pudo consultarse. Además, la documentación utilizada no se ha confirmado como reflejo exacto de 1.104.1. Trata los pasos como el procedimiento general documentado para el cliente de Linux.

Requisitos

Un equipo Linux con gestor de paquetes (apt, yum o zypper).
Acceso con sudo y una cuenta para autenticar el equipo en tu tailnet.
El módulo de kernel tun. Si falta, se carga con sudo modprobe tun. Para cargarlo en cada arranque, se añade tun a /etc/modules o a /etc/modules-load.d/tun.conf.
Si tu homelab incluye otros clientes: según el changelog consultado, Tailscale v1.104 requiere macOS Ventura 13 o posterior (no funciona en Monterey 12) y iOS 16 o posterior (no soporta iOS 15). Esto no afecta a Linux.

Pasos documentados

1. Instalar

En distribuciones con apt, yum o zypper, la documentación de Linux describe un script de instalación de una sola línea que se descarga con curl y se pasa a sh. Copia el comando exacto desde la página oficial de instalación en Linux (enlazada en «Fuentes») en lugar de reescribirlo de memoria. Como recomendación general, si prefieres revisar el script antes de ejecutarlo, descárgalo primero a un archivo y léelo.

2. Alternativa: binarios estáticos

Para distribuciones no cubiertas por el script existen binarios estáticos:

tar xvf tailscale_<version>_<arquitectura>.tgz
sudo tailscaled --state=tailscaled.state
sudo tailscale up

El archivo incluye una configuración de servicio systemd en el subdirectorio systemd/.

3. Autenticar el equipo

sudo tailscale up

El comando muestra una URL para autenticar el equipo en la tailnet. Después, confirma que el dispositivo aparece en la página Machines de la consola de administración.

4. Activar Tailscale SSH (opcional)

tailscale set --ssh

También existe el flag --ssh en tailscale up, que por defecto es false y permite el acceso según la política de acceso de la tailnet.

5. Caducidad de clave en servidores

En servidores, Raspberry Pi, hosts Docker o NAS se puede desactivar la caducidad de clave (key expiry) desde la página Machines de la consola. Esto reduce la seguridad y solo debe hacerse en dispositivos de confianza. Si la clave ya caducó, se fuerza la reautenticación con:

sudo tailscale up --force-reauth

6. Actualizar

El cliente puede actualizarse con tailscale update (Linux, Windows y macOS), desde la página de descargas o desde el sitio de paquetes de Tailscale, que ofrece las pistas stable, release candidate y unstable. También se pueden configurar actualizaciones automáticas.

Verificación

tailscale ip
tailscale status

tailscale ip muestra las direcciones IPv4 (100.x.y.z) e IPv6 Tailscale del equipo; con -4 o -6 se filtra la familia.
tailscale status muestra el estado de la conexión.

Comprueba además que la máquina figura en la página Machines de la consola.

Fuentes

Este artículo se ha elaborado con asistencia automatizada

Story originally reported by Dev.to. View at Dev.to →