Usuarios, roles y seguridad
Roles
| Rol | Para quién |
|---|---|
superadmin | Todo, incluidos los ajustes del sistema, los plugins, las copias de seguridad, las actualizaciones, la importación y gestionar otros administradores. |
admin | Gestiona usuarios (salvo administradores y superadministradores), todas las redes y la seguridad; ve el sistema. |
moderator | Ve los usuarios y la auditoría, y puede suspender y reactivar usuarios normales y limitados. |
user | Gestiona sus propias redes, canales e historial. Es el rol por defecto. |
limited | Usa redes que le prepara un administrador; gestiona canales e historial, pero no añade, edita ni borra redes. |
Qué puede hacer cada rol
| Permiso | superadmin | admin | moderator | user | limited |
|---|---|---|---|---|---|
| Editar ajustes del sistema, instalar plugins, copias de seguridad, importar, actualizar | sí | — | — | — | — |
| Ver el sistema, gestionar usuarios, seguridad y todas las redes | sí | sí | — | — | — |
| Ver usuarios y auditoría, suspender usuarios | sí | sí | sí | — | — |
| Gestionar sus propias redes | sí | sí | sí | sí | — |
| Usar sus redes, canales, historial, chat, módulos y plugins | sí | 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
| Área | Medida |
|---|---|
| Contraseñas | Argon2id (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 guardadas | Contraseñ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). |
| TLS | rustls, 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 plano | Prohibido en direcciones públicas salvo insecure = true explícito. El puerto sin TLS por defecto solo acepta la red local. |
| Fuerza bruta | Bloqueo 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. |
| Registros | Nunca se registran contraseñas, AUTHENTICATE, OPER ni mensajes a servicios (NickServ IDENTIFY, X LOGIN, Q AUTH…), en ningún nivel. |
| Entrada | Lí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. |
| Recursos | Límites de conexiones totales, de clientes y redes por usuario; colas acotadas por cliente y hacia el servidor; tiempo máximo de registro. |
| SQL | Todas las consultas usan parámetros enlazados. |
| Privilegios | El servicio corre como xbnc sin privilegios, con aislamiento de systemd. En Docker: usuario sin privilegios, solo lectura, sin capacidades. |
| Panel: sesiones | Token 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 origen | Token CSRF obligatorio en toda petición que cambia algo; peticiones y WebSockets con Origin de otro sitio rechazados. |
| Panel: cabeceras | CSP 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: abuso | 20 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 acceso | La primera cuenta solo se crea con un código de un solo uso que el servicio escribe en su registro. |
| Secretos en la API | Las contraseñas nunca se devuelven; solo se indica si existen. |
| Tokens de API | 256 bits con prefijo xbnc_; solo se guarda su SHA-256. Alcance, caducidad, último uso e IP visibles, revocación inmediata. |
| Módulos | Compilados 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 ficheros | Rutas construidas solo con nombres saneados (un canal no puede salir de su carpeta), carpetas 0700 y ficheros 0600. |
| Plugins | WebAssembly 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. |
| DCC | Las 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 servicios | En redes sin NickServ (IRCnet, EFnet) el modo automático nunca envía la contraseña. |
| Traducciones | Los 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. |
| FiSH | El intercambio de claves admite 5 peticiones por minuto y 100 claves por sesión; el texto descifrado no puede romper líneas. |
| Webhooks | Solo http(s), sin usuario en la URL ni caracteres de control, certificado verificado, sin seguir redirecciones, 10 s como máximo. |
| Importación | Solo un superadministrador; nunca concede ese rol; la vista previa no devuelve secretos. |
| Auditoría | Cada acción del panel, de IRC y de la terminal queda registrada con fecha, autor y detalle (Seguridad → Auditoría, o xbncd audit). |
| Fuzzing | Parser 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
| Clave | Por defecto | Qué hace |
|---|---|---|
hostname | xbnc | Nombre del servidor que ven los clientes. |
language | en | Idioma 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/locales | Carpeta 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_file | obligatoria | Ruta 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]
| Clave | Por defecto | Qué hace |
|---|---|---|
path | obligatoria | Fichero 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. |
ha | false | Alta 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)
| Clave | Por defecto | Qué hace |
|---|---|---|
address | obligatoria | Direcció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). |
insecure | false | Permitir texto plano en una dirección pública (desaconsejado). |
lan_only | false | Solo clientes de la red local (loopback, privadas, enlace local, CGNAT/Tailscale, IPv6 ULA). El resto recibe un ERROR explicativo. Puede ir sin TLS. |
[web]
| Clave | Por defecto | Qué hace |
|---|---|---|
address | obligatoria | Direcció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. |
insecure | false | HTTP sin cifrar en una dirección pública (solo detrás de un proxy TLS en una red de confianza). |
secure_cookies | true con TLS | Marca 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_hours | 12 | Duración de la sesión en horas (deslizante). |
trust_proxy | false | Fiarse de X-Forwarded-For y X-Real-IP de un proxy en loopback, para que el bloqueo use la IP real. |
shared | false | Servir 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]
| Clave | Por defecto | Qué hace |
|---|---|---|
retention_days | 30 | Borrar mensajes de más de N días. 0, para siempre. |
playback_max | 1000 | Máximo de mensajes reproducidos al reconectar. |
new_client_playback | 100 | Mensajes para un dispositivo que nunca se había conectado. |
chathistory_max | 500 | Máximo limit aceptado en CHATHISTORY. |
[limits]
| Clave | Por defecto | Qué hace |
|---|---|---|
max_connections | 1000 | Conexiones IRC de clientes en total. |
max_clients_per_user | 10 | Dispositivos conectados por usuario. |
max_networks_per_user | 10 | Redes por usuario. |
login_max_failures | 5 | Fallos antes de bloquear una IP. |
login_window_seconds | 600 | Ventana en la que se cuentan los fallos. |
login_block_seconds | 900 | Duración del bloqueo. |
registration_timeout_seconds | 30 | Tiempo para completar el login de un cliente. |
client_queue | 4096 | Líneas en cola por cliente antes de desconectarlo por lento (al volver recupera lo pendiente). |
[log]
| Clave | Por defecto | Qué hace |
|---|---|---|
level | info | Filtro: 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]
| Clave | Por defecto | Qué hace |
|---|---|---|
public_ip | la que usa xBNC hacia la red | Direcció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. |
ports | cualquiera libre | Rango 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)
| Clave | Por defecto | Qué hace |
|---|---|---|
host | obligatoria | Servidor de correo. |
port | 587 | Puerto. |
security | starttls | starttls, tls (puerto 465) o none (solo relés locales). |
username, password | — | Credenciales. |
from | obligatoria | Remitente, por ejemplo xBNC <xbnc@ejemplo.org>. |
[oidc] (OpenID Connect)
| Clave | Por defecto | Qué hace |
|---|---|---|
name | — | Texto del botón (Google, Keycloak…). |
issuer | obligatoria | URL del emisor; se lee su /.well-known/openid-configuration. |
client_id, client_secret | obligatorias | Datos 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). |
scopes | openid profile email | Alcances que se piden. |
username_claim | preferred_username | Dato que se usa como nombre de las cuentas creadas automáticamente. |
auto_create | false | Crear la cuenta de xBNC la primera vez que alguien entra. |
link_existing | false | Vincular con una cuenta local del mismo nombre (solo con proveedores que controles). |
default_role | user | Rol de las cuentas creadas. |
allowed_groups | [] (todos) | Si se indica, solo pueden entrar miembros de alguno de estos grupos. |
groups_claim | groups | Dato con los grupos. |
[ldap]
| Clave | Por defecto | Qué hace |
|---|---|---|
url | obligatoria | ldaps://host:636, o ldap://host:389 con starttls = true. |
starttls | false | Usar STARTTLS. |
bind_dn | obligatoria | DN con el que se entra; {{username}} se cambia por el nombre escrito. |
ca_file | certificados del sistema | Fichero PEM con la autoridad del servidor LDAP. |
auto_create, link_existing, default_role | false, false, user | Igual que en [oidc]. |
[updates]
| Clave | Por defecto | Qué hace |
|---|---|---|
check | true | Comprobar 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)
| Clave | Por defecto | Qué 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.
| Comando | Qué hace | Opciones |
|---|---|---|
xbncd run | Ejecuta el bouncer en primer plano (lo hace el servicio). SIGHUP (systemctl reload) relee redes, canales, usuarios e idiomas. | — |
xbncd init | Crea la base de datos y la clave secreta. | — |
xbncd check-config | Comprueba el fichero de configuración y termina. | — |
xbncd info | Muestra la dirección del panel y cómo se conectan los clientes. | — |
xbncd setup-code | Muestra el código de un solo uso para crear el primer administrador. | — |
xbncd user add NOMBRE | Crea 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 list | Lista los usuarios. | — |
xbncd user passwd NOMBRE | Cambia la contraseña. | --password-stdin |
xbncd user role NOMBRE ROL | Cambia el rol. | — |
xbncd user enable|disable NOMBRE | Reactiva o suspende una cuenta (tras reload, sus redes se desconectan). | — |
xbncd user reset-2fa NOMBRE | Quita la verificación en dos pasos (móvil perdido). | — |
xbncd user delete NOMBRE --yes | Borra el usuario, sus redes y su historial. | --yes (confirmar) |
xbncd network add USUARIO NOMBRE --host SERVIDOR | Añ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 USUARIO | Lista las redes de un usuario. | — |
xbncd network enable|disable USUARIO NOMBRE | Activa o desactiva una red. | — |
xbncd network delete USUARIO NOMBRE --yes | Borra una red. | --yes |
xbncd channel add USUARIO RED CANAL | Guarda un canal para entrar automáticamente. | --key (pide la clave del canal) |
xbncd channel list USUARIO RED | Lista los canales guardados. | — |
xbncd channel delete USUARIO RED CANAL | Quita un canal guardado. | — |
xbncd plugin install FICHERO.wasm | Instala o actualiza un plugin; cada usuario lo activa en sus redes. | --yes (aceptar los permisos que pide) |
xbncd plugin list | Lista los plugins instalados. | — |
xbncd plugin remove ID | Desinstala un plugin y borra sus ajustes en todas las redes. | — |
xbncd plugin check FICHERO.wasm | Comprueba un plugin y muestra su manifiesto. | — |
xbncd plugin pack PLUGIN.wasm MANIFIESTO.json -o SALIDA.wasm | Mete el manifiesto (JSON) dentro de un plugin compilado. | -o, --output (obligatoria) |
xbncd plugin catalog-keygen -o CLAVE | Para publicar un catálogo: crea la clave de firma (guárdala bien). | -o, --output |
xbncd plugin catalog-entry FICHERO.wasm URL | Para publicar un catálogo: imprime la entrada del índice de un plugin publicado en URL (https://). | — |
xbncd plugin catalog-sign --key CLAVE ÍNDICE | Para publicar un catálogo: firma el índice (escribe ÍNDICE.sig). | -k, --key |
xbncd backup DESTINO | Copia consistente de la base de datos, con xBNC en marcha. | — |
xbncd migrate-to-postgres URL | Copia la base de datos SQLite a una PostgreSQL nueva y vacía. Para xBNC antes; después pon database.url. | — |
xbncd import RUTA | Trae 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 CARPETA | Importa 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 keygen | Para 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-update | Instala 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 list | Idiomas 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
| Script | Uso |
|---|---|
scripts/install.sh | Instala 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 |
|---|---|
| Usuarios | Con su nombre. Los administradores pasan a admin (nunca a superadmin). Los usuarios que ya existen en xBNC no se tocan. |
| Contraseñas | Las 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. |
| Redes | Servidor, 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. |
| Canales | Con sus claves (cifradas). Los desactivados no se importan. |
| SASL, NickServ y comandos al conectar | SASL 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 cliente | Se importa si está en la carpeta de datos y su clave coincide. |
| Módulos | Se activa el equivalente de xBNC (tabla de abajo). |
| Registros | Los 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 anterior | En xBNC |
|---|---|
keepnick | Recuperar nick |
simple_away, away, autoaway, awaynick | Ausente automático (con el retraso y el mensaje de simple_away) |
autoop | Op y voz automáticos (vuelve a añadir las entradas: la sintaxis es otra) |
kickrejoin | Volver tras un kick (con su retraso) |
stickychan | Canales fijos (con la lista) |
buffextras | Eventos en el historial |
log | Registros en ficheros |
route_replies | Respuestas a quien pregunta |
cert | Certificado de cliente |
alias, watch | Alias y Vigilar palabras (vuelve a añadir las entradas) |
block_motd | Ocultar el MOTD |
ctcpreplies | Respuestas CTCP (con la respuesta a VERSION) |
perform, nickserv, sasl | Comandos al conectar y SASL de la red |
chansaver, savebuff, playback, clientbuffer, webadmin, controlpanel, fail2ban, lastseen, notes, clearbufferonmsg, simple_disconnect, missingmotd, certauth, listsockets, identfile, partyline | Ya 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):
| Alerta | Se activa cuando | Por defecto |
|---|---|---|
network_down | Una 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_logins | Hay N o más accesos fallidos (IRC, panel y tokens) en los últimos 10 minutos. | 30 |
memory | La memoria del proceso supera N MB. | desactivada |
database | La 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
*statusen 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étrica | Tipo | Qué mide |
|---|---|---|
xbnc_info | gauge | Versión del servidor (etiqueta version). |
xbnc_uptime_seconds | gauge | Segundos desde que arrancó. |
xbnc_users | gauge | Cuentas. |
xbnc_networks | gauge | Redes configuradas. |
xbnc_networks_running{state} | gauge | Conexiones por estado: connected, connecting, disconnected, reconnecting. |
xbnc_irc_clients | gauge | Clientes IRC conectados. |
xbnc_connections | gauge | Conexiones IRC abiertas al bouncer, también sin autenticar. |
xbnc_blocked_ips | gauge | Direcciones bloqueadas por fallos. |
xbnc_server_bytes_received_total, xbnc_server_bytes_sent_total | counter | Bytes recibidos de y enviados a los servidores IRC. |
xbnc_client_bytes_received_total, xbnc_client_bytes_sent_total | counter | Bytes recibidos de y enviados a los clientes. |
xbnc_server_lines_total | counter | Líneas recibidas de los servidores. |
xbnc_messages_stored_total | counter | Mensajes guardados en el historial. |
xbnc_reconnects_total | counter | Reconexiones a servidores IRC. |
xbnc_client_logins_total | counter | Logins correctos de clientes IRC. |
xbnc_failed_logins_total | counter | Logins fallidos (IRC y panel). |
xbnc_history_messages | gauge | Mensajes guardados en el historial. |
xbnc_database_bytes | gauge | Tamaño de la base de datos. |
xbnc_resident_memory_bytes | gauge | Memoria del proceso. |
xbnc_log_lines_dropped_total | counter | Líneas del módulo log descartadas porque el disco no daba abasto. |
xbnc_dcc_relays_total | counter | Envíos y chats DCC pasados por xBNC. |
xbnc_dcc_bytes_total | counter | Bytes de DCC pasados por xBNC. |
xbnc_alerts_firing{alert} | gauge | Alertas 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.
| Alcance | Puede |
|---|---|
read | Solo peticiones GET. |
write | Todo 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). |
metrics | Solo 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
POST /auth/logincon{"username", "password"}(ytotp_codesi la cuenta tiene verificación en dos pasos). La respuesta trae la cookiexbnc_sessiony, en el cuerpo,csrf.- Envía la cookie en cada petición, y en POST, PUT, PATCH y DELETE la cabecera
X-CSRF-Tokencon ese valor (GET /auth/melo devuelve otra vez). - Las peticiones con una cabecera
Originde 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étodo | Ruta | Qué hace | Quién |
|---|---|---|---|
GET | /health | Comprobación de vida. | sin sesión |
GET | /i18n | Idiomas 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 | /setup | Instalación inicial con el código de un solo uso. | sin sesión |
POST | /auth/login | Entrar: {username, password, totp_code}. Devuelve la cookie xbnc_session y el campo csrf. | sin sesión |
POST | /auth/logout | Cerrar la sesión. | sesión |
GET | /auth/me | Tu cuenta, tus permisos y el token CSRF. | sesión o token |
GET | /auth/methods | Formas de entrar que ofrece el servidor (passkeys, OpenID Connect, LDAP). | sin sesión |
GET | /auth/oidc/start | Redirige al proveedor de OpenID Connect. | sin sesión |
GET | /auth/oidc/callback | Vuelta desde el proveedor de OpenID Connect. | sin sesión |
POST | /auth/passkey/options | Empieza a entrar con passkey (desafío WebAuthn). | sin sesión |
POST | /auth/passkey | Entra con la respuesta de la passkey. | sin sesión |
GET | /dashboard | Resumen del Inicio (global para administradores). | sesión o token |
GET | /presets | Redes conocidas para el asistente. | sesión o token |
GET, POST | /networks | Listar (?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}/channels | Canales, 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}/history | Retenció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}/conversations | Conversaciones con su número de mensajes. | dueño o admin |
GET, DELETE | /networks/{id}/history | Buscar: 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/export | Descargar: ?format=txt|json y ?target=. | dueño o admin |
GET | /networks/{id}/chat | WebSocket 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-connect | Comandos al conectar: {commands: "/msg X login …"}; vacío los borra. | dueño o admin |
GET, PUT, DELETE | /networks/{id}/cert | Certificado 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/generate | Generar un certificado nuevo. | dueño o admin |
GET | /modules | Catálogo de módulos: ids, ajustes con tipo y límites. | sesión o token |
GET | /networks/{id}/modules | Estado 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}/plugins | Plugins de una red. | dueño o admin |
PUT | /networks/{id}/plugins/{plugin} | {enabled, config}. | dueño o admin |
GET | /mentions | Mensajes que te mencionan, más nuevos primero (?before=ms&limit=). | sesión o token |
GET | /notes | Tus 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/password | Cambiar tu contraseña (cierra tus otras sesiones). | solo sesión |
PUT | /me/avatar | Foto 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/avatar | Quitar tu foto de perfil. | sesión o token |
GET | /users/{id}/avatar | La 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}/avatar | Quitar la foto de un usuario (manage_users, en roles por debajo del tuyo). | sesión o token |
POST | /me/totp/setup | Empezar a activar la verificación en dos pasos (secreto y QR). | solo sesión |
POST | /me/totp/enable | Activarla con un código. | solo sesión |
POST | /me/totp/disable | Desactivarla. | solo sesión |
GET, POST | /me/passkeys | Tus passkeys; registrar una. | solo sesión |
POST | /me/passkeys/options | Empezar a registrar una passkey. | solo sesión |
DELETE | /me/passkeys/{id} | Quitar una passkey. | solo sesión |
GET, DELETE | /me/identities | Cuentas externas vinculadas (OpenID Connect, LDAP); desvincular. | solo sesión |
POST | /me/identities/oidc | Empezar a vincular tu cuenta de OpenID Connect. | solo sesión |
GET, PUT | /me/notifications | Ajustes de avisos (el token de Telegram se devuelve oculto). | sesión o token |
POST | /me/notifications/test | Enviar un aviso de prueba a todos los canales. | sesión o token |
GET, POST, DELETE | /me/push | Dispositivos con push; suscribir {endpoint, keys: {p256dh, auth}, label}; quitar {endpoint}. | sesión o token |
GET | /push/key | Clave pública VAPID para Web Push. | sesión o token |
GET | /diagnostics | Informe 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 | /tokens | Tus 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 | /sessions | Sesiones del panel (?all=true: todas, administradores). | sesión |
DELETE | /sessions/{id} | Cerrar una sesión. | sesión |
GET, POST | /users | Listar 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}/password | Restablecer la contraseña (cierra sus sesiones). | admin |
GET | /users/{id}/usage | Redes, clientes y espacio de historial usados frente a sus cuotas. | moderator |
GET | /security | Accesos e IPs bloqueadas. | moderator |
DELETE | /security/blocked/{ip} | Desbloquear una IP. | admin |
GET | /audit | Registro de auditoría. | moderator |
GET, PUT | /settings | Ajustes en caliente. | ver: admin; editar: superadmin |
GET | /system | Versión, base de datos, escuchas y contadores. | admin |
POST | /system/restart | Reiniciar xBNC (el servicio lo vuelve a arrancar). | superadmin |
GET | /alerts | Alertas activas. | admin |
GET | /metrics | Métricas en formato Prometheus. | admin o token metrics |
GET | /ws | WebSocket 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 | /backups | Copias, 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}/restore | Preparar la restauración de una copia del servidor. | superadmin |
POST, DELETE | /backups/restore | Subir una copia (.tar.gz) y prepararla; cancelar la restauración preparada. | superadmin |
GET | /plugins | Plugins instalados. | sesión o token |
POST | /plugins | Instalar o actualizar: el cuerpo es el .wasm (application/wasm, hasta 4 MB). | superadmin, sesión |
POST | /plugins/inspect | Comprobar un .wasm sin instalarlo. | superadmin, sesión |
PATCH, DELETE | /plugins/{id} | {enabled} en el servidor y dominios aprobados; desinstalar. | superadmin, sesión |
GET | /plugins/catalog | Catá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/dev | Modo desarrollo: estado y carpeta; activar o desactivar. | superadmin, sesión |
GET | /plugins/logs | WebSocket con el registro de los plugins: últimas líneas y las nuevas. | superadmin, sesión |
GET | /updates | Versión instalada y última publicada, si se puede actualizar desde el panel y el resultado de la última actualización. | admin |
POST | /updates/check | Comprobar ahora si hay versión nueva. | admin, sesión |
POST | /updates/install | Descargar, verificar e instalar el paquete firmado de la última versión. | superadmin, sesión |
POST | /import/preview | Vista previa de la importación: {config: "contenido del fichero"}. No escribe nada. | superadmin, sesión |
POST | /import/apply | Importar. | 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.