Instalar la aplicación Tailscale y completar un enlace de autenticación del dispositivo no garantiza que el contenedor de ZimaOS permanezca conectado. En este hilo resuelto de octubre de 2025, el dispositivo podía añadirse a Tailscale, pero nunca mostraba el estado de conexión esperado en la lista de dispositivos de administración de Tailscale.
La solución provino de otros usuarios de la comunidad, no de una cuenta del personal de IceWhale. Un usuario identificó la entrada de Tailscale de la App Store de ZimaOS que funcionaba en su entorno, cambió su configuración de Web UI y proporcionó una nueva clave de autenticación de Tailscale. Una respuesta posterior añadió un paso de recuperación importante para los estados persistentemente dañados: eliminar la carpeta antigua de AppData de Tailscale antes de reinstalar la aplicación.
El hilo utilizó una entrada específica de Tailscale en la App Store
La App Store de ZimaOS mostraba dos entradas relacionadas con Tailscale. El usuario de la comunidad informó que, en ese momento, solo la entrada resaltada a la izquierda había funcionado en su propia migración a ZimaOS 1.5.
Esta fue una observación de 2025, no una clasificación permanente de los paquetes actuales de la App Store. Las definiciones de las aplicaciones pueden cambiar, así que compara los detalles de los paquetes actuales antes de asumir que sigue siendo necesaria la misma entrada.
Configura la ruta de Web UI utilizada en la configuración de la comunidad
El usuario cambió el destino de Web UI de la aplicación Tailscale para que apuntara a la ruta de administración de inicio de sesión de Tailscale:
login.tailscale.com con la ruta /admin para su acceso directo de Web UI.Esta configuración controla el acceso directo que se abre desde ZimaOS. No debe confundirse con el estado de red del propio demonio de Tailscale.
Utiliza tu propia clave de autenticación actual de Tailscale
A continuación, la guía de la comunidad obtuvo una clave de autorización de Tailscale y la introdujo en la variable de entorno TS_AUTHKEY de la aplicación. No copies una clave de autenticación de una captura de pantalla, una publicación del foro, una copia de seguridad ni otra máquina. Las claves de autenticación son credenciales y deben generarse y administrarse para tu propia tailnet.
La documentación actual de Tailscale admite implementaciones en contenedores y parámetros de autenticación para Docker:
Documentación de Tailscale para Docker
Si reinstalar no ayuda, es posible que se siga reutilizando la AppData antigua
Otro usuario de la comunidad tenía una instalación de Tailscale que antes funcionaba y luego dejó de hacerlo. Actualizar, reiniciar, eliminar la aplicación y reinstalarla no la recuperó inicialmente.
El paso que finalmente funcionó para ese usuario fue:
- eliminar la aplicación Tailscale de ZimaOS;
- ir a la ubicación de AppData de ZimaOS;
- eliminar la antigua carpeta de datos de la aplicación
tailscale; - reinstalar Tailscale desde la App Store;
- repetir los pasos de configuración y autenticación que habían funcionado.
Advertencia: eliminar una carpeta de AppData borra el estado persistente de la aplicación. Haz una copia de seguridad de todo lo que puedas necesitar antes de eliminarla y verifica que estás eliminando la carpeta de Tailscale, no los datos de otra aplicación.
Por qué eliminar solo la aplicación puede no restablecer Tailscale
Las aplicaciones en contenedores suelen conservar el estado fuera del sistema de archivos desechable del contenedor. Esto permite que la configuración sobreviva a las actualizaciones o a la recreación del contenedor, pero también significa que un estado incorrecto u obsoleto puede sobrevivir a un ciclo normal de desinstalación y reinstalación si se deja atrás el directorio persistente de AppData.
Por lo tanto, el resultado posterior de este hilo es útil para distinguir dos niveles de recuperación: primero reinstala el contenedor y considera borrar el estado persistente únicamente cuando una reinstalación normal siga reutilizando la misma configuración defectuosa.
Este hilo resuelto trataba sobre conectar el nodo, no sobre el enrutamiento de subredes
El problema aquí era que el nodo de Tailscale nunca llegaba a conectarse. Es diferente de una conversación posterior de ZimaOS en la que Tailscale se conectaba correctamente, pero no anunciaba rutas de subred. Si tu dispositivo ya está conectado en Tailscale y solo no puedes acceder a servicios de la LAN remota, soluciona el enrutamiento de subredes en lugar de repetir este procedimiento centrado en la autenticación.
Preguntas frecuentes sobre la conexión de Tailscale en ZimaOS
¿Por qué mi dispositivo de Tailscale aparece registrado, pero nunca se conecta?
En el caso resuelto de 2025, la configuración comunitaria que funcionó incluía la entrada adecuada de la App Store, su configuración de Web UI y una clave de autenticación válida de Tailscale.
¿Debo eliminar inmediatamente la AppData de Tailscale?
No. La eliminación de AppData fue un paso de recuperación posterior utilizado después de que fallaran los intentos normales de actualizar, reiniciar, desinstalar y reinstalar. Borra el estado persistente, así que haz primero una copia de seguridad.
¿Es seguro reutilizar la clave de autenticación que aparece en una captura de pantalla antigua?
No. Genera y administra tu propia clave para tu tailnet. Trata las claves de autenticación como credenciales.
¿Fue esta una solución oficial de IceWhale?
No. El hilo se marcó como resuelto mediante la resolución de problemas de la comunidad. Es una referencia práctica útil, pero los pasos no se publicaron como un procedimiento oficial de soporte de IceWhale.
