IrcXpress · wiki

réseau ircxpress ← retour au tchat

IrcXpress — serveur IRC tout-en-un

Un seul binaire regroupe : serveur IRC, services (NickServ, ChanServ, OperServ, BotServ, HostServ, FunServ), panel d'administration web, client WebIRC, traduction automatique et liaison entre serveurs.

TCP 6667TLS 6697WebIRC SASLTraductionRôles ~&@%+

Connexion

Clients IRC (mIRC, HexChat…) : port 6667 (clair) ou 6697 (SSL). Le port 7000 sert à la liaison entre serveurs, pas aux clients.

SASL : dans mIRC, SSL + « Login method : SASL » avec pseudo enregistré + mot de passe → identification dès la connexion.

Commandes de base

  • /nick <pseudo>, /join #salon (ou /j), /part #salon, /quit [raison]
  • /msg <cible> <texte>, /me <action>, /topic #salon <sujet>
  • /list (salons), /names #salon, /who #salon, /whois <pseudo>
  • /mode #salon <modes>, /kick #salon <pseudo>, /invite <pseudo> #salon, /away [raison]

Le WHOIS affiche aussi la langue préférée du pseudo, et son IP réelle pour les opers.

Alias de commandes

/ns NickServ · /cs ChanServ · /bs BotServ · /hs HostServ · /fs FunServ · /os OperServ

/identify (= /id) · /register (= /reg) · /ghost · /release · /lang <code> · /translate on|off · /j = /join

Rôles de salon

PréfixeModeRôle
~+qowner (fondateur)
&+aadmin / protect
@+oopérateur
%+hhalfop
++vvoice

Modes de salon

+i sur invitation · +m modéré · +n pas d'externe · +t sujet verrouillé · +s secret/invisible · +p privé · +k <clé> · +l <limite> · +b <masque> ban · +R salon enregistré (posé et retiré automatiquement par ChanServ lors de REGISTER / DROP ; il ne se règle pas à la main)

Modes utilisateur

ModeSignification
+oopérateur IRC (après /oper)
+Iinvisible — réservé au devadmin : actif quand l'administrateur s'est rendu invisible depuis le panel (masqué des listes de membres, WHO et NAMES). Le client en est averti et /mode <ton pseudo> l'affiche.

Le mode de salon +R (salon enregistré) apparaît dans les modes du salon, par exemple +ntR, et dans le panneau « Statut IRC » du webchat.

NickServ — pseudos

  • /ns REGISTER <pass> [email] — enregistre ton pseudo.
  • /ns IDENTIFY <pass> — t'identifie (retrouve tes salons).
  • /ns GHOST <pseudo> <pass> — déconnecte une session fantôme sur ton pseudo.
  • /ns RELEASE <pseudo> <pass> — libère ton pseudo.
  • /ns DROP <pass>, /ns INFO [pseudo]

Un pseudo enregistré non identifié est renommé en guestNNN au bout de 60 s.

ChanServ — salons

  • /cs REGISTER #salon [desc] — enregistre le salon (il faut être op). Tu deviens owner.
  • /cs OWNER|PROTECT|OP|HALFOP|VOICE #salon [pseudo] (+ les DE…)
  • /cs INFO #salon, /cs DROP #salon

Dans le webchat : bouton ⚙ salon → « Enregistrer / Désenregistrer ce salon ».

BotServ — bots

  • /bs BOTLIST — liste des bots.
  • /bs ASSIGN #salon <bot> / /bs UNASSIGN #salon <bot>
  • /bs ADD <nom> [desc] / /bs DEL <nom> (oper)

FiGoLu est le bot du réseau : présent dans tous les salons, gérable depuis le panel admin. Les bots répondent aux commandes ! : !8ball, !dice, !choose, !coin, !ping.

HostServ — vhost

/hs SET <vhost> (identifié) masque ton adresse (ex : libre.pseudo). /hs OFF désactive.

FunServ — jeux

/fs 8BALL <question>, DICE [NdM], CHOOSE a|b|c, COIN, PING — ou en salon avec !.

Réseau multi-serveurs : HUB et LEAF

