Wiki de xBNC — La nueva generación de bouncers IRC Wiki v1.0.0

Wiki Referencia

Referencia

IRCv3, el informe de pruebas, la arquitectura, el modelo de amenazas, el rendimiento y el entorno de pruebas.

IRCv3

xBNC negocia con cada servidor las capacidades que ofrece y le interesan, y ofrece a cada cliente las suyas. A cada cliente solo le llega lo que ha pedido: un cliente clásico recibe los mensajes de siempre (por ejemplo, el JOIN corto y solo el rango más alto en la lista de usuarios).

Con los servidores

CapacidadPara qué
server-timeHora real de cada mensaje.
message-tagsEtiquetas en los mensajes.
multi-prefixTodos los rangos de un usuario (@+), no solo el más alto.
extended-joinLas entradas llevan la cuenta y el nombre real.
away-notifyAvisos cuando alguien se marca como ausente o vuelve.
account-notifyAvisos cuando alguien se identifica o deja de estarlo.
account-tagCada mensaje indica la cuenta de quien lo envía.
chghostCambios de usuario o host sin salir y entrar.
userhost-in-namesLa lista de usuarios con nick!usuario@host.
invite-notifyInvitaciones a otras personas en tus canales.
setnameCambios de nombre real.
cap-notifyEl servidor añade o quita capacidades en caliente.
saslIdentificación SASL (PLAIN y EXTERNAL hacia el servidor; PLAIN desde los clientes).

Con los clientes

CapacidadPara qué
server-timeHora real de cada mensaje.
message-tagsEtiquetas en los mensajes.
echo-messageTus propios mensajes vuelven confirmados por el servidor.
batchGrupos de mensajes (historial, reproducción).
saslIdentificación SASL (PLAIN y EXTERNAL hacia el servidor; PLAIN desde los clientes).
draft/chathistoryEl cliente pide el historial que necesita (CHATHISTORY).
draft/event-playbackEl historial incluye entradas, salidas, kicks y cambios de nick como eventos reales.
draft/read-markerMarcadores de lectura compartidos entre dispositivos.
soju.im/bouncer-networksTodas tus redes en una sola conexión.
soju.im/bouncer-networks-notifyAvisos de cambios en tus redes.
extended-joinLas entradas llevan la cuenta y el nombre real.
away-notifyAvisos cuando alguien se marca como ausente o vuelve.
account-notifyAvisos cuando alguien se identifica o deja de estarlo.
account-tagCada mensaje indica la cuenta de quien lo envía.
chghostCambios de usuario o host sin salir y entrar.
multi-prefixTodos los rangos de un usuario (@+), no solo el más alto.
userhost-in-namesLa lista de usuarios con nick!usuario@host.
invite-notifyInvitaciones a otras personas en tus canales.
setnameCambios de nombre real.
cap-notifyEl servidor añade o quita capacidades en caliente.

Con CAP LS 302 se anuncia sasl=PLAIN. Si el servidor no admite una capacidad que pide un cliente, xBNC la ofrece igual cuando puede construirla él (por ejemplo, el JOIN extendido con los datos que conoce). El informe para pruebas recoge, por red, lo que ofrece el servidor (caps_offered), lo que xBNC activó (caps_acked) y lo que pidió cada cliente.

Informe para pruebas

En Tu cuenta → Informe para pruebas → Descargar informe (o GET /api/v1/diagnostics) se descarga un JSON con lo que hace falta para diagnosticar un problema con una red, sin contraseñas, mensajes, nicks de otras personas ni IPs de tus dispositivos.

CampoContenido
report, formatxbnc-diagnostics, versión 1 del formato.
version, brandVersión de xBNC y «xBNC v1.0.0 - https://xbnc.org».
os, arch, databaseSistema, arquitectura y base de datos (sqlite o postgresql).
started_at, generated_atCuándo arrancó xBNC y cuándo se generó el informe.
timezone, languageTu zona horaria e idioma.
countersContadores del servidor (tráfico, mensajes, reconexiones, logins).
networks[]Por red: name, host, port, tls, enabled, si tiene SASL o contraseña de servidor, saved_channels, modules y plugins activos, y live.
networks[].livestate, server, network_name, connected_since, last_error, caps_offered, caps_acked, isupport, services_logged_in, host_hidden, channels_joined y clients (dispositivo y capacidades de cada uno).

Arquitectura

xBNC es un único programa (xbncd) con el panel incluido. El código se divide en crates/xbnc-proto (protocolo IRC sin E/S: parser y serializador con etiquetas IRCv3, prefijos, casemapping, ISUPPORT y CTCP) y crates/xbncd (servicio, CLI, API y panel), más los SDK de plugins en sdk/, el panel (React y TypeScript) en web/ y las traducciones en locales/.

