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

xBNC 1.0.0

Tu IRC, siempre conectado.

Un bouncer IRC moderno para Undernet, Libera.Chat, Rizon, EvilNet, IRCnet y cualquier red. Esta wiki explica todo lo que hace y cómo usarlo, de la instalación a la API.

  • 24 módulos
  • 18 plugins
  • 85 rutas de API
  • 64 comandos de *status
HexChat — undernet
Conectando a bnc.ejemplo.org:6697 (TLS)…
*statusBienvenido a xBNC 1.0.0 Made by y2k. Red: undernet. Último acceso: hace 9 horas.
*statusMientras no estabas: 3 privados (bob, carol) y 2 menciones en #xbnc.
bob[02:14] y2k, ¿mañana a qué hora es la reunión?
carol[07:52] buenos días
y2k/msg *status version
*statusxBNC 1.0.0 Made by y2k

Qué es xBNC

xBNC es un bouncer IRC: un programa que se queda conectado a tus redes IRC las 24 horas, aunque cierres el cliente o apagues el ordenador. Cuando vuelves, te entrega lo que te perdiste, una sola vez en cada dispositivo.

Se instala en un servidor propio (un VPS, una Raspberry Pi, un ordenador de casa), se usa con tu cliente IRC de siempre y se configura entero desde un panel web, o desde IRC con /msg *status. Es un único programa escrito en Rust, con el panel incluido dentro.

24módulos nativos configurables por red
18plugins oficiales en WebAssembly
2+idiomas: inglés y español incluidos, y cualquier otro con un fichero de traducción

Qué incluye

  • Bouncer: conexión permanente a varias redes por usuario, con TLS verificado, SASL PLAIN y EXTERNAL, reconexión automática con espera progresiva y protección anti-flood hacia el servidor.
  • Varios dispositivos a la vez: lo que escribes en uno aparece en los demás, y cada uno lleva su propia cuenta de lo que ha leído.
  • Historial: canales y privados con búsqueda de texto completo, filtros, exportación en TXT y JSON, retención general y por canal, y cuotas por usuario.
  • IRCv3 completo con los servidores y con los clientes (lista completa); los clientes clásicos ven el IRC de siempre.
  • Chat web en el panel, vista de menciones y marcadores de lectura compartidos entre dispositivos.
  • Avisos de menciones y privados por Telegram, Discord, correo, una dirección web propia o notificaciones push del navegador y el móvil.
  • 24 módulos (login en servicios, ausente automático, op automático, cifrado FiSH, canales desacoplados, tareas programadas…) y 18 plugins ya instalados (trivial, encuestas, recordatorios, el tiempo…).
  • Multiusuario: cinco roles, cuotas, suspensión, auditoría, verificación en dos pasos, passkeys, OpenID Connect y LDAP.
  • Datos: SQLite o PostgreSQL, alta disponibilidad activo/en espera, copias de seguridad desde el panel o la terminal, migración desde otro bouncer.
  • Administración: panel web, API REST con tokens, WebSocket, métricas para Prometheus con panel de Grafana, alertas por panel, IRC y webhook.
  • Seguridad: Argon2id, credenciales cifradas, bloqueo de fuerza bruta, CSRF, CSP, servicio sin privilegios, plugins aislados y fuzzing continuo.

Cómo funciona

Cómo funciona xBNC Tus dispositivos se conectan a xBNC; xBNC mantiene una conexión permanente con cada red IRC y guarda el historial. Tus dispositivos Portátil · HexChat Móvil · Goguma Navegador · panel apagado: no pasa nada xBNC siempre conectado historial por dispositivo módulos y plugins panel web y API Redes IRC Undernet Libera.Chat Rizon IRCnet… TLS · usuario/red@dispositivo TLS · SASL · servicios

Tu cliente IRC ya no se conecta a la red, sino a xBNC. xBNC mantiene una conexión por red que no se corta cuando cierras el cliente, y se presenta ante cada dispositivo como si fuera el servidor de esa red.

  1. Te conectas con la contraseña de servidor usuario/red@dispositivo:contraseña. El nombre del dispositivo (@portatil, @movil) es opcional, pero permite que cada uno lleve su propia cuenta de lo que ha leído.
  2. xBNC te pone al día: entra contigo en tus canales, te envía el tema y la lista de usuarios, y reproduce los mensajes que llegaron desde tu última conexión en ese dispositivo, sin repetir lo que ya viste.
  3. Mientras no estás, xBNC sigue en los canales, guarda el historial, responde a CTCP, te marca como ausente y ejecuta tus módulos y plugins.
  4. Todos tus dispositivos están sincronizados: lo que escribes en el móvil aparece en el portátil, y los marcadores de lectura se comparten.

Qué recibes al conectar

  1. La bienvenida de xBNC con los parámetros (ISUPPORT) de la red real.
  2. El MOTD de la red (salvo que actives Ocultar el MOTD), seguido del nombre y la versión de xBNC.
  3. Los canales en los que estás, con su tema y su lista de usuarios.
  4. Los mensajes que este dispositivo no ha visto. Si el cliente no admite server-time, cada mensaje lleva delante la fecha y la hora entre corchetes.
  5. Si te perdiste privados o menciones, un resumen de *status (módulo Ausente automático).
  6. Si la red está desconectada, un aviso de *status con el motivo.
  7. El mensaje del día de este servidor, si un superadministrador lo ha puesto (/msg *status setmotd).

Historial sin duplicados

  • Cada dispositivo (el @nombre del login, o default si no pones ninguno) tiene un cursor por red: el último mensaje que se le entregó. Dos conexiones con el mismo nombre comparten cursor.
  • Al conectar recibe los mensajes posteriores a su cursor, hasta playback_max (1000 por defecto). Un dispositivo nuevo recibe los new_client_playback más recientes (100 por defecto).
  • Los cursores se guardan al desconectar y cada 5 segundos, y nunca retroceden. Si el proceso se corta de golpe, como mucho se repiten unos segundos.
  • Los clientes con draft/chathistory no reciben reproducción automática: piden lo que necesitan con CHATHISTORY (hasta chathistory_max, 500 por defecto).

Conexión con cada red

  • Estados: desconectada, registrándose y conectada. Durante el registro se negocian las capacidades IRCv3, SASL y el nick (con alternativa si está ocupado).
  • Tiempo máximo de registro: 60 segundos. Si el servidor calla 90 segundos se le envía PING, y a los 180 se da la conexión por perdida.
  • Reconexión automática con espera progresiva de 5 segundos a 5 minutos, con una variación aleatoria del ±20 % para que miles de redes no vuelvan en el mismo segundo. Si la red avisa de que reconectas demasiado rápido, xBNC espera al menos 2 minutos.
  • La salida hacia el servidor pasa por un control de ritmo (ráfaga de 9 líneas y después 2 por segundo) para que la red no te expulse por flood.
  • El certificado TLS del servidor se verifica siempre con los certificados raíz del sistema. Para una red con certificado propio o caducado se puede confiar en ese certificado concreto por su huella SHA-256 (/msg *status addfingerprint); no existe opción para desactivar la verificación.
  • Cada red puede tener servidores de reserva (/msg *status addserver). Si la conexión a un servidor falla, xBNC prueba el siguiente al segundo; tras recorrer la lista entera vuelve a la espera progresiva. Si un servidor ya conectado corta la conexión, xBNC vuelve primero a ese mismo servidor.
  • La dirección local de salida (vhost) se puede fijar por red o por usuario (/msg *status setbindhost, solo administradores).
  • Si una línea no es UTF-8 se interpreta como Windows-1252, así que las tildes de los clientes antiguos se ven bien.

Usuarios virtuales

xBNC añade «usuarios» que empiezan por *. No existen en la red: son la forma de hablar con xBNC desde cualquier cliente. *status, *notes, *watch, *crypt, *ignore y uno por cada plugin (*trivia, *remind…). Ver Comandos IRC.

Instalación

Requisitos

  • Linux con systemd: Debian 12, Ubuntu 22.04 o posterior, Fedora, Rocky o Alma.
  • Rust 1.89 o posterior (rustup.rs) y un compilador de C: sudo apt install build-essential o sudo dnf install gcc.
  • 1 CPU y 512 MB de RAM para uso personal. Medido: 2 000 usuarios con sus redes y clientes en unos 150 MB (ver Rendimiento).
  • Puertos: 6697 (IRC con TLS), 6667 (IRC sin TLS, solo red local), 8443 (panel). Con Let's Encrypt, también el 80; con Nginx, el 443.

El panel web viene ya compilado dentro del código: no hace falta Node.js ni npm.

Instalar

# 1. Instalar Rust (una vez, como usuario normal)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 2. Compilar xBNC (como usuario normal)
unzip xbnc-1.0.0.zip && cd xbnc
cargo build --release

# 3. Instalar el servicio
sudo ./scripts/install.sh

Ejecutado en una terminal y sin opciones, el instalador te pregunta si quieres usar un dominio, el correo para Let's Encrypt y si quieres el panel en https://tudominio con Nginx. Al terminar muestra la dirección del panel y el código de un solo uso para crear tu cuenta:

  Panel:   https://bnc.ejemplo.org:8443
  IRC:     bnc.ejemplo.org, puerto 6697 (SSL)
  Código para crear tu cuenta:  K7QM-2XPA-9DWE

Abre el panel, escribe el código y crea el primer administrador (será superadministrador). Para volver a ver la dirección y los puertos: sudo xbncd info; para volver a ver el código: sudo xbncd setup-code.

Qué hace el instalador

  1. Comprueba el sistema, el binario compilado y, si usas dominio, que el DNS apunta a esta máquina y qué puertos tienes que abrir en el router.
  2. Crea el usuario del sistema xbnc, sin privilegios, y las carpetas con sus permisos.
  3. Instala el binario en /usr/local/bin/xbncd y el servicio de systemd con medidas de aislamiento (ProtectSystem=strict, NoNewPrivileges, sin capacidades, filtro de llamadas al sistema).
  4. Crea el certificado: propio para la IP (o el dominio), o de Let's Encrypt con renovación automática. La renovación recarga xBNC (y Nginx, si lo usa).
  5. Escribe /etc/xbnc/xbnc.toml con la versión en la cabecera, crea la base de datos y la clave secreta.
  6. Con --nginx, instala y configura Nginx: redirección del puerto 80, el panel en el 443, WebSockets y subida de plugins y copias de seguridad.
  7. Abre los puertos en ufw o firewalld y arranca el servicio.

Opciones del instalador

OpciónQué hace
--domain NOMBREUsar un dominio (bnc.ejemplo.org) en lugar de la IP.
--letsencrypt CORREOCon --domain: certificado gratuito de Let's Encrypt con renovación automática. Necesita el puerto 80 accesible desde internet.
--nginxCon --domain y --letsencrypt: instala y configura Nginx para servir el panel en https://DOMINIO (puerto 443).
--ip DIRECCIÓNIP que usar si la detectada no es la correcta (varias interfaces o VPN).
--language es|enIdioma del instalador y predeterminado de xBNC.
--behind-proxyPanel en 127.0.0.1:8080, para publicarlo con tu propio proxy.
--web-port NPuerto del panel (8443 por defecto).
--irc-port NPuerto IRC con SSL (6697 por defecto).
--plain-port N|offPuerto IRC sin SSL, solo red local (6667 por defecto); off lo quita.
--no-firewallNo abrir puertos en ufw o firewalld.
--reconfigureRehacer la configuración y el certificado de una instalación existente (guarda una copia de la anterior). No toca usuarios, redes ni historial.
--binary RUTABinario que instalar (target/release/xbncd por defecto).
--no-startInstalar sin arrancar el servicio.
--non-interactiveNo preguntar nada (por defecto pregunta si se ejecuta en una terminal).

Ejemplos

# Por IP, con certificado propio
sudo ./scripts/install.sh

# Con dominio y Let's Encrypt, panel en https://bnc.ejemplo.org:8443
sudo ./scripts/install.sh --domain bnc.ejemplo.org --letsencrypt tu@correo.org

# Igual, pero con el panel en https://bnc.ejemplo.org detrás de Nginx
sudo ./scripts/install.sh --domain bnc.ejemplo.org --letsencrypt tu@correo.org --nginx

# Pasar una instalación existente a dominio
sudo ./scripts/install.sh --reconfigure --domain bnc.ejemplo.org --letsencrypt tu@correo.org

# Cambiar la IP detectada
sudo ./scripts/install.sh --reconfigure --ip 192.168.1.50

Dónde queda cada cosa

RutaContenido
/usr/local/bin/xbncdEl programa.
/etc/xbnc/xbnc.tomlConfiguración del proceso (root:xbnc, 0640).
/etc/xbnc/tls/Certificado TLS: fullchain.pem y privkey.pem (root:xbnc, 0750).
/etc/xbnc/locales/Idiomas adicionales y correcciones de traducción (ver Traducir xBNC).
/var/lib/xbnc/Base de datos y clave secreta (xbnc:xbnc, 0700). Haz copia de secret.key: sin ella no se pueden descifrar las contraseñas guardadas.
/var/lib/xbnc/logs/Registros en ficheros del módulo log (carpetas 0700, ficheros 0600).
/var/lib/xbnc/plugins/Plugins instalados (0600). En dev/, los del modo desarrollo.
/var/lib/xbnc/backups/Copias de seguridad hechas desde el panel.

El servicio corre como el usuario sin privilegios xbnc. sudo systemctl status xbnc, sudo systemctl restart xbnc; sudo systemctl reload xbnc hace que relea redes, canales y usuarios cambiados con la terminal, y los ficheros de idioma. El registro: sudo journalctl -u xbnc -f.

Usarlo desde fuera de casa

  • Abre en el router el puerto 6697 hacia la máquina de xBNC y conéctate a tu IP pública o a un nombre de DNS dinámico (DuckDNS y similares). El 6667 no hace falta abrirlo: desde fuera xBNC lo rechaza.
  • Si no quieres abrir el panel (8443) a internet, administra con un túnel SSH: ssh -L 8443:127.0.0.1:8443 usuario@tu-ip-publica y abre https://localhost:8443.
  • Con un dominio que apunte a tu casa, reinstala con --reconfigure --domain … --letsencrypt … para quitar los avisos de certificado.

Panel detrás de tu propio Nginx

Si ya tienes Nginx y prefieres configurarlo tú, instala con --domain bnc.ejemplo.org --behind-proxy y usa el ejemplo incluido:

sudo apt install -y nginx
echo 'map $http_upgrade $connection_upgrade { default upgrade; "" close; }' | sudo tee /etc/nginx/conf.d/upgrade.conf
sudo cp packaging/nginx/xbnc.conf /etc/nginx/sites-available/xbnc   # cambia server_name y certificados
sudo ln -s ../sites-available/xbnc /etc/nginx/sites-enabled/xbnc
sudo nginx -t && sudo systemctl reload nginx

Contenido de packaging/nginx/xbnc.conf:

# Nginx reverse proxy for the xBNC web panel.
# Copy to /etc/nginx/sites-available/xbnc, adjust server_name and the
# certificate paths, then: ln -s ../sites-available/xbnc /etc/nginx/sites-enabled/
# In xbnc.toml: [web] address = "127.0.0.1:8080", public_url = "https://bnc.example.org",
# secure_cookies = true, trust_proxy = true.

server {
    listen 80;
    listen [::]:80;
    server_name bnc.example.org;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name bnc.example.org;

    ssl_certificate     /etc/letsencrypt/live/bnc.example.org/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bnc.example.org/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    # Plugins are up to 4 MB.
    client_max_body_size 8m;

    # Restoring a backup uploads the whole archive.
    location = /api/v1/backups/restore {
        client_max_body_size 4g;
        proxy_request_buffering off;
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 3600s;
    }

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        # WebSockets: live dashboard, web chat, plugin log
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 3600s;
    }
}

# Needed once per Nginx configuration (e.g. in /etc/nginx/conf.d/upgrade.conf):
# map $http_upgrade $connection_upgrade { default upgrade; '' close; }

En xbnc.toml, con el panel detrás de Nginx: address = "127.0.0.1:8080", public_url = "https://bnc.ejemplo.org", secure_cookies = true y trust_proxy = true.

Certificado de otra autoridad

Copia tu certificado y tu clave a /etc/xbnc/tls/fullchain.pem y /etc/xbnc/tls/privkey.pem (propietario root:xbnc, la clave con permisos 0640) y reinicia con sudo systemctl restart xbnc. El certificado se lee al arrancar; reload no basta.

Docker

mkdir -p tls
cp /ruta/fullchain.pem /ruta/privkey.pem tls/
# Edita XBNC_HOSTNAME y XBNC_PUBLIC_URL en docker-compose.yml
docker compose up -d --build
docker compose logs xbnc | grep "setup code"

Abre https://bnc.ejemplo.org:8443/, escribe el código y crea tu cuenta. La terminal: docker compose exec xbnc xbncd user add admin --admin. Los datos viven en el volumen xbnc-data. El contenedor se ejecuta como el usuario sin privilegios xbnc (uid 10001), con sistema de ficheros de solo lectura, sin capacidades y con no-new-privileges.

VariableUso
XBNC_HOSTNAMENombre del servidor (solo en el primer arranque).
XBNC_TLS_CERT, XBNC_TLS_KEYRutas del certificado y la clave dentro del contenedor; activan TLS en el 6697 (IRC) y el 8443 (panel).
XBNC_INSECURE=1Texto plano en el 6667 (IRC) y el 8080 (panel), solo para pruebas.
XBNC_PUBLIC_URLURL pública del panel.
XBNC_WEB=0Desactiva el panel.
XBNC_LOCALES_DIRCarpeta de idiomas adicionales (ver Traducir xBNC).
RUST_LOGNivel de registro, por ejemplo info o debug.

Actualizar

unzip xbnc-nueva.zip && cd xbnc     # o git pull
cargo build --release
sudo ./scripts/update.sh

update.sh comprueba el binario nuevo y la configuración, hace una copia de seguridad, para el servicio, cambia el binario y lo arranca. Si no arranca, vuelve al binario anterior y a la base de datos de antes de actualizar (un binario nuevo puede haber actualizado el esquema, y uno antiguo se niega a abrir un esquema más nuevo). Nunca se actualiza nada solo. Con --binary RUTA instala otro binario.

Si además quieres rehacer la configuración (por ejemplo, para pasar a dominio), ejecuta después sudo ./scripts/install.sh --reconfigure.

Desinstalar

sudo ./scripts/uninstall.sh            # quita el servicio y el binario; conserva /etc/xbnc y /var/lib/xbnc
sudo ./scripts/uninstall.sh --purge    # borra también la configuración, los datos y el usuario xbnc

Primeros pasos

  1. Crea tu cuenta en el panel con el código de un solo uso. La primera cuenta es superadministrador.
  2. Añade una red en Redes → Añadir red. El asistente tiene cuatro pasos: elegir la red (las conocidas vienen preparadas), tu nick y nombre, la identificación (SASL, X, Q…) y los canales.
  3. Conecta tu cliente. La página de la red tiene la tarjeta «Conecta tu cliente IRC» con tus datos exactos y los pasos para HexChat, mIRC, WeeChat e irssi, con botones para copiar.
  4. Activa módulos y plugins en Módulos. Elige la red arriba; con muchas redes, «Copiar a otras redes» repite la configuración.
  5. Elige tu zona horaria e idioma en Tu cuenta: la zona se usa en los registros y en las tareas programadas.
  6. Activa la verificación en dos pasos y, si quieres, una passkey, en Tu cuenta.

Redes preparadas en el asistente

RedServidorPuertoTLSIdentificaciónDescripción
Undernetirc.undernet.org6667noX con Login on ConnectRed clásica con canales de todo tipo
Libera.Chatirc.libera.chat6697síSASLComunidades de software libre y proyectos de código abierto
freenodeirc.freenode.net6697síSASLRed histórica de proyectos y comunidades
Rizonirc.rizon.net6697síSASL o NickServAnime, juegos y comunidades variadas
EvilNetirc.evilnet.org6697síAuthServ (X3)Red con servicios X3
IRCnetopen.ircnet.net6697sísin NickServRed histórica, muy popular en Europa
OFTCirc.oftc.net6697síNickServDebian, Tor, el núcleo de Linux y otros proyectos
EFnetirc.efnet.org6697sísin serviciosUna de las redes más antiguas
QuakeNetirc.quakenet.org6667noQJuegos y comunidades europeas
DALnetirc.dal.net6697síSASLComunidades sociales y de ayuda
hackintirc.hackint.org6697síSASLHackerspaces y comunidades técnicas

Lo mismo desde la terminal

sudo -u xbnc xbncd user add admin --admin
sudo -u xbnc xbncd network add admin libera --host irc.libera.chat --port 6697 --sasl-user micuenta
sudo -u xbnc xbncd channel add admin libera '#xbnc'
sudo systemctl reload xbnc

La contraseña SASL se pide al momento (o se lee de XBNC_SASL_PASSWORD) y se guarda cifrada.

Conectar tu cliente IRC

Sirve cualquier cliente que permita indicar servidor, puerto y contraseña de servidor. No hace falta ningún plugin.

