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

Wiki Usar

Usar

Conectar tu cliente IRC, añadir redes, los comandos IRC, el panel web, el historial y los avisos.

Conectar tu cliente IRC

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

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

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

Desde internet o desde tu red local

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

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

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

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

Si te equivocas de puerto o de SSL

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

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

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

Redes sin SASL (Undernet, QuakeNet)

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

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

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

Compatibilidad de clientes

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

Redes

Ajustes de una red

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

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

Comandos al conectar

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

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

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

Undernet

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

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

Libera.Chat y freenode

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

Rizon

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

EvilNet

Te identificas con NickServ (IDENTIFY cuenta contraseña). Elige NickServ en Login en servicios, o «Automático», que en EvilNet usa NickServ.

QuakeNet

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

IRCnet y EFnet

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

OFTC y otras redes con NickServ

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

Comandos IRC

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

*status

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

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

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

General

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

Redes y conexión

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

Servidores, certificados y direcciones

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

Canales

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

Historial (buffers)

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

Módulos y plugins

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

Administración

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

Notas sobre estos comandos

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

*notes

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

Son las mismas notas que en Tu cuenta → Notas.

*watch

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

*crypt

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

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

*ignore

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

Un servicio por plugin

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

Comandos de cliente

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

Panel web

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

Ajustes en caliente

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

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

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

Accesibilidad y uso en el móvil

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

Historial y búsqueda

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

Buscar

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

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

Exportar y borrar

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

Retención y cuotas

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

Registros en ficheros

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

Avisos

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

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

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

Formato del aviso en la dirección web propia

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

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