Cómo trabaja por dentro

  • Cada red de cada usuario es una tarea independiente que posee en exclusiva su conexión con el servidor, el estado de la red y la lista de clientes. Nadie más toca ese estado: no hay bloqueos en el camino de los mensajes.
  • Cada cliente es una tarea de lectura y otra de escritura, con una cola acotada. Si un cliente no lee, se le desconecta en vez de acumular memoria; al volver recupera lo pendiente.
  • El panel, la API y la terminal nunca tocan las conexiones IRC: escriben en la base de datos y envían órdenes a las tareas de red (estado, control, entrar, salir, recargar, desconectar un cliente, alerta, aviso a todos).
  • Todo acceso a la base de datos va por un grupo de hilos aparte. Los mensajes de todas las redes pasan por un único hilo escritor que guarda en una sola transacción todo lo que espera (hasta 512), conservando el orden de cada red.
  • Los módulos son código del propio programa, llamados en puntos concretos (línea del servidor, comando de un cliente, temporizador, conexión, cliente que entra o sale). Los plugins reciben los eventos desde la tarea de red y se ejecutan en el grupo de hilos bloqueante.
  • Al llegar un mensaje: se interpreta, se actualiza el estado (nick, canales, miembros, modos, tema), se guarda con la hora del servidor y un identificador, y se envía a cada cliente adaptado a sus capacidades.
  • Los textos se buscan por clave en los idiomas cargados (los incluidos y los ficheros de locales_dir), con el inglés como respaldo.

Módulos del código

Módulo (crates/xbncd/src)Qué hace
main.rsEl comando xbncd: el servicio y la línea de comandos (usuarios, redes, copias, importación, idiomas, versiones, actualizaciones).
configLectura y validación de xbnc.toml.
db, sqlAlmacenamiento: migraciones versionadas, usuarios, redes, canales, mensajes, cursores, auditoría y copias; sql da a SQLite (rusqlite) y a PostgreSQL la misma interfaz.
cryptoArgon2id, cifrado XChaCha20-Poly1305 de las credenciales guardadas y un tipo Secret que nunca se imprime.
authEl formato de login, la comprobación de contraseñas, el limitador de fuerza bruta y el enmascarado de líneas en los logs.
utilCodec de líneas IRC (límite de longitud, UTF-8 con pérdida, protección contra inyección de CR/LF) y funciones de tiempo.
network/La tarea de cada red de cada usuario: conexión con el servidor IRC, estado, historial y clientes vinculados. mods.rs y extra.rs tienen el comportamiento de los módulos, status.rs y status_more.rs los comandos *status, *notes y *watch, plugins.rs entrega los eventos a los plugins, dcc.rs decide qué ofertas DCC pasan por xBNC y readmark.rs guarda las marcas de lectura.
downstream, bouncer, eventsConexiones de clientes: registro, CAP, SASL, PASS y reenvío a la tarea de la red; soju.im/bouncer-networks; avisos a los clientes cuando cambia una red.
modulesCatálogo de módulos, esquema y validación de sus ajustes y configuración tipada por red.
performConvierte comandos al estilo del cliente (/msg, /mode…) en IRC, para los comandos al conectar, los alias y las tareas programadas.
logsRegistros en ficheros, escritos en un hilo aparte.
certsCertificados de cliente (generación, validación y huellas) y certificados de servidor de confianza.
fishCifrado FiSH: Blowfish ECB y CBC y el intercambio de claves DH1080.
i18nIdiomas: inglés y español incluidos y los ficheros de locales_dir.
netinfoDirecciones de la red local y la dirección que se muestra para 0.0.0.0.
server, haContexto compartido, registro de tareas de red, puertos TLS, mantenimiento y recarga; alta disponibilidad activo/en espera con PostgreSQL.
rbac, settingsLos cinco roles y sus permisos; ajustes de historial y límites editables en caliente (base de datos sobre xbnc.toml).
totp, webauthn, ssoVerificación en dos pasos (RFC 6238), passkeys, OpenID Connect y LDAP.
tzZonas horarias con horario de verano, con la base de datos incluida.
metrics, alertsContadores de tráfico y mensajes, memoria y CPU del proceso; reglas de alerta comprobadas cada 30 s, con avisos en el panel, por IRC y por webhook.
notify, pushAvisos por Telegram, Discord, correo, una dirección web propia y Web Push.
plugins, plugin_dev, catalogPlugins WebAssembly: manifiesto, validación, motor Wasmi con límites, instancias y acciones; modo desarrollo; el catálogo incluido y el remoto firmado.
dccLectura y reescritura de ofertas DCC y los túneles de un solo uso.
httpCliente HTTP/1.1 mínimo (TLS verificado, tamaño y tiempo acotados) para webhooks, avisos, plugins con acceso web y la comprobación de versiones.
updates, releaseAviso de versiones nuevas, descarga y comprobación de paquetes, el ayudante xbncd apply-update y las firmas Ed25519.
backupCopias de seguridad desde el panel y su restauración.
importMigración desde otro bouncer: lectura de su configuración, datos de módulos, plan, aplicación en una transacción e importación de registros.
web/Servidor HTTP (axum): API /api/v1, WebSocket, sesiones, CSRF, cabeceras y los ficheros del panel incluidos en el binario.

El panel (web/) es una aplicación React y TypeScript compilada con Vite. web/dist se incluye en el binario, así que xBNC sigue siendo un único fichero. Los plugins oficiales también van dentro del binario (crates/xbncd/catalog/).

Máquinas de estado

Se mantienen separadas:

  1. Conexión con la red: Disconnected → Registering → Connected. Durante el registro, xBNC negocia las capacidades IRCv3, SASL y el nick (con alternativa si está ocupado). Tiempos: 30 s para conectar, 60 s para registrarse, PING tras 90 s de silencio y desconexión a los 180 s. Reconexión con esperas crecientes de 5 s a 5 minutos con una variación aleatoria de ±20 %, y al menos 2 minutos tras un aviso de throttling. Si un servidor falla y la red tiene servidores de reserva, se prueba el siguiente al cabo de 1 segundo.
  2. Sesión de cliente: registro (CAP, PASS o SASL, NICK, USER) con tiempo límite, y después una sesión vinculada a una red.
  3. Usuario y bouncer: qué tareas de red existen y cuántos clientes tiene cada usuario.