Qué quieresContraseña de servidor
Usuario con una sola redalicia:contraseña
Elegir redalicia/undernet:contraseña
Elegir red e identificar el dispositivoalicia/undernet@portatil:contraseña
El mismo login en otro ordenalicia@portatil/undernet:contraseña
  • Servidor: tu dominio o IP (sudo xbncd info lo muestra).
  • Puerto: 6697 con SSL desde cualquier sitio; 6667 sin SSL solo desde tu red local.
  • Contraseña: la misma con la que entras al panel. También puedes poner alicia/undernet@portatil en el campo de usuario (USER) y la contraseña sola en PASS, o entrar con SASL PLAIN desde el cliente.
  • Una conexión equivale a una red: para dos redes, crea dos servidores en tu cliente (alicia/undernet y alicia/libera). Los clientes con soju.im/bouncer-networks (Goguma, gamja, Halloy) ven todas tus redes en una sola conexión.
  • Dispositivo: la parte @dispositivo es opcional pero recomendable. Cada dispositivo (@portatil, @movil, @trabajo) recibe su propio historial pendiente.
  • Si instalaste por IP, el certificado es propio: activa en tu cliente «aceptar certificados no válidos».

No tienes que averiguar nada de esto: en el panel, Redes → tu red → Conecta tu cliente IRC muestra el servidor, el puerto y la contraseña del servidor reales de tu cuenta para cada red, listos para copiar. Escribe ahí el nombre del dispositivo y tu contraseña y forma la línea completa (la contraseña no se envía ni se guarda). sudo xbncd info muestra lo mismo en el servidor, con tus usuarios y redes reales.

Desde internet o desde tu red local

Con un dominio, el servidor no es siempre el mismo:

Dónde estásServidorPuerto
En cualquier sitio (internet)Tu dominio, por ejemplo bnc.ejemplo.org6697 con SSL. El router tiene que redirigir el 6697 a la máquina de xBNC.
En casa (la misma red que xBNC)La IP local de la máquina de xBNC, por ejemplo 192.168.1.506667 sin SSL. El 6697 también funciona, pero el certificado del dominio no es válido para la IP: activa «aceptar certificados no válidos».

Desde casa, el dominio solo funciona si tu router lo admite (se llama NAT loopback o hairpin NAT); muchos no lo admiten y la conexión simplemente falla. Por eso el panel tiene las dos opciones, Desde internet y Desde tu red local, con los datos correctos de cada una.

Lista de redes → Añadir: «xBNC Undernet»
Editar → Servidor: bnc.ejemplo.org/6697
Marca «Usar SSL para todos los servidores»
Método de inicio de sesión: Contraseña del servidor (/PASS)
Contraseña: alicia/undernet@hexchat:tu-contraseña
Con certificado propio: marca «Aceptar certificados SSL no válidos»

Si te equivocas de puerto o de SSL

xBNC detecta los errores habituales y te lo dice en el propio cliente:

Lo que ves en el clienteQué pasaQué hacer
Closing link: this port uses SSL/TLS. Enable SSL in your IRC client, or connect to port 6667 without SSL.Te conectas al 6697 sin SSL.Activa SSL o usa el 6667 desde casa.
Closing link: this port only accepts connections from the local network...Usas el 6667 desde fuera de tu red.Usa el 6697 con SSL.
Error de certificado o «certificado no válido»Certificado propio (instalación por IP).Acepta el certificado o pasa a un dominio con Let's Encrypt.
Usuario o contraseña incorrectos (usuario «alice»)…Usuario o contraseña incorrectos.Usa el mismo usuario y contraseña que en el panel: alice/undernet@dispositivo:contraseña.
«TU_CONTRASEÑA» es el ejemplo…Se copió el ejemplo sin escribir la contraseña.Escribe tu contraseña después de los dos puntos. No cuenta como intento fallido.
No hay ninguna red llamada «…» en tu cuenta. Tus redes: …La red de la contraseña del servidor no existe (es el nombre corto de la red en el panel).Usa uno de los nombres de la lista.
Indica qué red usar en la contraseña del servidor…Tienes varias redes y no indicaste cuál.Añade /red al usuario.
Demasiados accesos fallidos desde tu dirección (…): está bloqueada N minutos másTu IP está bloqueada por fallos, en IRC y en el panel. Un cliente que sigue reconectando con una contraseña incorrecta también cuenta.Corrige la contraseña en el cliente (o ciérralo) y espera, o pide a un administrador que la desbloquee en Seguridad → IPs bloqueadas.

Cuando el cliente se conecta con SSL a un puerto sin SSL no puede mostrar ningún mensaje: lo indica el registro del servicio (client sent TLS to a plain-text port).

Redes sin SASL (Undernet, QuakeNet)

Algunas redes no usan SASL: te identificas con un bot de servicios, X en Undernet o Q en QuakeNet. xBNC lo hace por ti cada vez que se conecta. Activa el módulo Login en servicios (en el asistente, el paso Cuenta) con tu cuenta y tu contraseña. Si prefieres hacerlo a mano, escribe los comandos en Configuración → Comandos al conectar, uno por línea, como en tu cliente:

/mode $nick +x
/msg x@channels.undernet.org login TU_CUENTA TU_CONTRASEÑA

Se envían antes de entrar en los canales y se guardan cifrados. Cuando los comandos (o el módulo, con «Ocultar mi IP») piden +x, xBNC no entra en ningún canal, y retiene también los JOIN de tu cliente, hasta que la red confirma el host oculto (numérico 396). Tu dirección real nunca se ve en un canal. Si el host no se oculta después de la espera (por ejemplo, porque falló el login con X), los canales siguen esperando y *status te dice por qué; se entra en cuanto el host se oculta, o enseguida con /msg *status joinnow.

Compatibilidad de clientes

Los tests automáticos usan un cliente IRC estándar, un cliente con todas las capacidades IRCv3 y un cliente clásico sin ninguna. HexChat, mIRC, WeeChat e irssi se han usado a mano con xBNC; el resto de clientes de la lista siguen los mismos estándares pero no se han comprobado uno a uno. Si algo no funciona con un cliente concreto, avisa con su nombre y versión (ver Probar la beta).

Redes

Ajustes de una red

En el panel, Redes → (tu red) → Configuración. También con la API (PATCH /networks/{id}) o la terminal.

AjusteQué es
Nombre cortoEl que usas en el login (alicia/undernet). Cambiarlo no corta la conexión.
Servidor y puertoDirección de la red. Puerto 6697 con TLS por defecto.
TLSConexión cifrada con la red. El certificado del servidor se verifica siempre.
NickTu nick en la red. Si está ocupado al conectar, xBNC añade «_» y, con Recuperar nick, vuelve a él en cuanto queda libre.
Usuario (ident) y nombre realLos campos de USER. Por defecto, el nick.
Contraseña de servidorSe envía con PASS al conectar. Se guarda cifrada y no se vuelve a mostrar.
Cuenta y contraseña SASLIdentificación SASL PLAIN. Para SASL EXTERNAL, usa un certificado de cliente.
ActivaDesactivada, xBNC no se conecta a esa red.
Comandos al conectarLíneas que se envían tras conectar y antes de entrar en los canales (ver abajo).
CanalesCanales guardados, con su clave (cifrada). Un /join o /part desde el cliente se guarda solo.
Retención por canalCuánto se guarda el historial de un canal: lo del servidor, nada, para siempre o N días.
Servidores de reservaOtros servidores de la misma red que xBNC prueba si falla el actual. Con /msg *status addserver (ver Comandos IRC).
Certificados de confianzaHuellas SHA-256 de certificados de servidor que se aceptan aunque no validen (certificado propio o caducado). Con /msg *status addfingerprint.
Dirección local (vhost)La IP de este servidor con la que se conecta a la red. Con /msg *status setbindhost (solo administradores).
Canales desactivados y ordenUn canal desactivado sigue guardado pero no se entra en él; el orden es el de entrada al conectar. Con /msg *status disablechan y movechan.

Comandos al conectar

Se escriben como en tu cliente, uno por línea (hasta 20 y 510 caracteres cada uno), y se guardan cifrados porque suelen llevar contraseñas. $nick se cambia por tu nick actual. Se admiten /msg (o /privmsg, /query), /notice, /quote (o /raw) y cualquier comando IRC con barra (/mode, /away…). Una línea sin barra se envía tal cual.

/mode $nick +x
/msg x@channels.undernet.org login TU_USUARIO TU_CLAVE
AWAY :Conectado desde xBNC

Para identificarte con X, NickServ, Q o AuthServ es mejor el módulo Login en servicios: espera a que la red confirme el inicio de sesión antes de entrar en los canales y en Undernet usa Login on Connect.

Undernet

Undernet usa el servicio X y no tiene SASL ni TLS. Activa Login en servicios con tu cuenta de X: con Login on Connect la cuenta viaja en la contraseña del servidor (+x! cuenta contraseña), así que tu IP real no llega a verse nunca y entras en los canales ya con cuenta.users.undernet.org.

*** Tu host es ahora y2k.users.undernet.org
* y2k ha entrado en #xbnc
*statusxBNC 1.0.0 Made by y2k
  • Con Invitación y desbaneo, si no puedes entrar en un canal tuyo, xBNC pide a X INVITE o UNBAN.
  • Ignorar usa SILENCE: los mensajes de quien ignoras ni siquiera llegan a xBNC.
  • Los nicks tienen 12 caracteres como máximo; el nick de ausente se recorta solo.
  • Muchos canales hispanos usan Latin-1: xBNC lo entiende siempre, y con Codificación puedes escribirles en Latin-1.
  • La conexión con Undernet va sin cifrar porque la red no ofrece TLS; la contraseña de X viaja en claro hasta el servidor, igual que con cualquier cliente.

Libera.Chat y freenode

Identificación por SASL: pon tu cuenta y contraseña en la configuración de la red. En Libera también puedes usar un certificado (Certificado de cliente) con SASL EXTERNAL: genera el certificado en el panel, conéctate identificado, escribe /msg NickServ CERT ADD y reconecta. Si tu nick está ocupado al conectar, Login en servicios con «Recuperar mi nick» envía REGAIN (Libera) o GHOST (freenode).

Rizon

NickServ (Anope), por SASL o con Login en servicios. ChanServ atiende las invitaciones y los desbaneos.

EvilNet

Servicios X3: te identificas con AuthServ (AUTH cuenta contraseña) y el modo +x oculta tu host (numérico 396). Elige AuthServ en Login en servicios, o «Automático».

QuakeNet

Servicio Q (AUTH a Q@CServe.quakenet.org) y +x. Login en servicios lo hace por ti; la invitación y el desbaneo usan INVITE y UNBANME.

IRCnet y EFnet

No tienen NickServ: cualquiera podría ponerse ese nick. Por eso, en «Automático», xBNC nunca envía tu contraseña de servicios en estas redes y lo avisa en *status y en el registro. IRCnet ofrece SASL opcional con cuentas de sasl.ircnet.com. Para conservar op sin servicios, usa Recuperar op al quedarte solo.

OFTC y otras redes con NickServ

Login en servicios con NickServ, o comandos al conectar. Para el certificado de cliente, OFTC usa la huella SHA-1 y Libera la SHA-512: el panel muestra las tres huellas (SHA-1, SHA-256 y SHA-512).

Comandos IRC

Se escriben desde tu cliente con /msg *servicio comando. Las respuestas salen en tu idioma.

*status

Es el servicio principal: todo lo que se hace en el panel con una red se puede hacer también aquí. /msg *status help lista los comandos agrupados y con el nombre en negrita, solo los que tu cuenta puede usar; /msg *status help <comando> explica uno con un ejemplo, y /msg *status help <palabra> busca (por ejemplo help canal). Los nombres no distinguen mayúsculas, y se aceptan también los nombres que usan otros bouncers (ListChans, ListMods, AddTrustedServerFingerprint…), indicados en cada comando como «También vale».

*statusxBNC: comandos de *status
*statusSe escriben como /msg *status <comando>. Detalles y un ejemplo: help <comando>.
*statusCanales
*status channels Tus canales: usuarios, modos y estado
*status nicks <#canal> Quién está en un canal, con su rango
*status topics El tema de cada canal

Si no se indica otra cosa, el comando lo puede usar cualquier cuenta. Los demás indican quién: las cuentas con permiso de cambios (todos los roles menos «limitado»), los administradores (administrador y superadministrador) o los superadministradores. Las acciones de administración quedan en la auditoría.

General

ComandoQué hace
help [comando]Esta lista, o los detalles de un comando. Sin comando, lista todos los que puedes usar. Con uno, explica cómo funciona y da un ejemplo. También busca: help canal.
Ejemplo: /msg *status help addserver
versionVersión de xBNC.
Ejemplo: /msg *status version
uptimeCuánto llevan en marcha xBNC y esta red.
Ejemplo: /msg *status uptime
language <código>Tu idioma, también para el panel web. Cambia al momento el idioma de los mensajes de xBNC, de los plugins y del panel web. Sin código, lista los idiomas instalados.
Ejemplo: /msg *status language en
seenCuándo te conectaste por última vez.
Ejemplo: /msg *status seen
showmotdEl mensaje del día de este servidor.
Ejemplo: /msg *status showmotd
clients [usuario]Dispositivos conectados a esta red. Los administradores pueden indicar un usuario para ver todos los suyos.
Ejemplo: /msg *status clients
También vale: listclients

Redes y conexión

ComandoQué hace
statusEstado de esta red: servidor, TLS, nick, capacidades.
Ejemplo: /msg *status status
networksTus redes y su estado.
Ejemplo: /msg *status networks
También vale: listnetworks
addnetwork <nombre> <servidor> [[+]puerto]Añadir una red a tu cuenta. Un + delante del puerto significa TLS. Sin puerto: 6697 con TLS. Tu nick será el de esta red. Después conéctate con usuario/nombre.
Ejemplo: /msg *status addnetwork libera irc.libera.chat +6697
delnetwork <nombre> confirmarBorrar una de tus redes y su historial. Pide confirmación: repite el comando añadiendo «confirmar». No se puede deshacer.
Ejemplo: /msg *status delnetwork pruebas confirmar
setnick <nick>Cambiar el nick guardado de esta red.
Ejemplo: /msg *status setnick y2k
Solo cuentas con permiso de cambios (no el rol limitado).
connectVolver a conectar a la red.
Ejemplo: /msg *status connect
Solo cuentas con permiso de cambios (no el rol limitado).
disconnectDesconectar y quedarse desconectado. xBNC se queda desconectado de esta red hasta que uses connect.
Ejemplo: /msg *status disconnect
Solo cuentas con permiso de cambios (no el rol limitado).
jump [servidor]Reconectar, al siguiente servidor o al que digas. Sin servidor, pasa al siguiente de la lista (servers). Con uno, conecta a ese.
Ejemplo: /msg *status jump irc2.undernet.org
Solo cuentas con permiso de cambios (no el rol limitado).

Servidores, certificados y direcciones

ComandoQué hace
serversServidores de esta red (principal y de reserva). Si un servidor falla, xBNC prueba el siguiente por turnos.
Ejemplo: /msg *status servers
También vale: listservers
addserver <servidor> [[+]puerto] [contraseña]Añadir un servidor de reserva. Un + delante del puerto significa TLS. Sin puerto: el del servidor principal. Hasta 20.
Ejemplo: /msg *status addserver irc2.undernet.org 6667
Solo cuentas con permiso de cambios (no el rol limitado).
delserver <servidor> [puerto]Quitar un servidor. Si quitas el principal, el primero de reserva pasa a ser el principal.
Ejemplo: /msg *status delserver irc2.undernet.org
Solo cuentas con permiso de cambios (no el rol limitado).
addfingerprint <SHA-256>Confiar en el certificado de un servidor por su huella. Para servidores con certificado propio o caducado. 64 dígitos hexadecimales, con o sin dos puntos. Se aplica en la próxima conexión.
Ejemplo: /msg *status addfingerprint 3F:9A:...:C2:1E
También vale: addtrustedserverfingerprint
Solo cuentas con permiso de cambios (no el rol limitado).
delfingerprint <SHA-256>Dejar de confiar en un certificado.
Ejemplo: /msg *status delfingerprint 3F:9A:...:C2:1E
También vale: deltrustedserverfingerprint
Solo cuentas con permiso de cambios (no el rol limitado).
fingerprintsCertificados de confianza de esta red.
Ejemplo: /msg *status fingerprints
También vale: listtrustedserverfingerprints
showbindhostDirección local con la que se conecta.
Ejemplo: /msg *status showbindhost
setbindhost <IP>Dirección local para esta red (vhost). Una de las direcciones IP de este servidor. Se aplica en la próxima conexión (jump).
Ejemplo: /msg *status setbindhost 203.0.113.25
Solo administradores.
clearbindhostUsar la dirección automática en esta red.
Ejemplo: /msg *status clearbindhost
Solo administradores.
setuserbindhost <IP>Dirección local por defecto para todas tus redes. La dirección propia de una red (setbindhost) tiene prioridad.
Ejemplo: /msg *status setuserbindhost 2001:db8::25
Solo administradores.
clearuserbindhostQuitar tu dirección local por defecto.
Ejemplo: /msg *status clearuserbindhost
Solo administradores.

Canales

ComandoQué hace
channelsTus canales: usuarios, modos y estado.
Ejemplo: /msg *status channels
También vale: listchans
nicks <#canal>Quién está en un canal, con su rango.
Ejemplo: /msg *status nicks #xbnc
También vale: listnicks
topicsEl tema de cada canal.
Ejemplo: /msg *status topics
enablechan <#canales>Entrar en canales guardados que estaban desactivados. Admite varios canales y los comodines * y ?.
Ejemplo: /msg *status enablechan #xbnc #xbnc-dev
Solo cuentas con permiso de cambios (no el rol limitado).
joinnowEntrar ya en tus canales, sin esperar al host oculto. Cuando pides el host oculto (/mode $nick +x en los comandos al conectar, o el módulo Login en servicios), xBNC no entra en ningún canal hasta que el servidor oculta tu host, así nunca se ve tu dirección real. Este comando entra en ellos ya de todas formas.
Ejemplo: /msg *status joinnow
disablechan <#canales>Salir de canales pero dejarlos guardados. No se vuelve a entrar en ellos hasta enablechan. Admite * y ?.
Ejemplo: /msg *status disablechan #xbnc*
Solo cuentas con permiso de cambios (no el rol limitado).
attach <#canales>Volver a mostrar canales desacoplados.
Ejemplo: /msg *status attach #xbnc
detach <#canales>Ocultar canales del cliente (siguen grabando). Una mención trae el canal de vuelta. Admite * y ?.
Ejemplo: /msg *status detach #xbnc
Solo cuentas con permiso de cambios (no el rol limitado).
movechan <#canal> <posición>Cambiar la posición de un canal en el orden. El orden es en el que xBNC entra en tus canales y los lista.
Ejemplo: /msg *status movechan #xbnc 1
Solo cuentas con permiso de cambios (no el rol limitado).
swapchans <#canal1> <#canal2>Intercambiar la posición de dos canales.
Ejemplo: /msg *status swapchans #xbnc #xbnc-dev
Solo cuentas con permiso de cambios (no el rol limitado).

Historial (buffers)

ComandoQué hace
playbuffer <#canal|nick> [líneas]Reproducir el historial de una conversación. Te envía las últimas líneas (50 por defecto, hasta 1000).
Ejemplo: /msg *status playbuffer #xbnc 100
clearbuffer <#canal|nick>Borrar el historial de una conversación. Admite * y ?.
Ejemplo: /msg *status clearbuffer bob
También vale: clearhistory
clearallbuffersBorrar todo el historial de esta red.
Ejemplo: /msg *status clearallbuffers
clearallchannelbuffersBorrar el historial de todos los canales.
Ejemplo: /msg *status clearallchannelbuffers
clearallquerybuffersBorrar el historial de todos los privados.
Ejemplo: /msg *status clearallquerybuffers
setbuffer <#canal> <días|siempre|nada|servidor>Cuánto tiempo se guarda el historial de un canal. siempre: no se borra; nada: no se guarda; servidor: lo general; o un número de días.
Ejemplo: /msg *status setbuffer #xbnc 90
Solo cuentas con permiso de cambios (no el rol limitado).

Módulos y plugins

ComandoQué hace
modulesMódulos y plugins de esta red y su estado.
Ejemplo: /msg *status modules
También vale: listmods
availmodsTodos los módulos y plugins, con lo que hacen.
Ejemplo: /msg *status availmods
También vale: listavailmods
enable <módulo|plugin>Activar un módulo o plugin en esta red.
Ejemplo: /msg *status enable away
También vale: loadmod
Solo cuentas con permiso de cambios (no el rol limitado).
disable <módulo|plugin>Desactivarlo.
Ejemplo: /msg *status disable away
También vale: unloadmod
Solo cuentas con permiso de cambios (no el rol limitado).
reloadmod <módulo|plugin>Reiniciar un módulo o plugin en esta red.
Ejemplo: /msg *status reloadmod trivia
También vale: updatemod
Solo cuentas con permiso de cambios (no el rol limitado).
get <módulo|plugin>Ver sus ajustes.
Ejemplo: /msg *status get away
set <módulo> <ajuste> <valor>Cambiar un ajuste. Para ajustes sí/no: on/off. Mira los nombres con get.
Ejemplo: /msg *status set away delay 60
Solo cuentas con permiso de cambios (no el rol limitado).
addline <módulo> <ajuste> <texto>Añadir una línea a un ajuste de lista.
Ejemplo: /msg *status addline watch patterns *xbnc*
Solo cuentas con permiso de cambios (no el rol limitado).
dellines <módulo> <ajuste>Vaciar un ajuste de lista.
Ejemplo: /msg *status dellines watch patterns
Solo cuentas con permiso de cambios (no el rol limitado).

