Índice de la guía2 de 9
Conectar tus máquinas
Un código de unión por máquina, y qué puede publicar cada una.
Unir la primera máquina
El servidor imprimió al instalarse la línea de la primera máquina. Si la perdiste o quieres añadir otra, pide una nueva. Un código que nadie usa en 7 días deja de valer: pedir otra vez el de una máquina que nunca se unió le da uno nuevo, con lo mismo.
En el VPS
sudo lnkstart server join-code portatil
En tu máquina
curl -fsSL https://lnkstart.com/ install.sh | sh -s -- join LD1.xxxxx app=3000
Instala LnkStart, une la máquina (antes comprueba que el servidor acepta el código), publica app.<dominio> desde su puerto 3000 y la deja como servicio que arranca con el equipo; en Linux pide sudo para eso. Cambia app=3000 por el nombre y el puerto de tu app. El código lleva dentro la dirección del servidor y la credencial de esa máquina: se comparte sólo con ella, y caduca si no se usa en 7 días. Con LnkStart ya instalado, lo mismo es lnkstart join LD1.xxxxx app=3000 --install.
Unirla sin copiar el código
Con la consola del servidor encendida, la máquina puede pedir entrar y tú la apruebas desde el navegador: no hay nada largo que copiar de una terminal a otra.
En tu máquina
curl -fsSL https://lnkstart.com/ install.sh | sh -s -- join lnk.tunnels.midominio.com app=3000
Enseña un código corto (como KQ7M-4PXA) y un enlace a la consola, y espera hasta 10 minutos. En la consola, abre el enlace o escribe el código en Máquinas, ponle nombre y apruébala: la máquina recibe su código de unión y sigue sola, como con el código. Apruébala sólo si el código que ves es el de tu pantalla. Con LnkStart ya instalado, lo mismo es lnkstart join lnk.tunnels.midominio.com app=3000 --install.
Que las máquinas nuevas esperen tu aprobación
Si das códigos a otras personas (técnicos, clientes), puedes hacer que una máquina nueva no publique nada hasta que la aceptes: en la consola, Ajustes → Máquinas nuevas. Al conectarse por primera vez, sale en Máquinas con el equipo y la dirección desde la que llega, y la aceptas o la retiras. Una que ya publicaba no se corta.
En el VPS
sudo lnkstart server token approve oficina
Lo mismo desde la terminal. sudo lnkstart server token list dice cuáles esperan.
Publicar y dejarlo funcionando
En tu máquina
lnkstart add app=3000 lnkstart add api=8080 --app web sudo lnkstart install lnkstart list
add guarda en services.toml y aparta el nombre en el servidor; con --app lo agrupa. Se sirve en cuanto esta máquina corre el agente: install lo deja como servicio que arranca con el equipo (en Linux, sudo lnkstart install, que corre como tú y no se para al cerrar la sesión; en macOS, sin sudo). list enseña las aplicaciones.
En tu máquina
lnkstart up lnkstart up web lnkstart down web lnkstart app=3000 lnkstart remove app lnkstart uninstall
up publica lo guardado sin instalar nada; up y down llevan el nombre de una aplicación o de un servicio; la cuarta forma publica algo suelto mientras la dejes abierta.
Con un paquete .deb o .rpm
En Debian, Ubuntu, Raspberry Pi OS, Fedora o RHEL, el binario también se instala como paquete. Sólo deja /usr/bin/lnkstart: el servicio lo pone sudo lnkstart install, como en cualquier Linux. Cambia x86_64 por aarch64 en un ARM de 64 bits, o por armv7 en una Raspberry Pi con sistema de 32 bits.
En tu máquina
curl -fsSLO https://lnkstart.com/ releases/ latest/ lnkstart-linux-x86_64.deb sudo apt install ./ lnkstart-linux-x86_64.deb
En Fedora o RHEL, el .rpm con sudo dnf install. Los paquetes van en el SHA256SUMS firmado de cada publicación. Después, lnkstart join <código> app=3000 --install, que une, publica y la deja como servicio.
En un NAS o con Docker
La imagen lnkstart/lnkstart trae sólo el binario, para amd64, arm64 y armv7, y no corre como root. Va con la red del anfitrión (--network host), para que 127.0.0.1 sea el propio equipo, y guarda su configuración en un volumen montado en /config.
En el NAS
docker run --rm -v lnkstart:/config lnkstart/ lnkstart join LD1.xxxxx docker run --rm -v lnkstart:/ config --network host lnkstart/ lnkstart add app=3000 docker run -d --name lnkstart --restart unless-stopped -v lnkstart:/ config --network host lnkstart/ lnkstart
Los dos primeros se unen y guardan; el tercero lo deja publicando y vuelve solo tras reiniciar. Para añadir o quitar algo después, otro docker run --rm con add o remove, y docker restart lnkstart. En Synology, Container Manager la encuentra buscando lnkstart en el registro: ponle la red del anfitrión y un volumen en /config.
Limitar lo que una máquina puede publicar
En el VPS
sudo lnkstart server join-code oficina --names nas,camaras sudo lnkstart server join-code becario --names 'dev-*'
Sin --names, esa máquina puede publicar cualquier nombre libre.
Un nombre es de la máquina que lo publicó, y de las que creaste «igual que» ella (en «Varias máquinas para lo mismo»): ningún otro código puede quitárselo.
Ver y quitar máquinas
En el VPS
sudo lnkstart server token list sudo lnkstart server token revoke oficina sudo lnkstart server services list
token list dice cuál está conectada, cuál espera tu aprobación y cuándo caduca un código sin usar. Al revocar, esa máquina se queda fuera en menos de 30 segundos.
Quitar LnkStart de una máquina
En tu máquina
lnkstart uninstall rm -r ~/.config/ lnkstart rm "$(command -v lnkstart)"
Quita el servicio, lo guardado (el servidor, su credencial y services.toml) y el binario. Si lo instalaste con sudo, sudo delante de la primera línea y de la última.
Su credencial sigue valiendo en el servidor hasta que la revoques (arriba): hazlo si no vas a volver a unirla.
Ver qué está pasando ahora mismo
En el VPS
sudo lnkstart server status
Qué servicios hay, cuál sirve cada máquina, por qué transporte y desde cuándo, cuántas visitas hay en curso y cuánto le queda a la licencia. DOWN es que el visitante no ve la app: o no hay máquina, o la hay y la app no contesta, y la línea dice cuál. Si el servidor está parado, lo dice en la primera línea en vez de enseñar datos viejos.
Comprobar lo que descargas
En tu máquina
lnkstart verify-release --manifest SHA256SUMS
Cada publicación lleva un SHA256SUMS firmado. Descarga SHA256SUMS y SHA256SUMS.sig en la misma carpeta y ejecuta esto ahí; con --file y el nombre del binario que has bajado, comprueba también su suma. El instalador comprueba la firma solo, antes de instalar: con el LnkStart que ya tengas o, la primera vez, con OpenSSL (el de macOS no sabe, y ahí se queda en la suma).