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 !.
Avatars (client web)
Quand l'administrateur les a activés, le bouton 🖼️ en haut ouvre « Mon avatar » : choisis une image (PNG, JPEG ou GIF, 2 Mo maximum), elle est recadrée au carré et réduite à 128×128. Il faut être identifié (NickServ) ; l'avatar suit ton compte, quel que soit ton pseudo. Selon les réglages, un administrateur le valide avant qu'il soit visible. Sans avatar, une pastille générée (initiale sur fond coloré) est affichée.
Les clients IRC classiques (mIRC…) n'affichent pas d'avatar. Les utilisateurs Discord et Fluxer montrent leur photo. Case « Afficher les avatars » dans la même fenêtre pour les masquer.
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. - Android : télécharger l'application Android (fichier APK ; autorise l'installation depuis ce navigateur). Elle ouvre le client web en plein écran.
- 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).