Asterobot n'a pas besoin d'écran. Il peut tourner sur un serveur loué, un Raspberry Pi rangé dans un placard ou un PC dans une autre maison, pendant que vous utilisez Asteroboard dans votre propre navigateur. Les exemples utilisent Linux, le système habituel des serveurs, et les mêmes principes s'appliquent sous Windows et macOS.
L'installer
Asterobot est publié pour Linux sur deux types de processeur : Asterobot_VERSION_linux_amd64.7z pour Intel et AMD, et Asterobot_VERSION_linux_arm64.7z pour ARM, comme un Raspberry Pi 4 ou 5 ou un serveur ARM. Lancez uname -m sur la machine pour savoir lequel il vous faut : x86_64 correspond à amd64, et aarch64 à arm64.
Sur votre propre ordinateur, téléchargez l'archive depuis https://asterobot.net/files/category/3-asterobot/, puis copiez-la sur la machine, par exemple avec
scp.Sur la machine, décompressez-la et rendez le programme exécutable :
7zz x Asterobot_VERSION_linux_amd64.7z chmod +x asterobot
Télécharger Asterobot explique chaque étape et comment vérifier le téléchargement. Prévoyez de l'espace disque pour les versions de jeu qu'utiliseront vos bots : voir Prérequis.
Le lancer sans bureau
Lancez Asterobot depuis un terminal sur la machine, par exemple dans une session SSH :
./asterobotIl fonctionne comme sur un ordinateur de bureau, à deux différences près.
Il ne peut pas ouvrir de navigateur. Asterobot essaie d'ouvrir Asteroboard au démarrage, et la page de connexion d'asterobot.net quand il a besoin que vous vous connectiez. Sur une machine sans bureau, il affiche à la place Failed to open frontend et Failed to open the web browser, puis continue. Ni l'un ni l'autre n'est un problème. Activez server.skipOpenFrontend si vous préférez ne pas voir le premier.
Vous ne pouvez pas encore l'atteindre. Asterobot écoute sur 127.0.0.1:8080, que seule la machine elle-même peut atteindre. Laissez ce réglage tel quel et utilisez un tunnel SSH.
L'atteindre par un tunnel SSH
Un tunnel SSH amène un port de la machine distante jusqu'à votre propre ordinateur, à l'intérieur de votre connexion SSH. Asterobot continue d'écouter sur 127.0.0.1, rien de nouveau n'est ouvert sur Internet, et votre navigateur parle à 127.0.0.1 sur votre propre ordinateur, qu'Asteroboard a le droit d'atteindre sans HTTPS.
Sur votre propre ordinateur, ouvrez un terminal et lancez cette commande, avec votre nom d'utilisateur et l'adresse de la machine :
ssh -L 8080:127.0.0.1:8080 user@serverN'importe quel client SSH capable de rediriger un port convient aussi.
Laissez cette connexion ouverte. Tant qu'elle l'est, le port 8080 de votre ordinateur mène à Asterobot sur la machine.
Dans votre navigateur, ouvrez
http://127.0.0.1:8080. Asterobot vous renvoie vers Asteroboard, qui enregistre cette adresse comme URL du serveur et affiche Serveur connecté.
Quand la connexion SSH se ferme, Asteroboard affiche Serveur déconnecté. Il continue d'essayer, et se reconnecte tout seul dès que le tunnel est rétabli.
Si Asterobot tourne aussi sur votre propre ordinateur, le port 8080 y est déjà pris. Mettez un autre port du côté gauche du tunnel, et ouvrez celui-là :
ssh -L 9080:127.0.0.1:8080 user@serverOuvrez ensuite http://127.0.0.1:9080. Un navigateur garde une seule URL du serveur à la fois : pour passer de l'un de vos deux Asterobot à l'autre, ouvrez l'adresse de celui que vous voulez.
À travers un tunnel, Asterobot n'a besoin ni de mot de passe ni de HTTPS : SSH chiffre déjà la connexion, et seules les personnes qui peuvent se connecter à la machine passent. Gardez à l'esprit que toute personne ayant un compte sur cette machine peut aussi atteindre 127.0.0.1:8080. Si vous avez tout de même activé server.tls ou server.basicAuth, ouvrez plutôt https://127.0.0.1:8080, et attendez-vous à l'avertissement de certificat et à la demande de mot de passe décrits dans Asteroboard sur un autre appareil. Le mode MITM (« homme du milieu », de l'anglais man-in-the-middle) a besoin que les deux soient désactivés.
Ou ouvrir le port
Asterobot peut aussi écouter sur l'adresse publique de la machine, comme Asteroboard sur un autre appareil le met en place sur un réseau domestique : server.basicAuth avec un mot de passe, server.tls activé, server.listenAddress réglé sur 0.0.0.0:8080, un redémarrage, et le port autorisé dans le pare-feu. Vous ouvrez alors https:// suivi de l'adresse de la machine et de :8080, depuis n'importe quel appareil.
Caution
Un port ouvert sur un serveur est accessible à n'importe qui sur Internet. Sans mot de passe, celui qui le trouve contrôle votre Asterobot, vos bots et vos comptes Ankama. N'ouvrez jamais le port sans server.basicAuth et server.tls à la fois, et limitez-le dans le pare-feu à vos propres adresses si vous le pouvez. Voir Sécurité.
| Tunnel SSH | Port ouvert | |
|---|---|---|
| Ouvert sur Internet | Rien de plus que SSH | Le port 8080 |
| Qui peut entrer | Les personnes qui peuvent se connecter à la machine | Toute personne ayant un mot de passe de server.basicAuth |
| Chiffrement | SSH | server.tls |
| Avertissement de certificat | Aucun | Une fois par navigateur |
| Appareils | Ceux qui ont un client SSH | N'importe quel navigateur |
| Mode MITM | Continue de fonctionner | Cesse de fonctionner |
Se connecter à asterobot.net
À son premier démarrage, Asterobot doit être connecté à asterobot.net. Il affiche le lien dans le terminal, sur la ligne qui suit Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized. Vous pouvez l'ouvrir de l'une de ces façons :
- Copiez le lien depuis votre terminal SSH dans votre navigateur.
- Une fois le tunnel ouvert, cliquez sur le bouton du compte en bas de la barre latérale d'Asteroboard. Il indique Connexion en attente, et ouvre le même lien.
- Activez
website.showQRCodedans Serveur > Config, et scannez le QR code que le terminal affiche avec le code de connexion suivant.
Confirmez sur asterobot.net, et Asterobot reprend tout seul. Se connecter avec asterobot.net explique toute la démarche.
Connecter vos comptes Ankama
Les bots en mode Full socket de la machine se connectent avec les comptes Ankama enregistrés dans cet Asterobot.
- La connexion manuelle fonctionne depuis n'importe quel endroit où vous utilisez Asteroboard. Ouvrir la connexion Ankama ouvre la page d'Ankama dans votre propre navigateur, et vous recollez le lien dans Asteroboard. Rien n'est à installer sur la machine. Voir Connexion manuelle.
- La connexion automatique démarre un navigateur sur la machine elle-même : Chrome, Chromium ou Edge doit donc y être installé. Par défaut, ce navigateur tourne sans fenêtre, ce qui fonctionne sur une machine sans bureau. Quand Ankama demande qu'une personne intervienne, vous ne pouvez pas afficher cette fenêtre sur un serveur : connectez-vous plutôt manuellement. Voir Connexion automatique.
Le mode MITM fonctionne aussi avec un Asterobot distant, mais votre client Dofus tourne sur votre propre ordinateur, où Asterobot ne peut modifier aucun fichier : voir MITM sur plusieurs machines.
Le laisser tourner
Asterobot s'arrête quand son terminal se ferme, et mettre fin à la session SSH depuis laquelle vous l'avez lancé ferme ce terminal. Deux méthodes courantes le gardent en marche :
- Un multiplexeur de terminal, comme
tmuxouscreen. Lancez Asterobot à l'intérieur, détachez-vous, déconnectez-vous, et rattachez-vous plus tard pour lire ce qu'il a affiché. - Un service système, comme une unité systemd sous Linux, pour qu'Asterobot démarre avec la machine. Asterobot n'est pas fourni avec un fichier de service : vous en écrivez un qui lance le programme
Asterobot. Lancez-le avec l'utilisateur sous lequel vous avez configuré Asterobot : Asterobot garde ses réglages et ses données dans des dossiers de l'utilisateur qui le lance (Fichiers et dossiers), et un autre utilisateur démarre sans aucun d'entre eux.
Sans terminal sous les yeux, lisez ce qu'affiche Asterobot dans Serveur > Console, dans Asteroboard. Voir État et console.
Deux autres points comptent sur une machine devant laquelle vous n'êtes pas :
- Éteindre le serveur, dans Asteroboard, arrête Asterobot, et Asteroboard ne peut pas le relancer. Il vous faudra une session SSH, ou un service configuré pour le démarrer.
- Quand Asterobot redémarre, après un redémarrage de la machine par exemple, vos bots reviennent déconnectés, et rien ne se reconnecte ni ne joue tout seul. Remettez-les en ligne depuis Asteroboard. Voir Déconnecter, supprimer et redémarrer.
Pour mettre à jour Asterobot, remplacez le fichier du programme, comme l'explique Mettre à jour Asterobot.