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

Wiki Ayuda

Ayuda

Problemas frecuentes con sus causas y soluciones, y cómo probar la beta en redes reales.

Problemas frecuentes

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

Instalación

SíntomaCausa probableSolución
«La compilación ha fallado» y «Killed» en la salidaLa máquina se quedó sin memoria al compilar (necesita unos 2 GB, contando la swap).Añade swap y vuelve a ejecutar el instalador: sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
«El binario preparado no funciona en este sistema»El sistema es anterior a 2019 (glibc anterior a 2.28).No hay que hacer nada: el instalador lo compila solo. Tarda unos minutos.
«No se pudo instalar Rust»El servidor no llega a https://sh.rustup.rs (cortafuegos o proxy).Permite HTTPS hacia sh.rustup.rs y static.rust-lang.org, o instala Rust a mano y vuelve a ejecutar el instalador. En x86_64 este paso no hace falta: el programa viene ya compilado.
«Hacen falta unos 3 GB libres»No hay disco suficiente para compilar.Libera espacio, o descomprime el .zip en un disco con más sitio.
«Se necesita systemd»El sistema no usa systemd (Alpine, contenedores).Usa Docker (ver Docker más arriba) o una distribución con systemd.

No puedes conectar

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

Problemas con una red

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

Módulos y plugins

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

Panel y servicio

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

Más detalle en el registro

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

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

Probar la beta

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

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

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

Límites conocidos

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