Despliegue de Faro
en VPS: Paso a Paso

Podés elegir cualquier empresa en la nube (Hetzner, DigitalOcean, Linode, Vultr, Contabo, etc.). Al momento de crearlo, elegí:

• Sistema Operativo: Debian 12 (Recomendado) o Ubuntu 22.04/24.04 LTS.
• Plan: El más económico (1 vCPU y 1 GB de RAM es más que suficiente).
• Tipo de red: Con dirección IPv4 pública fija.

Anotá la dirección IP y la contraseña o clave SSH que te asignen para el usuario root. Pegala en el personalizador de arriba.

En el panel de control web donde contrataste el VPS (sección Firewall o Security Groups), agregá las siguientes reglas entrantes:

⚠️ Nota: El puerto del panel web (8088 o 8090) NO se abre públicamente a internet. Tu PC se conectará a través de un túnel cifrado SSH.

Abrí una terminal (PowerShell en Windows o Bash en Linux/Mac) dentro de la carpeta com-org-faro de tu computadora y ejecutá:

ssh root@TU_IP_VPS "mkdir -p /tmp/faro"
scp instalar_debian.sh root@TU_IP_VPS:/tmp/faro/
scp -r bin_linux root@TU_IP_VPS:/tmp/faro/

(Si preferís usar una aplicación gráfica como WinSCP o FileZilla, conectate por SFTP como root y arrastrá instalar_debian.sh y la carpeta bin_linux dentro de /tmp/faro/).

1. Conectate por consola a tu servidor VPS:

ssh root@TU_IP_VPS

2. En la consola del servidor, ejecutá este comando unificado (genera el token e instala todo automáticamente):

cd /tmp/faro && chmod +x instalar_debian.sh && TOKEN=$(openssl rand -hex 32) && echo "=== TU TOKEN ES: $TOKEN ===" && sudo COMARG_ADMIN_TOKEN="$TOKEN" FARO_HOST="TU_IP_VPS" ./instalar_debian.sh

Guardá el TOKEN que se muestra en pantalla y pegalo en el campo superior de esta guía para los siguientes pasos.

Desde la terminal de tu computadora personal (en la carpeta com-org-faro), subí los certificados generados:

scp faros_emitidos/lighthouse/faro_lighthouse.crt root@TU_IP_VPS:/tmp/
scp faros_emitidos/lighthouse/faro_lighthouse.key root@TU_IP_VPS:/tmp/
scp ca_raiz/ca_raiz.crt root@TU_IP_VPS:/tmp/

Ahora, en la consola de tu servidor VPS, aplicá los certificados e iniciá Nebula:

sudo mkdir -p /etc/nebula
sudo install -m 0644 /tmp/faro_lighthouse.crt /etc/nebula/lighthouse.crt
sudo install -m 0600 /tmp/faro_lighthouse.key /etc/nebula/lighthouse.key
sudo install -m 0644 /tmp/ca_raiz.crt /etc/nebula/ca.crt
rm -f /tmp/faro_lighthouse.* /tmp/ca_raiz.crt
sudo systemctl enable --now comorg-nebula

Para administrar los nodos desde el panel web de tu PC sin exponer la seguridad a internet, abrí una terminal en tu computadora y dejá corriendo este comando:

ssh -N -L 8090:localhost:8090 root@TU_IP_VPS

(Mantené abierta esa ventana de terminal mientras quieras aprobar y administrar nodos).

1. En tu navegador, ingresá al panel local: http://localhost:8088

2. En la sección de vinculación o VPS colocá:

• Host: 127.0.0.1
• Puerto: 8090
• Token: (El token guardado en el Paso 4)

¡Listo! Tu Faro en VPS ya está operativo recibiendo conexiones seguras de tu comunidad.