Plusieurs serveurs IrcXpress peuvent former un seul réseau : mêmes salons, mêmes utilisateurs, mêmes comptes, où que l'on se connecte.

  • HUB : le serveur central. Il porte les services (NickServ, ChanServ, BotServ, HostServ, OperServ), les comptes et les salons enregistrés, le bot FiGoLu et les ponts Discord / Fluxer. Il relie tous les LEAF entre eux.
  • LEAF : serveur de discussion simple, relié au hub, sans services. Il peut se trouver n'importe où (adresse IP ou nom DNS).

Sur un LEAF, tout fonctionne comme d'habitude : /ns IDENTIFY, /cs REGISTER, /oper et l'identification SASL sont transmis au hub, qui répond. Ton compte, tes droits de salon (fondateur, op, voice) et le mode +R sont les mêmes sur tout le réseau.

  • Si le hub devient injoignable, la discussion continue sur chaque LEAF, mais les services répondent « Services indisponibles » jusqu'au retour du hub. Les utilisateurs des autres serveurs disparaissent le temps de la coupure (netsplit) puis reviennent.
  • Les liens sont chiffrés (TLS) et le certificat du hub est vérifié par empreinte.
  • Les protections de connexion (SecureServ : listes noires, limites par IP) restent propres à chaque serveur.

Certificat client (certfp) — s'identifier sans mot de passe

Connecte-toi en TLS (port 6697) avec un certificat personnel : le serveur calcule son empreinte SHA-256 et, si elle est liée à ton compte, t'identifie automatiquement à la connexion.

  1. Crée ton certificat : openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes -keyout client.key -out client.crt -days 3650 -subj "/CN=monpseudo" puis cat client.key client.crt > client.pem.
  2. Configure ton client IRC pour l'envoyer (mIRC : Options → Connect → Options → SSL ; HexChat : fichier ~/.config/hexchat/certs/<réseau>.pem ; WeeChat : /set irc.server.<nom>.tls_cert ~/client.pem ; irssi : option -tls_cert).
  3. Connecte-toi en TLS, identifie-toi une fois (/ns IDENTIFY <mot de passe>) puis /ns CERT ADD : l'empreinte du certificat de cette connexion est liée à ton compte.
🪟 Tutoriel Windows (PowerShell) — créer le certificat avec OpenSSL
  1. Installe OpenSSL : télécharge « Win64 OpenSSL » (version Light) sur slproweb.com/products/Win32OpenSSL.html, lance l'installateur et garde les options par défaut. OpenSSL s'installe dans C:\Program Files\OpenSSL-Win64\bin\.
  2. Ouvre PowerShell (menu Démarrer, tape « PowerShell ») et colle les commandes ci-dessous, une par une. Les fichiers sont créés dans le dossier Bureau\openssl : remplace monpseudo par ton pseudo IRC.