Administración

ComandoQué hace
usersTodas las cuentas y si están conectadas.
Ejemplo: /msg *status users
También vale: listusers
Solo administradores.
allnetworksTodas las redes de todos los usuarios, con su estado.
Ejemplo: /msg *status allnetworks
También vale: listallusernetworks
Solo administradores.
trafficTráfico y mensajes desde que arrancó xBNC.
Ejemplo: /msg *status traffic
Solo administradores.
broadcast <mensaje>Enviar un aviso a todos los usuarios conectados.
Ejemplo: /msg *status broadcast Reinicio a las 23:00
Solo administradores.
movenetwork <usuario> <red> <usuario nuevo> [nombre nuevo]Pasar una red a otro usuario. La red se reconecta como el nuevo usuario, con su historial.
Ejemplo: /msg *status movenetwork ana libera bob
Solo administradores.
rehashReleer usuarios, redes, canales e idiomas. Para cambios hechos con la terminal (xbncd). Los cambios en xbnc.toml necesitan reiniciar.
Ejemplo: /msg *status rehash
También vale: reload
Solo administradores.
listportsPuertos en los que escucha xBNC. Los puertos se configuran en xbnc.toml (o con el instalador) y necesitan reiniciar.
Ejemplo: /msg *status listports
Solo administradores.
saveconfigGuardar la configuración. No hace falta: xBNC guarda cada cambio al momento.
Ejemplo: /msg *status saveconfig
Solo administradores.
setmotd <texto>Poner el mensaje del día de este servidor. Los usuarios lo reciben de *status al conectar. Hasta 20 líneas.
Ejemplo: /msg *status setmotd Bienvenidos a xBNC
Solo superadministradores.
addmotd <texto>Añadir una línea al mensaje del día.
Ejemplo: /msg *status addmotd Normas: /msg *status help
Solo superadministradores.
clearmotdQuitar el mensaje del día.
Ejemplo: /msg *status clearmotd
Solo superadministradores.
restart [mensaje]Reiniciar xBNC. Todas las redes se reconectan. El mensaje, si lo hay, se envía antes a todos.
Ejemplo: /msg *status restart Actualizando
Solo superadministradores.
shutdown [mensaje]Parar xBNC por completo. Queda parado hasta que se arranque de nuevo en el servidor (systemctl start xbnc).
Ejemplo: /msg *status shutdown Mantenimiento
Solo superadministradores.

Notas sobre estos comandos

  • Servidores de reserva. Si la conexión a un servidor falla, xBNC prueba el siguiente de la lista al segundo, y tras recorrerla entera vuelve a esperar como siempre (5 s, 10 s, 20 s… hasta 5 min). Si un servidor ya conectado corta la conexión, xBNC vuelve primero a ese mismo servidor. Las contraseñas de los servidores de reserva se guardan cifradas. jump sin nada pasa al siguiente; jump servidor o jump servidor:puerto, a uno concreto.
  • Certificados de confianza. Para redes con certificado propio, caducado o con otro nombre. xBNC sigue comprobando todo lo demás de TLS y solo acepta ese certificado concreto (su huella SHA-256). Para ver la huella de un servidor: openssl s_client -connect irc.ejemplo.org:6697 </dev/null 2>/dev/null | openssl x509 -noout -fingerprint -sha256
  • Dirección local (vhost). Solo administradores, porque usa las direcciones IP del servidor. xBNC comprueba que la dirección pertenece a la máquina antes de guardarla. La de la red tiene prioridad sobre la del usuario. Se aplica en la siguiente conexión.
  • Canales desactivados. Siguen guardados con su clave y su configuración, pero xBNC no entra en ellos al conectar. El panel los marca como «Desactivado». enablechan entra en ellos al momento.
  • Orden de los canales. Es el orden en el que xBNC entra al conectar y en el que los lista channels y el panel. Los canales nuevos van al final.
  • Comodines. enablechan, disablechan, attach, detach y clearbuffer aceptan varios nombres separados por espacios o comas, y los comodines * y ?: disablechan #xbnc* #xbnc-dev.
  • Mensaje del día. Lo pone un superadministrador y lo recibe cada usuario, como aviso de *status, cada vez que conecta un cliente. Hasta 20 líneas de 400 caracteres. Se ve con showmotd.
  • Avisos a todos. broadcast envía «[Aviso del administrador] texto» a cada red en marcha; lo reciben todos los clientes conectados. restart y shutdown con mensaje lo envían antes.
  • Reiniciar y parar. restart reinicia xBNC dentro del mismo proceso (las redes se reconectan). shutdown lo para del todo y systemd no lo vuelve a arrancar: hay que hacerlo con sudo systemctl start xbnc.
  • Puertos y xbnc.toml. Los puertos y el resto de xbnc.toml no se cambian desde IRC: listports los muestra y rehash relee usuarios, redes, canales e idiomas (lo mismo que sudo systemctl reload xbnc). saveconfig existe por costumbre: xBNC guarda cada cambio al momento.

*notes

ComandoQué hace
listTus notas.
get <clave>Ver una nota.
add <clave> <texto>Guardar una nota (hasta 400 caracteres).
del <clave>Borrar una nota.

Son las mismas notas que en Tu cuenta → Notas.

*watch

Aquí llegan las coincidencias del módulo Vigilar palabras. /msg *watch help recuerda cómo configurarlo.

*crypt

ComandoQué hace
setkey <#canal|nick> [cbc:]<clave>Guardar la clave FiSH de un canal o privado (cbc: para el modo CBC). Se guarda cifrada.
delkey <#canal|nick>Borrar una clave.
keyx <nick>Acordar una clave en privado con DH1080 (la otra persona necesita FiSH).
listConversaciones con clave.

Escribe +p delante de un mensaje para enviarlo sin cifrar. Ver Cifrado de mensajes.

*ignore

ComandoQué hace
add <nick o máscara>Ignorar a alguien (nick, o nick!usuario@host con *).
del <nick o máscara>Dejar de ignorar.
listLista de ignorados.

Un servicio por plugin

Cada plugin activo responde en *id (*trivia, *remind, *poll…). Con ayuda o cualquier texto que no entienda, explica cómo se usa. Si un plugin no tiene nada que decir, xBNC responde con su nombre, versión, descripción y uso.

Comandos de cliente

ComandoQué hace
/quote DETACH #canalDesacopla un canal: sigue guardando, pero no aparece en tu cliente.
/quote ATTACH #canal o /join #canalVuelve a mostrar un canal desacoplado, con los últimos mensajes.
/quote <alias> [argumentos]Ejecuta un alias si tu cliente no envía comandos que no conoce.

Panel web

PáginaPara qué sirve
InicioEstado en vivo de tus redes (se actualiza cada 2 segundos) y, para administradores, memoria, CPU, tráfico, conexiones, IPs bloqueadas, alertas activas y aviso de versiones nuevas.
ChatCliente IRC web: canales y privados de todas tus redes, con historial. El panel cuenta como uno de tus dispositivos.
MencionesTodo lo que te han dicho en privado o donde han escrito tu nick, de más nuevo a más antiguo.
RedesAñadir (asistente de cuatro pasos) y editar redes; control (conectar, desconectar, reconectar); canales; dispositivos conectados (con botón para desconectar uno); historial con búsqueda y exportación; comandos al conectar; certificado de cliente; tarjeta «Conecta tu cliente IRC».
MódulosMódulos y plugins de cada red. Selector de red que sirve con cualquier número de redes y «Copiar a otras redes» (módulos y plugins, salvo el certificado).
PluginsCatálogo oficial y remoto, instalación con un clic o subiendo un .wasm, permisos y sitios aprobados, activar o desactivar en el servidor, desinstalar, registro en directo y modo desarrollo (superadministradores).
UsuariosAltas, roles, cuotas de redes, dispositivos e historial, suspensión, restablecer contraseña, uso de cada cuenta e importación desde otro bouncer.
SeguridadIntentos de acceso (IRC, panel y tokens), IPs bloqueadas con botón para desbloquear, sesiones abiertas y auditoría de todas las acciones.
AjustesHistorial, límites, protección del acceso, idioma por defecto, alertas, copias de seguridad, actualizaciones y reinicio del servicio.
Tu cuentaIdioma, zona horaria, avisos, contraseña, verificación en dos pasos, passkeys, cuentas externas vinculadas, notas, tokens de API, informe para pruebas y sesiones abiertas.

Ajustes en caliente

Lo que se cambia en Ajustes se guarda en la base de datos, se aplica sin reiniciar y tiene prioridad sobre xbnc.toml. El icono ↺ junto a un campo vuelve al valor de xbnc.toml.

GrupoAjustesPor defecto
HistorialDías de retención (0: para siempre); mensajes reproducidos al reconectar; mensajes para un dispositivo nuevo; límite de CHATHISTORY.30 días; 1000; 100; 500
LímitesConexiones totales; dispositivos por usuario; redes por usuario; cola por cliente (líneas antes de desconectar a un cliente lento). Cada usuario puede tener excepciones en Usuarios.1000; 10; 10; 4096
Protección del accesoIntentos fallidos antes de bloquear; ventana; duración del bloqueo; tiempo para completar el login.5; 600 s; 900 s; 30 s
GeneralIdioma por defecto para quien no ha elegido uno en Tu cuenta. Se guarda y se aplica al pulsarlo, también a quien lo cambia.el de xbnc.toml
AlertasVer Monitorización.
Copias de seguridadAutomáticas sí/no, cada cuántas horas (1–720) y cuántas conservar (1–365).no; 24 h; 7

Lo que se lee al arrancar (puertos, certificados, base de datos, clave secreta, el propio panel y el nivel de registro) se cambia en xbnc.toml y necesita sudo systemctl restart xbnc. La página lo indica. Los superadministradores tienen además un botón para reiniciar el servicio.

Accesibilidad y uso en el móvil

  • Navegable con teclado, con foco visible; los diálogos se cierran con Escape.
  • Respeta «reducir movimiento» del sistema.
  • En pantallas estrechas la barra lateral se abre con el botón de menú.
  • El tema (claro, u oscuro en negro, amarillo y gris) sigue al sistema la primera vez; el botón de luna o sol lo cambia y lo recuerda en ese navegador.
  • Se puede instalar como aplicación (PWA) para tener las notificaciones push.
  • En inglés y en español, y en cualquier idioma instalado como fichero de traducción (ver Traducir xBNC). El idioma se cambia en la pantalla de entrada, en Tu cuenta o (el predeterminado del servidor) en Ajustes, y se aplica al momento al panel y a los mensajes de xBNC en IRC, también con el cliente conectado. Con /msg *status language en se cambia desde IRC.

Historial y búsqueda

xBNC guarda los mensajes de canales y privados (y, con el módulo Eventos, entradas, salidas, kicks, cambios de nick, temas y modos). Cada mensaje lleva la hora del servidor si la red la envía.

Buscar

En Redes → (red) → Historial, o con la API. La búsqueda usa un índice de texto completo:

  • Encuentra palabras enteras y comienzos de palabra: desplie encuentra «despliegue».
  • No distingue mayúsculas ni tildes: cancion encuentra «Canción».
  • Varias palabras tienen que aparecer todas, en cualquier orden. Entre comillas se busca la frase exacta: "fuera de servicio".
  • Si no hay coincidencias por palabra, busca también trozos del medio de una palabra: spliegue encuentra «despliegue».
  • Se combina con los filtros de conversación, emisor y fechas.

Exportar y borrar

Se exporta en TXT o JSON (todo, o una conversación). Se borra una conversación o todo el historial de la red desde el panel, con /msg *status clearbuffer (o clearallbuffers, clearallchannelbuffers, clearallquerybuffers) o con la API.

Retención y cuotas

  • General: Ajustes → Historial, días de retención (30 por defecto; 0, para siempre).
  • Por canal: en los canales de cada red, o con /msg *status setbuffer: lo del servidor, no guardar nada, para siempre o N días.
  • Por usuario: un administrador puede fijar una cuota de espacio de historial (max_history_mb) en Usuarios; el uso se ve en la ficha de cada usuario.
  • Espacio: unos 150 bytes por mensaje guardado, con el índice de búsqueda.

Registros en ficheros

Aparte del historial, el módulo Registros en ficheros escribe ficheros de texto diarios con el formato clásico de IRC en /var/lib/xbnc/logs/usuario/red/#canal/AAAA-MM-DD.log, con la hora en tu zona horaria.

Avisos

En Tu cuenta → Avisos, xBNC te avisa de las menciones y los privados.

OpciónQué hacePor defecto
Activar avisosInterruptor general.no
Solo cuando no tengo ningún cliente conectadoNo avisa si tienes un cliente IRC o el chat del panel abiertos.sí
Cuando alguien escribe mi nick en un canalMenciones.sí
Cuando recibo un mensaje privadoPrivados.sí
CanalQué necesitas
Navegador y móvil (push)Pulsa «Activar en este dispositivo» desde el panel abierto en ese dispositivo. En el móvil, instala antes el panel como aplicación. Se puede activar en varios dispositivos.
TelegramCrea un bot con @BotFather, escríbele una vez y pon su token y tu id de chat (te lo dice @userinfobot). El panel no vuelve a mostrar el token completo.
DiscordUn webhook del canal: Ajustes del canal → Integraciones → Webhooks. Los avisos no mencionan a nadie.
CorreoTu dirección. El administrador tiene que configurar la sección [smtp] de xbnc.toml.
Dirección web propiaUna URL https que recibe un POST con el aviso en JSON.

«Enviar un aviso de prueba» manda uno a todos los canales configurados. Para no inundarte, xBNC agrupa los avisos: si llegan muchos seguidos, los que no se envían se cuentan y el siguiente aviso indica cuántos se saltaron.

Formato del aviso en la dirección web propia

{
  "network": "undernet",
  "network_id": 1,
  "conversation": "#xbnc",
  "from": "bob",
  "text": "y2k, ¿mañana a qué hora es la reunión?",
  "private": false,
  "ts": 1762851240000,
  "skipped": 0
}

En push, al tocar el aviso se abre el chat del panel en esa conversación.

Módulos

Los módulos son funciones nativas de xBNC, compiladas dentro del programa, que se activan y configuran por red: en el panel (Módulos), con la API o desde IRC con /msg *status. Los cambios se aplican al momento, sin reconectar. Toda la configuración se valida (tipos, rangos, longitudes, sin caracteres de control). Las contraseñas y claves se guardan cifradas y el panel no las vuelve a mostrar: para cambiarlas se escriben de nuevo.

/msg *status modules                         lista y estado
/msg *status enable keepnick                 activar (disable para desactivar)
/msg *status get away                        ver ajustes
/msg *status set away delay 60               cambiar un ajuste
/msg *status addline watch patterns *xbnc*   añadir una línea a una lista
/msg *status dellines watch patterns         vaciar una lista
/msg *status availmods                       todos los módulos y plugins, con lo que hacen

Tipos de ajuste: sí/no (en *status, true, on o 1 para sí y false, off o 0 para no), número (con mínimo y máximo), texto, lista (una entrada por línea), opción (uno de los valores indicados) y secreto (se guarda cifrado).

Conexión y cuenta

Login en servicios

servicesnuevo en 1.0

Te identifica con X (Undernet), NickServ, Q o AuthServ al conectar y oculta tu IP antes de entrar en los canales.

En Undernet usa Login on Connect: la cuenta va en la contraseña del servidor y tu IP real no llega a verse. Si la red ya tiene contraseña de servidor, se identifica con /msg X login después de conectar. Los canales esperan a que la red confirme el inicio de sesión. Con «Ocultar mi IP», nunca se entra en ningún canal antes de que la red oculte tu IP, aunque tarde más que la espera (/msg *status joinnow entra igualmente). La contraseña se guarda cifrada y no se vuelve a mostrar.

AjusteTipoPor defectoDetalle
Servicio
service
opciónautoOpciones: auto Automático según la red, x X (Undernet), nickserv NickServ (Libera, freenode, Rizon…), q Q (QuakeNet), authserv AuthServ (EvilNet, GameSurge).
Cuenta
account
textovacíoTu nombre de cuenta en el servicio. Con NickServ puede quedar vacío si es tu nick.
Contraseña
password
secretovacío
Ocultar mi IP (modo +x)
hide_host
sí/nosíEn X, Q y AuthServ. En el resto de redes lo hace la propia red.
Identificarse al conectar (Login on Connect)
login_on_connect
sí/nosíSolo Undernet: la IP real no llega a verse nunca.
Esperar antes de entrar en los canales (segundos)
wait
número (0–120)15Hasta que la red confirme el inicio de sesión. 0: no esperar. Con «Ocultar mi IP», los canales siempre esperan a que la IP esté oculta.
Recuperar mi nick si está ocupado
recover_nick
sí/nosíCon NickServ: pide el nick (REGAIN o GHOST) al identificarte.
Ejemplo
Conectando a irc.undernet.org:6667 con Login on Connect…
*** Tu host es ahora y2k.users.undernet.org
* y2k ha entrado en #xbnc

Desde IRC: /msg *status enable services y /msg *status get services

Invitación y desbaneo

invitenuevo en 1.0

Si no puedes entrar en un canal (+i, +k, +l o ban), pide a X o ChanServ que te invite o te quite el ban y vuelve a entrar.

Lo intenta como mucho tres veces cada diez minutos por canal. Necesitas acceso en el canal para que el servicio te haga caso.

AjusteTipoPor defectoDetalle
Servicio de canales
service
opciónautoOpciones: auto Automático según la red, x X (Undernet), chanserv ChanServ, q Q (QuakeNet).
Pedir que me quiten el ban
unban
sí/nosí
Entrar cuando me inviten a uno de mis canales
join_invites
sí/nosí
Ejemplo
#xbnc: no puedes entrar (+i)
*statusPidiendo a X que te deje entrar en #xbnc (+i).
* y2k ha entrado en #xbnc

Desde IRC: /msg *status enable invite y /msg *status get invite

Certificado de cliente (CertFP)

cert

Te identifica en la red con un certificado en lugar de una contraseña. Permite SASL EXTERNAL.

Genera un certificado, añade su huella a tu cuenta de la red y reconecta. En Libera.Chat: conéctate identificado y escribe /msg NickServ CERT ADD. Solo funciona con TLS.

AjusteTipoPor defectoDetalle
Usar SASL EXTERNAL si la red lo ofrece
sasl_external
sí/nosí
Ejemplo
y2k/msg NickServ CERT ADD
NickServAdded fingerprint 3f9a…c21e to your fingerprint list.

Desde IRC: /msg *status enable cert y /msg *status get cert

Recuperar nick

keepnickactivo por defecto

Si tu nick está ocupado al conectar, xBNC lo recupera en cuanto quede libre.

Comprueba cada 30 segundos si tu nick está libre y lo recupera al momento cuando quien lo tiene se desconecta. Si cambias de nick a mano desde tu cliente, se pausa hasta la próxima conexión.

Ejemplo
*statusTu nick y2k está ocupado; conectado como y2k_. Lo recupero en cuanto quede libre.
* y2k_ ahora se llama y2k

Desde IRC: /msg *status enable keepnick y /msg *status get keepnick

Canales

Canales fijos

stickychan

Canales de los que no puedes salir por error: xBNC bloquea el /part y vuelve a entrar si sales.

AjusteTipoPor defectoDetalle
Canales
channels
listavacíoUno por línea.
Ejemplo
#xbnc
#xbnc-dev

Si escribes /part #xbnc, xBNC no sale del canal.

Desde IRC: /msg *status enable stickychan y /msg *status get stickychan

Volver tras un kick

kickrejoin

Vuelve a entrar en el canal si te echan. Deja de intentarlo si te echan más de 3 veces en un minuto.

AjusteTipoPor defectoDetalle
Espera antes de volver a entrar (segundos)
delay
número (0–600)10
Ejemplo
* bob te ha echado de #xbnc (prueba)
* y2k ha entrado en #xbnc

Desde IRC: /msg *status enable kickrejoin y /msg *status get kickrejoin

Op y voz automáticos

autoop

Da op, halfop o voz a las personas que elijas cuando entran en tus canales (si tú tienes op).

AjusteTipoPor defectoDetalle
Espera antes de dar el modo (segundos)
delay
número (0–30)3
Personas
entries
listavacíoUna por línea: modo (o, h o v), máscara y, si quieres, canales separados por comas (o *) y una clave. Con clave, xBNC envía un desafío y solo da el modo si la otra persona responde con la misma clave desde su propio xBNC.
Ejemplo
o *!*@casa.ejemplo.org #xbnc
v amigo!*@* *
o bob!*@* #xbnc clave-compartida

Desde IRC: /msg *status enable autoop y /msg *status get autoop

Recuperar op al quedarte solo

autocyclenuevo en 1.0

Si te quedas solo en un canal sin op, sales y vuelves a entrar para conseguirlo. Nunca en canales +i o con clave.

AjusteTipoPor defectoDetalle
Solo en estos canales
channels
listavacíoUno por línea. Vacío: en todos.
Ejemplo
* bob ha salido de #xbnc
*statusTe has quedado solo en #xbnc sin op: salgo y vuelvo a entrar.
* y2k ha entrado en #xbnc (con op)

