ircxp — 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.
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éfixe | Mode | Rôle |
|---|---|---|
~ | +q | owner (fondateur) |
& | +a | admin / protect |
@ | +o | opérateur |
% | +h | halfop |
+ | +v | voice |
Modes de salon
+i sur invitation · +m modéré · +n pas d'externe · +Z filtre de mots interdits (liste réglée par l'administrateur) · +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
| Mode | Signification |
|---|---|
+o | opérateur IRC (après /oper) |
+I | invisible — 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](+ lesDE…)/cs INFO #salon,/cs DROP #salon
Dans le webchat : bouton ⚙ salon → « Enregistrer / Désenregistrer ce salon ».
ChanServ — accès et options d'un salon enregistré
Liste d'accès : /cs ACCESS #salon ADD <compte> <rôle>, DEL <compte>, LIST (rôles owner, admin, op, halfop, voice ; raccourcis /cs AOP|SOP|HOP|VOP #salon ADD|DEL|LIST). Les comptes de la liste reçoivent leur statut à chaque arrivée et dès qu'ils s'identifient. Le fondateur et les owner gèrent la liste ; les op voient la liste.
Options (fondateur, owner ou oper) : /cs SET #salon AUTOOP on|off (statut automatique de la liste, activé par défaut) · AUTOVOICE off|ident|on (voix pour personne, pour les comptes identifiés ou pour tout le monde) · KEEPTOPIC on|off (le sujet est conservé et restauré, même après un redémarrage) · MLOCK +nt|off (modes remis à la recréation du salon, lettres i m n p s t Z) · ENTRYMSG <texte>|off (notice envoyée à chaque arrivant). /cs INFO #salon les affiche. Dans le webchat : réglages du salon, bloc « Salon enregistré ».
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 !.
Rangs et XP
Quand l'administrateur l'a activé, chaque message gagne un peu d'XP (avec un délai anti-spam) et ton rang monte avec ton XP. Les montées de rang sont annoncées dans le salon.
!rang ton rang · !rang <pseudo> celui d'un autre · !rang top classement · /rank [pseudo] (en privé) · le rang apparaît aussi dans le /whois. Si tu es identifié (NickServ), l'XP suit ton compte ; sinon elle est attachée à ton pseudo.
Motus — jeu de questions-réponses
Quand l'administrateur l'a activé, tape !motus dans un salon pour lancer une partie : le bot pose des questions, la première bonne réponse gagne les points (plus tu réponds vite, plus tu en gagnes). Des indices apparaissent pendant le temps imparti.
!motus lance · !motus stop arrête (celui qui a lancé, un opérateur du salon ou un oper) · !motus top classement · !motus score [pseudo] statistiques · !motus aide. Les scores sont gardés par pseudo.
Réseau multi-serveurs : HUB et LEAF
Plusieurs serveurs ircxp 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.
- 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"puiscat client.key client.crt > client.pem. - 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). - 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
- 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\. - 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: remplacemonpseudopar 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) etclient.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-Win64a pu être choisi à l'installation).
| Commande | Effet |
|---|---|
/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 LIST | liste 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.
/whoisaffiche 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 paropenssl 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-pseudodans 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),#salonset/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)
| Commande | Effet |
|---|---|
/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|enforce | observation 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.
| Port | Usage |
|---|---|
6667, 6690 | IRC en clair |
6697, 6698 | IRC chiffré (TLS) — recommandé |
| web | client 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/6697avec 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).