El camino de un mensaje

  1. La tarea de la red lee una línea del servidor y la analiza.
  2. Actualiza el estado (nick, canales, miembros, modos, tema).
  3. Si es un PRIVMSG, NOTICE o ACTION de alguien (o un evento, con el módulo Eventos), lo guarda en messages con la hora del servidor (server-time) o la local, y le da el identificador msgid = x<id>.
  4. Lo envía a cada cliente vinculado adaptado a sus capacidades (quitando las tags que el cliente no pidió) y avanza el cursor de cada cliente.

Lo que envía un cliente va al servidor, se guarda como saliente y se reenvía al resto de clientes del usuario (y al propio emisor si pidió echo-message).

Historial sin duplicados

  • Cada dispositivo (@dispositivo en el login, default si no se indica) tiene un cursor por red en client_cursors: el identificador del último mensaje entregado.
  • Al conectar, recibe los mensajes posteriores a su cursor (hasta playback_max, 1.000 por defecto). Un dispositivo nuevo recibe los new_client_playback más recientes (100 por defecto).
  • Los cursores se guardan al desconectar el dispositivo y cada 5 segundos; nunca retroceden.
  • Los clientes con draft/chathistory no reciben reproducción automática: piden lo que necesitan con CHATHISTORY. Los mensajes ya leídos en otro dispositivo (draft/read-marker) no se vuelven a reproducir.

Esquema de la base de datos

TablaContenidoDesde la migración
usersUsuario, hash Argon2id, rol, límites y cuotas, secreto TOTP cifrado, idioma, zona horaria, dirección de salida, último acceso y última conexión.1 (2, 4, 8, 9, 10)
networksServidor, puerto, TLS, nick, SASL, comandos al conectar, certificado de cliente, servidores de reserva y certificados de confianza; contraseñas y claves cifradas.1 (3, 4, 10)
channelsCanales guardados por red, con clave cifrada, retención, desactivado y posición.1 (8, 10)
messagesHistorial: red, conversación, hora, emisor, comando, texto, saliente y mención.1 (8)
client_cursorsÚltimo mensaje entregado por red y dispositivo.1
audit_logAcciones administrativas.1
web_sessionsSesiones del panel (hash del token, CSRF, IP, navegador, caducidad).2
settingsAjustes cambiados desde el panel.2
login_eventsIntentos de acceso por IRC y en el panel (10.000 como máximo).2
module_configMódulos por red: activo y ajustes en JSON validado.4
notesNotas de cada usuario.4
messages_ftsÍndice de texto completo de messages.text, mantenido con triggers (SQLite; PostgreSQL usa su propia búsqueda de texto).5
api_tokensTokens de API: hash SHA-256, prefijo, alcance, caducidad, último uso e IP.6
pluginsPlugins instalados: manifiesto, SHA-256, tamaño, activo en el servidor, dominios web aprobados y el propio módulo.7 (8)
plugin_configPlugins por red: activo, ajustes y estado guardado.7
plugin_kvAlmacén clave-valor de cada plugin por red.8
notify_settingsAjustes de avisos de cada usuario.8
push_subscriptionsSuscripciones Web Push de los navegadores de cada usuario.8
read_markersÚltimo mensaje leído de cada conversación.8
passkeysPasskeys: credencial, clave pública, contador, nombre y último uso.8
user_identitiesIdentidades externas (OpenID Connect, LDAP) vinculadas a usuarios locales.8

PostgreSQL tiene el mismo esquema; se admite desde la versión 8 del esquema (PG_MIGRATIONS) y cada migración nueva se añade a las dos listas. Los eventos de canal (JOIN, PART…) se guardan en messages con su comando. Las contraseñas importadas de otro bouncer con SHA-256 se guardan como legacy-sha256$<hash>$<sal> hasta el primer acceso correcto, en el que se sustituyen por Argon2id. Las migraciones se aplican al arrancar dentro de una transacción, y un binario se niega a abrir un esquema más nuevo del que conoce.

Modelo de amenazas

Qué protege xBNC, de quién y con qué medida en cada punto. Es la guía para la auditoría externa y para revisar cada cambio.

Qué se protege

ActivoPor qué importa
Contraseñas de las cuentas de xBNCDan acceso a las redes, al historial y, a los administradores, al servidor entero.
Credenciales de red (SASL, contraseña de servidor, claves de canal, comandos al conectar, contraseñas de servicios, claves FiSH, certificados)Permiten suplantar al usuario en las redes.
Historial y registrosPrivados y canales: información personal.
Sesiones del panel y tokens de APIEquivalen a la contraseña mientras son válidos.
La clave secreta (secret.key)Descifra todas las credenciales guardadas.
La disponibilidad del servicioSi cae, los usuarios pierden mensajes y presencia.
La reputación de la IP del servidorTodas las conexiones salen de ella.

Quién puede atacar

