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

Wiki Administrar

Administrar

Usuarios y seguridad, el fichero de configuración, la línea de comandos, copias, monitorización, la API REST y actualizaciones.

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.
sharedfalseServir el panel en el puerto IRC de address (una de las entradas [[listen]], con TLS): los navegadores ven el panel y los clientes IRC el bouncer, en el mismo puerto, con el certificado del listener (no pongas aquí tls_cert ni tls_key).

[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). El instalador escribe 50000-50100 y lo abre.

[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 otra --host irc.ejemplo.net --sasl-user alicia
sudo -u xbnc xbncd network add alicia ejemplo --host irc.ejemplo.org --port 6667 --no-tls
sudo -u xbnc xbncd channel add alicia otra '#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] [--build]Actualiza el binario con copia previa y vuelta atrás automática.
scripts/prereqs.sh [--check]Instala lo necesario para compilar xBNC (herramientas y Rust), o con --check solo dice qué falta.
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 ejemplo /ruta/a/logs/ejemplo --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/otra",
  "message": "Network alicia/otra has been disconnected for more than 15 minutes",
  "since": 1762600000000,
  "text": "[xBNC bnc.ejemplo.org] firing: Network alicia/otra ...",
  "content": "[xBNC bnc.ejemplo.org] firing: Network alicia/otra ..."
}

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":"ejemplo","host":"irc.ejemplo.org","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
PUT/me/avatarFoto de perfil: los bytes de la imagen con Content-Type image/png, image/jpeg o image/webp (como mucho 256 KB y 1024×1024 píxeles; se comprueba el formato real).sesión o token
DELETE/me/avatarQuitar tu foto de perfil.sesión o token
GET/users/{id}/avatarLa foto de un usuario: la tuya, o la de cualquiera con view_users. La dirección con ?v= está en el campo avatar de los usuarios y de /auth/me.sesión o token
DELETE/users/{id}/avatarQuitar la foto de un usuario (manage_users, en roles por debajo del tuyo).sesión o token
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 .zip: se actualiza descomprimiendo el nuevo y ejecutando 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.