Emparejar una máquina · Docs

Vincule una máquina a su cuenta de proveedor con el agente de Node Lodge en Linux o Windows: descárguelo, verifíquelo, emparéjelo y manténgalo activo.

El emparejamiento vincula una máquina a su organización. El agente envía entonces el hardware de la máquina y un latido cada 30 segundos, y la máquina aparece en su consola en Machines. Unos 5 minutos.

Antes de empezar

Una cuenta de proveedor con una dirección de correo electrónico verificada.
Node.js 22.12 o posterior en la máquina.
Una terminal en la máquina como usuario estándar: ni root ni administrador.
Para alojar sesiones Community: una máquina que cumpla los Requisitos del proveedor.

Windows y otros sistemas Linux se emparejan y envían su hardware. Las publicaciones Community requieren una máquina con Ubuntu Server 24.04 que cumpla los Requisitos del proveedor; los pasos desde el emparejamiento hasta la publicación están en Proveedores.

1. Genere un código de emparejamiento

En la consola, abra Setup y vaya a Install.
Asigne un nombre a la máquina. Los arrendatarios ven el nombre: evite datos personales.
Seleccione Generate pairing code. El código sirve una sola vez y caduca a los 15 minutos.

La consola muestra entonces los comandos para su máquina. Elija Linux o Windows encima del primero.

2. Obtenga el agente

El primer comando crea una carpeta ComputeHost en su directorio personal, descarga el agente y su firma, y verifica la firma con las claves de publicación de Node Lodge. Si la verificación falla, se eliminan ambos archivos y no se ejecuta nada.

Linux: péguelo en una terminal (bash).
Windows: péguelo en PowerShell, sin privilegios de administrador.

3. Empareje

node compute-host.mjs enroll --api <console address> --code <your code>

La consola rellena ambos valores. El agente genera un par de claves en la máquina y envía solo la mitad pública. La clave privada nunca sale de la máquina.

4. Manténgalo activo

node compute-host.mjs run

Los latidos salen cada 30 segundos por HTTPS. La máquina no abre ningún puerto. Mantenga el comando en ejecución: en una terminal que permanezca abierta, o con un gestor de servicios (systemd en Linux, Programador de tareas en Windows) con el mismo usuario estándar.

En cuanto la máquina se empareja, la consola abre su página con el primer latido.

Lo que envía el agente

Envía	Nunca envía
Modelo de CPU, núcleos e hilos	Nombre del equipo o nombres de usuario
Tamaño de la memoria	Direcciones IP o MAC
Modelo de GPU, cantidad, VRAM, controlador, versión de CUDA, enlace PCIe, temperatura y límite de potencia	Números de serie
Tipo, modelo, tamaño y espacio libre del disco	Nombres o contenido de archivos
Fabricante y modelo de la placa base	Nombres de interfaces de red
Velocidad y tipo del enlace de red	Nada de lo que usted escribe o ejecuta
Velocidad de internet, medida cada semana con la máquina inactiva
Sistema, distribución y versión del agente

Cada GPU se identifica con un hash unidireccional de su ID, de modo que se detecta una tarjeta emparejada dos veces.

Prueba de velocidad de internet

Al emparejar la máquina, y después una vez por semana, cuando ninguna sesión está en curso ni empieza en los 15 minutos siguientes, el agente mide la velocidad de internet de la máquina contra speedtest.nodelodge.com: unos 8 segundos en cada sentido con conexiones paralelas, hasta unos pocos GB a alta velocidad. El servidor de prueba funciona en la red de Cloudflare, en el punto más cercano a la máquina, por lo que Cloudflare ve la IP pública de la máquina, como en cualquier conexión; la consola solo recibe las velocidades, la latencia y la hora de la prueba. Nunca se ejecuta durante un alquiler.

Ejecútela usted mismo en cualquier momento, sin que se envíe nada a la consola:

node compute-host.mjs speedtest

Para desactivar la prueba semanal, inicie el agente con node compute-host.mjs run --no-speedtest.

5. Compruebe la máquina

node compute-host.mjs doctor

Un autodiagnóstico de solo lectura: versión de Node, privilegios, hardware, conexión con la consola y reloj. Muestra pass, warn o fail para cada comprobación, y el estado del emparejamiento. Añada --community en Linux para las comprobaciones de sesión descritas en Requisitos del proveedor.

Después del emparejamiento

Revisión. El equipo de Node Lodge compara el hardware enviado con los requisitos y revisa los latidos de la máquina. La página de la máquina muestra awaiting review y luego approved o rejected.
Precio. Fije su precio por hora en la página de la máquina. Puede prepararlo durante la revisión.
Publicación. Una vez aprobada, publique la oferta en el catálogo. Retírela cuando quiera.

Solución de problemas

Si ve	Haga esto
`Signature check failed`	Vuelva a ejecutar el comando de descarga. Si falla dos veces, contacte con soporte.
`node` no se reconoce	Instale Node.js 22.12 o posterior, abra una terminal nueva y vuelva a ejecutar el comando.
Código caducado	Genere un código nuevo en Setup. Cada código sirve una vez, durante 15 minutos.
Emparejada y luego sin conexión	`run` se detuvo. Vuelva a iniciarlo en la máquina.
`privileges: fail`	Cierre la terminal de administrador o root y use un usuario estándar.

Desemparejar una máquina

En la página de la máquina, abra Settings y seleccione Revoke key. La máquina ya no puede conectarse y su oferta se retira. En la máquina, node compute-host.mjs forget elimina la identidad local. Para volver a usar la máquina, emparéjela con un código nuevo.