ActorQué controlaQué intenta
Cualquiera en internetConexiones a los puertos de IRC, panel y DCCAdivinar contraseñas, agotar recursos, explotar el parser.
Alguien en una red IRCMensajes, CTCP, DCC, nombres de canal y nickInyectar comandos, que xBNC se conecte a redes internas, saturar el historial.
Un servidor IRC maliciosoTodo lo que llega por la conexión de una redLo anterior, más respuestas malformadas, líneas enormes y desconexiones en bucle.
Un usuario de xBNCSu cuenta, sus redes, módulos y pluginsLeer datos de otros, escalar a administrador, abusar del servidor.
Un administradorUsuarios y redes de otrosEscalar a superadministrador, cambiar ajustes globales.
El autor de un pluginEl código que instala un superadministradorSalir del aislamiento, leer datos, actuar sin permiso.
El autor de un fichero de idiomaUn fichero que un administrador copia en locales_dirMeter comandos IRC o HTML con los textos (se rechaza: se validan y se tratan como texto plano).
Una web maliciosaEl navegador de un usuario con sesiónCSRF, robo de sesión, secuestro del WebSocket.
Quien accede a las copias de seguridadLos .tar.gzCredenciales y conversaciones.

Fuera de alcance: quien ya es root en la máquina, el proveedor del servidor y los fallos del sistema operativo o de las redes IRC.

Conexiones de clientes IRC (6697/6667)

AmenazaMedida
Fuerza bruta de contraseñasBloqueo por IP compartido con el panel y los tokens; Argon2id; mismo coste para usuarios inexistentes.
Agotar conexiones o memoriaLímite global de conexiones, 16 sin autenticar por IP, clientes por usuario, tiempo de registro y colas acotadas.
Líneas enormes o binariasLímite de 8703 bytes por línea y UTF-8 con pérdida.
Inyección de comandos con CR/LFCualquier CR o LF corta la línea; los textos de módulos, plugins y ficheros de idioma se validan sin caracteres de control.
Texto plano en internetLos puertos sin TLS solo aceptan la red local o exigen insecure = true.
Credenciales en los registrosEnmascarado de PASS, AUTHENTICATE, OPER y mensajes a servicios en todos los niveles.

Conexiones a las redes IRC

AmenazaMedida
Suplantación del servidorTLS verificado con el almacén del sistema, sin opción para desactivarlo; un certificado de confianza solo acepta su huella SHA-256 exacta.
Respuestas malformadasParser propio sin unsafe, con tests y fuzzing.
Inundación del historialRetención configurable, eventos opcionales, colas acotadas; el módulo log descarta líneas si el disco no da abasto; ocultar canales inundados.
Desconexiones en bucleEspera progresiva con variación aleatoria y espera mínima tras avisos de throttling.
Expulsión por floodControl de ritmo en la salida.
Robo de la contraseña de serviciosEn redes sin NickServ nunca se envía en modo automático.

DCC

AmenazaMedida
Usar el bouncer para llegar a redes internas (SSRF)Ofertas hacia direcciones internas o puertos por debajo de 1024 rechazadas salvo permiso del usuario.
Hacer que xBNC se conecte a un terceroEn tus envíos solo se conecta de vuelta a la IP de tu dispositivo.
Puertos abiertos indefinidamenteUn puerto por oferta, una sola conexión, tiempo de espera, cierre por inactividad y límite de tamaño.
Robo de la transferenciaEn la recepción, el puerto solo acepta la IP del cliente.

Panel web y API

AmenazaMedida
CSRFToken CSRF en cabecera, cookie SameSite=Strict y comprobación de Origin.
XSSReact escapa todo el contenido; CSP sin scripts externos ni en línea; los textos de IRC nunca se interpretan como HTML; las traducciones son texto plano.
Robo de sesiónCookie HttpOnly y Secure; solo el SHA-256 del token en la base de datos; caducidad deslizante; cambiar la contraseña cierra las demás sesiones.
Secuestro del WebSocketComprobación de Origin, revalidación de la sesión cada 30 s y sin tokens de API.
Escalada de privilegiosPermisos comprobados en el servidor en cada ruta; nadie cambia su propio rol; siempre queda un superadministrador.
Ver datos de otros usuariosLas redes ajenas responden 404, no 403.
Abuso de la API y slowloris20 peticiones/s por IP, cuerpos acotados, 64 conexiones por IP y 4 096 en total, cierre tras 2 minutos sin tráfico, 10 s para el saludo TLS.
Tokens filtradosAlcance, caducidad, último uso e IP visibles, revocación inmediata, solo su SHA-256 guardado.
Primer acceso robadoCódigo de un solo uso, solo en el registro del servicio.
Webhook hacia sitios internosSolo lo configura un superadministrador; sin redirecciones, sin credenciales en la URL, 10 s como máximo.

Plugins

AmenazaMedida
Salir del aislamientoIntérprete Wasmi sin JIT, módulo validado al cargar, sin WASI ni más importaciones que las de xbnc, funciones avanzadas de WebAssembly desactivadas.
Bloquear o tumbar el servidorCombustible por evento, memoria limitada, ejecución que nunca hace crecer la pila nativa, llamadas en hilos aparte, parada tras cinco fallos.
Actuar sin permisoAcciones declarativas comprobadas contra los permisos; comandos peligrosos siempre prohibidos; máximo de mensajes por evento; acceso web solo a dominios aprobados y con límites.
Leer datos de otrosCada instancia solo recibe los eventos de su red; estado y almacén separados por red.
Fichero cambiado tras instalarloSe guarda su SHA-256 y no se carga si no coincide; ficheros 0600.
Plugin malicioso instaladoSolo un superadministrador instala, viendo permisos y huella; queda en la auditoría; catálogo remoto firmado.

