> tze _

Terminal de la Zone de l’Éduc…

Capture d'écran AMC

Installer AMC (Auto Multiple Choice) en version web, auto-hébergée sur Debian 12 via Docker et exposée sur le web via YunoHost

Auto Multiple Choice (AMC) est un excellent logiciel libre de création et de correction automatique de QCM en version papier. Son défaut, pour qui veut travailler depuis plusieurs appareils : c’est une application de bureau Linux, qui s’appuie sur LaTeX et ne propose pas d’interface web officielle.

Il existe une interface web communautaire, amc-web-ui, qui enveloppe la ligne de commande d’AMC dans un backend Python/Flask, avec un frontend React et une base MongoDB, le tout conteneurisé avec Docker. Le projet est ancien (2017-2018) et n’est plus maintenu, si bien qu’il ne se construit plus tel quel sur une distribution récente.

Cet article détaille toutes les corrections nécessaires pour le faire fonctionner sur Debian 12, puis pour l’exposer proprement derrière YunoHost. Cette étape est facultative si vous l’utilisez depuis votre lan. L’avantage de YunoHost étant d’apporter une authentification que l’application ne propose pas.

Mon infrastructure personnelle repose sur un serveur Proxmox VE (serveur de virtualisation) et une instance YunoHost (serveur web multi-application spécialisé dans l’auto-hébergement). L’installation décrite ici se fait donc dans une VM (machine virtuelle) Debian 12 sous Proxmox, mais elle est transposable à toute machine Debian 12.

⚠️ Avertissements à lire avant de commencer

  • Aucune authentification. amc-web-ui n’a ni compte, ni mot de passe, et répond avec un en-tête Access-Control-Allow-Origin: *. Quiconque atteint l’URL peut voir et modifier toutes les questions. Il est indispensable de ne jamais exposer le site directement sur Internet, et de placer le service derrière l’authentification de YunoHost (ou un VPN).
  • Données personnelles. Les copies scannées et les noms d’élèves sont des données personnelles. Auto-hébergez-les sur une infrastructure que votre établissement accepte, et vérifiez les règles RGPD avec votre délégué à la protection des données.
  • Logiciels anciens. Ce montage installe une version d’AMC datée (celle des archives Debian Jessie). Voir la conclusion sur ses limites.

Prérequis

  • Une VM – machine virtuelle – (ou machine physique) sous Debian 12 « bookworm ». Comptez au moins 2 Go de RAM, 2 cœurs et 15 à 20 Go de disque : l’installation de LaTeX est volumineuse.
  • Une instance YunoHost opérationnelle avec un nom de domaine, pour le reverse proxy et le HTTPS.
  • Un accès à la console ou en SSH sur la VM.

1. Installer sudo et Docker

Sur une installation Debian minimale, sudo n’est pas présent et votre utilisateur n’a pas les droits d’administration. On passe d’abord en root pour corriger cela.

su -
apt update && apt upgrade -y
apt install -y sudo curl git
usermod -aG sudo VOTRE_UTILISATEUR

On installe Docker via le script officiel (le paquet Debian ne fournit pas toujours le plugin Compose), puis on ajoute l’utilisateur au groupe docker :

curl -fsSL https://get.docker.com | sh
usermod -aG docker VOTRE_UTILISATEUR
exit

Déconnectez-vous puis reconnectez-vous (les changements de groupe ne s’appliquent qu’à une nouvelle session), et vérifiez :

groups
docker run --rm hello-world
docker compose version

Vous devez voir sudo et docker dans vos groupes, et le conteneur de test doit afficher son message de bienvenue.

2. Cloner le dépôt

mkdir -p ~/amc && cd ~/amc
git clone https://github.com/Ameobea/amc-web-ui.git

3. Corriger le Dockerfile

