Conectar tu cliente IRC
Sirve cualquier cliente que permita indicar servidor, puerto y contraseña de servidor. No hace falta ningún plugin.
| Qué quieres | Contraseña de servidor |
|---|---|
| Usuario con una sola red | alicia:contraseña |
| Elegir red | alicia/ejemplo:contraseña |
| Elegir red e identificar el dispositivo | alicia/ejemplo@portatil:contraseña |
| El mismo login en otro orden | alicia@portatil/ejemplo:contraseña |
- Servidor: tu dominio o IP (
sudo xbncd infolo 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@portatilen 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/ejemployalicia/otra). Los clientes consoju.im/bouncer-networks(Goguma, gamja, Halloy) ven todas tus redes en una sola conexión. - Dispositivo: la parte
@dispositivoes 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ás | Servidor | Puerto |
|---|---|---|
| En cualquier sitio (internet) | Tu dominio, por ejemplo bnc.ejemplo.org | 6697 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.50 | 6667 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»Lo más rápido, en cualquier ventana:
/server bnc.ejemplo.org +6697 alicia/ejemplo@mirc:tu-contraseña
El + delante del puerto activa SSL. Con certificado propio, mIRC pregunta la
primera vez: pulsa Aceptar. Para guardarlo: Archivo → Seleccionar servidor →
Añadir, con los mismos datos./server add xbnc-ejemplo bnc.ejemplo.org/6697 -tls
/set irc.server.xbnc-ejemplo.password "alicia/ejemplo@weechat:tu-contraseña"
/set irc.server.xbnc-ejemplo.capabilities "server-time,message-tags,batch,draft/chathistory,echo-message"
/connect xbnc-ejemplo
Con certificado propio: /set irc.server.xbnc-ejemplo.tls_verify off/network add -nick alicia xbnc-ejemplo
/server add -tls -network xbnc-ejemplo -password alicia/ejemplo@irssi:tu-contraseña bnc.ejemplo.org 6697
/connect xbnc-ejemplo
Con certificado propio, añade -notls_verify al /server addGoguma (Android) y Palaver (iOS) admiten bouncers: añade el servidor bnc.ejemplo.org, puerto 6697 con TLS, usuario alicia y tu contraseña. Goguma muestra todas tus redes en una sola conexión y pide el historial con CHATHISTORY. Para recibir avisos con la aplicación cerrada, usa los avisos de xBNC (push, Telegram…), o instala el panel como aplicación.
KVIrc, Konversation, Textual, Halloy, The Lounge y Quassel (como cliente de una red IRC normal) funcionan con los mismos datos: servidor, puerto con TLS y contraseña de servidor. Los clientes con draft/chathistory (Goguma, gamja, Kiwi IRC, Halloy) piden el historial directamente y no reciben reproducción automática.
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 cliente | Qué pasa | Qué 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ás | Tu 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.
| Ajuste | Qué es |
|---|---|
| Nombre corto | El que usas en el login (alicia/ejemplo). Cambiarlo no corta la conexión. |
| Servidor y puerto | Dirección de la red. Puerto 6697 con TLS por defecto. |
| TLS | Conexión cifrada con la red. El certificado del servidor se verifica siempre. |
| Nick | Tu 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 real | Los campos de USER. Por defecto, el nick. |
| Contraseña de servidor | Se envía con PASS al conectar. Se guarda cifrada y no se vuelve a mostrar. |
| Cuenta y contraseña SASL | Identificación SASL PLAIN. Para SASL EXTERNAL, usa un certificado de cliente. |
| Activa | Desactivada, xBNC no se conecta a esa red. |
| Comandos al conectar | Líneas que se envían tras conectar y antes de entrar en los canales (ver abajo). |
| Canales | Canales guardados, con su clave (cifrada). Un /join o /part desde el cliente se guarda solo. |
| Retención por canal | Cuánto se guarda el historial de un canal: lo del servidor, nada, para siempre o N días. |
| Servidores de reserva | Otros servidores de la misma red que xBNC prueba si falla el actual. Con /msg *status addserver (ver Comandos IRC). |
| Certificados de confianza | Huellas 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 orden | Un 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.
- Con Invitación y desbaneo, si no puedes entrar en un canal tuyo, xBNC pide a X
INVITEoUNBAN. - 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».
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
| Comando | Qué 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 |
version | Versión de xBNC. Ejemplo: /msg *status version |
uptime | Cuá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 |
seen | Cuándo te conectaste por última vez. Ejemplo: /msg *status seen |
showmotd | El 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 clientsTambién vale: listclients |
Redes y conexión
| Comando | Qué hace |
|---|---|
status | Estado de esta red: servidor, TLS, nick, capacidades. Ejemplo: /msg *status status |
networks | Tus redes y su estado. Ejemplo: /msg *status networksTambié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> confirmar | Borrar 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 y2kSolo cuentas con permiso de cambios (no el rol limitado). |
connect | Volver a conectar a la red. Ejemplo: /msg *status connectSolo cuentas con permiso de cambios (no el rol limitado). |
disconnect | Desconectar y quedarse desconectado. xBNC se queda desconectado de esta red hasta que uses connect. Ejemplo: /msg *status disconnectSolo 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.orgSolo cuentas con permiso de cambios (no el rol limitado). |
Servidores, certificados y direcciones
| Comando | Qué hace |
|---|---|
servers | Servidores de esta red (principal y de reserva). Si un servidor falla, xBNC prueba el siguiente por turnos. Ejemplo: /msg *status serversTambié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 6667Solo 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.orgSolo 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:1ETambién vale: addtrustedserverfingerprintSolo 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:1ETambién vale: deltrustedserverfingerprintSolo cuentas con permiso de cambios (no el rol limitado). |
fingerprints | Certificados de confianza de esta red. Ejemplo: /msg *status fingerprintsTambién vale: listtrustedserverfingerprints |
showbindhost | Direcció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.25Solo administradores. |
clearbindhost | Usar la dirección automática en esta red. Ejemplo: /msg *status clearbindhostSolo 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::25Solo administradores. |
clearuserbindhost | Quitar tu dirección local por defecto. Ejemplo: /msg *status clearuserbindhostSolo administradores. |
Canales
| Comando | Qué hace |
|---|---|
channels | Tus canales: usuarios, modos y estado. Ejemplo: /msg *status channelsTambién vale: listchans |
nicks <#canal> | Quién está en un canal, con su rango. Ejemplo: /msg *status nicks #xbncTambién vale: listnicks |
topics | El 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-devSolo cuentas con permiso de cambios (no el rol limitado). |
joinnow | Entrar 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 #xbncSolo 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 1Solo 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-devSolo cuentas con permiso de cambios (no el rol limitado). |
Historial (buffers)
| Comando | Qué 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 bobTambién vale: clearhistory |
clearallbuffers | Borrar todo el historial de esta red. Ejemplo: /msg *status clearallbuffers |
clearallchannelbuffers | Borrar el historial de todos los canales. Ejemplo: /msg *status clearallchannelbuffers |
clearallquerybuffers | Borrar 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 90Solo cuentas con permiso de cambios (no el rol limitado). |
Módulos y plugins
| Comando | Qué hace |
|---|---|
modules | Módulos y plugins de esta red y su estado. Ejemplo: /msg *status modulesTambién vale: listmods |
availmods | Todos los módulos y plugins, con lo que hacen. Ejemplo: /msg *status availmodsTambién vale: listavailmods |
enable <módulo|plugin> | Activar un módulo o plugin en esta red. Ejemplo: /msg *status enable awayTambién vale: loadmodSolo cuentas con permiso de cambios (no el rol limitado). |
disable <módulo|plugin> | Desactivarlo. Ejemplo: /msg *status disable awayTambién vale: unloadmodSolo 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 triviaTambién vale: updatemodSolo 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 60Solo 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 patternsSolo cuentas con permiso de cambios (no el rol limitado). |
Administración
| Comando | Qué hace |
|---|---|
users | Todas las cuentas y si están conectadas. Ejemplo: /msg *status usersTambién vale: listusersSolo administradores. |
allnetworks | Todas las redes de todos los usuarios, con su estado. Ejemplo: /msg *status allnetworksTambién vale: listallusernetworksSolo administradores. |
traffic | Tráfico y mensajes desde que arrancó xBNC. Ejemplo: /msg *status trafficSolo administradores. |
broadcast <mensaje> | Enviar un aviso a todos los usuarios conectados. Ejemplo: /msg *status broadcast Reinicio a las 23:00Solo 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 bobSolo administradores. |
rehash | Releer usuarios, redes, canales e idiomas. Para cambios hechos con la terminal (xbncd). Los cambios en xbnc.toml necesitan reiniciar. Ejemplo: /msg *status rehashTambién vale: reloadSolo administradores. |
listports | Puertos en los que escucha xBNC. Los puertos se configuran en xbnc.toml (o con el instalador) y necesitan reiniciar. Ejemplo: /msg *status listportsSolo administradores. |
saveconfig | Guardar la configuración. No hace falta: xBNC guarda cada cambio al momento. Ejemplo: /msg *status saveconfigSolo 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 xBNCSolo superadministradores. |
addmotd <texto> | Añadir una línea al mensaje del día. Ejemplo: /msg *status addmotd Normas: /msg *status helpSolo superadministradores. |
clearmotd | Quitar el mensaje del día. Ejemplo: /msg *status clearmotdSolo 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 ActualizandoSolo 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 MantenimientoSolo 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.
jumpsin nada pasa al siguiente;jump servidorojump 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».
enablechanentra en ellos al momento. - Orden de los canales. Es el orden en el que xBNC entra al conectar y en el que los lista
channelsy el panel. Los canales nuevos van al final. - Comodines.
enablechan,disablechan,attach,detachyclearbufferaceptan 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 conshowmotd. - Avisos a todos.
broadcastenvía «[Aviso del administrador] texto» a cada red en marcha; lo reciben todos los clientes conectados.restartyshutdowncon mensaje lo envían antes. - Reiniciar y parar.
restartreinicia xBNC dentro del mismo proceso (las redes se reconectan).shutdownlo para del todo y systemd no lo vuelve a arrancar: hay que hacerlo consudo systemctl start xbnc. - Puertos y xbnc.toml. Los puertos y el resto de xbnc.toml no se cambian desde IRC:
listportslos muestra yrehashrelee usuarios, redes, canales e idiomas (lo mismo quesudo systemctl reload xbnc).saveconfigexiste por costumbre: xBNC guarda cada cambio al momento.
*notes
| Comando | Qué hace |
|---|---|
list | Tus 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
| Comando | Qué 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). |
list | Conversaciones con clave. |
Escribe +p delante de un mensaje para enviarlo sin cifrar. Ver Cifrado de mensajes.
*ignore
| Comando | Qué hace |
|---|---|
add <nick o máscara> | Ignorar a alguien (nick, o nick!usuario@host con *). |
del <nick o máscara> | Dejar de ignorar. |
list | Lista 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
| Comando | Qué hace |
|---|---|
/quote DETACH #canal | Desacopla un canal: sigue guardando, pero no aparece en tu cliente. |
/quote ATTACH #canal o /join #canal | Vuelve 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ágina | Para qué sirve |
|---|---|
| Inicio | Estado 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. |
| Chat | Cliente IRC web: canales y privados de todas tus redes, con historial. El panel cuenta como uno de tus dispositivos. |
| Menciones | Todo lo que te han dicho en privado o donde han escrito tu nick, de más nuevo a más antiguo. |
| Redes | Añ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ódulos | Mó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). |
| Plugins | Catá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). |
| Usuarios | Altas, roles, cuotas de redes, dispositivos e historial, suspensión, restablecer contraseña, uso de cada cuenta e importación desde otro bouncer. |
| Seguridad | Intentos de acceso (IRC, panel y tokens), IPs bloqueadas con botón para desbloquear, sesiones abiertas y auditoría de todas las acciones. |
| Ajustes | Historial, límites, protección del acceso, idioma por defecto, alertas, copias de seguridad, actualizaciones y reinicio del servicio. |
| Tu cuenta | Foto 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.
| Grupo | Ajustes | Por defecto |
|---|---|---|
| Historial | Dí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ímites | Conexiones 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 acceso | Intentos fallidos antes de bloquear; ventana; duración del bloqueo; tiempo para completar el login. | 5; 600 s; 900 s; 30 s |
| General | Idioma 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 |
| Alertas | Ver Monitorización. | |
| Copias de seguridad | Automá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 ense 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:
desplieencuentra «despliegue». - No distingue mayúsculas ni tildes:
cancionencuentra «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:
spliegueencuentra «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ón | Qué hace | Por defecto |
|---|---|---|
| Activar avisos | Interruptor general. | no |
| Solo cuando no tengo ningún cliente conectado | No avisa si tienes un cliente IRC o el chat del panel abiertos. | sí |
| Cuando alguien escribe mi nick en un canal | Menciones. | sí |
| Cuando recibo un mensaje privado | Privados. | sí |
| Canal | Qué 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. |
| Telegram | Crea 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. |
| Discord | Un webhook del canal: Ajustes del canal → Integraciones → Webhooks. Los avisos no mencionan a nadie. |
| Correo | Tu dirección. El administrador tiene que configurar la sección [smtp] de xbnc.toml. |
| Dirección web propia | Una 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.