Importación desde otro bouncer

AmenazaMedida
Fichero preparado para crear un superadministradorLa importación nunca concede ese rol.
Contraseñas débiles heredadasSHA-256 con sal comparado en tiempo constante y sustituido por Argon2id; los formatos no comprobables reciben una contraseña aleatoria.
Rutas o tamaños abusivosFichero de hasta 4 MB, anidamiento limitado, nombres validados; los registros solo se leen de las carpetas indicadas.
Fugas en la vista previaLa vista previa no incluye secretos.

Actualizaciones desde el panel

AmenazaMedida
Paquete falso (servidor de descargas, DNS o red comprometidos)Firma Ed25519 sobre el nombre del paquete y su SHA-256; la clave pública solo está en xbnc.toml, propiedad de root.
Volver a una versión con fallos conocidosSe rechazan las versiones iguales o anteriores a la instalada.
Un proceso xbnc comprometido que intenta instalar algo como rootEl ayudante (xbnc-update.service) no confía en nada de la carpeta del servicio: copia el paquete a /run (0700), comprueba la firma y la versión sobre esa copia, nunca sigue enlaces simbólicos, valida el nombre del fichero y usa cada petición una sola vez.
Petición de actualización falsaSolo superadministradores, desde una sesión del panel (no con tokens de API) y con CSRF; queda en la auditoría.
Descargas infinitas o redirecciones a texto plano200 MB y 10 minutos como máximo; solo https://, 5 redirecciones como máximo.

Datos guardados y copias de seguridad

AmenazaMedida
Robo de la base de datosCredenciales de red cifradas con XChaCha20-Poly1305; la clave fuera de la base de datos, con permisos 0600 comprobados al arrancar.
Robo de una copia de seguridadFichero 0600; incluye la clave, así que hay que guardarlo cifrado.
Acceso desde otros usuarios del sistemaServicio con el usuario xbnc sin privilegios, carpetas 0700 y hardening de systemd.

Riesgos aceptados

  • El historial se guarda sin cifrar en la base de datos: cifrarlo impediría la búsqueda y la reproducción. Lo protegen los permisos del sistema.
  • Los clientes IRC no tienen segundo factor: la contraseña del bouncer es su única protección (de ahí el bloqueo por IP y Argon2id).
  • Un superadministrador puede instalar un plugin con permiso para enviar mensajes en nombre de quien lo active: es una decisión de confianza que el panel muestra antes de instalar.
  • Todas las conexiones a las redes salen de la IP del servidor.
  • FiSH es criptografía antigua (Blowfish, sin integridad); los mensajes descifrados se guardan en el historial como el resto.

Revisión

Cada versión revisa estas tablas: una función nueva que abra una superficie que no esté aquí se añade a ellas. Los tests que respaldan cada medida están en crates/xbncd/tests/ y en los tests unitarios de cada módulo; el fuzzing cubre el parser IRC, DCC, el fichero de configuración importado, la búsqueda, y los manifiestos y la ejecución de plugins (ver Entorno de pruebas).

Revisión interna de la versión 0.7. Se revisó todo el código con estas tablas como guía (no sustituye a la auditoría externa):

  • Consultas SQL: todas con parámetros enlazados; las partes construidas con format! son solo listas de columnas y cláusulas fijas.
  • Autorización de la API: cada ruta comprueba la sesión o el token y el permiso; las rutas de redes comprueban el dueño. Corregido: PATCH /users/{id} respondía 404 o 403 a cuentas sin permiso según existiera el usuario.
  • Procesos externos: el único es dpkg o rpm en el ayudante de actualización, con argumentos fijos y el paquete ya comprobado.
  • Rutas de ficheros: registros, plugins y actualizaciones construyen rutas solo con nombres validados; el ayudante de actualización nunca sigue enlaces simbólicos.
  • Denegación de servicio: se añadieron el límite de conexiones IRC sin autenticar por IP, los límites de conexiones y el tiempo de inactividad del panel, y el límite de cálculos de Argon2id simultáneos.
  • Plugins: el intérprete pasó al modo de ejecución en bucle después de que el fuzzing encontrara que el modo de llamadas encadenadas podía agotar la pila nativa en compilaciones sin optimizar.
  • Código unsafe: solo una llamada a mallopt al arrancar (ajuste del asignador de memoria).
  • Dependencias: cargo-deny en el CI (licencias y avisos de seguridad).

Revisión interna de la versión 1.0. Se revisó el código nuevo de la 1.0 y se corrigieron tres puntos antes de publicar: en redes sin servicios nunca se envía la contraseña a quien use el nick «NickServ»; el intercambio de claves FiSH tiene límite de peticiones y de claves guardadas; el texto descifrado no puede romper líneas. Los ficheros de idioma se validan (marcadores, etiquetas, sin caracteres de control ni saltos de línea) y un texto que no pasa se muestra en inglés.

Rendimiento

Prueba de carga (cargo run --release --example loadtest -- --users 1000 --clients 1 --rate 2 --seconds 60): un servidor IRC simulado envía mensajes a todas las redes a la vez (el peor caso) y cada cliente mide cuánto tarda en recibirlos, pasando por el historial, los módulos y los plugins. Máquina: 2 vCPU Xeon a 2,1 GHz, 7 GB de RAM, disco en red, configuración por defecto (SQLite).