Le Dockerfile part de l’image python:3.5.5-jessie, basée sur Debian 8 (Jessie), qui n’est plus en ligne sur les miroirs standards. Il faut rediriger apt vers archive.debian.org, désactiver la vérification de date de validité, et autoriser les paquets dont la clé GPG a expiré.

nano ~/amc/amc-web-ui/Dockerfile

Remplacez la ligne d’installation des paquets (la première commande RUN apt-get ...) par :

RUN sed -i 's/deb.debian.org/archive.debian.org/g; s/security.debian.org/archive.debian.org/g; /updates/s/^/#/' /etc/apt/sources.list \
    && echo 'Acquire::Check-Valid-Until "false";' > /etc/apt/apt.conf.d/99no-check-valid \
    && apt-get update && apt-get install -y --allow-unauthenticated build-essential libssl-dev auto-multiple-choice texlive-fonts-recommended

Ce que fait cette commande, point par point :

  • bascule les dépôts vers l’archive Debian ;
  • commente les lignes updates, qui n’existent pas dans l’archive ;
  • désactive le contrôle de validité des index (dépôts figés) ;
  • installe les paquets malgré la clé GPG expirée grâce à --allow-unauthenticated.

Les messages GPG error et KEYEXPIRED pendant le build sont normaux. L’option --allow-unauthenticated est acceptable ici car ces archives ne reçoivent plus de mise à jour de sécurité de toute façon ; ne l’utilisez pas dans un contexte de production classique.

4. Corriger requirements.txt

Le fichier de dépendances Python utilise une syntaxe ~> (style Bundler) que pip ne comprend pas. L’équivalent pip est ~=.

sed -i 's/~>/~=/g' ~/amc/amc-web-ui/backend/requirements.txt
cat ~/amc/amc-web-ui/backend/requirements.txt

Le résultat attendu :

flask ~= 0.12.3
flask-cors==3.0.3
pymongo==3.6.1

5. Écrire le fichier docker-compose.yml

On lance deux conteneurs : l’application et MongoDB. Deux détails importants, découverts à l’usage :

  • Version de MongoDB. Le driver embarqué est pymongo 3.6, incompatible avec les MongoDB récents. On fige donc mongo:4.4, la dernière version compatible.
  • Dossier de données. AMC écrit un fichier SQLite de barème dans /app/backend/data, dossier absent de l’image. Sans un volume monté à cet emplacement, la génération échoue avec unable to open database: /app/backend/data/scoring.sqlite. On le monte explicitement.
mkdir -p ~/amc/data
nano ~/amc/docker-compose.yml
services:
  mongo:
    image: mongo:4.4
    restart: unless-stopped
    volumes:
      - mongo-data:/data/db
    networks:
      - amc

  amc:
    build: ./amc-web-ui
    restart: unless-stopped
    ports:
      - "4545:4545"
    environment:
      - MONGO_HOST=mongo
      - MONGO_PORT=27017
    volumes:
      - ./data:/app/backend/data
    depends_on:
      - mongo
    networks:
      - amc

networks:
  amc:

volumes:
  mongo-data:

MongoDB n’est pas publié hors du réseau Docker interne : seul le conteneur amc peut l’atteindre.

6. Construire et lancer

cd ~/amc
docker compose up -d --build

Le premier build est long : il télécharge l’image Python, installe plus d’un gigaoctet de LaTeX et de polices, installe Node 8.5.0 via nvm, puis compile le frontend React. Comptez facilement cinq à dix minutes. Vérifiez ensuite l’état et les logs :

docker compose ps
docker compose logs --tail=50 amc

Vous devez voir les deux conteneurs Up et une ligne Running on http://0.0.0.0:4545/.

7. Tester

Depuis la VM :

curl -I http://localhost:4545/

Une réponse HTTP/1.0 200 OK confirme que l’application répond. On peut aussi vérifier que MongoDB est joignable depuis le conteneur :

docker compose exec amc python -c "from pymongo import MongoClient; print(MongoClient('mongodb://mongo:27017', serverSelectionTimeoutMS=3000).server_info()['version'])"