Desde IRC: /msg *status enable autocycle y /msg *status get autocycle

Canales desacoplados

detachnuevo en 1.0

Canales que siguen guardando todo pero no aparecen en tu cliente. Vuelven a aparecer si te mencionan.

Desde tu cliente: /quote DETACH #canal para desacoplar y /join #canal para volver a verlo. Al volver se muestran los últimos mensajes.

AjusteTipoPor defectoDetalle
Canales
channels
listavacíoUno por línea. Admite * (por ejemplo #*-bots).
Mostrar el canal si mencionan mi nick
on_mention
sí/nosí
Mostrar el canal si escribe alguno de estos nicks
nicks
listavacíoUno por línea.
Ejemplo
/quote DETACH #xbnc     desacopla el canal (sigue guardando)
/quote ATTACH #xbnc     o /join #xbnc: vuelve a mostrarlo

Si alguien escribe tu nick en #xbnc, el canal reaparece con los últimos mensajes.

Desde IRC: /msg *status enable detach y /msg *status get detach

Ocultar canales inundados

flooddetachnuevo en 1.0

Si un canal se llena de mensajes de golpe, lo oculta un rato para que tu cliente no se congele. Se sigue guardando.

AjusteTipoPor defectoDetalle
Mensajes
messages
número (3–1000)25Cuántos mensajes…
…en cuántos segundos
seconds
número (1–600)10
Segundos de calma antes de volver a mostrarlo
calm
número (10–3600)60
Ejemplo
Mensajes: 25
…en cuántos segundos: 10
Segundos de calma antes de volver a mostrarlo: 60

Desde IRC: /msg *status enable flooddetach y /msg *status get flooddetach

Mensajes

Ausente automático

awayactivo por defecto

Te marca como ausente cuando cierras todos tus clientes y, al volver, te resume lo que te perdiste.

AjusteTipoPor defectoDetalle
Mensaje de ausencia
message
textovacíoVacío: «Ausente» en tu idioma.
Esperar antes de marcarte ausente (segundos)
delay
número (0–3600)60
Al volver, avisarme de los privados y menciones recibidos
summary
sí/nosí
Nick mientras estás ausente
nick
textovacíoVacío: no lo cambia. {nick} es tu nick, por ejemplo {nick}|away. Se recorta a lo que permita la red (12 caracteres en Undernet).
Ejemplo
Mensaje de ausencia: Vuelvo enseguida
Nick mientras estás ausente: {nick}|away

Al volver, *status te resume: «Mientras no estabas: 3 privados (bob, carol) y 2 menciones en #xbnc».

Desde IRC: /msg *status enable away y /msg *status get away

Vigilar palabras

watchactivo por defecto

Copia a la conversación *watch los mensajes que contienen lo que te interesa, aunque no estuvieras conectado.

AjusteTipoPor defectoDetalle
Avisarme también cuando mencionen mi nick
mentions
sí/nono
Patrones
patterns
listavacíoUno por línea. * vale por cualquier texto: *despliegue* encuentra «el despliegue falló». Después puedes poner un canal o un nick para limitarlo.
Ejemplo
*despliegue*
*xbnc* #xbnc
*urgente* bob

Las coincidencias llegan a la conversación *watch.

Desde IRC: /msg *status enable watch y /msg *status get watch

Alias

aliasactivo por defecto

Tus propios comandos: escribes /ghost bob y xBNC envía /msg NickServ GHOST bob.

AjusteTipoPor defectoDetalle
Alias
aliases
listavacíoUno por línea: nombre y comando. $1, $2… son los argumentos, $1- todos desde el primero y $nick tu nick.
Ejemplo
ghost /msg NickServ GHOST $1
op /mode $1 +o $nick
saluda /msg $1 hola, $1, ¿qué tal?

En tu cliente: /ghost y2k   (o /quote ghost y2k si tu cliente no lo envía)

Desde IRC: /msg *status enable alias y /msg *status get alias

Ignorar

ignorenuevo en 1.0

No recibes los mensajes de quien ignoras en ningún cliente ni en el historial. En Undernet usa SILENCE para que ni siquiera lleguen.

En IRC: /msg *ignore add nick, /msg *ignore del nick y /msg *ignore list.

AjusteTipoPor defectoDetalle
Ignorar a
masks
listavacíoUno por línea: un nick o una máscara nick!usuario@host (admite *).
Usar SILENCE si la red lo permite
silence
sí/nosí
Ejemplo
/msg *ignore add pesado
/msg *ignore add *!*@spam.example
/msg *ignore list
/msg *ignore del pesado

Desde IRC: /msg *status enable ignore y /msg *status get ignore

Quitar colores

stripcontrolsnuevo en 1.0

Quita colores, negritas, subrayados y parpadeos de los mensajes, también en el historial.

AjusteTipoPor defectoDetalle
Solo en estos canales
channels
listavacíoUno por línea. Vacío: en todos.
Ejemplo
Solo en estos canales:
#xbnc

Antes: \x0304,01rojo\x03 \x02negrita\x02   Después: rojo negrita

Desde IRC: /msg *status enable stripcontrols y /msg *status get stripcontrols

Codificación de caracteres

charsetnuevo en 1.0

Las tildes y la ñ se ven bien aunque el canal use Latin-1, y puedes escribir en Latin-1 donde haga falta.

xBNC siempre entiende los mensajes en Latin-1 que no son UTF-8. Este módulo elige la tabla exacta y en qué canales o privados envías tus mensajes en esa codificación (para gente con clientes muy antiguos).

AjusteTipoPor defectoDetalle
Codificación antigua
legacy
opciónwindows-1252Opciones: windows-1252 Windows-1252 (la más común), iso-8859-15 ISO-8859-15 (con €), iso-8859-1 ISO-8859-1 (Latin-1).
Enviar en esa codificación a
send_legacy
listavacíoCanales o nicks, uno por línea. * para todos. Vacío: siempre UTF-8.
Ejemplo
Codificación antigua: Windows-1252
Enviar en esa codificación a:
#xbnc
abuelo

Desde IRC: /msg *status enable charset y /msg *status get charset

Cifrado de mensajes (FiSH)

cryptnuevo en 1.0

Cifra tus mensajes en canales y privados con claves compartidas, compatible con FiSH de mIRC, HexChat e irssi.

En IRC: /msg *crypt setkey #canal clave, /msg *crypt keyx nick para acordar una clave en privado y +p delante de un mensaje para enviarlo sin cifrar. Las claves se guardan cifradas. FiSH protege de los servidores de la red, no sustituye al cifrado de extremo a extremo.

AjusteTipoPor defectoDetalle
Claves
keys
lista secretavacíoUna por línea: canal o nick y clave (cbc: delante para el modo CBC). Se guardan cifradas: escribe todas otra vez para cambiarlas.
Marca para los mensajes descifrados
prefix
textovacíoPor ejemplo [cifrado] . Vacío: sin marca.
Aceptar intercambios de claves (DH1080)
key_exchange
sí/nosíCuando alguien te propone una clave en privado.
Ejemplo
/msg *crypt setkey #xbnc cbc:una-clave-larga
/msg *crypt keyx bob          acordar una clave en privado (DH1080)
/msg *crypt list
/msg *crypt delkey #xbnc
+p hola                       envía este mensaje sin cifrar

Desde IRC: /msg *status enable crypt y /msg *status get crypt

Tareas programadas

schedulenuevo en 1.0

Comandos a una hora fija o cada cierto tiempo, en tu zona horaria.

La zona horaria se elige en Tu cuenta. Las tareas solo se ejecutan mientras la red está conectada.

AjusteTipoPor defectoDetalle
Tareas
tasks
listavacíoUna por línea: hora y comando (08:00 /away Trabajando), días y hora (lun-vie 18:00 /msg #canal me voy) o intervalo (cada 30m /msg #canal sigo aquí). Días: lun mar mie jue vie sab dom, laborables, finde.
Ejemplo
lun-vie 08:00 /away Trabajando
lun-vie 15:00 /away
finde 10:30 /msg #xbnc ¡Buenos días!
cada 2h /msg #xbnc-dev sigo aquí

Desde IRC: /msg *status enable schedule y /msg *status get schedule

Respuestas CTCP

ctcpactivo por defecto

Responde a VERSION, PING y TIME cuando no hay clientes conectados, frena las inundaciones de CTCP y permite ocultar tu versión.

AjusteTipoPor defectoDetalle
Peticiones CTCP permitidas cada 10 segundos
flood_limit
número (1–100)5
Respuesta a VERSION
version
textovacíoVacío: la de tu cliente, o la de xBNC si no hay ninguno conectado.
CTCP que ignorar
block
listavacíoUno por línea, por ejemplo TIME o FINGER.
Ejemplo
Peticiones CTCP permitidas cada 10 segundos: 5
Respuesta a VERSION: mIRC v7.77
CTCP que ignorar:
FINGER
TIME

Desde IRC: /msg *status enable ctcp y /msg *status get ctcp

Ocultar el MOTD

block_motd

No muestra a tus clientes el mensaje del día del servidor.

Ejemplo
Sin ajustes. Activado, tus clientes no reciben el mensaje del día del servidor.

Desde IRC: /msg *status enable block_motd y /msg *status get block_motd

Historial y DCC

Eventos en el historial

eventsactivo por defecto

Guarda entradas, salidas, kicks, cambios de nick, temas y modos junto a los mensajes.

Los clientes modernos los reciben como eventos reales; el resto, como mensajes de *events al reproducir el historial.

AjusteTipoPor defectoDetalle
Guardar entradas, salidas y desconexiones
joins
sí/nosíEn canales grandes generan mucho ruido.
Guardar kicks, cambios de nick, temas y modos
other
sí/nosí
Ejemplo
Con «Guardar kicks, cambios de nick, temas y modos» activado, al reproducir el historial
verás también: «bob ha cambiado el tema a: Reunión a las 20:00».

Desde IRC: /msg *status enable events y /msg *status get events

Registros en ficheros

log

Escribe cada conversación en ficheros de texto diarios, con el formato clásico de los registros de IRC.

Los ficheros quedan en el servidor, en la carpeta logs junto a la base de datos (por ejemplo /var/lib/xbnc/logs/usuario/red/#canal/2026-11-08.log). Las horas están en tu zona horaria (Tu cuenta).

AjusteTipoPor defectoDetalle
Borrar ficheros con más de (días)
retention_days
número (0–3650)00 los conserva para siempre.
Incluir eventos (entradas, salidas, kicks…)
events
sí/nosí
Ejemplo
/var/lib/xbnc/logs/y2k/undernet/#xbnc/2026-11-11.log

[18:30:12] <bob> hola a todos
[18:30:20] * carol ha entrado

Desde IRC: /msg *status enable log y /msg *status get log

Respuestas a quien pregunta

route_repliesactivo por defecto

Las respuestas a WHOIS, WHO, LIST, NAMES o listas de bans llegan solo al dispositivo que las pidió, no a todos.

Ejemplo
Si haces /whois bob desde el móvil, la respuesta llega solo al móvil,
no al portátil que también está conectado.

Desde IRC: /msg *status enable route_replies y /msg *status get route_replies

DCC a través de xBNC

dcc

Los envíos de ficheros y chats DCC pasan por xBNC: la otra persona no ve tu IP y funcionan aunque estés detrás de un router.

xBNC abre un puerto para cada envío y une las dos conexiones; no guarda nada en disco. En un servidor con IP pública funciona sin configurar nada; detrás de NAT, indica la IP pública en [dcc] public_ip de xbnc.toml y abre los puertos de [dcc] ports en el cortafuegos.

AjusteTipoPor defectoDetalle
Tamaño máximo por envío (MB)
max_size_mb
número (0–1000000)40960 = sin límite.
Segundos para aceptar un envío
wait
número (30–900)180
Permitir envíos desde direcciones privadas
private_addresses
sí/nonoDesactivado, xBNC no se conecta a redes internas (10.x, 192.168.x…) aunque alguien en IRC lo pida.
Ejemplo
# xbnc.toml, solo si el servidor está detrás de un router (NAT):
[dcc]
public_ip = "203.0.113.10"
ports = "50000-50100"

Desde IRC: /msg *status enable dcc y /msg *status get dcc

Siempre activos

Funciones del núcleo que no hace falta activar.

FunciónDónde se configura
Comandos al conectarEn la configuración de cada red.
Guardar canalesSiempre activo: tus /join y /part se recuerdan.
SASL y NickServEn la configuración de cada red.
Bloqueo de fuerza brutaEn Ajustes y Seguridad.
NotasEn Tu cuenta o con /msg *notes.
Última conexiónEn Usuarios y con /msg *status seen.
Historial por dispositivoSiempre activo, con búsqueda en cada red.
Administración web e IRCEste panel y /msg *status.

Plugins

Los plugins añaden funciones para todo el canal. Se ejecutan en WebAssembly, aislados: no pueden leer ficheros ni ver otras redes, tienen límites de CPU y memoria, y solo hacen lo que permiten sus permisos, que se ven antes de instalarlos. Los que salen a internet solo pueden conectarse a los sitios aprobados.

  1. Los 18 plugins oficiales vienen instalados: xBNC instala los que faltan al arrancar por primera vez y después de cada actualización, y actualiza los que tengan una versión antigua. Quedan desactivados en todas las redes. Uno que un superadministrador desinstala a propósito no vuelve hasta la siguiente versión de xBNC (o hasta que se instala de nuevo desde Plugins → Catálogo).
  2. Un superadministrador puede instalar otros desde el catálogo remoto o subiendo un fichero .wasm, y aprueba los sitios web de los plugins que salen a internet («Sitios a los que puede conectarse»): títulos de enlaces, el tiempo y noticias.
  3. Cada usuario los activa en sus redes desde Módulos, en la sección Plugins, y ajusta su configuración.
  4. Contestan en tu idioma de xBNC (o en el del ajuste «Idioma») y funcionan también con tus propios mensajes. Los oficiales hablan inglés y español; en otro idioma responden en inglés.
PermisoQué permite
sendEnviar mensajes y avisos.
rawComandos IRC como KICK, MODE o INVITE. Nunca QUIT, PASS, USER, NICK, CAP, AUTHENTICATE, OPER, SERVER ni SQUIT.
timerRecibir un evento cada minuto (o cada 5–60 segundos si el plugin lo pide).
presenceVer entradas, salidas, kicks, cambios de nick y la lista de usuarios de los canales.
httpPedir páginas https, solo a los dominios que declara (hasta 10) y que apruebe el superadministrador.

Trivial

trivia 1.0.0nuevo en 1.0

Juego de preguntas para tus canales, con pistas, puntos y ranking.

Cómo se usa

En un canal: !trivial para empezar, !trivial stop y !trivial top. Se responde escribiendo en el canal. /msg *trivia add ¿Pregunta? | respuesta añade preguntas propias; list y del N para gestionarlas.

Ejemplo
carol!trivial
y2k¡Empieza el trivial! 10 preguntas; responde escribiendo en el canal.
y2kPregunta 1/10: ¿Cuál es la capital de Japón?
bobtokio
y2k¡Correcto, bob! Era «Tokio». Llevas 1 punto.
AjustePor defectoDetalle
Comando
trigger
!trivia
Preguntas por partida
rounds
10
Segundos para responder
seconds
40A mitad de tiempo sale una pista.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, temporizador. Ayuda desde IRC: /msg *trivia ayuda

Bienvenida

greet 1.0.0nuevo en 1.0

Saluda a quien entra en tus canales, con un mensaje distinto la primera vez y saludos personales.

Cómo se usa

Automático. /msg *greet test #canal nick muestra qué se diría. En los mensajes se cambian {nick} y {channel}.

Ejemplo
* carol ha entrado en #xbnc
y2k¡Bienvenido a #xbnc, carol! Es tu primera vez por aquí.
AjustePor defectoDetalle
La primera vez
first
¡Bienvenido a {channel}, {nick}! Es tu primera vez por aquí.Para quien nunca ha estado en el canal. Se cambian {nick} y {channel}.
Cuando vuelven
message
Hola {nick}, bienvenido de nuevo a {channel}.Vacío: no se saluda a quien vuelve.
Saludos personales
personal
vacíoUno por línea: nick y mensaje. Sustituye al habitual para esa persona.
Saludar en privado (notice)
notice
noDesactivado: el saludo se escribe en el canal.
Minutos antes de volver a saludar a la misma persona
cooldown
30
No saludar nunca
ignore
vacíoNicks, uno por línea (bots, servicios).
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, entradas y salidas. Ayuda desde IRC: /msg *greet ayuda

Títulos de enlaces

urltitle 1.0.0nuevo en 1.0

Muestra el título de los enlaces de YouTube, Vimeo, SoundCloud, Dailymotion y Spotify, artículos de Wikipedia y repositorios de GitHub que se pegan en tus canales.

Cómo se usa

Automático. Un administrador aprueba cada sitio en el panel (Plugins → «Sitios a los que puede conectarse»).

Ejemplo
bobmirad esto https://www.youtube.com/watch?v=…
y2kYouTube: Cómo montar un bouncer IRC en 5 minutos
AjustePor defectoDetalle
Segundos entre títulos en un canal
cooldown
5
También para tus propios enlaces
own
sí
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, acceso web a sitios aprobados. Ayuda desde IRC: /msg *urltitle ayuda

Definiciones

factoids 1.0.0nuevo en 1.0

La memoria del canal: respuestas cortas a preguntas frecuentes que tú y tus editores mantenéis al día.

Cómo se usa

En un canal: !def palabra (o ?palabra), !def palabra = texto, !def -palabra, !defs. Aquí: /msg *factoids palabra.

Ejemplo
y2k!def normas = Sé respetuoso y no hagas flood.
carol?normas
y2knormas: Sé respetuoso y no hagas flood.
AjustePor defectoDetalle
Comando
trigger
!def
Responder también a ?palabra
question_mark
sí
Quién más puede cambiar definiciones
editors
vacíoNicks, uno por línea. Tú siempre puedes.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *factoids ayuda

El tiempo

weather 1.0.0nuevo en 1.0

El tiempo ahora y la previsión de hoy para cualquier ciudad, de Open-Meteo (gratis, sin clave).

Cómo se usa

En un canal: !tiempo Madrid o !weather London. Aquí: /msg *weather Sevilla.

Ejemplo
bob!tiempo Sevilla
y2kSevilla (España): 22 °C, cielo despejado, viento 9 km/h, humedad 40 %. Hoy entre 14 y 25 °C.
AjustePor defectoDetalle
Comando
trigger
!weather
Ciudad por defecto
city
vacíoSe usa cuando no se escribe ninguna.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, acceso web a sitios aprobados. Ayuda desde IRC: /msg *weather ayuda

Noticias

news 1.0.0nuevo en 1.0

Publica en tus canales las novedades de fuentes RSS y Atom (periódicos, blogs, canales de YouTube, versiones de GitHub).

Cómo se usa

Configura las fuentes en el panel: una por línea, «#canal https://...». /msg *news list, /msg *news check.

Ejemplo
y2k[Hacker News] Show HN: un bouncer IRC escrito en Rust — https://…
AjustePor defectoDetalle
Fuentes
feeds
vacíoUna por línea: canal y dirección, por ejemplo #xbnc https://hnrss.org/frontpage. Un administrador aprueba los sitios.
Minutos entre comprobaciones
interval
15
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, temporizador, acceso web a sitios aprobados. Ayuda desde IRC: /msg *news ayuda

Karma

karma 1.0.0nuevo en 1.0

Puntos entre personas: nick++ y nick--, con ranking.

Cómo se usa

En un canal: nick++, nick--, !karma nick, !karma top. Aquí: /msg *karma nick.

Ejemplo
bobcarol++
y2kcarol tiene 1 de karma.
carol!karma top
AjustePor defectoDetalle
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *karma ayuda

Citas

quotes 1.0.0nuevo en 1.0

Frases memorables del canal: guárdalas, búscalas y saca una al azar.

Cómo se usa

En un canal: !cita, !cita 12, !cita buscar palabra, !cita añadir texto, !cita borrar 12 (o !quote add/search/del).

Ejemplo
bob!cita añadir hoy es un gran día
y2kCita 1 guardada.
carol!cita 1
y2k#1: hoy es un gran día
AjustePor defectoDetalle
Comando
trigger
!quote
Cualquiera puede añadir citas
anyone_adds
síDesactivado: solo tú y los editores.
Editores
editors
vacíoNicks que pueden añadir y borrar citas, uno por línea.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *quotes ayuda

Palabras prohibidas

badwords 1.0.0nuevo en 1.0

Avisa, echa y al final banea a quien escribe palabras prohibidas en tus canales (necesitas op).

Cómo se usa

Pon las palabras en el panel. /msg *badwords test texto dice si un texto se detectaría.

Ejemplo
caroleres tontito
y2kcarol: esa palabra no está permitida aquí. La próxima vez, kick.
AjustePor defectoDetalle
Palabras prohibidas
words
vacíoUna por línea. Da igual mayúsculas y tildes; un * al final vale por el principio de una palabra.
Duración del ban (minutos)
ban_minutes
100: el ban se queda.
Motivo del kick
reason
vacío
Avisar en privado (notice)
warn_private
no
No actuar nunca sobre
exempt
vacíoNicks, uno por línea.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, comandos IRC (kick, ban), temporizador. Ayuda desde IRC: /msg *badwords ayuda

Juegos

games 1.0.0nuevo en 1.0

Ahorcado, bola 8 mágica y piedra, papel o tijera para tus canales.

Cómo se usa

En un canal: !8ball pregunta, !ppt piedra (o !rps rock), !ahorcado (o !hangman) y !a letra para jugar.

Ejemplo
bob!ppt piedra
y2kpiedra contra tijera: ¡ganas, bob!
bob!8ball ¿funcionará?
y2kLa bola 8 dice: «Pregunta más tarde».
AjustePor defectoDetalle
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *games ayuda

Dados

dice 1.1.0

Tira dados en canales y privados: !dado, !dado 2d6, !dado d20.

Cómo se usa

En un canal o privado: !dado (un dado de seis caras), !dado 2d6, !dado d20. También !roll y !dice.

/msg *dice 3d8 tira solo para ti.

Ejemplo
bob!dado 2d6
y2kbob tira 2 dados de 6 caras: 3 y 5 (total 8).
AjustePor defectoDetalle
Comando adicional
trigger
!roll!dado, !dados, !roll y !dice funcionan siempre.
Máximo de dados por tirada
max_dice
10
Responder en privados
in_queries
sí
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *dice ayuda

Encuestas

poll 1.1.0

!poll ¿Pregunta? | opción | opción, y luego !vote N. Se cierra sola y anuncia la ganadora.

Cómo se usa

En un canal: !poll ¿Pizza o sushi? | pizza | sushi (hasta 10 opciones) — vota con !vote 1 — !poll muestra el recuento — !poll end la cierra (quien la creó, o tú). Se cierra sola pasados los minutos de los ajustes. También !encuesta y !votar.

Ejemplo
carol!poll ¿Café o té? | café | té
bob!vote 2
*pollVoto registrado en #xbnc: 2) té. Puedes cambiarlo votando otra vez.
AjustePor defectoDetalle
Comando
trigger
!poll
Comando para votar
vote_trigger
!vote
Minutos hasta que se cierra
minutes
60
Otras personas pueden crear encuestas
public
síDesactivado: solo las creas tú; votar puede todo el mundo.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, temporizador. Ayuda desde IRC: /msg *poll ayuda

Recordatorios

remind 1.1.0

Te lo recuerda (a ti o a cualquiera del canal) pasado un tiempo o a una hora: !recuerda 10m sacar la pizza, !recuerda 18:30 reunión.

Cómo se usa

En un canal: !recuerda 10m sacar la pizza — !recuerda 2 horas llamar a Bob — !recuerda 1h30m … — !recuerda 18:30 reunión — !recuerda lista — !recuerda borrar. También !remind.

/msg *remind 10m … te lo recuerda en privado. Los recordatorios se comprueban cada minuto.

Ejemplo
bob!recuerda en 10 minutos sacar la pizza
y2kbob: vale, te lo recuerdo dentro de 10 minutos.
y2kbob: sacar la pizza
AjustePor defectoDetalle
Comando adicional
trigger
!remind!remind y !recuerda funcionan siempre.
Otras personas pueden crear recordatorios
public
síDesactivado: solo los tuyos y /msg *remind.
Recordatorios pendientes por persona
max_per_nick
10
Zona horaria para horas como 18:30
timezone
Europe/MadridEurope/Madrid, Europe/London, UTC o una diferencia como +1.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, temporizador. Ayuda desde IRC: /msg *remind ayuda

Mensajes diferidos

tell 1.1.0

!tell nick mensaje: se lo da en el canal cuando esa persona escriba o entre.

Cómo se usa

En un canal: !tell bob el build está arreglado — bob lo recibe en el canal en cuanto escriba algo o entre. Funciona para ti y para cualquiera del canal. También !avisa.

Ejemplo
y2k!tell carol el build está arreglado
y2ky2k: vale, se lo diré a carol en cuanto escriba o entre en el canal.
* carol ha entrado en #xbnc
y2kcarol: y2k te dejó un mensaje hace 5 minutos: el build está arreglado
AjustePor defectoDetalle
Comando
trigger
!tell
Entregar al entrar
on_join
síDesactivado: solo cuando escriba algo.
Mensajes esperando por persona
max_per_nick
5
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, entradas y salidas. Ayuda desde IRC: /msg *tell ayuda

Respuestas automáticas

autoresponder 1.1.0

Responde solo cuando alguien escribe una palabra clave y, si quieres, a los privados mientras estás ausente.

Cómo se usa

Escribe las reglas en los ajustes, una por línea: palabra = respuesta. {nick} es quien escribió y {channel} el canal. La regla * = texto responde a cualquier privado.

/msg *autoresponder muestra las reglas; /msg *autoresponder test <texto> las prueba.

Ejemplo
bobhola, ¿alguien?
y2k¡Hola bob! Ahora mismo no estoy, déjame tu mensaje.
AjustePor defectoDetalle
Reglas
rules
vacíoUna por línea: palabra = respuesta. Ejemplo: hola = ¡Hola {nick}! — * = respuesta a cualquier privado.
Segundos antes de que la misma regla vuelva a responder
cooldown
60
Responder también a privados
in_queries
sí
Solo cuando no hay ningún cliente conectado
only_when_away
noAsí responde por ti mientras estás ausente.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de los mensajes
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes. Ayuda desde IRC: /msg *autoresponder ayuda

Estadísticas del canal

chanstats 1.1.0

!stats: mensajes del canal y quién habla más. !stats nick: lo de una persona.

Cómo se usa

En un canal: !stats muestra los mensajes y quién habla más — !stats bob, lo de una persona. /msg *chanstats #canal te lo muestra en privado. Los recuentos se guardan cada minuto. También !estadisticas y !top.

Ejemplo
bob!stats
y2k#xbnc: 1204 mensajes desde el 3 nov 2026. Más activos: carol 312, bob 280, y2k 199.
AjustePor defectoDetalle
Comando
trigger
!stats
Personas en la clasificación
top
5
Responder a otras personas
public
síDesactivado: solo tu propio !stats.
Solo en estos canales
channels
vacíoUno por línea. Vacío: en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, temporizador. Ayuda desde IRC: /msg *chanstats ayuda

Visto por última vez

seen 2.1.0

!seen nick: cuándo se vio a alguien por última vez y qué hacía, o en qué canales está ahora.

Cómo se usa

En un canal: !seen bob — cuándo se vio a bob por última vez y si está ahora. /msg *seen bob, o /msg *seen stats.

Ejemplo
bob!seen carol
y2kcarol fue visto por última vez hace 2 horas, en #xbnc diciendo «me voy a cenar».
AjustePor defectoDetalle
Comando
trigger
!seenLo que se escribe antes del nick.
Responder a otras personas en los canales
public
síDesactivado: solo te responde a ti (tu propio !seen y /msg *seen).
Segundos entre respuestas en un canal
cooldown
5
Mostrar lo último que dijo
show_text
síDesactivado: solo dice dónde y cuándo.
Responder solo en estos canales
channels
vacíoUno por línea. Vacío: en todos. La actividad se registra en todos.
Idioma de las respuestas
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: enviar mensajes, entradas y salidas. Ayuda desde IRC: /msg *seen ayuda

Anti-flood

antiflood 1.1.0

Avisa, expulsa o banea a quien hace flood o repite mensajes en tus canales (tienes que ser operador del canal).

Cómo se usa

Funciona solo, en los canales que pongas en los ajustes (tienes que ser operador allí). /msg *antiflood muestra cómo está configurado.

Ejemplo
spama
spama
spama
* spam ha sido expulsado de #xbnc por y2k (flood)
AjustePor defectoDetalle
Canales que proteger
channels
vacíoUno por línea. No hace nada hasta que pongas alguno.
Máximo de líneas
lines
5
En estos segundos
seconds
4
Misma línea repetida
repeats
3Veces seguidas; 0 lo desactiva.
Qué hacer
action
kickwarn (avisar la primera vez y expulsar la segunda), kick o ban.
Duración del ban en minutos
ban_minutes
100: el ban no se quita.
Motivo de la expulsión
reason
vacío
No actuar nunca contra estos nicks
exempt
vacíoUno por línea.
Idioma de los mensajes
lang
vacíoVacío: tu idioma en xBNC. O es / en.

Permisos: comandos IRC (kick, ban), enviar mensajes, temporizador. Ayuda desde IRC: /msg *antiflood ayuda

Usuarios, roles y seguridad

Roles

RolPara quién
superadminTodo, incluidos los ajustes del sistema, los plugins, las copias de seguridad, las actualizaciones, la importación y gestionar otros administradores.
adminGestiona usuarios (salvo administradores y superadministradores), todas las redes y la seguridad; ve el sistema.
moderatorVe los usuarios y la auditoría, y puede suspender y reactivar usuarios normales y limitados.
userGestiona sus propias redes, canales e historial. Es el rol por defecto.
limitedUsa redes que le prepara un administrador; gestiona canales e historial, pero no añade, edita ni borra redes.

Qué puede hacer cada rol

Permisosuperadminadminmoderatoruserlimited
Editar ajustes del sistema, instalar plugins, copias de seguridad, importar, actualizarsí————
Ver el sistema, gestionar usuarios, seguridad y todas las redessísí———
Ver usuarios y auditoría, suspender usuariossísísí——
Gestionar sus propias redessísísísí—
Usar sus redes, canales, historial, chat, módulos y pluginssísísísísí

Un administrador solo gestiona roles por debajo del suyo; nadie puede cambiarse su propio rol ni elevarse, y siempre queda al menos un superadministrador. Los usuarios no ven las redes de otros (la API responde 404).

Cuentas

  • Nombres de usuario: de 1 a 32 caracteres A-Z a-z 0-9 . _ -, sin distinguir mayúsculas. Contraseñas: al menos 10 caracteres.
  • Cuotas por usuario: redes (max_networks), dispositivos (max_clients) y espacio de historial en MB (max_history_mb). Vacío: lo general del servidor.
  • Suspender una cuenta cierra su acceso y desconecta sus redes. Borrarla elimina también sus redes e historial.
  • Cambiar o restablecer la contraseña cierra las demás sesiones del panel de esa cuenta.

Formas de entrar al panel

  • Usuario y contraseña, con verificación en dos pasos opcional (TOTP, RFC 6238, con QR) usando Google Authenticator, Aegis, 1Password u otra compatible. El secreto se guarda cifrado; un código incorrecto cuenta como intento fallido. Los clientes IRC siguen entrando solo con contraseña: el protocolo no admite un segundo paso.
  • Passkeys (WebAuthn): entrar con la huella, la cara o el PIN del dispositivo. Se añaden y se quitan en Tu cuenta.
  • OpenID Connect (Google, Microsoft, Keycloak, Authentik…) y LDAP, si el administrador los configura en xbnc.toml (ver Configuración). Una cuenta externa se vincula y desvincula en Tu cuenta.

Medidas de seguridad

ÁreaMedida
ContraseñasArgon2id (m = 19 MiB, t = 2, p = 1). Un usuario que no existe cuesta lo mismo de comprobar, para no revelar qué cuentas existen. Como mucho un cálculo por CPU a la vez, para que una avalancha de intentos no agote la memoria.
Credenciales guardadasContraseñas SASL y de servidor, claves de canal, comandos al conectar, contraseñas de servicios, claves FiSH, secretos TOTP y claves de certificados, cifrados con XChaCha20-Poly1305. La clave está fuera de la base de datos (secret.key, permisos 0600 comprobados al arrancar).
TLSrustls, solo TLS 1.2 y 1.3. Hacia las redes se verifica el certificado con el almacén del sistema, sin opción para desactivarlo. Un certificado de confianza (addfingerprint) solo acepta esa huella SHA-256 exacta, y se siguen comprobando las firmas del saludo TLS.
Texto planoProhibido en direcciones públicas salvo insecure = true explícito. El puerto sin TLS por defecto solo acepta la red local.
Fuerza brutaBloqueo de IP tras 5 fallos en 10 minutos durante 15 minutos (configurable), compartido entre IRC (PASS y SASL), el panel y los tokens de API. Máximo 16 conexiones IRC sin autenticar por IP.
RegistrosNunca se registran contraseñas, AUTHENTICATE, OPER ni mensajes a servicios (NickServ IDENTIFY, X LOGIN, Q AUTH…), en ningún nivel.
EntradaLíneas limitadas a 8703 bytes; cualquier CR o LF dentro de una línea la corta, para impedir inyección de comandos; nicks, nombres y textos de módulos y plugins validados.
RecursosLímites de conexiones totales, de clientes y redes por usuario; colas acotadas por cliente y hacia el servidor; tiempo máximo de registro.
SQLTodas las consultas usan parámetros enlazados.
PrivilegiosEl servicio corre como xbnc sin privilegios, con aislamiento de systemd. En Docker: usuario sin privilegios, solo lectura, sin capacidades.
Panel: sesionesToken aleatorio de 256 bits en cookie HttpOnly, SameSite=Strict y Secure; en la base de datos solo su SHA-256. Caducidad deslizante (12 h por defecto).
Panel: CSRF y origenToken CSRF obligatorio en toda petición que cambia algo; peticiones y WebSockets con Origin de otro sitio rechazados.
Panel: cabecerasCSP estricta sin scripts externos ni en línea, X-Frame-Options: DENY, nosniff, Referrer-Policy: no-referrer, HSTS con TLS y Cache-Control: no-store en la API.
Panel: abuso20 peticiones por segundo por IP, cuerpos de hasta 256 KB (4 MB para plugins), 64 conexiones por IP y 4 096 en total, cierre tras 2 minutos sin tráfico y 10 s para el saludo TLS. Con trust_proxy se usa la IP real detrás de Nginx.
Primer accesoLa primera cuenta solo se crea con un código de un solo uso que el servicio escribe en su registro.
Secretos en la APILas contraseñas nunca se devuelven; solo se indica si existen.
Tokens de API256 bits con prefijo xbnc_; solo se guarda su SHA-256. Alcance, caducidad, último uso e IP visibles, revocación inmediata.
MódulosCompilados dentro del programa: no se carga código externo. Op automático: *!*@* se rechaza; con clave, desafío aleatorio respondido con HMAC-SHA256 y comparado en tiempo constante.
Registros en ficherosRutas construidas solo con nombres saneados (un canal no puede salir de su carpeta), carpetas 0700 y ficheros 0600.
PluginsWebAssembly en el intérprete Wasmi, con combustible (CPU) por evento, 16 MB de memoria, sin acceso a ficheros ni red propia. Acciones comprobadas contra los permisos. Solo un superadministrador instala, viendo la huella SHA-256; un fichero que cambia tras instalarse no se carga. Cinco fallos seguidos lo detienen.
DCCLas ofertas de IRC no pueden hacer que xBNC se conecte a redes internas ni a puertos por debajo de 1024 (salvo permiso). En tus envíos solo se conecta de vuelta a la IP de tu dispositivo. Cada puerto acepta una sola conexión, con tiempo de espera, límite de tamaño y cierre por inactividad.
Login en serviciosEn redes sin NickServ (IRCnet, EFnet) el modo automático nunca envía la contraseña.
TraduccionesLos ficheros de idioma son datos, no código: un texto de IRC con saltos de línea o caracteres de control, o con marcadores distintos de los del inglés, se ignora. Ficheros de 2 MB como máximo y 100 idiomas.
FiSHEl intercambio de claves admite 5 peticiones por minuto y 100 claves por sesión; el texto descifrado no puede romper líneas.
WebhooksSolo http(s), sin usuario en la URL ni caracteres de control, certificado verificado, sin seguir redirecciones, 10 s como máximo.
ImportaciónSolo un superadministrador; nunca concede ese rol; la vista previa no devuelve secretos.
AuditoríaCada acción del panel, de IRC y de la terminal queda registrada con fecha, autor y detalle (Seguridad → Auditoría, o xbncd audit).
FuzzingParser IRC, DCC, importador, búsqueda, manifiestos y ejecución de plugins, cada semana en el CI con los fallos anteriores como regresiones.

Recomendaciones

  • Usa un certificado real (Let's Encrypt) y no publiques puertos en texto plano.
  • Guarda las copias de seguridad cifradas: contienen la clave secreta.
  • Todas las conexiones a las redes salen de la IP del servidor: si un usuario abusa en una red, la IP del servidor puede acabar bloqueada.
  • Activa la verificación en dos pasos o una passkey en las cuentas de administración.

Para avisar de una vulnerabilidad, sigue SECURITY.md: no la publiques; usa el aviso privado del repositorio. Respuesta en 3 días como máximo, evaluación en 7 y corrección en 90 como mucho. El modelo de amenazas completo está en Modelo de amenazas.

Configuración (xbnc.toml)

/etc/xbnc/xbnc.toml solo guarda ajustes del proceso: usuarios, redes y canales están en la base de datos. El instalador lo crea por ti. Tras editarlo: sudo xbncd check-config y sudo systemctl restart xbnc. Una clave desconocida es un error, para que una errata no pase desapercibida. Lo de Ajustes en el panel tiene prioridad sobre [history] y [limits].

General

ClavePor defectoQué hace
hostnamexbncNombre del servidor que ven los clientes.
languageenIdioma por defecto de los mensajes de IRC y del panel: en, es o cualquier idioma instalado en locales_dir. Cada usuario puede elegir el suyo. El instalador pone el que elijas.
locales_dir/etc/xbnc/localesCarpeta de idiomas adicionales y correcciones (un fichero <código>.json por idioma, ver Traducir xBNC). Se lee al arrancar y al recargar. La variable de entorno XBNC_LOCALES_DIR tiene prioridad.
secret_key_fileobligatoriaRuta de la clave de 32 bytes que cifra las credenciales. La crea xbncd init con permisos 0600. Haz copia: sin ella no se pueden descifrar.

[database]

ClavePor defectoQué hace
pathobligatoriaFichero SQLite. Su carpeta es también la de datos (plugins, registros, copias).
url—PostgreSQL en lugar de SQLite: postgres://usuario:clave@host/base. Añade ?sslmode=require para cifrar la conexión.
hafalseAlta disponibilidad (necesita url): varios nodos comparten la base de datos; uno trabaja y los demás esperan para tomar el relevo.

[[listen]] (uno por puerto)

ClavePor defectoQué hace
addressobligatoriaDirección y puerto: 0.0.0.0:6697 o [::]:6697.
tls_cert—Cadena del certificado (PEM). Obligatoria salvo insecure, lan_only o una dirección de loopback.
tls_key—Clave privada (PEM).
insecurefalsePermitir texto plano en una dirección pública (desaconsejado).
lan_onlyfalseSolo clientes de la red local (loopback, privadas, enlace local, CGNAT/Tailscale, IPv6 ULA). El resto recibe un ERROR explicativo. Puede ir sin TLS.

[web]

ClavePor defectoQué hace
addressobligatoriaDirección del panel y la API, por ejemplo 0.0.0.0:8443 o 127.0.0.1:8080. Sin [web], no hay panel.
tls_cert, tls_key—Certificado del panel.
insecurefalseHTTP sin cifrar en una dirección pública (solo detrás de un proxy TLS en una red de confianza).
secure_cookiestrue con TLSMarca la cookie de sesión como Secure. Ponlo a true detrás de un proxy TLS.
public_url—URL pública del panel (https://bnc.ejemplo.org). Se usa para comprobar el Origin de las peticiones y como base de OpenID Connect.
session_hours12Duración de la sesión en horas (deslizante).
trust_proxyfalseFiarse de X-Forwarded-For y X-Real-IP de un proxy en loopback, para que el bloqueo use la IP real.

[history]

ClavePor defectoQué hace
retention_days30Borrar mensajes de más de N días. 0, para siempre.
playback_max1000Máximo de mensajes reproducidos al reconectar.
new_client_playback100Mensajes para un dispositivo que nunca se había conectado.
chathistory_max500Máximo limit aceptado en CHATHISTORY.

[limits]

ClavePor defectoQué hace
max_connections1000Conexiones IRC de clientes en total.
max_clients_per_user10Dispositivos conectados por usuario.
max_networks_per_user10Redes por usuario.
login_max_failures5Fallos antes de bloquear una IP.
login_window_seconds600Ventana en la que se cuentan los fallos.
login_block_seconds900Duración del bloqueo.
registration_timeout_seconds30Tiempo para completar el login de un cliente.
client_queue4096Líneas en cola por cliente antes de desconectarlo por lento (al volver recupera lo pendiente).

[log]

ClavePor defectoQué hace
levelinfoFiltro: error, warn, info, debug, trace, o por módulo (info,xbncd=debug). La variable RUST_LOG tiene prioridad. Las credenciales se enmascaran en todos los niveles.

[dcc]

ClavePor defectoQué hace
public_ipla que usa xBNC hacia la redDirección que se anuncia en IRC. Necesaria detrás de NAT. Si la conexión con la red es IPv6, se anuncia la IPv4 pública.
portscualquiera libreRango para los túneles, por ejemplo 50000-50100 (ábrelo en el cortafuegos y el router).

[smtp] (avisos por correo)

ClavePor defectoQué hace
hostobligatoriaServidor de correo.
port587Puerto.
securitystarttlsstarttls, tls (puerto 465) o none (solo relés locales).
username, password—Credenciales.
fromobligatoriaRemitente, por ejemplo xBNC <xbnc@ejemplo.org>.

[oidc] (OpenID Connect)

ClavePor defectoQué hace
name—Texto del botón (Google, Keycloak…).
issuerobligatoriaURL del emisor; se lee su /.well-known/openid-configuration.
client_id, client_secretobligatoriasDatos de la aplicación registrada en el proveedor. La dirección de retorno es https://TU-PANEL/api/v1/auth/oidc/callback (usa public_url).
scopesopenid profile emailAlcances que se piden.
username_claimpreferred_usernameDato que se usa como nombre de las cuentas creadas automáticamente.
auto_createfalseCrear la cuenta de xBNC la primera vez que alguien entra.
link_existingfalseVincular con una cuenta local del mismo nombre (solo con proveedores que controles).
default_roleuserRol de las cuentas creadas.
allowed_groups[] (todos)Si se indica, solo pueden entrar miembros de alguno de estos grupos.
groups_claimgroupsDato con los grupos.

[ldap]

ClavePor defectoQué hace
urlobligatorialdaps://host:636, o ldap://host:389 con starttls = true.
starttlsfalseUsar STARTTLS.
bind_dnobligatoriaDN con el que se entra; {{username}} se cambia por el nombre escrito.
ca_filecertificados del sistemaFichero PEM con la autoridad del servidor LDAP.
auto_create, link_existing, default_rolefalse, false, userIgual que en [oidc].

[updates]

ClavePor defectoQué hace
checktrueComprobar una vez al día si hay versión nueva (y cuando un administrador lo pide). No descarga nada.
repository—Repositorio de GitHub con las versiones (dueño/nombre).
url—O cualquier URL https que responda {{"version", "url", "notes", "packages"}}.
public_key—Clave pública Ed25519 de las versiones. Con ella, y xBNC instalado desde paquete, un superadministrador puede actualizar desde el panel.

[catalog] (catálogo remoto de plugins)

ClavePor defectoQué hace
url—Dirección https:// del índice JSON.
public_key—Clave pública Ed25519 (base64) que firma el índice.

Ejemplo completo

hostname = "bnc.ejemplo.org"
language = "es"
secret_key_file = "/var/lib/xbnc/secret.key"

[database]
path = "/var/lib/xbnc/xbnc.db"
# url = "postgres://xbnc:clave@127.0.0.1/xbnc?sslmode=require"
# ha = true

[[listen]]
address = "0.0.0.0:6697"
tls_cert = "/etc/xbnc/tls/fullchain.pem"
tls_key = "/etc/xbnc/tls/privkey.pem"

[[listen]]
address = "0.0.0.0:6667"
lan_only = true

[web]
address = "0.0.0.0:8443"
tls_cert = "/etc/xbnc/tls/fullchain.pem"
tls_key = "/etc/xbnc/tls/privkey.pem"
public_url = "https://bnc.ejemplo.org:8443"
session_hours = 12

[history]
retention_days = 30
playback_max = 1000
new_client_playback = 100
chathistory_max = 500

[limits]
max_connections = 1000
max_clients_per_user = 10
max_networks_per_user = 10
login_max_failures = 5
login_window_seconds = 600
login_block_seconds = 900
registration_timeout_seconds = 30
client_queue = 4096

[log]
level = "info"

[dcc]
public_ip = "203.0.113.10"
ports = "50000-50100"

[smtp]
host = "smtp.ejemplo.org"
port = 587
security = "starttls"
username = "xbnc@ejemplo.org"
password = "..."
from = "xBNC <xbnc@ejemplo.org>"

[oidc]
name = "Keycloak"
issuer = "https://sso.ejemplo.org/realms/casa"
client_id = "xbnc"
client_secret = "..."
auto_create = true
default_role = "user"
allowed_groups = ["irc"]

[ldap]
url = "ldaps://ldap.ejemplo.org:636"
bind_dn = "uid={username},ou=people,dc=ejemplo,dc=org"

[updates]
repository = "dueño/xbnc"

[catalog]
url = "https://plugins.ejemplo.org/index.json"
public_key = "BASE64..."

Línea de comandos

Todos los comandos aceptan -c RUTA (o la variable XBNC_CONFIG; por defecto /etc/xbnc/xbnc.toml), -h para la ayuda y -V para la versión. Los que escriben en la base de datos se ejecutan como el usuario del servicio: sudo -u xbnc xbncd … (en Docker, docker compose exec xbnc xbncd …). Después, sudo systemctl reload xbnc para que el servicio aplique los cambios de usuarios, redes y canales. Cada acción queda en la auditoría.

ComandoQué haceOpciones
xbncd runEjecuta el bouncer en primer plano (lo hace el servicio). SIGHUP (systemctl reload) relee redes, canales, usuarios e idiomas.—
xbncd initCrea la base de datos y la clave secreta.—
xbncd check-configComprueba el fichero de configuración y termina.—
xbncd infoMuestra la dirección del panel y cómo se conectan los clientes.—
xbncd setup-codeMuestra el código de un solo uso para crear el primer administrador.—
xbncd user add NOMBRECrea un usuario. La contraseña se pide dos veces, se lee de la entrada con --password-stdin o de XBNC_PASSWORD.--role superadmin|admin|moderator|user|limited (user por defecto); --admin (atajo de --role superadmin); --password-stdin
xbncd user listLista los usuarios.—
xbncd user passwd NOMBRECambia la contraseña.--password-stdin
xbncd user role NOMBRE ROLCambia el rol.—
xbncd user enable|disable NOMBREReactiva o suspende una cuenta (tras reload, sus redes se desconectan).—
xbncd user reset-2fa NOMBREQuita la verificación en dos pasos (móvil perdido).—
xbncd user delete NOMBRE --yesBorra el usuario, sus redes y su historial.--yes (confirmar)
xbncd network add USUARIO NOMBRE --host SERVIDORAñade una red. Las contraseñas SASL y de servidor se piden o se leen de XBNC_SASL_PASSWORD y XBNC_SERVER_PASSWORD.--port (6697); --no-tls; --nick; --username; --realname; --server-password; --sasl-user CUENTA
xbncd network list USUARIOLista las redes de un usuario.—
xbncd network enable|disable USUARIO NOMBREActiva o desactiva una red.—
xbncd network delete USUARIO NOMBRE --yesBorra una red.--yes
xbncd channel add USUARIO RED CANALGuarda un canal para entrar automáticamente.--key (pide la clave del canal)
xbncd channel list USUARIO REDLista los canales guardados.—
xbncd channel delete USUARIO RED CANALQuita un canal guardado.—
xbncd plugin install FICHERO.wasmInstala o actualiza un plugin; cada usuario lo activa en sus redes.--yes (aceptar los permisos que pide)
xbncd plugin listLista los plugins instalados.—
xbncd plugin remove IDDesinstala un plugin y borra sus ajustes en todas las redes.—
xbncd plugin check FICHERO.wasmComprueba un plugin y muestra su manifiesto.—
xbncd plugin pack PLUGIN.wasm MANIFIESTO.json -o SALIDA.wasmMete el manifiesto (JSON) dentro de un plugin compilado.-o, --output (obligatoria)
xbncd plugin catalog-keygen -o CLAVEPara publicar un catálogo: crea la clave de firma (guárdala bien).-o, --output
xbncd plugin catalog-entry FICHERO.wasm URLPara publicar un catálogo: imprime la entrada del índice de un plugin publicado en URL (https://).—
xbncd plugin catalog-sign --key CLAVE ÍNDICEPara publicar un catálogo: firma el índice (escribe ÍNDICE.sig).-k, --key
xbncd backup DESTINOCopia consistente de la base de datos, con xBNC en marcha.—
xbncd migrate-to-postgres URLCopia la base de datos SQLite a una PostgreSQL nueva y vacía. Para xBNC antes; después pon database.url.—
xbncd import RUTATrae usuarios, redes, canales y módulos de otro bouncer (su carpeta de datos, con configs/ y users/, o su fichero de configuración). Sin --apply no escribe nada.--apply; --logs (también los registros); --utc-offset ZONA (+02:00 o Europe/Madrid; +00:00 por defecto)
xbncd import-logs USUARIO RED CARPETAImporta registros de texto (una carpeta por canal con ficheros AAAA-MM-DD.log) al historial de una red. Se puede repetir sin duplicar.--utc-offset ZONA
xbncd auditÚltimas acciones administrativas.--limit N (50)
xbncd release keygenPara publicar versiones: crea el par de claves de firma. La pública va en [updates] public_key.--out FICHERO (xbnc-release.key)
xbncd release sign FICHEROS…Escribe FICHERO.sig junto a cada paquete. La clave privada se lee de XBNC_RELEASE_KEY o de --key.--key
xbncd release verify --public-key CLAVE FICHEROS…Comprueba las firmas .sig.—
xbncd apply-updateInstala una actualización pedida desde el panel (lo ejecuta como root el servicio xbnc-update; vuelve a comprobar la firma).—
xbncd locales check FICHEROS…Comprueba ficheros de idioma contra el inglés: textos que faltan, textos que xBNC no usa, {0} o etiquetas <b> rotas. No necesita la configuración.--missing (lista también lo que falta)
xbncd locales listIdiomas que ofrece este servidor, con el porcentaje traducido de cada uno.—

Ejemplos

sudo xbncd info
sudo xbncd setup-code
sudo -u xbnc xbncd user add alicia
sudo -u xbnc xbncd user add carla --role moderator
echo 'una-contraseña-larga' | sudo -u xbnc xbncd user add bob --password-stdin
sudo -u xbnc xbncd user role carla admin
sudo -u xbnc xbncd user reset-2fa alicia
sudo -u xbnc xbncd network add alicia libera --host irc.libera.chat --sasl-user alicia
sudo -u xbnc xbncd network add alicia undernet --host irc.undernet.org --port 6667 --no-tls
sudo -u xbnc xbncd channel add alicia libera '#xbnc' --key
sudo -u xbnc xbncd backup /var/lib/xbnc/copia.db
sudo -u xbnc xbncd import /home/antiguo/.bouncer --logs --utc-offset Europe/Madrid             # vista previa
sudo -u xbnc xbncd import /home/antiguo/.bouncer --logs --utc-offset Europe/Madrid --apply     # importar
sudo systemctl reload xbnc

Scripts

ScriptUso
scripts/install.shInstala o reconfigura el servicio (ver Instalación).
scripts/update.sh [--binary RUTA]Actualiza el binario con copia previa y vuelta atrás automática.
scripts/backup.sh [CARPETA] [--keep N]Copia en caliente: base de datos, clave secreta y /etc/xbnc en un .tar.gz 0600 (en /var/backups/xbnc, conserva 14).
scripts/restore.sh ARCHIVO [--with-config] [--yes]Restaura una copia de backup.sh. Guarda los ficheros actuales como *.pre-restore-FECHA.
scripts/uninstall.sh [--purge]Quita el servicio y el binario; con --purge, también configuración, datos y el usuario xbnc.

Copias de seguridad, bases de datos y migración

Copias desde el panel

En Ajustes → Copias de seguridad (superadministradores): crear una copia ahora, descargarla, borrarla, restaurarla y programar copias automáticas (cada N horas, conservando las últimas M). Cada copia es un .tar.gz con la base de datos (copia en caliente con comprobación de integridad), la clave secreta y los plugins instalados, guardado en /var/lib/xbnc/backups/.

Restaurar deja la copia preparada (también se puede subir una desde el ordenador) y se aplica cuando xBNC se reinicia; mientras tanto se puede cancelar. Las copias contienen la clave secreta: guárdalas cifradas.

Copias desde la terminal

sudo ./scripts/backup.sh                       # en /var/backups/xbnc, conserva 14
sudo ./scripts/backup.sh /mnt/copias --keep 30

# Cada noche a las 3:30
echo '30 3 * * * root /ruta/a/xbnc/scripts/backup.sh >/dev/null' | sudo tee /etc/cron.d/xbnc-backup

# Restaurar (para el servicio, guarda lo actual como *.pre-restore-FECHA, restaura y arranca)
sudo ./scripts/restore.sh /var/backups/xbnc/xbnc-20261108T033000Z.tar.gz
sudo ./scripts/restore.sh ARCHIVO --with-config    # también /etc/xbnc

# Solo la base de datos
sudo -u xbnc xbncd backup /var/lib/xbnc/copia.db

PostgreSQL

sudo systemctl stop xbnc
sudo -u xbnc xbncd migrate-to-postgres postgres://xbnc:clave@127.0.0.1/xbnc
# en /etc/xbnc/xbnc.toml:
#   [database]
#   url = "postgres://xbnc:clave@127.0.0.1/xbnc"
sudo systemctl start xbnc

La base de datos de destino tiene que estar vacía. Con ?sslmode=require la conexión va cifrada. La búsqueda de texto completo funciona igual con SQLite y con PostgreSQL.

Alta disponibilidad

Con ha = true, varios servidores ejecutan xBNC contra la misma base de datos PostgreSQL. El que tiene un bloqueo de PostgreSQL trabaja y los demás esperan. Si el activo cae, su conexión se cierra, el bloqueo se libera y otro toma el relevo en segundos. Un nodo activo que pierde la base de datos se detiene al momento, así que nunca hay dos a la vez. Los clientes tienen que poder llegar al nodo activo (una IP flotante o un DNS que cambie).

Migrar desde otro bouncer

xBNC trae lo que tenías en tu bouncer anterior si usa el formato clásico de configuración por bloques (<User nombre>, <Network nombre>, <Chan #canal>).

QuéCómo queda en xBNC
UsuariosCon su nombre. Los administradores pasan a admin (nunca a superadmin). Los usuarios que ya existen en xBNC no se tocan.
ContraseñasLas guardadas con SHA-256 con sal siguen funcionando y pasan a Argon2id la primera vez que cada usuario entra. Las de otro formato (MD5) reciben una contraseña nueva aleatoria, que se muestra una sola vez.
RedesServidor, puerto, TLS, contraseña de servidor, nick, ident y nombre real. Las redes desactivadas siguen desactivadas. Si había varios servidores, se usa el primero (añade los demás después como servidores de reserva con /msg *status addserver). Se admiten servidores IPv6.
CanalesCon sus claves (cifradas). Los desactivados no se importan.
SASL, NickServ y comandos al conectarSASL pasa a la red; la contraseña de NickServ y los comandos al conectar, a «Comandos al conectar» (cifrados). Necesitan la carpeta de datos.
Certificado de clienteSe importa si está en la carpeta de datos y su clave coincide.
MódulosSe activa el equivalente de xBNC (tabla de abajo).
RegistrosLos ficheros de texto diarios pasan al historial de cada red, con búsqueda. Se pueden repetir sin duplicar.

Desde el panel (Usuarios → Importar desde otro bouncer, superadministradores): elige el fichero .conf o pega su contenido, pulsa «Ver qué se importa» (no escribe nada) y después «Importar». Desde el panel solo se lee la configuración; SASL, NickServ, comandos al conectar, certificados y registros están en la carpeta de datos y se importan desde el servidor.

# Vista previa: no cambia nada
sudo -u xbnc xbncd import /ruta/a/la/carpeta
# Importar, con los registros (que estaban en hora de Madrid)
sudo -u xbnc xbncd import /ruta/a/la/carpeta --apply --logs --utc-offset Europe/Madrid
sudo systemctl reload xbnc

# Registros de una red concreta, aparte
sudo -u xbnc xbncd import-logs alicia libera /ruta/a/logs/libera --utc-offset America/New_York

La carpeta de registros tiene una subcarpeta por canal o conversación (#xbnc/, bob/) con ficheros AAAA-MM-DD.log. Se reconocen mensajes, acciones (* nick …), avisos (-nick- …) y entradas, salidas, desconexiones, kicks, cambios de nick, temas y modos. Con una zona horaria con nombre (Europe/Madrid) se aplica el horario de verano de cada día.

Módulo del bouncer anteriorEn xBNC
keepnickRecuperar nick
simple_away, away, autoaway, awaynickAusente automático (con el retraso y el mensaje de simple_away)
autoopOp y voz automáticos (vuelve a añadir las entradas: la sintaxis es otra)
kickrejoinVolver tras un kick (con su retraso)
stickychanCanales fijos (con la lista)
buffextrasEventos en el historial
logRegistros en ficheros
route_repliesRespuestas a quien pregunta
certCertificado de cliente
alias, watchAlias y Vigilar palabras (vuelve a añadir las entradas)
block_motdOcultar el MOTD
ctcprepliesRespuestas CTCP (con la respuesta a VERSION)
perform, nickserv, saslComandos al conectar y SASL de la red
chansaver, savebuff, playback, clientbuffer, webadmin, controlpanel, fail2ban, lastseen, notes, clearbufferonmsg, simple_disconnect, missingmotd, certauth, listsockets, identfile, partylineYa incluidos en xBNC, siempre activos

Cualquier otro módulo aparece en la vista previa como «sin equivalente». Después de importar: las redes con varios servidores usan solo el primero; las redes sin TLS aparecen avisadas; si usabas los mismos puertos, para el bouncer anterior antes de arrancar xBNC; y configura tus clientes con el formato usuario/red.

Alertas y monitorización

Alertas

xBNC comprueba cada 30 segundos estas condiciones. Se ajustan en Ajustes → Alertas (0 desactiva cada una):

AlertaSe activa cuandoPor defecto
network_downUna red lleva más de N minutos intentando conectar sin conseguirlo (las que desconectas tú no cuentan). Hasta 10 080 (una semana).15 minutos
failed_loginsHay N o más accesos fallidos (IRC, panel y tokens) en los últimos 10 minutos.30
memoryLa memoria del proceso supera N MB.desactivada
databaseLa base de datos supera N MB.desactivada

Cuando una alerta empieza y cuando se resuelve:

  • Aparece (o desaparece) en el Inicio del panel para los administradores.
  • Queda en la auditoría (acción alert).
  • Con «Avisar por IRC a los administradores» (activado por defecto), cada administrador y superadministrador conectado recibe un aviso de *status en su idioma.
  • Con un webhook (solo lo configura un superadministrador), xBNC envía un POST con JSON. Tiene 10 segundos para responder con 2xx; si falla, queda en el registro del servicio.
{
  "source": "xbnc",
  "server": "bnc.ejemplo.org",
  "state": "firing",
  "alert": "network_down",
  "subject": "alicia/libera",
  "message": "Network alicia/libera has been disconnected for more than 15 minutes",
  "since": 1762600000000,
  "text": "[xBNC bnc.ejemplo.org] firing: Network alicia/libera ...",
  "content": "[xBNC bnc.ejemplo.org] firing: Network alicia/libera ..."
}

state es firing o resolved. Los campos text y content hacen que funcione tal cual con los webhooks entrantes de Slack y Mattermost (text) y de Discord (content).

Métricas para Prometheus

GET /api/v1/metrics en formato Prometheus, con la sesión de un administrador o un token de alcance «métricas»:

scrape_configs:
  - job_name: xbnc
    scheme: https
    metrics_path: /api/v1/metrics
    authorization:
      credentials: xbnc_...
    static_configs:
      - targets: ["bnc.ejemplo.org:8443"]
MétricaTipoQué mide
xbnc_infogaugeVersión del servidor (etiqueta version).
xbnc_uptime_secondsgaugeSegundos desde que arrancó.
xbnc_usersgaugeCuentas.
xbnc_networksgaugeRedes configuradas.
xbnc_networks_running{state}gaugeConexiones por estado: connected, connecting, disconnected, reconnecting.
xbnc_irc_clientsgaugeClientes IRC conectados.
xbnc_connectionsgaugeConexiones IRC abiertas al bouncer, también sin autenticar.
xbnc_blocked_ipsgaugeDirecciones bloqueadas por fallos.
xbnc_server_bytes_received_total, xbnc_server_bytes_sent_totalcounterBytes recibidos de y enviados a los servidores IRC.
xbnc_client_bytes_received_total, xbnc_client_bytes_sent_totalcounterBytes recibidos de y enviados a los clientes.
xbnc_server_lines_totalcounterLíneas recibidas de los servidores.
xbnc_messages_stored_totalcounterMensajes guardados en el historial.
xbnc_reconnects_totalcounterReconexiones a servidores IRC.
xbnc_client_logins_totalcounterLogins correctos de clientes IRC.
xbnc_failed_logins_totalcounterLogins fallidos (IRC y panel).
xbnc_history_messagesgaugeMensajes guardados en el historial.
xbnc_database_bytesgaugeTamaño de la base de datos.
xbnc_resident_memory_bytesgaugeMemoria del proceso.
xbnc_log_lines_dropped_totalcounterLíneas del módulo log descartadas porque el disco no daba abasto.
xbnc_dcc_relays_totalcounterEnvíos y chats DCC pasados por xBNC.
xbnc_dcc_bytes_totalcounterBytes de DCC pasados por xBNC.
xbnc_alerts_firing{alert}gaugeAlertas activas por tipo.

Los mismos contadores se ven desde IRC con /msg *status traffic (administradores).

Grafana y reglas de Prometheus

En packaging/monitoring/:

  • grafana-dashboard.json: un panel listo para importar con redes conectadas y sin conectar, clientes IRC, usuarios, memoria, tiempo en marcha, mensajes por segundo, tráfico, redes por estado, logins, reconexiones, almacenamiento, historial y alertas activas.
  • prometheus-rules.yml: alertas XbncDown, XbncNetworksDisconnected, XbncManyReconnects, XbncFailedLogins, XbncBlockedAddresses, XbncMemoryHigh, XbncDatabaseLarge, XbncLogLinesDropped y XbncInternalAlert.

Comprobación de vida

GET /api/v1/health responde sin sesión; sirve para balanceadores y monitores externos.

API REST

Todo lo que hace el panel está en la API. Base: /api/v1, en la misma dirección que el panel. Formato JSON; los errores son {"error": "código", "message": "texto"} con el código HTTP adecuado. La especificación OpenAPI 3.1 está en GET /api/v1/openapi.json (y en docs/openapi.json); un test comprueba que documenta todas las rutas.

Tokens de API

Créalos en Tu cuenta → Tokens de API. El token completo (xbnc_ y 43 caracteres) solo se muestra al crearlo: xBNC guarda su SHA-256. Envíalo en la cabecera Authorization: Bearer xbnc_…; con token no hace falta CSRF.

AlcancePuede
readSolo peticiones GET.
writeTodo lo que puede tu cuenta, salvo cerrar sesión, cambiar la contraseña, la verificación en dos pasos, las passkeys y crear o revocar tokens (eso exige la sesión del panel y responde 403 session_required).
metricsSolo GET /metrics.

Caducan a los 30, 90 o 365 días, o nunca; máximo 50 por usuario. La lista muestra el prefijo, el último uso y la última IP. Un token incorrecto cuenta como intento fallido (mismos bloqueos que IRC y el panel). Crear y revocar queda en la auditoría.

Sesión del panel

  1. POST /auth/login con {"username", "password"} (y totp_code si la cuenta tiene verificación en dos pasos). La respuesta trae la cookie xbnc_session y, en el cuerpo, csrf.
  2. Envía la cookie en cada petición, y en POST, PUT, PATCH y DELETE la cabecera X-CSRF-Token con ese valor (GET /auth/me lo devuelve otra vez).
  3. Las peticiones con una cabecera Origin de otro sitio se rechazan; curl y los scripts no la envían.

Ejemplos

B=https://bnc.ejemplo.org:8443/api/v1
T="Authorization: Bearer xbnc_..."

# Redes y su estado
curl -s -H "$T" $B/networks

# Buscar en el historial de la red 1
curl -s -H "$T" "$B/networks/1/history?target=%23xbnc&q=reunión&limit=20"

# Reconectar una red (token write)
curl -s -X POST -H "$T" -H 'Content-Type: application/json' -d '{"action":"jump"}' $B/networks/1/control

# Activar un módulo
curl -s -X PUT -H "$T" -H 'Content-Type: application/json' \
  -d '{"enabled":true,"config":{"delay":60,"summary":true}}' $B/networks/1/modules/away

# Con sesión en lugar de token: crear un usuario y darle una red
curl -s -c jar -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"tu-contraseña"}' $B/auth/login > login.json
CSRF=$(python3 -c 'import json;print(json.load(open("login.json"))["csrf"])')
curl -s -b jar -H "X-CSRF-Token: $CSRF" -H 'Content-Type: application/json' \
  -d '{"username":"bruno","password":"una-clave-larga","role":"user","max_networks":3}' $B/users
curl -s -b jar -H "X-CSRF-Token: $CSRF" -H 'Content-Type: application/json' \
  -d '{"user_id":2,"name":"libera","host":"irc.libera.chat","port":6697,"tls":true,"nick":"bruno",
       "sasl_username":"bruno","sasl_password":"secreto","channels":["#xbnc","#xbnc-dev"]}' $B/networks

Todas las rutas

MétodoRutaQué haceQuién
GET/healthComprobación de vida.sin sesión
GET/i18nIdiomas instalados (código, nombre, porcentaje traducido, traductores) y el idioma por defecto del servidor.sin sesión
GET/i18n/{code}Textos del panel en un idioma: texto en inglés → traducción.sin sesión
GET, POST/setupInstalación inicial con el código de un solo uso.sin sesión
POST/auth/loginEntrar: {username, password, totp_code}. Devuelve la cookie xbnc_session y el campo csrf.sin sesión
POST/auth/logoutCerrar la sesión.sesión
GET/auth/meTu cuenta, tus permisos y el token CSRF.sesión o token
GET/auth/methodsFormas de entrar que ofrece el servidor (passkeys, OpenID Connect, LDAP).sin sesión
GET/auth/oidc/startRedirige al proveedor de OpenID Connect.sin sesión
GET/auth/oidc/callbackVuelta desde el proveedor de OpenID Connect.sin sesión
POST/auth/passkey/optionsEmpieza a entrar con passkey (desafío WebAuthn).sin sesión
POST/auth/passkeyEntra con la respuesta de la passkey.sin sesión
GET/dashboardResumen del Inicio (global para administradores).sesión o token
GET/presetsRedes conocidas para el asistente.sesión o token
GET, POST/networksListar (?all=true: todas, administradores) y crear redes: {user_id, name, host, port, tls, nick, username, realname, server_password, sasl_username, sasl_password, channels, on_connect}.crear: user o superior
GET, PATCH, DELETE/networks/{id}Ver con estado en vivo, editar (un secreto omitido se conserva, "" lo borra) y borrar.dueño o admin
POST/networks/{id}/control{action: connect | disconnect | jump}.dueño o admin
GET, POST/networks/{id}/channelsCanales, con disabled (desactivado) y position (orden de entrada); añadir {name, key}.dueño o admin
DELETE/networks/{id}/channels/{nombre}Quitar un canal (codifica # como %23).dueño o admin
PUT/networks/{id}/channels/{nombre}/historyRetención del canal: {retention_days: null (lo del servidor) | -1 (no guardar) | 0 (siempre) | N días}.dueño o admin
DELETE/networks/{id}/clients/{cliente}Desconectar un dispositivo.dueño o admin
GET/networks/{id}/conversationsConversaciones con su número de mensajes.dueño o admin
GET, DELETE/networks/{id}/historyBuscar: target, q, sender, before_id, from, to, limit (hasta 500), más nuevos primero. DELETE borra (?target= una conversación).dueño o admin
GET/networks/{id}/history/exportDescargar: ?format=txt|json y ?target=.dueño o admin
GET/networks/{id}/chatWebSocket del chat del panel: el panel como un cliente IRC más. Mensajes {line: "PRIVMSG #xbnc :hola"} en los dos sentidos.solo el dueño, sesión
GET, PUT/networks/{id}/on-connectComandos al conectar: {commands: "/msg X login …"}; vacío los borra.dueño o admin
GET, PUT, DELETE/networks/{id}/certCertificado de cliente: huellas SHA-1/256/512; subir {certificate, private_key} en PEM; borrar. La clave nunca se devuelve.dueño o admin
POST/networks/{id}/cert/generateGenerar un certificado nuevo.dueño o admin
GET/modulesCatálogo de módulos: ids, ajustes con tipo y límites.sesión o token
GET/networks/{id}/modulesEstado de los módulos de una red (secretos vacíos y secrets_set).dueño o admin
PUT/networks/{id}/modules/{módulo}{enabled, config}: se valida y se aplica al momento. Un secreto vacío conserva el guardado; null lo borra.dueño o admin
GET/networks/{id}/pluginsPlugins de una red.dueño o admin
PUT/networks/{id}/plugins/{plugin}{enabled, config}.dueño o admin
GET/mentionsMensajes que te mencionan, más nuevos primero (?before=ms&limit=).sesión o token
GET/notesTus notas.sesión o token
PUT, DELETE/notes/{clave}Guardar {text} (hasta 400 caracteres) o borrar una nota.sesión o token
PUT/me/language{language: código de un idioma instalado (en, es…) | ""} (vacío: el del servidor).sesión o token
PUT/me/timezone{timezone: "Europe/Madrid"} (nombre IANA; vacío: UTC).sesión o token
PUT/me/passwordCambiar tu contraseña (cierra tus otras sesiones).solo sesión
POST/me/totp/setupEmpezar a activar la verificación en dos pasos (secreto y QR).solo sesión
POST/me/totp/enableActivarla con un código.solo sesión
POST/me/totp/disableDesactivarla.solo sesión
GET, POST/me/passkeysTus passkeys; registrar una.solo sesión
POST/me/passkeys/optionsEmpezar a registrar una passkey.solo sesión
DELETE/me/passkeys/{id}Quitar una passkey.solo sesión
GET, DELETE/me/identitiesCuentas externas vinculadas (OpenID Connect, LDAP); desvincular.solo sesión
POST/me/identities/oidcEmpezar a vincular tu cuenta de OpenID Connect.solo sesión
GET, PUT/me/notificationsAjustes de avisos (el token de Telegram se devuelve oculto).sesión o token
POST/me/notifications/testEnviar un aviso de prueba a todos los canales.sesión o token
GET, POST, DELETE/me/pushDispositivos con push; suscribir {endpoint, keys: {p256dh, auth}, label}; quitar {endpoint}.sesión o token
GET/push/keyClave pública VAPID para Web Push.sesión o token
GET/diagnosticsInforme para pruebas: qué admite cada una de tus redes y cómo la ha tratado xBNC (sin secretos ni mensajes).sesión o token
GET, POST/tokensTus tokens; crear {name, scope: read | write | metrics, expires_days: 0–3650} (0: no caduca). El token solo viene en la respuesta.solo sesión
DELETE/tokens/{id}Revocar un token.solo sesión
GET/sessionsSesiones del panel (?all=true: todas, administradores).sesión
DELETE/sessions/{id}Cerrar una sesión.sesión
GET, POST/usersListar y crear {username, password, role, max_networks, max_clients}.ver: moderator; crear: admin
GET, PATCH, DELETE/users/{id}Ver, cambiar {role, enabled, max_networks, max_clients, max_history_mb} (null quita el límite) y borrar.según el rol
POST/users/{id}/passwordRestablecer la contraseña (cierra sus sesiones).admin
GET/users/{id}/usageRedes, clientes y espacio de historial usados frente a sus cuotas.moderator
GET/securityAccesos e IPs bloqueadas.moderator
DELETE/security/blocked/{ip}Desbloquear una IP.admin
GET/auditRegistro de auditoría.moderator
GET, PUT/settingsAjustes en caliente.ver: admin; editar: superadmin
GET/systemVersión, base de datos, escuchas y contadores.admin
POST/system/restartReiniciar xBNC (el servicio lo vuelve a arrancar).superadmin
GET/alertsAlertas activas.admin
GET/metricsMétricas en formato Prometheus.admin o token metrics
GET/wsWebSocket del Inicio: un mensaje {type: "stats"} cada 2 segundos con el estado de las redes y, para administradores, memoria, CPU, clientes, conexiones, IPs bloqueadas y contadores; {type: "logout"} si la sesión termina.solo sesión
GET, POST/backupsCopias, restauración preparada y ajustes de las automáticas; crear una copia ahora.superadmin
GET, DELETE/backups/{nombre}Descargar o borrar una copia.superadmin
POST/backups/{nombre}/restorePreparar la restauración de una copia del servidor.superadmin
POST, DELETE/backups/restoreSubir una copia (.tar.gz) y prepararla; cancelar la restauración preparada.superadmin
GET/pluginsPlugins instalados.sesión o token
POST/pluginsInstalar o actualizar: el cuerpo es el .wasm (application/wasm, hasta 4 MB).superadmin, sesión
POST/plugins/inspectComprobar un .wasm sin instalarlo.superadmin, sesión
PATCH, DELETE/plugins/{id}{enabled} en el servidor y dominios aprobados; desinstalar.superadmin, sesión
GET/plugins/catalogCatálogo: plugins oficiales y catálogo remoto firmado.sesión o token
POST/plugins/catalog/{id}Instalar del catálogo con un clic.superadmin, sesión
GET, PUT/plugins/devModo desarrollo: estado y carpeta; activar o desactivar.superadmin, sesión
GET/plugins/logsWebSocket con el registro de los plugins: últimas líneas y las nuevas.superadmin, sesión
GET/updatesVersión instalada y última publicada, si se puede actualizar desde el panel y el resultado de la última actualización.admin
POST/updates/checkComprobar ahora si hay versión nueva.admin, sesión
POST/updates/installDescargar, verificar e instalar el paquete firmado de la última versión.superadmin, sesión
POST/import/previewVista previa de la importación: {config: "contenido del fichero"}. No escribe nada.superadmin, sesión
POST/import/applyImportar.superadmin, sesión

«dueño o admin»: el dueño de la red o un administrador. «solo sesión»: no se admite con token. Las contraseñas nunca se devuelven: las redes indican has_sasl_password y has_server_password.

Versiones y actualizaciones

Aviso de versiones nuevas

Con [updates] repository (o url) en xbnc.toml, xBNC consulta una vez al día la última versión publicada y avisa en el Inicio y en Ajustes → Actualizaciones. Por sí solo no descarga ni instala nada.

Actualizar

En esta beta, xBNC se instala desde el código: se actualiza con scripts/update.sh (ver Instalación).

Actualizar desde el panel (instalaciones con paquete)

xBNC incluye también la actualización con un clic para cuando se instala desde paquetes .deb o .rpm firmados. Con [updates] public_key, Ajustes → Actualizaciones muestra «Actualizar ahora» a los superadministradores. xBNC descarga el paquete y su firma .sig, comprueba la firma Ed25519 y lo deja en /var/lib/xbnc/updates/. El servicio del sistema xbnc-update lo vuelve a comprobar todo como root sin fiarse de esa carpeta (verifica con la clave de /etc/xbnc/xbnc.toml, que xBNC no puede cambiar, y rechaza versiones iguales o más antiguas), lo instala con dpkg o rpm y xBNC se reinicia. Un paquete sin firma, firmado con otra clave o modificado no se instala nunca. Sin public_key, o sin instalación por paquete, el panel explica cómo actualizar a mano.

Publicar versiones firmadas

# Una vez: crear la clave (la privada, secreta; la pública va en [updates] public_key)
xbncd release keygen --out xbnc-release.key

# En cada versión: firmar los paquetes (escribe FICHERO.sig)
XBNC_RELEASE_KEY="$(cat xbnc-release.key)" xbncd release sign xbnc_1.0.0_amd64.deb xbnc-1.0.0-1.x86_64.rpm

# Comprobar
xbncd release verify --public-key "BASE64..." xbnc_1.0.0_amd64.deb

El repositorio incluye un flujo que compila y firma paquetes .deb y .rpm y una imagen de contenedor (.github/workflows/release.yml). Necesita la clave como secreto del repositorio (XBNC_RELEASE_KEY) y la clave pública como variable (XBNC_RELEASE_PUBLIC_KEY). Durante la beta xBNC se publica solo como un .zip con el código fuente, así que el flujo solo se ejecuta cuando se lanza a mano desde la pestaña Actions.

Publicar en GitHub

scripts/publish-github.sh publica el código fuente, una versión con el .zip y su suma de comprobación, y la wiki como sitio web propio (GitHub Pages), desde el ordenador de quien mantiene el proyecto y con su cuenta de GitHub. La guía completa está en docs/PUBLISHING.md (en inglés).

Escribir plugins

Un plugin es un fichero WebAssembly con un manifiesto JSON dentro. Hay SDK para C (sdk/c, con los 18 plugins oficiales como ejemplo y el ayudante xbnc_util.h) y para Rust (sdk/rust). Cualquier lenguaje que compile a WebAssembly sin WASI sirve si cumple la interfaz.

Manifiesto

CampoObligatorioQué es
idsí1–32 caracteres a-z 0-9 _ -, empezando por letra. No puede ser status, notes, watch, events, xbnc, bnc, plugin ni plugins. Es el nombre de su servicio (*id).
namesíNombre visible, 1–60 caracteres.
versionsíVersión, 1–20 caracteres.
descriptionnoQué hace.
usagenoCómo se usa (hasta 1000 caracteres). El panel lo muestra en «Cómo se usa» y xBNC lo responde si el plugin no contesta a un comando.
authornoAutor.
homepagenoPágina del plugin (https://).
abinoVersión de la interfaz (1).
permissionsnoLista de send, raw, timer, presence y http.
http_domainscon httpDe 1 a 10 dominios a los que pide permiso para conectarse.
timer_secsnoCon timer: recibir el temporizador cada 5–60 segundos en lugar de cada minuto.
settingsnoHasta 20 ajustes: {key, type (bool, int, text o lines), label, help, default, min, max}. El panel los muestra como formulario.
translationsnoPor código de idioma (es, pt, fr…): name, description, usage y, por ajuste, label y help. Los textos de la raíz del manifiesto son la base, en inglés.
{
  "id": "hola",
  "name": "Hello",
  "version": "1.0.0",
  "description": "Answers !hola.",
  "usage": "In a channel: !hola",
  "author": "tu-nombre",
  "permissions": ["send"],
  "settings": [
    { "key": "greeting", "type": "text", "label": "Greeting", "default": "Hello!" },
    { "key": "lang", "type": "text", "label": "Language", "help": "Empty: your xBNC language.", "default": "" }
  ],
  "translations": {
    "es": {
      "name": "Hola",
      "description": "Responde a !hola.",
      "usage": "En un canal: !hola",
      "settings": { "greeting": { "label": "Saludo" } }
    }
  }
}

Interfaz (ABI 1)

El módulo exporta:

ExportFirmaQué hace
memorymemoriaMemoria lineal del plugin.
xbnc_alloc(len: i32) -> i32Reserva len bytes para el evento y devuelve su dirección.
xbnc_on_event(ptr: i32, len: i32) -> i64Recibe el evento (JSON UTF-8) y devuelve (dirección << 32) | longitud de la respuesta (JSON), o 0 si no responde.

Y solo puede importar del módulo xbnc (ni WASI ni nada más):

ImportQué hace
log(ptr, len)Escribe una línea en el registro (máximo 10 por evento y 500 caracteres).
now_ms() -> i64Milisegundos desde 1970.
kv_get, kv_set, kv_del, kv_listAlmacén clave-valor propio del plugin en esa red: claves de hasta 200 bytes, valores de hasta 64 KB, 16 MB y 200 000 claves en total, hasta 2 000 escrituras por evento (se guardan juntas).

Eventos

{
  "event": "message",
  "network": "undernet", "nick": "y2k", "connected": true, "clients": 1, "lang": "es",
  "config": { "trigger": "!dado" },
  "state": null,
  "command": "PRIVMSG", "conversation": "#xbnc", "channel": true,
  "from": "bob", "from_mask": "bob!b@host", "text": "!dado 2d6",
  "action": false, "outgoing": false
}
EventoCuándoCampos propios
loadEl plugin arranca en la red (al activarlo o al iniciar xBNC).—
connectedxBNC termina de conectar a la red.—
messageUn mensaje o aviso en un canal o privado, también los tuyos.command, conversation, channel, from, from_mask, text, action, outgoing
commandAlguien escribe /msg *id texto.text
timerCada minuto, o cada timer_secs (permiso timer).—
join, part, kick, quit, nick, namesMovimientos en los canales (permiso presence).los datos de cada movimiento
httpLa respuesta a una petición web (permiso http).id, status, body, error

Campos comunes: network, nick (tu nick actual), connected, clients (clientes conectados), lang (tu idioma), config (sus ajustes) y state (lo que guardó).

Respuesta

{
  "actions": [
    { "reply": "texto en la misma conversación" },
    { "tell": "texto solo para ti, como *id" },
    { "privmsg": { "target": "#canal", "text": "..." } },
    { "notice": { "target": "nick", "text": "..." } },
    { "raw": "MODE #canal +o bob" },
    { "http": { "id": "tiempo", "method": "GET", "url": "https://api.open-meteo.com/..." } }
  ],
  "state": { "lo que quieras guardar": 1 }
}
  • Textos de una sola línea. Las acciones sin permiso o mal formadas se descartan y quedan en el registro.
  • state sustituye el estado guardado del plugin en esa red; llega en cada evento y sobrevive a los reinicios. La instancia se mantiene entre eventos mientras la red sigue activa.
  • raw nunca puede enviar QUIT, PASS, USER, NICK, CAP, AUTHENTICATE, OPER, SERVER ni SQUIT.
  • http: ('id', 'url', 'method', 'body'). Solo https, a dominios aprobados; métodos GET, POST, PUT y DELETE; cuerpo de hasta 16 KB (texto o JSON); hasta 3 peticiones a la vez y 30 por minuto por plugin y red. La respuesta llega como evento http con id, status, body (hasta 256 KB) y, si falló, error.

Límites

LímiteValor
Tamaño del fichero4 MB
Memoria16 MB
CPU por eventounos 20 millones de instrucciones (50 millones al arrancar)
Respuesta64 KB y 20 acciones; 5 mensajes por evento
Estado guardado64 KB
Almacén clave-valor16 MB y 200 000 claves por plugin y red
Fallos seguidos antes de detenerse en una red5

SDK de C

sdk/c/xbnc_plugin.h resuelve la interfaz. Funciones principales:

FunciónQué hace
void on_event(const xbnc_event *ev)La función que escribes tú: recibe cada evento.
xbnc_get(ev, "campo", buf, max)Lee un campo de texto del evento.
xbnc_is(ev, "campo")Lee un campo sí/no.
xbnc_config(ev, "clave", buf, max), xbnc_config_int, xbnc_config_boolLee un ajuste.
xbnc_get_state(ev)El estado guardado (JSON).
xbnc_reply(texto), xbnc_tell(texto)Responder en la conversación o solo a ti.
xbnc_privmsg(destino, texto), xbnc_notice(destino, texto)Mensaje o aviso a quien quieras.
xbnc_raw(línea)Comando IRC (permiso raw).
xbnc_http_get(id, url), xbnc_http_post_json(id, url, json)Peticiones web (permiso http).
xbnc_state(json)Guardar el estado.
xbnc_kv_get, xbnc_kv_set, xbnc_kv_del, xbnc_kv_list (y las variantes _str)Almacén clave-valor.
xbnc_log(texto)Escribir en el registro.

sdk/c/xbnc_util.h añade lo que usan los plugins oficiales: idioma de la respuesta (u_lang), lectura de comandos con alias (u_command), recorrido del almacén (u_next_key), fechas, zonas horarias con horario de verano europeo y construcción de textos.

#include "xbnc_plugin.h"

void on_event(const xbnc_event *ev) {
    static char kind[16], text[256], greeting[128];
    xbnc_get(ev, "event", kind, sizeof kind);
    if (!xbnc_streq(kind, xbnc_strlen(kind), "message")) return;
    xbnc_get(ev, "text", text, sizeof text);
    if (!xbnc_streq(text, xbnc_strlen(text), "!hola")) return;
    xbnc_config(ev, "greeting", greeting, sizeof greeting);
    xbnc_reply(greeting[0] ? greeting : "¡Hola!");
}
cd sdk/c
clang --target=wasm32 -O2 -nostdlib -fno-builtin -I. \
  -Wl,--no-entry -Wl,--export-dynamic -Wl,--strip-debug -Wl,-z,stack-size=65536 \
  -o hola.raw.wasm hola.c
xbncd plugin pack hola.raw.wasm hola.json -o hola.wasm
xbncd plugin check hola.wasm
sudo -u xbnc xbncd plugin install hola.wasm

# Los ejemplos oficiales: make (o make bundle para copiarlos al catálogo)

Necesita clang y wasm-ld (LLVM 15 o posterior) y llvm-objcopy (o xbncd plugin pack).

SDK de Rust

El crate xbnc-plugin (sdk/rust) da el trait Plugin, el tipo Event (con kind(), text(), conversation(), is_channel(), outgoing(), config_str(), state()…), Response (con reply(), tell(), state()…) y la macro plugin!. Ejemplo incluido (sdk/rust/examples/stats.rs):

//! Example plugin: counts messages per channel and answers "!stats".
//! The counts survive restarts thanks to the persisted state.
//!
//! Build: cargo build -p xbnc-plugin --release --target wasm32-unknown-unknown --example stats
//! then: xbncd plugin pack target/wasm32-unknown-unknown/release/examples/stats.wasm \
//!         sdk/rust/examples/stats.json -o stats.wasm

use xbnc_plugin::{plugin, Event, Plugin, Response};

#[derive(Default)]
struct Stats;

impl Plugin for Stats {
    fn on_event(&mut self, ev: &Event) -> Response {
        let mut r = Response::new();
        let mut counts = ev.state().as_object().cloned().unwrap_or_default();
        match ev.kind() {
            "message" if ev.is_channel() && !ev.outgoing() => {
                let chan = ev.conversation().to_lowercase();
                let n = counts.get(&chan).and_then(|v| v.as_u64()).unwrap_or(0) + 1;
                counts.insert(chan, n.into());
                if ev.text().trim() == ev.config_str("trigger") {
                    r.reply(format!("{} messages counted in {}", n, ev.conversation()));
                }
                r.state(counts.into());
            }
            "command" => {
                if counts.is_empty() {
                    r.tell("Nothing counted yet.");
                }
                let mut v: Vec<_> = counts.iter().collect();
                v.sort_by_key(|e| std::cmp::Reverse(e.1.as_u64()));
                for (chan, n) in v.into_iter().take(10) {
                    r.tell(format!("{chan}: {n}"));
                }
            }
            _ => {}
        }
        r
    }
}

plugin!(Stats);

Modo desarrollo

En Plugins → Desarrollo (superadministradores): con el modo activo, xBNC vigila /var/lib/xbnc/plugins/dev/. Un .wasm guardado ahí se comprueba e instala en cuanto cambia y todas las redes lo recargan. Si pones nombre.json junto a nombre.wasm, lo empaqueta solo (no hace falta xbncd plugin pack). Un plugin nuevo se activa en las redes de quien activó el modo. Los resultados y lo que escribe el plugin se ven en el registro en directo de la página.

sudo cp hola.wasm hola.json /var/lib/xbnc/plugins/dev/

Publicar un catálogo propio

Además de los oficiales, xBNC puede ofrecer los plugins de un catálogo remoto firmado ([catalog] en xbnc.toml). El índice es un JSON {"plugins": [{"id", "version", "url", "sha256", "size", "manifest"}]} y su firma Ed25519 en base64 se publica en índice.sig. Cada plugin se comprueba contra el SHA-256 firmado antes de instalarlo.

xbncd plugin catalog-keygen -o catalogo.key        # una vez; la pública va en [catalog] public_key
xbncd plugin catalog-entry hola.wasm https://plugins.ejemplo.org/hola.wasm   # entrada para el índice
xbncd plugin catalog-sign --key catalogo.key index.json                     # escribe index.json.sig

Traducir xBNC

xBNC puede hablar cualquier idioma. Todos sus textos están en un fichero por idioma: el panel web, la pantalla de entrada y todo lo que dice por IRC (*status, su ayuda, los avisos y los mensajes de los módulos). Se traduce un fichero y el idioma aparece en todos los selectores de idioma de xBNC, sin programar ni compilar nada.

Los ficheros

FicheroQué es
locales/en.jsonInglés. Es la base: tiene todos los textos de xBNC.
locales/es.jsonEspañol.
locales/<código>.jsonCualquier otro idioma: pt.json, fr.json, pt-BR.json…

El inglés y el español van dentro del programa. Los demás idiomas, y las correcciones, se ponen en /etc/xbnc/locales/ (locales_dir en xbnc.toml, o la variable XBNC_LOCALES_DIR). xBNC los lee al arrancar y al recargar (sudo systemctl reload xbnc o /msg *status rehash).

{
  "language": {
    "code": "pt",
    "name": "Português",
    "english_name": "Portuguese",
    "locale": "pt-PT",
    "translators": ["Tu nombre o nick"]
  },
  "irc": {
    "connected_to": "Ligado a {0} como {1}.",
    "help.group.channels": "Canais"
  },
  "panel": {
    "Joined": "Dentro",
    "Delete {username}": "Apagar {username}"
  }
}
ParteQué es
languagecode: código del idioma (dos o tres letras, con región si hace falta: pt, pt-BR); el fichero se llama igual. name: nombre del idioma en ese idioma, como sale en los selectores. locale: para fechas y números. translators: sale en xbncd locales list.
ircLo que xBNC dice por IRC. La clave de la izquierda es un nombre; solo se traduce el texto de la derecha.
panelEl panel web. La clave de la izquierda es el texto en inglés; solo se traduce el texto de la derecha.

Paso a paso

  1. Copia en.json como <código>.json (por ejemplo, pt.json).
  2. Cambia la parte language: código, nombre, nombre en inglés, locale y tu nombre.
  3. Traduce los textos de la derecha. No cambies nunca las claves de la izquierda.
  4. Comprueba el fichero: xbncd locales check pt.json (añade --missing para ver lo que falta).
  5. Pruébalo: cópialo en /etc/xbnc/locales/ y recarga xBNC. Aparece al momento en la pantalla de entrada, en Tu cuenta, en Ajustes y con /msg *status language pt.
  6. Envíalo al proyecto para incluirlo en la siguiente versión.

Reglas de los textos

En el texto en inglésQué hacer
{0}, {1}… (IRC)Valores que pone xBNC (un nick, un número…). Mantenlos todos; puedes moverlos dentro de la frase.
{name}, {count}… (panel)Igual: mantenlos con el mismo nombre exacto.
<b>…</b>, <u>…</u> (IRC)Negrita y subrayado en el cliente IRC. Mantenlos alrededor de las mismas palabras, cada <b> con su </b>.
Comandos y ajustes (/msg *status help, set away delay 60)No se traducen: es lo que la gente escribe.
$1, $nickVariables del módulo de alias: se dejan tal cual.
Disabled|network state (clave del panel)Lo que va tras la | es una pista de dónde sale el texto (para el género, por ejemplo). Se traduce solo el texto, sin la pista.
PluralesLos textos terminados en .one se usan con 1 y los terminados en .other con cualquier otro número (unit.network.one = «{{0}} red»).
Saltos de líneaNo se admiten en los textos de IRC.

Un texto que no cumple estas reglas se ignora y sale en inglés; xbncd locales check lo indica como problema. Esto impide también que un fichero de idioma pueda meter comandos IRC (los saltos de línea están prohibidos).

Corregir un idioma incluido

Un fichero de un idioma que ya existe (por ejemplo, es.json en /etc/xbnc/locales/) solo necesita los textos que quieras cambiar: el resto se queda como está.

Lo que no se traduce con un fichero

  • Las respuestas de los plugins. Su nombre, descripción y ajustes se traducen en su manifiesto (translations). Lo que un plugin responde en un canal está escrito en el propio plugin; en un idioma que no incluye, responde en inglés. Los plugins oficiales hablan inglés y español.
  • El instalador habla inglés y español.
  • El registro del servidor está en inglés.

Traducir esta wiki

La wiki es un proyecto propio, aparte de la app (xbnc-wiki), para que cualquiera pueda leerla sin instalar xBNC. Se genera con build.py a partir de un fichero de contenido por idioma (content/en.py es la base) y del código fuente de xBNC. Para traducirla, copia en.py como <código>.py y traduce los textos entre comillas sin tocar las etiquetas HTML ni las llamadas como code(…). Las tablas de módulos, plugins y comandos se traducen solas con los ficheros de idioma de xBNC. Al generar la wiki, cada idioma aparece en el selector de la cabecera.

Para desarrolladores

  • En el panel, los textos se escriben en inglés dentro de t("…"), tk("…") o tx("…"). npm run i18n:check (en web/) lista lo que falta en en.json, y node scripts/i18n-check.mjs --sync lo añade.
  • En el servidor, el texto se añade a la sección irc de locales/en.json y se usa con self.t("clave", &[]), tr!(self, "clave", arg1, arg2) o i18n::tr(lang, "clave", &[…]). Los tests comprueban que cada clave usada existe y que es.json las traduce todas con los mismos marcadores.

La guía completa, en inglés, está en TRANSLATING.md, en el código fuente; esta sección es su versión en español.

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 1.0.0 Made by y2k».
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 (143)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, y para qué nombres es válido un certificado TLS.
API (12)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 (16 + 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.
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.
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.

Problemas frecuentes

Empieza siempre por el registro y por *status: sudo journalctl -u xbnc -n 100 --no-pager y, desde tu cliente, /msg *status status.

No puedes conectar

SíntomaCausa probableSolución
El cliente dice «certificado no válido»Instalaste por IP con certificado propio.Acepta el certificado en el cliente o pasa a dominio: sudo ./scripts/install.sh --reconfigure --domain … --letsencrypt …
Usuario o contraseña incorrectos (usuario «…»)Usuario o contraseña incorrectos.La contraseña del servidor es usuario/red@dispositivo:contraseña, con el usuario y la contraseña del panel. El panel muestra la tuya lista para copiar en Redes → tu red; sudo xbncd info las lista.
«TU_CONTRASEÑA» es el ejemploSe copió el ejemplo sin la contraseña.Escribe tu contraseña después de los dos puntos. No cuenta como intento fallido.
Demasiados accesos fallidos desde tu dirección (…): está bloqueada N minutos másIP bloqueada por fallos, en IRC y en el panel. Un cliente que reconecta solo con una contraseña incorrecta la vuelve a bloquear una y otra vez.Corrige (o cierra) el cliente y desbloquea la IP en Seguridad → IPs bloqueadas, o espera.
No hay ninguna red llamada «…» en tu cuentaLa red de la contraseña del servidor no es una de las tuyas.Usa el nombre corto de la red tal como lo muestra el panel (el mensaje las lista).
Indica qué red usar en la contraseña del servidorTienes varias redes y no indicaste cuál.Añade /red al usuario.
Tu cuenta todavía no tiene redesLa cuenta no tiene ninguna red, o está desactivada.Añade una en Redes → Añadir red, o actívala.
Desde casa, el dominio no conectaTu router no admite NAT loopback (hairpin NAT).Desde casa usa la IP local de la máquina de xBNC (Desde tu red local, en el panel).
Por la IP local, el cliente rechaza el certificadoEl certificado es del dominio (Let's Encrypt), no de la IP.Desde casa usa el puerto 6667 sin SSL, o activa «aceptar certificados no válidos».
this port uses SSL/TLS. Enable SSL…Conectas al 6697 sin SSL.Activa SSL o usa el 6667 desde tu red local.
this port only accepts connections from the local networkUsas el 6667 desde fuera.Usa el 6697 con SSL.
El cliente no conecta y en el registro no aparece nadaEl cliente no llega a la máquina (IP, puerto o cortafuegos).sudo xbncd info; desde el cliente: openssl s_client -connect IP:6697 (Linux) o Test-NetConnection IP -Port 6697 (Windows).
Registro: client sent TLS to a plain-text portEl cliente tiene SSL activado contra el 6667.Desactiva SSL o usa el 6697.
Registro: TLS handshake failedEl cliente no acepta el certificado propio.Activa «aceptar certificados no válidos» o usa --domain con --letsencrypt.

Problemas con una red

SíntomaCausa probableSolución
*status: connection failed: … invalid peer certificateCertificado del servidor IRC no válido (propio o caducado) o faltan los certificados raíz.sudo apt install ca-certificates; comprueba el host y el puerto TLS. Si la red usa un certificado propio, confía en él con /msg *status addfingerprint HUELLA.
*status: registration timed outPuerto equivocado (TLS contra un puerto sin TLS o al revés).Revisa el puerto y el TLS de la red (Undernet: 6667 sin TLS).
SASL authentication failedCuenta o contraseña SASL incorrectas.Corrígelas en la configuración de la red.
SASL is configured but this server does not offer SASL PLAINLa red no admite SASL.Quita SASL y usa Login en servicios.
Your host is trying to (re)connect too fast -- throttledLa red frena las reconexiones seguidas desde tu IP.Espera; xBNC aguarda al menos 2 minutos. No pulses Conectar varias veces.
No entra en los canales: «Tu host sigue sin ocultarse después de … segundos»Se pidió +x (comandos al conectar o Login en servicios) pero la red no ha ocultado el host, normalmente porque falló el login con X.Revisa la cuenta y la contraseña de X; xBNC entra en cuanto el host se oculta. /msg *status joinnow entra ya, con el host real.
El login con X, Q o AuthServ no funcionaCuenta o contraseña del servicio incorrectas.Revisa Login en servicios; el motivo llega por *status.
En IRCnet no se identificaIRCnet no tiene NickServ; xBNC no envía la contraseña a propósito.Usa SASL de sasl.ircnet.com en la red, o nada.
El nick termina en «_»El nick estaba ocupado al conectar.Activa Recuperar nick o escribe /nick tu-nick.
xBNC cambia mi nick todo el ratoRecuperar nick vuelve al nick guardado./msg *status setnick nuevo, o desactiva el módulo.
Veo «�» en lugar de tildesRaro: xBNC convierte Latin-1 a UTF-8.Si quien no ve bien las tildes es la otra persona, añade su canal o nick en Codificación.
El certificado de cliente no identificaLa huella no está en tu cuenta, la red no usa TLS o no reconectaste.Añade la huella (SHA-512 en Libera, SHA-1 en OFTC) y reconecta.

Módulos y plugins

SíntomaCausa probableSolución
/msg *plugin solo muestra «Uso: MSG <apodo> <mensaje>»Es la ayuda de tu cliente: no escribiste nada después del nombre./msg *poll ayuda.
Un alias no hace nadaTu cliente no envía comandos que no conoce./quote nombre argumentos.
No me da op el módulo autoopNo tienes op, la máscara no coincide o la otra persona no responde al desafío.Comprueba con /whois el usuario@host real y la clave.
Un plugin con acceso web no respondeSus sitios no están aprobados.Un superadministrador los aprueba en Plugins («Sitios a los que puede conectarse»).
Un plugin se ha detenido en una redFalló cinco veces seguidas.Mira el registro de Plugins; desactívalo y actívalo de nuevo tras corregirlo.
No aparecen ficheros de registroEl módulo log está desactivado o no hay permisos en /var/lib/xbnc/logs.Actívalo; el registro del servicio avisa si no puede escribir.
Las tareas programadas salen a otra horaTu zona horaria no está puesta.Tu cuenta → Zona horaria.

Panel y servicio

SíntomaCausa probableSolución
El panel no carga (conexión rechazada)Falta [web] o escucha en 127.0.0.1.sudo xbncd info; para rehacer la configuración, sudo ./scripts/install.sh --reconfigure.
«La página estaba desactualizada»Token CSRF antiguo tras volver a entrar.Recarga la página.
«Petición rechazada por venir de otro sitio»public_url no coincide con la dirección del navegador.Corrige public_url o entra por esa dirección.
Tras entrar vuelves a la pantalla de loginCookie Secure en HTTP sin TLS.Usa HTTPS o localhost (o secure_cookies = false solo en pruebas).
Todos quedan bloqueados detrás de NginxSin trust_proxy, todo viene de 127.0.0.1.trust_proxy = true y la cabecera X-Forwarded-For en Nginx.
secret key file … not found; run xbncd init firstNo se inicializó.sudo -u xbnc xbncd init.
secret key … is accessible by other usersPermisos de la clave demasiado abiertos.sudo chmod 600 /var/lib/xbnc/secret.key && sudo chown xbnc:xbnc /var/lib/xbnc/secret.key.
listener … has no TLS certificatePuerto público sin TLS.Añade tls_cert y tls_key, usa lan_only o 127.0.0.1.
database schema version N is newer than this binary supportsHas vuelto a un binario más antiguo.Usa el binario nuevo o restaura la copia previa.
Los cambios hechos con la terminal no se venEl servicio no se recargó.sudo systemctl reload xbnc.
Un idioma nuevo no aparece en el panelEl fichero no está en locales_dir, tiene otro nombre o no se recargó xBNC.xbncd locales check FICHERO; cópialo en /etc/xbnc/locales/CÓDIGO.json y sudo systemctl reload xbnc. El registro dice qué idiomas cargó.
El cliente se desconecta solo con mucho tráficoLa cola del cliente se llenó.Aumenta client_queue; al volver recibe lo pendiente.
Playback was truncatedHabía más de playback_max mensajes pendientes.Aumenta playback_max o usa un cliente con draft/chathistory.
Perdiste el código de instalación—sudo xbncd setup-code, o crea el usuario con la terminal.
Perdiste el móvil con la verificación en dos pasos—sudo -u xbnc xbncd user reset-2fa usuario.
Olvidaste la contraseña del único administrador—sudo -u xbnc xbncd user passwd usuario.

Más detalle en el registro

# En /etc/xbnc/xbnc.toml:  [log] level = "info,xbncd=debug"
sudo systemctl restart xbnc
sudo journalctl -u xbnc -f
sudo journalctl -u xbnc --since "1 hour ago" -p warning

Con trace se registra cada línea IRC (con las credenciales enmascaradas). Vuelve a info al terminar: con debug aparecen nicks y canales.

Probar la beta

La versión 1.0.0 está en pruebas en redes reales (Undernet, Libera.Chat, freenode, Rizon, EvilNet, IRCnet y otras) antes de declararla estable.

  1. Instálala y añade tus redes.
  2. Sigue el plan de pruebas de testenv/real/PLAN.md: una sección por red, módulo y plugin.
  3. Si algo falla, descarga el informe para pruebas de Tu cuenta.
  4. Envíalo con lo que hiciste, lo que esperabas, lo que pasó, la red, el cliente, la hora aproximada, la versión (/msg *status version) y los avisos del registro (sudo journalctl -u xbnc --since "1 hour ago" | grep -E "WARN|ERROR"; revísalo antes de enviarlo).

Si el proyecto está en GitHub, usa la plantilla de incidencia «Informe de prueba». Los fallos de seguridad no se publican: sigue SECURITY.md.

Límites conocidos

  • Undernet y QuakeNet no ofrecen TLS: la conexión con esas redes va sin cifrar.
  • FiSH es criptografía antigua (Blowfish, sin integridad): protege de los servidores de la red, no sustituye al cifrado de extremo a extremo. Los mensajes descifrados se guardan en tu historial como el resto.
  • Algunos clientes no envían comandos que no conocen: los alias necesitan /quote.
  • DCC entre un cliente solo IPv6 y otro solo IPv4 no se traduce.
  • La búsqueda por trozos de palabra solo se usa si no hay coincidencias por palabra completa.
  • Si el proceso se corta de golpe, se pueden repetir unos segundos de historial.
  • En un idioma añadido como fichero, las respuestas de los plugins oficiales salen en inglés (hablan inglés y español).
  • En esta beta la instalación es desde el código; no hay paquetes .deb ni .rpm publicados.
  • Pendiente de comprobar en redes reales: login con X, NickServ, Q y AuthServ; invitación y desbaneo; plugins con acceso web; FiSH con clientes reales; instalador con systemd real y Let's Encrypt; DCC entre redes; SASL EXTERNAL; importador con instalaciones reales.
xBNC 1.0.0 Made by y2kApache License 2.0