Usuarios y redesClientesMensajes/s entregadosCPU (de un núcleo)MemoriaLatencia p50 / p95 / p99Todas las redes de vuelta tras una caída
5005004925 %52 MB21 / 43 / 46 ms6,2 s
5005004 84743 %56 MB46 / 64 / 72 ms6,2 s
1 0001 0001 95117 %88 MB50 / 80 / 95 ms6,2 s
1 0002 0001 96811 %114 MB44 / 66 / 78 ms6,2 s
2 0002 0001 96819 %153 MB75 / 141 / 155 ms6,3 s
  • Ningún mensaje se perdió en ninguna prueba.
  • La latencia sube con el tamaño de la ráfaga: con 2 000 redes recibiendo el mismo mensaje a la vez, el último se entrega unos 150 ms después que el primero. Con tráfico real, repartido en el tiempo, es de pocos milisegundos.
  • Memoria: unos 45 KB por red conectada y unos 30 KB más por cliente, sin contar el historial (en disco).
  • Los logins de clientes (Argon2id) van de uno en uno por CPU: 2 000 clientes entrando juntos tardan unos 27 s en 2 núcleos, sin disparar la memoria.
  • Disco: unos 150 bytes por mensaje guardado, con el índice de búsqueda.

Para dimensionar: un servidor pequeño (1–2 vCPU, 1 GB de RAM) atiende cientos de usuarios con varias redes y miles de mensajes por segundo. Con muchos usuarios, revisa limits.max_connections, LimitNOFILE del servicio (65 536 por defecto) y la retención del historial.

Cómo se mide

La prueba (crates/xbncd/examples/loadtest.rs) arranca en un solo proceso:

  • un servidor IRC simulado con un canal #xbnc;
  • xBNC con N usuarios, cada uno con su red conectada a ese servidor y dentro de #xbnc;
  • uno o varios clientes IRC por usuario conectados a xBNC.

El servidor envía --rate mensajes por segundo al canal, a todas las redes a la vez (el peor caso: ráfagas simultáneas). Cada mensaje lleva la hora de envío y cada cliente mide cuánto tarda en llegar: servidor IRC → xBNC (guardado en el historial, módulos, plugins) → cliente. Al final el servidor corta todas las conexiones y la prueba mide cuánto tardan todas las redes en volver.

La memoria y la CPU son las del proceso completo, así que incluyen el servidor simulado y los clientes de la prueba (xBNC solo consume algo menos). La compilación es --release con la configuración por defecto (historial en SQLite con WAL).

Problemas encontrados y corregidos con esta prueba

ProblemaAntesDespués
Memoria tras muchas entradas simultáneas: glibc guardaba en cada hilo los 19 MB de cada cálculo de Argon2id.1.680 MB con 500 clientes55 MB (util::tune_allocator, umbral fijo de mmap)
Cientos de cálculos de Argon2id a la vez (también útil contra avalanchas de intentos de entrada).Sin límiteUno por CPU (crypto::with_hash_slot)
Una transacción de SQLite por mensaje guardado.p50 70 ms y 13 % de CPU con 500 redesp50 21 ms y 5 % de CPU: un único hilo escritor guarda en una sola transacción todo lo que espera (Db::insert_message)

Pendiente

  • Repetir la prueba en hardware dedicado y con varias redes por usuario.
  • Medir con servidores IRC reales a distancia (la prueba usa uno local, sin latencia de red).

Para repetirla: cargo run --release --example loadtest -- --users 2000 --clients 1 --rate 1 --seconds 60. Las opciones son --users, --clients (por usuario), --rate (mensajes por segundo al canal) y --seconds.

Entorno de pruebas

Con Docker

testenv/ levanta xBNC con dos servidores IRC distintos (Ergo e InspIRCd) en una red aislada, todo en texto plano a propósito:

cd testenv
docker compose up -d --build
./setup.sh
# IRC: localhost:6667, contraseña test/ergo@laptop:testpassword1
# Panel: http://localhost:8080 (usuario test, contraseña testpassword1)

No publiques esos puertos en una interfaz pública.

Tests automáticos