Repérez l’adresse IP de la VM avec ip -4 a | grep inet, puis ouvrez http://IP_DE_LA_VM:4545/ depuis un autre appareil du réseau local. L’interface « Online Quiz Management with AMC » doit s’afficher.

8. Exposer le service derrière YunoHost

C’est l’étape qui apporte le HTTPS et, surtout, l’authentification qui manque à l’application.

  1. Créez un sous-domaine dédié au service dans YunoHost (Domaines → Ajouter un domaine).
  2. Installez l’application Redirect de YunoHost sur ce sous-domaine, et configurez-la en reverse proxy (type « proxy / rewrite », et non une simple redirection) vers http://IP_DE_LA_VM:4545.
  3. Activez le HTTPS (avec un certificat Let’s Encrypt) pour le sous-domaine.
  4. Restreignez l’accès de l’application aux seuls utilisateurs autorisés, dans les permissions YunoHost.

Dans mon cas, cette configuration via l’application Redirect a fonctionné du premier coup. Le backend (service AMC de la VM) étant en HTTP simple, aucune option de certificat particulière n’est à prévoir côté proxy : YunoHost gère le HTTPS côté public.

Ne laissez jamais le port 4545 ouvert sur votre box/routeur. Tout l’accès extérieur doit passer par le sous-domaine YunoHost.

9. Piège à connaître : type de question

Au premier essai de génération, la création du sujet échoue avec, dans les logs, une avalanche de :

ERR: 2/4 good answers not coherent for a simple question

suivie d’un FileNotFoundError sur DOC-subject.pdf et d’une erreur 500. La cause n’est ni le nom du test ni les accents : AMC distingue les questions à réponse unique (« simple ») des questions à réponses multiples. Si une question comporte plusieurs bonnes réponses, AMC refuse de produire le sujet car cette version web se limite à produire des questionnaires à choix uniques (QCU).

La correction : dans l’éditeur, pour chaque question concernée, ne gardez qu’une seule bonne réponse. Une fois les questions corrigées, la génération des sujets aboutit.

Les copies produites sont en anglais.

10. Sauvegardes

Deux choses à sauvegarder : la base MongoDB (questions et tests) et le dossier ~/amc/data.

cd ~/amc
docker compose exec mongo mongodump --archive=/tmp/amc.archive
docker compose cp mongo:/tmp/amc.archive ~/amc/amc-backup-$(date +%F).archive

Un snapshot Proxmox de la VM protège en plus l’ensemble (code, configuration, données) en une seule opération.

Conclusion : une expérience bien plus limitée qu’AMC natif

Ce montage fonctionne et répond au besoin de départ : accéder à AMC depuis n’importe quel appareil, via un simple navigateur. Mais soyons honnête sur ses limites. L’interface web ne couvre qu’une petite partie des possibilités d’AMC : elle sert à saisir des questions, générer un sujet et corriger, sans la finesse de réglage de l’interface native (barèmes complexes, mise en page, gestion des scans, association des copies, annotation…). De plus, le projet amc-web-ui n’est plus maintenu et s’appuie sur une version ancienne d’AMC, ce qui impose les rustines décrites ici et exclut les améliorations récentes du logiciel.

Autrement dit : pratique pour un usage simple et nomade, mais à réserver à des questionnaires courts. Pour exploiter AMC pleinement, l’application de bureau reste très supérieure.

C’est pourquoi je compte tenter prochainement une autre approche afin de garder cette logique d’itinérance sans devoir installer AMC sur chaque machine que j’utilise : installer la version native et à jour d’AMC sur une VM Debian, et en exposer l’interface graphique dans le navigateur via Apache Guacamole. On garderait alors toute la puissance d’AMC natif, tout en conservant l’accès « web » depuis n’importe quel appareil. Je publierai un retour d’expérience sur ce montage dans un prochain article.