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.
Un faro es un servidor que:
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.
| 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.
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.
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.
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.
La mayorÃa de las conexiones móviles y muchas residenciales vienen detrás de CGNAT — no hay reenvÃo de puerto posible. Opciones:
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.
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.
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.
¿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_