cargo test --workspace                                   # todos los tests
XBNC_TEST_POSTGRES=postgres://postgres@127.0.0.1/postgres cargo test --workspace   # también con PostgreSQL
cargo clippy --workspace --all-targets -- -D warnings
cd web && npm run build && npm run i18n:check            # panel y traducciones
xbncd locales check locales/*.json                       # ficheros de idioma
python3 ../xbnc-wiki/build.py --app .                   # la wiki (proyecto aparte)

Incluyen el protocolo, las unidades, la API contra un bouncer real, IRC de extremo a extremo, todos los comandos de *status, el cambio a un servidor de reserva, el certificado de confianza con un saludo TLS real, un idioma añadido como fichero, módulos y plugins contra un servidor IRC simulado, el panel, SSO y servidores IRC reales en el CI (Ergo, InspIRCd, UnrealIRCd, Solanum y miniircd). El fuzzing (fuzz/) se ejecuta cada semana. testenv/ui/language_check.py comprueba en un navegador real que todas las formas de cambiar el idioma funcionan.

Pruebas en redes reales

El plan de pruebas por red, módulo y plugin está en testenv/real/PLAN.md. Ver Probar la beta.

Los conjuntos de tests

ConjuntoDóndeQué cubre
Protocolo (16)crates/xbnc-protoParser y serializador, escapado de tags, prefijos, casemapping, ISUPPORT, CTCP.
Unitarios del servicio (159)crates/xbncd/srcConfiguración, Argon2id, cifrado y permisos de la clave, base de datos y migraciones (SQLite y PostgreSQL, y actualización de un esquema antiguo), historial y búsqueda, cursores, sesiones, copias, login, limitador de fuerza bruta, enmascarado de logs, codec, CAP, roles, ajustes, TOTP (vectores del RFC 6238), métricas, tokens, cookies, origen, IP tras un proxy, cobertura de OpenAPI, redirección HTTP→HTTPS, catálogo y validación de módulos, globs, menciones, alias, registros, certificados de cliente y de confianza (con un handshake TLS real), FiSH, zonas horarias, idiomas (todas las claves usadas existen, español completo, ficheros comprobados y cargados), plugins (permisos, límites, regresiones del fuzzing), DCC, cliente HTTP, firmas de versiones, el ayudante de actualización y límites de conexiones, para qué nombres es válido un certificado TLS, y la dirección del panel que se muestra al instalar, y los textos del instalador (completos en inglés y en español, comprobados en cualquier fichero de idioma, y que existe cada clave que usan los scripts).
API (13)tests/api.rsPrimera instalación con código de un solo uso, login, sesiones, CSRF, origen, cabeceras, fuerza bruta, redes, canales, historial, exportación, aislamiento entre usuarios, roles, ajustes en caliente, 2FA, panel, OpenAPI, módulos, certificados, notas, idioma, tokens, métricas, alertas, importación y plugins.
Extremo a extremo (16)tests/e2e.rsEl bouncer completo contra un servidor IRC simulado (escenarios abajo).
Módulos (18 + 12)tests/modules.rs, tests/modules_v1.rsCada módulo contra el servidor simulado: ausente y resumen, recuperar nick, respuestas al dispositivo que pregunta, eventos, CTCP, canales fijos, alias, op automático, volver tras un kick, vigilar palabras, MOTD y registros; y los módulos de la 1.0: extras IRCv3 solo para los clientes que los piden, login en servicios (X con la IP oculta y Login on Connect), invitación, ignorar y quitar colores, FiSH en los dos sentidos y DH1080, canales desacoplados, canales inundados, recuperar op, Latin-1 y tareas programadas.
Comandos *status (12)tests/status_commands.rsAyuda agrupada, nombres de comandos de otros bouncers, servidores de reserva (añadir, saltar, promover y cambio automático), huellas de confianza, direcciones de salida, canales desactivados y ordenados, búferes, MOTD y avisos a todos, permisos, redes desde IRC y un idioma añadido como fichero.
Plugins (2 + 5 + 7)tests/plugins.rs, tests/plugins_v1.rs, tests/official_plugins.rsPlugins respondiendo en la red y al usuario, y cada plugin oficial: seen, trivia, greet, factoids, karma, quotes, games, badwords, acceso web solo a sitios aprobados, recordatorios, tell, encuestas, estadísticas, antiflood, dados y respuestas automáticas.
Puerto único (2)tests/shared_port.rsEl panel e IRC en un solo puerto TLS: un navegador recibe el panel, un cliente IRC el bouncer, http:// se envía a https:// y a un cliente IRC sin SSL se le pide activarlo.
Panel (3)tests/panel.rsChat en el panel, menciones e historial de canal, modo desarrollo de plugins y el catálogo de un clic.
SSO (3)tests/sso.rsPasskeys, OpenID Connect y LDAP.
Línea de comandos (2)tests/cli.rsxbncd info ejecutado como un proceso real: el panel en la dirección dada al instalar, y ningún error cuando su salida va a head.
PostgreSQL (1)tests/postgres.rsPaso de una base de datos SQLite a PostgreSQL (con XBNC_TEST_POSTGRES).
Servidor IRC real (1)tests/real_ircd.rsUn xBNC real contra un servidor IRC real (ver abajo).
SDK de Rust (3)sdk/rustEventos y respuestas del SDK.

Escenarios de extremo a extremo

  1. Al conectarse, el cliente recibe la bienvenida, el ISUPPORT de la red, sus canales, el tema y la lista de usuarios.
  2. Un mensaje recibido con el cliente cerrado se reproduce al reconectar, con su hora; los mensajes propios no se reproducen al mismo dispositivo y una tercera conexión no recibe duplicados.
  3. Dos dispositivos conectados a la vez se sincronizan; un dispositivo nuevo recibe el historial reciente.
  4. CHATHISTORY LATEST, AFTER y errores, batch, el server-time del servidor conservado, msgid y echo-message; no se anuncian capacidades no implementadas.
  5. Login con SASL PLAIN.
  6. Una contraseña incorrecta se rechaza y la IP se bloquea tras tres fallos, incluso con la contraseña correcta.
  7. Red inexistente: el error indica las redes disponibles.
  8. Caída del servidor: el bouncer avisa, reconecta con esperas crecientes y vuelve a entrar en los canales.
  9. *status, y PART y JOIN con clave guardados (la clave se guarda cifrada).
  10. Los comandos al conectar se envían antes de entrar en los canales.
  11. Las marcas de lectura se comparten entre dispositivos.
  12. soju.im/bouncer-networks para clientes modernos.
  13. Con /mode $nick +x en los comandos al conectar, ningún JOIN llega al servidor (canales guardados, los de los comandos, los del propio cliente) hasta que el servidor oculta el host (396).
  14. /msg *status joinnow entra en los canales retenidos.
  15. Una contraseña incorrecta recibe el formato correcto, y tras los fallos la dirección se bloquea indicando los minutos que quedan y dónde desbloquearla.
  16. La contraseña de ejemplo («TU_CONTRASEÑA») se explica y no bloquea la dirección.

Servidores IRC reales

tests/real_ircd.rs conecta un xBNC real a un servidor IRC real (variable XBNC_IRCD=host:puerto) y comprueba la lista de usuarios, los mensajes en los dos sentidos, la sincronización entre dos dispositivos, la reproducción sin duplicados con el cliente cerrado, el cambio de nick, salir de un canal y seguir conectado a la red:

XBNC_IRCD=127.0.0.1:6667 cargo test -p xbncd --test real_ircd -- --ignored

El CI lo ejecuta contra Ergo, InspIRCd, UnrealIRCd, Solanum y miniircd (testenv/ci/start-ircd.sh compila o instala cada uno con una configuración mínima).

Fuzzing

fuzz/ tiene seis objetivos de libFuzzer:

ObjetivoQué recibe
irc_messageLíneas IRC arbitrarias: parser, serializador y la vuelta atrás.
dccOfertas DCC.
import_configFicheros de configuración de otro bouncer.
search_queryConsultas de búsqueda contra el índice de texto completo.
plugin_manifestFicheros WebAssembly con manifiestos arbitrarios.
plugin_runtimeMódulos WebAssembly arbitrarios cargados y ejecutados como plugins.
cargo install cargo-fuzz          # necesita Rust nightly
cd fuzz && mkdir -p corpus/irc_message && cp seeds/irc_message/* corpus/irc_message/
cargo +nightly fuzz run irc_message corpus/irc_message -- -max_total_time=600

El CI (.github/workflows/fuzz.yml) ejecuta cada objetivo 20 minutos cada semana, conserva el corpus entre ejecuciones y antes comprueba que los fallos ya encontrados (fuzz/regressions/) siguen corregidos. Los fallos encontrados hasta ahora, todos corregidos y con su test:

  1. El parser aceptaba CR, LF o NUL dentro de una línea.
  2. El parser aceptaba comandos que no son alfanuméricos (@ @).
  3. Las ofertas DCC aceptaban caracteres de control.
  4. Incrustar un manifiesto desbordaba con secciones de tamaño imposible.
  5. Un plugin con un bucle largo agotaba la pila nativa del proceso en compilaciones donde el compilador no convierte en saltos las llamadas del intérprete: ahora el intérprete usa el modo de ejecución en bucle, que nunca hace crecer la pila.

Pruebas de carga

cargo run --release --example loadtest -- --users 2000 --rate 1 --seconds 60. Resultados y método en Rendimiento.

El panel en un navegador

El panel se ha recorrido en Chrome con Playwright contra un bouncer real con un cliente IRC conectado de verdad: primera instalación, asistente de redes, canales, historial y búsqueda, usuarios, seguridad, ajustes, 2FA, módulos, plugins (instalación con la vista previa de permisos, ajustes por red), importación desde otro bouncer, alertas, actualizaciones, copias, chat, la pantalla de entrada, los temas claro y oscuro y el móvil, en inglés y en español, sin errores en la consola salvo el 401 esperado antes de entrar. testenv/ui/language_check.py URL USUARIO CONTRASEÑA repite en un navegador real todas las formas de cambiar el idioma (pantalla de entrada, Tu cuenta, Ajustes, un idioma añadido como fichero) y comprueba que no queda ningún texto en otro idioma.

Lista de verificación manual

Úsala con testenv/ o con una instalación real:

  • El servicio arranca y para limpiamente (systemctl start y stop xbnc; en el log aparece xBNC stopped).
  • Se crean un administrador y varios usuarios con la línea de comandos.
  • Un usuario con dos redes está conectado a las dos a la vez.
  • Un cliente clásico (HexChat, WeeChat, irssi o mIRC) se conecta con usuario/red@dispositivo:contraseña.
  • Con el cliente cerrado, otra persona escribe en el canal y por privado; al reconectar esos mensajes llegan una sola vez.
  • Dos clientes del mismo usuario ven lo que escribe el otro.
  • docker compose restart ergo (o cortar la red): xBNC avisa, reconecta y vuelve a los canales.
  • /msg *status status muestra el estado correcto.
  • Cinco contraseñas incorrectas bloquean la IP durante 15 minutos.
  • scripts/backup.sh y scripts/restore.sh recuperan usuarios, redes e historial.
  • journalctl -u xbnc no contiene contraseñas tras hacer login, SASL y /msg NickServ IDENTIFY.
  • Desde el panel: crear un usuario, añadirle una red con el asistente, entrar en un canal y ver el historial.
  • Un usuario normal no ve Usuarios, Seguridad ni Ajustes, ni las redes de otros.
  • Activar la verificación en dos pasos y entrar con el código.
  • Cambiar la retención en Ajustes y comprobar en Sistema que se aplica sin reiniciar.
  • Consumo de memoria con 1 usuario y 2 redes (systemctl status xbnc): anótalo para comparar en versiones futuras.