$ssl = "C:\Program Files\OpenSSL-Win64\bin\openssl.exe"
New-Item -ItemType Directory -Force "$env:USERPROFILE\Desktop\openssl"; cd "$env:USERPROFILE\Desktop\openssl"
& $ssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes -keyout client.key -out client.crt -days 3650 -subj "/CN=monpseudo"
Get-Content client.key, client.crt | Set-Content client.pem -Encoding ascii
& $ssl x509 -in client.crt -noout -fingerprint -sha256
  • La dernière commande affiche l'empreinte (sha256 Fingerprint=AB:CD:…) : copie-la et colle-la dans le bouton « Certificat » du webchat (ou /ns CERT ADD …).
  • Fichiers créés : client.key (clé privée, ne la partage jamais), client.crt (certificat) et client.pem (les deux réunis, à donner à ton client IRC : mIRC, HexChat…).
  • Si PowerShell ne trouve pas OpenSSL, vérifie le chemin de la première ligne (un autre dossier que OpenSSL-Win64 a pu être choisi à l'installation).
CommandeEffet
/ns CERT ADD [empreinte]lie le certificat de la connexion (ou l'empreinte donnée, 64 hexa) à ton compte — 5 maximum, une empreinte ne sert qu'à un compte
/ns CERT LISTliste tes empreintes
/ns CERT DEL <empreinte|n°>supprime une empreinte
  • SASL EXTERNAL : les clients qui le gèrent (mIRC, HexChat…) s'identifient avec le certificat dès l'ouverture de la connexion.
  • /whois affiche ton empreinte (à toi et aux opérateurs seulement).
  • Webchat : le navigateur n'envoie pas de certificat au serveur, donc le webchat s'identifie toujours par mot de passe. Depuis le webchat, le bouton « Certificat » (ou /ns CERT ADD <empreinte>, avec l'empreinte donnée par openssl x509 -in client.crt -noout -fingerprint -sha256) lie un certificat à ton compte pour tes autres clients IRC.
  • Fonctionne aussi sur un LEAF : c'est le hub qui décide. Sans certificat, tout marche comme avant (mot de passe).

Traduction automatique

Choisis ta langue (au login ou /lang <code>), affichée [FR] devant ton pseudo. Avec /translate on, les messages de salon te sont traduits et préfixés [XX]. Un dev chinois écrit en chinois, un mainteneur allemand lit la traduction allemande, etc.

Client web (WebIRC)

  • 3 colonnes : salons · messages · membres (avec grades colorés et tag de langue).
  • Thème clair/sombre 🌙, sélecteur d'emoji 😊, personnalisation des couleurs 🎨.
  • Clic droit salon/membre, bouton ⚙ salon (réglages sujet/modes/enregistrement) pour op/halfop.
  • Rester connecté (reconnexion auto), liste des salons du réseau.

Fonctions du client web

  • Messages privés : bouton « messages » avec pastille rouge, liste des personnes qui t'écrivent, aperçu du dernier message, suppression d'une conversation (×).
  • Mentions : quand quelqu'un écrit @ton-pseudo dans un salon, la ligne est surlignée, le salon reçoit une pastille orange @n, un bip retentit et une notification du navigateur s'affiche si l'onglet est caché.
  • Historique : ↑ / ↓ dans la zone de saisie rappellent les messages et commandes déjà envoyés (comme dans un terminal ; le brouillon en cours est conservé).
  • Autocomplétion : @pseudo, pseudos (touche Tab), #salons et /commandes ; flèches, Tab ou Entrée pour choisir.
  • Liste des membres par groupes : Propriétaires, Admins, Opérateurs, Demi-ops, Voix, Discord, Fluxer, En ligne — chaque groupe est repliable.
  • Colonnes redimensionnables (glisser les poignées, double-clic pour réinitialiser) et panneau « Statut IRC » (serveur, version, latence, compte, modes et sujet du salon).
  • Barre d'outils : s'identifier à NickServ, créer un compte, enregistrer un salon (ChanServ), infos, réglages, aide.
  • Effets sur le pseudo (bouton ✨) : arc-en-ciel, doré, feu, océan, néon, clignotant ou couleur unie — disponibles seulement si l'administrateur les a activés.
  • Chat compagnon : le bouton 🐈 de l'en-tête fait vivre un petit chat qui marche sur les éléments de la page (boutons, panneaux, messages), saute de l'un à l'autre, se lave, dort et réagit au clic (miaou, cœurs ; double-clic : il saute) et quand on t'appelle. Il se désactive à tout moment ; l'administrateur peut l'interdire.
  • Smartphone : affichage adapté, salons et membres dans des tiroirs (☰ et 👥), outils derrière le bouton ⚙.
  • Filigrane : le logo du réseau apparaît très discrètement au centre du chat (réglable dans le panel admin).

Pont Discord ↔ IRC

Un salon Discord peut être relié à un salon IRC : les messages passent instantanément dans les deux sens. Les personnes présentes sur Discord apparaissent dans la liste des utilisateurs sous la forme [D]pseudo (groupe « Discord »). Les mentions @everyone / @here ne notifient personne.

  • Fichiers et images Discord : leur lien est ajouté au message IRC.
  • Messages IRC vers Discord : postés par un bot (« pseudo : message ») ou, avec un webhook, sous le pseudo de l'auteur « pseudo (IRC) ».
  • Option : afficher tous les membres en ligne qui voient le salon, sinon ils apparaissent quand ils écrivent.
  • Configuration par l'administrateur, onglet « Discord » du panel (avec guide pas à pas pour créer le bot).

Pont Fluxer ↔ IRC

Même principe avec Fluxer (plateforme de discussion libre auto-hébergée) : un salon Fluxer est relié à un salon IRC, les messages circulent instantanément dans les deux sens, et les personnes de Fluxer apparaissent sous la forme [F]pseudo (groupe « Fluxer »).

  • Si les ponts Discord et Fluxer sont reliés au même salon IRC, leurs messages se retrouvent aussi de l'un à l'autre.
  • Un bot ou un webhook relaie les messages IRC vers Fluxer ; les mentions de masse sont neutralisées.
  • Option « membres en ligne » : tous les membres connectés qui voient le salon apparaissent en [F]pseudo ; sinon ils apparaissent quand ils écrivent et disparaissent après 30 minutes.
  • Configuration par l'administrateur, onglet « Fluxer » du panel.

FiGoLu — le bot « darkbot »

Le bot du réseau, présent dans tous les salons, s'inspire de darkbot :

  • Message de bienvenue : accueille les nouveaux arrivants (IRC, webchat, Discord, Fluxer — avec des messages spécifiques possibles pour les [D] et les [F]), dans le salon ou en notice privée, sans répéter pour la même personne.
  • Phrases aléatoires : dites sur les salons choisis à intervalle aléatoire (seulement si le salon est actif).
  • Réponses automatiques : règles « mot clé => réponse », avec joker *.
  • Variables : %user (pseudo sans [D]), %nick, %chan, %users, %rand (quelqu'un au hasard), %bot, %network, %time, %date.
  • Tout se règle dans l'onglet « FiGoLu (darkbot) » du panel admin. Ses messages sont aussi relayés vers Discord / Fluxer.

Les jeux !8ball, !dice… restent disponibles (voir FunServ).

SecureServ — protection des connexions

  • Listes noires DNSBL : chaque connexion peut être vérifiée dans DroneBL et EFnet RBL (liste Tor en option, autres listes ajoutables).
  • Limites par adresse IP : nombre de clones simultanés et de connexions par minute, avec bannissement temporaire en cas d'excès.
  • Mode observation : le journal indique ce qui serait bloqué sans rien refuser ; l'administrateur passe en blocage quand il est satisfait.
  • Adresses locales, liste blanche et utilisateurs de ponts ne sont jamais contrôlés ; si une liste ne répond pas, la connexion est acceptée.
  • Vraie adresse IP des utilisateurs du webchat (même derrière un proxy), donc les bans G/K/Z-line et les limites fonctionnent aussi pour eux.

Anti-takeover et verrouillage de connexion

  • Fondateur protégé : le fondateur d'un salon enregistré ne peut être ni deopé, ni expulsé, ni banni par d'autres (les opérateurs IRC sont exemptés).
  • Limiteur d'actions : trop de deop / kick / ban en quelques secondes par la même personne → ses droits sont retirés, le salon est verrouillé quelques minutes (+im) et les opérateurs sont prévenus.
  • Échecs de mot de passe : après plusieurs essais ratés (IDENTIFY, OPER, SASL), l'adresse IP — et le compte, avec un seuil plus haut — est verrouillée un moment.
  • Ces protections suivent le mode de SecureServ (observation ou blocage).

Commandes SecureServ (opérateurs)

CommandeEffet
/ss STATUSétat, compteurs (vérifiées, listées, bloquées)
/ss CHECK <ip>vérifie une adresse dans les listes noires
/ss MODE observe|enforceobservation ou blocage
/ss WHITELIST ADD|DEL|LIST <ip|cidr>gère la liste blanche

Se connecter avec un client ou un script IRC

Le serveur parle le protocole IRC standard : n'importe quel client (mIRC, HexChat, WeeChat, irssi, Textual…) ou script/bot (scripts mIRC, eggdrop, bots Python ou Node…) peut s'y connecter.

PortUsage
6667, 6690IRC en clair
6697, 6698IRC chiffré (TLS) — recommandé
webclient web et panel via https://irc.example.org
  • mIRC : /server -m irc.example.org +6697 (le certificat est auto-signé : accepte-le). SASL PLAIN pris en charge pour s'identifier dès la connexion.
  • HexChat / WeeChat / irssi : serveur irc.example.org/6697 avec SSL, « accepter les certificats invalides ».
  • eggdrop : set servers {irc.example.org:+6697} (le bot peut être enregistré avec NickServ puis opé par ChanServ).
  • Scripts : un simple socket TCP suffit (NICK, USER, JOIN, PRIVMSG). Les commandes propres au réseau : LANG, TRANSLATE, NICKFX, /ns /cs /bs /hs /fs /os /ss.
  • Les utilisateurs d'IRC, du webchat, de Discord et de Fluxer partagent les mêmes salons.

🔒 Zone administration

Documentation des commandes admin/oper (OperServ, kill, G/K/Z-line, panel…). Protégée par un code PIN (modifiable dans le panel admin).