Integraciones

Tailscale

Configure el widget con OAuth y distinga entre el widget, el acceso remoto y las claves de autenticación.

Con frecuencia se confunden tres usos diferentes:

UsoIdentificador necesarioDónde configurarlo
Mostrar los dispositivos del tailnet en el widgetOAuth Client ID + OAuth Client SecretNasDash, conexión compartida
Acceder a NasDash de forma remota mediante TailscaleNingún secreto en NasDashCliente de Tailscale en cada equipo
Registrar automáticamente un equipo nuevoClave de autenticación de TailscaleEn ese equipo, no en el widget

Crear las credenciales del widget

  1. Abra la consola OAuth.
  2. Cree un cliente con lectura necesaria, como devices:core:read.
  3. Copie Client ID y secreto inmediatamente.
  4. Guarde conexión Tailscale en Ajustes → Integraciones con tailnet, Client ID y secreto.
  5. Todos los widgets Tailscale usan la conexión Tailscale o Headscale guardada más recientemente; guarde la deseada en último lugar. No hay selector por widget.

El tailnet puede identificarse mediante su nombre DNS o mediante la identidad que aparece en la consola. Los clientes OAuth y sus ámbitos se explican en la documentación oficial de Tailscale.

No pegue una clave de autenticación en el widget

Una clave que suele comenzar por tskey-auth- sirve para conectar un equipo al tailnet. El widget espera un secreto de cliente OAuth, normalmente presentado como tskey-client-..., junto con su Client ID.

Acceder a NasDash mediante Tailscale

  1. Instale Tailscale en el host donde se ejecuta NasDash y en el equipo cliente.
  2. Conecte ambos al mismo tailnet.
  3. Mantenga el puerto de NasDash accesible desde la IP de Tailscale o utilice un proxy inverso privado.
  4. Abra http://IP_TAILSCALE:2504.

Este método no requiere activar el widget. Aun así, proteja NasDash con contraseñas robustas y con ACL de Tailscale adecuadas.

Rotación

Cree un cliente OAuth nuevo, sustituya el secreto en NasDash, compruebe el widget y revoque después el cliente anterior. Una copia de seguridad de /app/data contiene la configuración cifrada; protéjala como un secreto.

Headscale

Cree una conexión Headscale en Ajustes → Integraciones con la URL del servidor y su clave API. Guárdela en último lugar para que la usen todos los widgets Tailscale. El acceso remoto a NasDash sigue siendo una configuración de red aparte.