Glossaire¶

Les termes que la documentation emploie sans les réexpliquer à chaque fois.

Jargon eMule et conteneur¶

Ceux-là sont opaques la première fois qu'on les croise. Inutile de revenir ici : partout ailleurs sur le site, ils sont soulignés en pointillés et affichent leur définition.

eD2k: eDonkey2000, le plus ancien des deux réseaux eMule surveillés. Il passe par des serveurs centraux, auxquels le nœud se connecte.
Kad: Kademlia, le second réseau surveillé. Décentralisé : aucun serveur, les clients se trouvent entre eux. Le nœud cherche sur les deux en parallèle.
High-ID: Votre nœud est joignable depuis l'extérieur, donc les autres clients peuvent l'appeler directement. C'est le bon cas : plus de sources, des téléchargements plus rapides.
Low-ID: Votre nœud n'est pas joignable de l'extérieur : pare-feu, box, ou VPN sans port ouvert. Tout fonctionne quand même, simplement avec moins de sources. C'est l'état par défaut, et il convient parfaitement pour cataloguer.
user hash: L'identifiant qu'un client eD2k annonce aux autres : un pseudonyme, stable tant que la même installation tourne, jamais une adresse. C'est sous lui que l'historique des sources range une source.
IncomingDir: Le dossier où le client eMule dépose un fichier une fois terminé. Ici, il correspond à ed2k/downloads/incoming dans votre dossier de travail.
s6: Le petit superviseur qui, dans le conteneur ed2k, fait tourner deux programmes (amuled et le port-sync) et en relance un s'il meurt. Vous le croisez surtout dans les journaux.
amuleapi: L'interface web et REST livrée avec aMule, qu'amuled démarre et arrête avec lui. C'est elle que vous ouvrez sur le port 4711, et c'est par elle que p2pwatch pilote le client eMule : lancer une recherche, mettre un fichier en file, lire l'état. Une erreur d'authentification signifie presque toujours un AMULE_API_PASSWORD qui ne correspond pas.
EC: External Connection, le canal interne par lequel amuleapi parle à amuled. Les deux sont dans le conteneur ed2k ; AMULE_EC_PASSWORD est ce qui les relie.
port-sync: Le service qui, dans le conteneur ed2k, aligne le port d'aMule sur celui que le VPN lui forwarde. Il ne tourne que sous la variante VPN, avec VPN_PORT_FORWARDING=on.

Vocabulaire du projet¶

Des mots courants employés dans un sens précis. Le contexte suffit en général.

pile: Les conteneurs que docker compose démarre ensemble, décrits par les fichiers compose. La variante directe en a deux, p2pwatch et ed2k ; la variante VPN ajoute ed2k-gluetun.
variante: La façon dont aMule rejoint son réseau : direct, ou vpn derrière gluetun. La ligne include: de compose.yml la choisit.
service: Une brique de la pile : un conteneur géré par docker compose. Un nœud a deux services, p2pwatch et ed2k, trois avec le VPN.
dossier de travail: Le dossier qui contient votre compose.yml, votre .env et vos données (data/, et ed2k/ pour aMule). Toutes les commandes de la documentation se lancent depuis là.