🗼 Faros — El Casamentero Soberano

XionIA Kernel — Los faros presentan pares, prestan STUN y sostienen el blind relay de respaldo. Jamás ven contenido, jamás guardan nada, y cuando el túnel se establece, desaparecen del camino.


¿Qué es un Faro?

Un faro es un servidor que:

La doctrina del faro

El faro es escalera, no andimio. Presenta a los pares, los ayuda a encontrarse — y cuando el túnel ICE se establece, sale del camino. Verificado en producción: 20 minutos de conversación directa entre dos nodos con el faro caído. El círculo ya constituido no lo necesita.

Protocolo del faro

Comando Descripción
ANNOUNCE <DID> <ts> <sig> Registro DID → dirección (verificación de firma Ed25519, anti-spoofing)
ACK_IP Confirmación de registro — y detección de roaming: si tu IP pública cambió, el kernel re-ANNOUNCE
ICE_INFO <target> <sender> <b64> Forward de señalización ICE entre pares (opaco para el faro)
RELAY <target> <sender> <payload> Blind relay: transporta ciphertext, nada más
STUN (RFC5389) Binding requests/responses en el mismo puerto — STUN soberano

Todo mensaje al faro lleva padding aleatorio de 50–200 bytes (anti-DPI): un ANNOUNCE y cualquier otro paquete tienen el mismo aspecto en el wire.


Tu propio faro: la guía completa

No requiere permiso, registro, ni aprobación. El binario es tuyo, el puerto es tuyo, la máquina es tuya. Si tenés un Linux con un puerto UDP abierto, tenés un faro.

Requisitos

El caso común: tenés IP pública en casa

Si tu ISP te da IP pública (fijate en el router: WAN empieza con tu IP real y no con 100.64.x.x o 10.x.x.x):

1. Reenvío de puertos en el router (port forwarding):

Admin del router → NAT / Virtual Server / Port Forwarding:
  Puerto externo 3478 UDP → IP local del faro :3478
  Puerto externo 3479 UDP → IP local del faro :3479
  Puerto externo 8443 TCP → IP local del faro :8443  (opcional, WSS)

2. IP fija para el cacharro del faro (que el DHCP no te la cambie):

Admin del router → DHCP → Reserva de dirección → IP local del faro

3. Compilar y levantar:

git clone https://github.com/mamanga1/xionia-kernel
cd xionia-kernel && go build -o faro-server ./cmd/faro-server/
./faro-server -udp 3478 -wss 8443

4. Habilitar el firewall del host (si tiene):

sudo ufw allow 3478/udp
sudo ufw allow 3479/udp
sudo ufw allow 8443/tcp   # solo si usás WSS

5. Que sobreviva a los reinicios (systemd):

# /etc/systemd/system/faro.service
[Unit]
Description=XionIA Faro (signaling + STUN, amnésico)
After=network.target

[Service]
Type=simple
User=xionia
WorkingDirectory=/opt/xionia/faro
ExecStart=/opt/xionia/faro/faro-server -udp 3478 -wss 8443
Restart=always
RestartSec=5

# Hardening: el faro no toca nada más
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
sudo systemctl enable faro
sudo systemctl start faro

6. Los nodos se conectan a tu faro:

xion@nodo:~$ faro <TU_IP_PUBLICA>:3478

En la APK de SanJorge: nubecita → TU_IP:3478. Queda persistida en faros.json y se auto-conecta en cada apertura. También entra por QR.

IP dinámica (cambia sola cada tanto)

Pedile al router DDNS (No-IP, DuckDNS — la mayoría lo trae adentro) y compartís el dominio (mi-faro.duckdns.org:3478) en vez de la IP.

Sin IP pública (CGNAT)

La mayoría de las conexiones móviles y muchas residenciales vienen detrás de CGNAT — no hay reenvío de puerto posible. Opciones:

  1. Un VPS (Oracle tiene capa gratuita — cualquier Linux chico sirve): abrís 3478/3479/8443 en el firewall del VPS y listo, mismo procedimiento
  2. Un amigo con IP pública que te preste 10W de un enchufe
  3. Contactanos — la instalación del faro es parte del servicio del proyecto: se configura el router, se levanta el faro y queda andando

El CGNAT no impide los túneles — pion/ice lo perfora (validado en producción con el CGNAT de Claro, 4G). Solo complica hostear el faro.

¿Cuánto banco?

10.000 nodos ≈ 1.3 Mbps y 10 MB de RAM. Un Raspberry Pi alimenta un pueblo entero. La entrada del registry son ~100 bytes en RAM: el faro es amnésico por diseño, no por escasez. Con una Netbook, de esas de bajo consuo 24/7 de 4gb de RAM podes tener sin despeinarte 100.000 nodos trabajando.


El faro semilla

Los binarios vienen con un faro semilla para que la primera conexión sea plug-and-play — después, cada quien apunta al suyo:

Nombre Dirección STUN WSS Operador
Faro semilla (kati) 190.220.45.26:3478 ✅ (RFC5389, mismo puerto) 8443 mamanga1 · Corrientes, Argentina

El faro semilla es escalera de arranque, no dependencia: cambiás al tuyo con un comando y quedás fuera de la infraestructura ajena. Ese es el diseño.


Preguntas Frecuentes

¿El faro puede ver mis mensajes? No. Tres razones apiladas: lo que transporta es ciphertext (ChaCha20), no tiene las claves (nunca salieron de tu dispositivo), y cuando hay túnel directo el tráfico ni pasa por él. Verificable con tcpdump: el faro solo ve QUÉ puertos hablan, jamás QUÉ dicen.

¿Qué pasa si el faro se cae? El círculo ya constituido sigue hablando directo (verificado: 20 min). Los mensajes a nodos que están detrás de relay se pierden hasta que el faro vuelva o se cambie a otro. No hay pérdida de datos del faro porque no hay datos en el faro — es amnésico.

¿Puedo correr un faro en mi casa? Sí — esa es la idea. IP pública (o DDNS), reenvío del 3478/udp, tres comandos. Una TV Box con 1GB alcanza.

¿Necesito permiso para levantar un faro? No. No hay registro central de faros, no hay autoridad que apruebe. La soberanía es eso.

¿El faro se satura? 10.000 nodos = 1.3 Mbps. Y la carga baja sola cuando los pares conectan directo: el faro es escalera, no andamio — el tráfico directo no pasa por él.

¿Por qué UDP y no TCP? UDP es más eficiente para señalización y STUN (sin handshake, sin control de flujo). WSS (TCP) existe como fallback para redes que bloquean UDP (firewalls corporativos, algunas VPNs).

¿Por qué el STUN en el mismo puerto que la señalización? Un solo puerto para todo el casamiento: menos superficie, menos reglas de firewall, menos para explicar. Y el STUN es soberano — derivado del propio faro, jamás Google ni terceros hardcodeados.

¿Federación? Es la evolución planificada: múltiples faros interconectados para escalar sin puntos únicos de fallo. Jamás una DHT global — la burocracia descentralizada no es soberanía, es trámite.


Última actualización: Octubre de 2026 — xionia-kernel v9.1 en producción_