💾 Archived View for lord.re › posts › 229-ergo-serveur-irc-tout-compris › index.gmi captured on 2024-08-18 at 18:37:25. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2024-08-18)
-=-=-=-=-=-=-
-------------------------------------------------
[12/04/2022] - ~9mins - #irc #adminsys
-------------------------------------------------
Allez je vous présente **Ergo** un serveur IRC avec tout ce qu'il faut là où il faut.
Si vous souhaitez avoir votre serveur IRC en 2022 **Ergo** est une alternative très intéressante.
Sa mise en service nécessite peu de connaissances et de ressources et de temps.
Son seul inconvénient est qu'il ne propose pas de mécanisme de haute disponibilité.
IRC n'est toujours pas entièrement mort.
Et logiciellement c'est d'ailleurs loin d'ĂŞtre le cas.
Il y a quelques nouveaux clients IRC (comme Catgirl [1] ou bien Goguma [2]) mais c'est vrai que côté serveurs et services ça bouge assez peu.
Je vais vous présenter un ptit nouveau mais d'abord un peu d'explications !
Si vous n'avez jamais administré de réseau IRC, il y a deux éléments principaux :
- l'**ircd** qui est le serveur IRC à proprement parlé
- les **services** qui sont des bots qui ajoutent des fonctionnalités comme l'authentification, la gestion un peu plus poussée des salons, l'envoi de mémos
Les services sont optionnels mais les réseaux digne de ce nom en utilisent tous.
Sans ça, pas de gestion de l'identité des utilisateurs… c'est un peu le far west.
Pour les serveurs IRC il existe pas mal de concurrence même si on ne va pas se le cacher, le principal est le très fameux **UnrealIRCD**.
Il est vieux comme le monde (bon en fait il y a d'autres serveurs bien plus vieux).
D'ailleurs une ptite parenthèse au passage : IRC est un écosystème à fond dans le logiciel libre.
Il n'y a presque pas de serveur sorti de nulle part (et Ergo n'échappe pas à cette règle).
Et ça se ressent du coup par moment dans leurs configurations ou bien certains abus de langage que l'on utilise lors de l'administration.
Voilà , c'était juste une brève remarque.
Pour les services il y a bien moins d'abondance.
Sur Geeknode, nous avons par contre nos services fait maison : Child [3].
Ils sont tout beau et mine de rien sacrément robustes, merci les devs ;-)
D'un point de vue technique, les services ont un fonctionnement un peu particulier.
IRC est protocole "fédéré" (je met des guillemets parceque c'est de la fédération assez étrange qui prédate un peu ce que l'on a tendance à appeler fédéré désormais. Du coup je n'aborderai ce point que plus tard dans un autre article dédié).
On différencie les types de serveurs par rapport aux connexions qu'ils écoutent :
- **hub** : serveur recevant des connexions d'autres serveurs. Pas de client sur ces nœuds.
- **leaf** : serveur se connectant Ă un hub oĂą les clients se connectent.
- **service** : serveur ne recevant pas de connexion se rattachant Ă un hub mais apportant les fameux services
C'est très généralement de l'IRC classique mais avec des ajouts spécifiques à chaque implémentation.
Toujours est-il que du coup, les services sont en fait un serveur "irc" discutant avec un autre serveur IRC.
C'est au final une architecture assez cool permettant pas mal de folies mais ça veut aussi dire que d'un point de vue mise en place c'est pas spécialement simple.
Surtout lorsqu'on débute et que l'on a pas trop les bases de réseau et d'adminsys.
Il faut mettre en place plusieurs serveurs qui communiquent entre eux, donner des droits, chiffrer, pourquoi pas ajouter quelques mots de passe…
C'est pas spécialement super complexe mais c'est pour un débutant c'est une étape assez laborieuse qui nécessite de comprendre pas mal de points différents.
Surtout que *les docs sur les différents projets sont vraiment pas géniales* (sérieux vous avez vu le site pourri d'Anope [4] ? Un lien sur deux hs, la doc c'est le désert, …).
Bon, IRC est un protocole qui remonte à 1988 mais il n'est pas non plus figé.
Il a connu plusieurs RFC et surtout il y a en ce moment l'initiative IRCv3 [5] qui vise Ă moderniser un peu le protocole.
Mais si l'on y regarde de plus près il y a certaines nouveautés pas mal comme par exemple l'historique d'un salon [6] ou bien les notifs d'écritures [7].
Mais surtout toutes ces modifications sont faites avec *un respect absolu de rétrocompatibilité* : un serveur ou un client IRC qui ne les gèrent pas, ne doit pas être impacté.
Et toutes ces nouveautés n'arrivent que quand le serveur les a implémentés, que les services aussi (enfin celles qui concernent les services) et aussi les clients.
Donc *ça n'arrive que lentement* très lentement.
Mais *c'est un peu plus qu'un serveur puisqu'il intègre également les services*.
Vous n'aurez donc pas besoin de vous faire chier Ă configurer et administrer vos services en plus.
Non, ici c'est un seul logiciel.
C'est beaucoup plus simple du coup et puis ça évolue ensemble : pas d'incompatibilité ou autre.
Mais **Oragono** est mort.
Vous avez vu ce cliffhanger !
Et bien non il n'est pas mort, il a juste changé de nom.
C'est désormais **Ergo** c'est moins marquant mais plus simple.
Parceque ouai c'Ă©tait oragano, oregano, orogano, oragono ?
Personne ne sait…
Bref en changeant de nom ils ont gommé la plus grande difficulté.
Le fait qu'il soit *codé en Go simplifie énormément son installation* (ils fournissent des binaires pour un peu toutes les plateformes).
L'ultime difficulté de mise en place est désormais la partie TLS qui nécessite un outil extérieur pour cela (mais bon ils peuvent pas faire de miracle).
D'un point de vue fonctionnalité, *il gère tout ce que l'on peut attendre d'un serveur IRC moderne et même un peu plus*.
Il intègre les services avec les fonctions usuelles de **nickserv** ainsi que **chanserv** pour la gestion de son identité ou de son salon.
Il sait fournir des cloak (planquer l'adresse ip des utilisateurs) via **hostserv**.
Mais en plus de cela, *il peut Ă©galement assurer la fonction de bouncer IRC*.
En théorie sur IRC, quand vous n'êtes pas connectés… bha vous ne voyez pas les messages.
Quand vous vous reconnectez bha vous ne savez pas ce qui s'est passé lors de votre absence.
Pour pallier ce souci, les utilisateurs utilisent souvent des bouncers qui sont en fait des clients IRC qui servent de proxy.
Ils tournent sur des serveurs 24h/24 et sont donc connectés en permanence.
Lorsqu'un utilisateur se connecte, il le fait non pas au serveur mais à son bouncer qui lui rebalance tous les messages qu'il a ratés.
De ce fait, *l'utilisateur apparait comme toujours connecté pour les autres*.
Et bien Ergo fait ça de lui-même (enfin si vous le configurez pour et si l'utilisateur en fait le choix).
Comme ça vos utilisateurs n'ont plus besoin de le faire de leur côté.
Plus besoin de faire tourner un client 24h/24 sur un coin de serveur pour cela.
C'est un peu plus optimisé et écologique !
Bon par contre, *contrairement à la majorité de ses collègues, Ergo ne sait pas fonctionner de façon fédérée*.
Vous ne pouvez donc pas agréger plusieurs serveurs pour former un réseau.
Ici, vous avez 1 seul ergo.
Vous perdez une machine vous disparaissez.
C'est à mon sens le seul inconvénient de ce logiciel.
On passe un peu Ă la pratique ?
Bon à moins qu'il ne soit packagé pour votre OS (ce dont je doute), il va vous falloir faire un ptit tour sur leur repo git pour y chopper la dernière release [8] en fonction de votre OS.
wget https://github.com/ergochat/ergo/releases/download/v2.9.1/ergo-2.9.1-linux-x86_64.tar.gz (ne copiez/collez cette ligne que si vous ĂŞtes sur un linux avec un processeur classique).
On décompresse le bousin.
tar xvf ergo-2.9.1-linux-x86_64.tar.gz
Et lĂ vous obtenez un dossier avec tout ce qu'il faut.
Je vous conseille d'aller ranger ce dossier dans un endroit à peu près logique (genre /opt)
Dans ce dossier il vous faut créer un fichier de configuration que vous pouvez copier depuis celui fourni.
cp default.yaml ircd.yaml
Ce fichier doit être édité pour y mettre vos préférences.
Il est rempli de commentaires partout détaillant toutes les options.
Donc on l'Ă©dite dans son Ă©diteur de texte favoris.
kak ircd.yml
Donc lĂ -dedans les personnalisations de base Ă faire sont les changements de nom.
Ensuite les chemins pour les fichiers de certificats tls (à laisser par défaut si vous vous contentez de l'auto-signé (je l'aborde plus loin)).
Ensuite, changez absolument le mot de passe dans opers/admin/password.
Pour savoir quoi mettre il faut le générer via ergo lui-même.
Pour cela faites dans un autre terminal un ptit ./ergo genpasswd et il vous sortira une ligne de texte Ă foutre dans le fichier de configuration.
VoilĂ tout pour la configuration.
Si jamais vous avez des modifs à y faire il suffit de trifouiller le fichier de configuration et pour lui faire prendre en compte les modifs, pas besoin de le relancer mais il faut faire ce que l'on nomme communément un **rehash**.
Pour le déclencher il faut envoyer un **SIGHUP** à ergo avec un joli kill -1 $(pgrep ergo).
Un léger encart pour vous dire que je n'aborderai pas cette partie en profondeur.
En gros, deux possibilités :
- vous pouvez utiliser des certificats autosignés (ça fera couiner les clients irc mais c'est pas si grave)
- vous utilisez un certificat signé par une CA (je vous recommande LetsEncrypt avec un client cool comme par exemple **acme.sh** ou n'importe quel autre (**certbot** est le plus connu mais pas le plus simple ni le plus rapide ni le plus fiable ni le plus léger).
Si vous partez pour la première solution un simple ./ergo mkcerts et le tour est joué.
Si vous optez pour l'autre solution, démerdez-vous :-)
Bon bha qu'est-ce qu'on attend ?
./ergo run
Voilà , ça tourne.
Maintenant on s'y connecte avec un client irc.
Pouf ça marche.
VoilĂ .
En l'espace d'une ptite demi-heure on a un serveur irc et ses services pleinement fonctionnels.
Ă€ vous de parvenir Ă le peupler maintenant :-)
Bon, déjà vérifiez que les bots ne sont pas en train de roupiller.
EmbĂŞtez-les avec un ptit /query nickserv help
Bon, je ne vais pas paraphraser plus que cela leur documentation donc je m'arrĂŞte lĂ .
C'était surtout pour *prouver que c'est une alternative très rapide à mettre en place et vraiment simple*.
Pour aller plus loin, je vous conseille d'aller voir cette doc [9] qui est certe en anglais mais reste assez claire Ă mon sens.
VoilĂ , c'est Ă mon sens un excellent choix en 2022 de partir sur ce logiciel plutĂ´t que les grands anciens ircd.
Vous n'aurez pas besoin de vous faire chier avec toutes les notions de \*:line, pas de link, bref c'est pas mal simplifié par rapport aux autres.
[1] Catgirl (https://git.causal.agency/catgirl/about/)
[2] Goguma (https://sr.ht/~emersion/goguma/)
[3] Child (https://github.com/Ethylix/child)
[4] Anope (https://anope.org/)
[5] IRCv3 (https://ircv3.net/)
[6] l'historique d'un salon (https://lord.re/posts/217-irc-backlog-caps/)
[7] notifs d'écritures (https://lord.re/posts/223-notifications-décritures-sur-irc-avec-weechat/)
[8] la dernière release (https://github.com/ergochat/ergo/releases)
[9] cette doc (https://github.com/ergochat/ergo/blob/stable/docs/MANUAL.md)
------------------------------------
------------------------------------
[12/04/2022] - #irc #adminsys
------------------------------------