SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Auto-héberger HRConvert2 pour convertir vos fichiers

Installez HRConvert2 sur votre VPS avec Docker ou Apache. Gardez les fichiers chez vous grâce au sandboxing bubblewrap, aux limites d’envoi et au nettoyage.

Pourquoi héberger soi-même un convertisseur de fichiers

Un convertisseur de fichiers auto-hébergé conserve le fichier sur votre propre disque. C’est la seule raison d’en utiliser un. Un site de conversion gratuit reçoit le fichier téléversé, sans vous permettre de savoir ce qu’il en fait ensuite. Lorsque le fichier est un contrat client signé ou un dossier médical numérisé, le simple téléversement constitue déjà l’incident. HRConvert2 est un serveur de conversion de fichiers avec glisser-déposer, écrit en PHP et distribué sous licence GPLv3. Ce guide a été rédigé pour la version 3.7.4, publiée le 18 août 2026. Le projet a évolué rapidement depuis : la version la plus récente au 8 novembre 2026 est la v4.0.0, publiée le 6 novembre 2026, et le projet revendique la prise en charge de plus de 490 formats. Cette version contient des correctifs de sécurité. Examinez-la avant d’exposer une installation plus ancienne.

Il n’utilise ni base de données, ni comptes, ni cookies. Un utilisateur correspond à un répertoire temporaire. Chaque conversion est effectuée localement par un outil en ligne de commande : LibreOffice pour les documents, FFmpeg pour l’audio et la vidéo, ImageMagick pour les images, Tesseract pour la reconnaissance optique de caractères (OCR), ainsi qu’une longue liste d’outils plus spécialisés pour les autres formats. HRConvert2 fournit la page de téléversement, le pipeline et le nettoyage associés.

Il convertit un fichier d’un format vers un autre. Ce n’est pas une suite bureautique dans le navigateur. Si vous souhaitez que des utilisateurs modifient des documents dans un onglet, comparez plutôt OnlyOffice et Collabora auto-hébergés. Ce n’est pas non plus un espace de stockage. Les fichiers convertis sont destinés à être supprimés. Si les fichiers doivent être conservés quelque part, utilisez plutôt un gestionnaire de fichiers auto-hébergé.

Ce qu’il vous faut

Debian ou Ubuntu, Apache 2.4, PHP 8 ou version ultérieure, et bubblewrap. Bubblewrap (bwrap) fournit le sandbox : avec $RequireSandbox = TRUE, l’installation manuelle de la version v3.7.4 refuse les conversions qui nécessitent un sandbox lorsqu’elle ne peut pas en créer un. Les conversions de documents utilisent un listener persistant en dehors de ce sandbox. Le README du projet indique qu’un Raspberry Pi Model B+ suffit, ce qui est vrai pour la partie PHP. Les binaires de conversion déterminent les ressources matérielles réellement nécessaires ; ce point est traité plus loin.

Deux méthodes sont possibles. L’image Docker fonctionne dès ce soir. L’installation d’Apache et de PHP prend une soirée et vous montre exactement ce qui est installé sur la machine.

Exécutez-le ce soir avec Docker

L’image contient tous les binaires de conversion, elle est donc volumineuse : environ 3 GB une fois compressée pour l’image amd64 épinglée. Vérifiez l’espace disque disponible avant de la télécharger.

Les tags sont importants ici. Ce guide épingle v3.7.2. v3.7.4 lui a succédé le 18 August. Au 8 November 2026, la dernière release GitHub est v4.0.0 (6 November 2026), et le tag latest de Docker Hub pointe vers les mêmes images que v4.0.0. Le tag latest peut changer sans préavis. Cette application expose une large surface d’analyse, épinglez donc une version et effectuez les mises à niveau volontairement.

docker pull zelon88/hrconvert2:v3.7.2
docker run -d --name hrconvert2 \
  -p 127.0.0.1:8080:80 \
  --security-opt seccomp=unconfined \
  zelon88/hrconvert2:v3.7.2
docker ps
curl -I http://127.0.0.1:8080/

Un conteneur sain reste dans l’état Up et la commande curl renvoie HTTP/1.1 200 OK. Un conteneur qui redémarre continuellement rencontre un problème au démarrage. Consultez donc docker logs hrconvert2 avant de modifier quoi que ce soit d’autre.

Deux options sont déterminantes. -p 127.0.0.1:8080:80 publie le port sur l’adresse loopback de l’hôte. Le Docker host peut ainsi atteindre directement le convertisseur sans proxy. Les versions de Docker antérieures à 28.0.0 permettent également aux hosts du même segment L2, par exemple sur le même switch réseau, d’atteindre les ports publiés sur localhost. Utilisez Docker 28.0.0 ou une version ultérieure avant de compter sur ce binding pour isoler le service du réseau externe. L’exemple actuel du projet mappe -p 8080:80, qui écoute sur toutes les interfaces, y compris l’interface publique. --security-opt seccomp=unconfined est nécessaire, car bubblewrap construit sa sandbox avec des appels système liés aux user namespaces et aux mounts, que le profil seccomp par défaut de Docker bloque. Les commentaires de config.php indiquent également que certains hosts ont besoin de --security-opt apparmor=unconfined. Sans ces options, le conteneur ne peut pas construire la sandbox. Les conversions concernées échouent ou non selon $RequireSandboxOnDocker.

Cette option implique un compromis réel. Vous assouplissez le filtre d’appels système du conteneur afin que l’application puisse construire une sandbox plus restrictive à l’intérieur de celui-ci. Les deux paramètres qui déterminent ce comportement sont $RequireSandbox et $RequireSandboxOnDocker dans Resources/config.php. La release v3.7.4 les fournit avec les valeurs TRUE et FALSE. Le tag v3.7.2 épinglé ici les fournit tous les deux avec la valeur FALSE, car ses commentaires indiquent qu’un conteneur doit laisser $RequireSandbox désactivé et laisser $RequireSandboxOnDocker décider. Comme l’exigence Docker est désactivée par défaut, un conteneur sans l’option seccomp peut effectuer une conversion sans aucune sandbox. Une fois l’option en place, définissez $RequireSandboxOnDocker = TRUE; pour refuser les conversions qui nécessitent une sandbox indisponible. Cela ne sandboxe pas le listener de documents 3.7.

Les images plus récentes démarrent différemment. Le projet a modifié son processus Docker dans v3.8.0 (25 August 2026). Son README actuel et sa page Docker Hub exécutent le conteneur avec --cap-add SYS_ADMIN au lieu de l’option seccomp et indiquent que les conversions sont refusées sans cette option. Si vous déplacez votre pin vers un tag plus récent, utilisez les options documentées par cette image. Cette capability est large. Conservez donc le binding du port 127.0.0.1.

Si Docker vient d’être installé sur cette machine, configurez d’abord le daemon. Exécuter Docker sur un VPS couvre l’installation, le storage driver et la manière dont Docker écrit ses propres règles de firewall.

Installez-le avec Apache et PHP

Jusqu’à la v3.7.4, le fichier Documentation/INSTALLATION_INSTRUCTIONS.txt du dépôt présentait une installation manuelle en neuf étapes, et cette section suit cette procédure. Depuis la v3.8.0, le même fichier décrit plutôt un script d’installation. Exécutez sudo bash Documentation/Build/hrconvert2-setup.sh depuis le dépôt cloné : il installe les dépendances, écrit les paramètres PHP dans un fichier drop-in au lieu de modifier php.ini, et installe un profil AppArmor propre à l’application pour sa propre copie de bubblewrap. Ensuite, php convertCore.php -v et sudo php convertCore.php --status vérifient le résultat. La procédure manuelle prend plus de temps, mais vous savez exactement ce qu’elle a installé sur la machine. Voici sa structure. Commencez par le serveur web, le langage et la sandbox :

sudo apt update
sudo apt install -y apache2 php libapache2-mod-php php-all-dev php8.3-zip php8.3-gd bubblewrap

Les noms php8.3-* correspondent à Ubuntu 24.04. Exécutez php -v et utilisez le préfixe correspondant à votre version, car ces noms de paquets changent à chaque nouvelle version de PHP et un préfixe incorrect vous donne Unable to locate package.

Passez ensuite aux convertisseurs. Cela couvre les documents, les images, l’audio, la vidéo et l’OCR, c’est-à-dire la plupart des formats que les utilisateurs convertissent réellement :

sudo apt install -y imagemagick ffmpeg libreoffice-common libreoffice-java-common \
  default-jre ghostscript poppler-utils libgxps-utils tesseract-ocr inkscape \
  xvfb clamav curl tar libxcb-cursor0

Les formats d’archives, les modèles 3D, les ebooks et les images ISO amorçables nécessitent davantage de paquets, et certains se trouvent dans le composant multiverse d’Ubuntu. Dans la v3.7.4, l’étape 3 des instructions officielles fournissait la liste complète des paquets apt et l’étape 5 les compilations depuis les sources. Le guide actuel ne contient aucune liste de paquets. L’installateur lit le manifeste Resources/Contract/depends.php, et php convertCore.php --setup --check-depends affiche la liste actuelle ainsi que son état. Deux dépendances peuvent également être compilées depuis les sources. Le dépôt fournit Documentation/Build/ffmpeg-build.sh pour les encodeurs absents du FFmpeg fourni sous forme de paquet, et Documentation/Build/build-imagemagick-v7.sh pour ImageMagick 7 sur Ubuntu 22.04 ou 24.04, qui fournissent encore la branche 6.9 sous forme de paquet. Ubuntu 25.10 et 26.04 LTS fournissent ImageMagick 7.1 sous forme de paquet. La prise en charge des ebooks vient de l’installateur propre à calibre, que les instructions de la 3.7 donnaient sur une seule ligne :

sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

Il s’agit d’un script fourni par l’éditeur, envoyé dans un shell en tant que root. C’est la méthode amont, et elle est facultative : si vous l’ignorez, seule la conversion des ebooks sera indisponible.

Passons ensuite aux limites de PHP. Les conversions sont lentes et les fichiers volumineux, donc les valeurs par défaut sont trop faibles. Les instructions de la 3.7 définissaient ces valeurs dans php.ini :

max_execution_time = 1200
max_input_time = 90
memory_limit = 512M
post_max_size = 5000M
upload_max_filesize = 5000M
max_file_uploads = 100
display_errors = Off
zlib.output_compression = On

Ces valeurs supposent une machine disposant de suffisamment de ressources. Réduisez-les avant de les utiliser sur un petit VPS. post_max_size = 5000M limite l’ensemble du corps POST à environ 4.88 GiB, fichiers téléversés et surcharge des formulaires compris ; max_file_uploads = 100 ne multiplie pas cette limite. Les requêtes simultanées, les fichiers temporaires et la sortie des conversions nécessitent toujours un espace disque supplémentaire. Redémarrez Apache et vérifiez les paramètres PHP de la ligne de commande ; Apache peut charger une configuration différente :

sudo service apache2 restart
php -i | grep -E "upload_max_filesize|post_max_size|memory_limit"

Passons maintenant au répertoire de travail. $ConvertLoc dans Resources/config.php le définit, et la valeur par défaut est /DATA/HRConvert2. L’utilisateur du serveur web doit en être propriétaire :

sudo mkdir -p /DATA/HRConvert2
sudo chmod -R 0755 /DATA/HRConvert2
sudo chown -R www-data:www-data /DATA/HRConvert2

Décompressez la release sous la racine documentaire d’Apache. La disposition par défaut la place dans un dossier HRProprietary/HRConvert2, et $InstLoc dans Resources/config.php doit indiquer l’emplacement où vous l’avez réellement installée. Exécutez ensuite le diagnostic intégré. C’est le moyen le plus rapide de détecter une dépendance manquante avant qu’un utilisateur ne la rencontre :

sudo php /path/to/HRConvert2/convertCore.php -v

-v parcourt toute l’installation : versions du cœur, vérification des dépendances, état de la sandbox et packs de langue. Les conversions de fichiers ne sont pas prises en charge depuis la ligne de commande ; cet ensemble d’arguments est donc réservé à l’administration.

Pourquoi chaque conversion échoue-t-elle sur une nouvelle installation d’Ubuntu 24.04 ?

Ubuntu 24.04 restreint par défaut les user namespaces des utilisateurs non privilégiés via AppArmor. Bubblewrap a besoin d’un user namespace pour créer son sandbox. Si un bwrap est bloqué, les conversions qui en ont besoin échouent. Dans la version v3.7.4, les conversions de documents utilisent un listener persistant en dehors de ce sandbox et ne sont pas soumises à cette exigence.

Vérifiez-le directement :

bwrap --ro-bind / / --dev /dev /bin/true && echo sandbox ok

Une erreur « permission denied » signifie que le namespace a été bloqué. La correction consiste à créer un profil AppArmor pour le binaire bwrap. Commencez par lister les fichiers ABI et relevez le numéro le plus élevé présent :

ls /etc/apparmor.d/abi/

Écrivez ensuite /etc/apparmor.d/bwrap en remplaçant 4.0 par ce numéro :

abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}

Chargez-le :

sudo apparmor_parser -r /etc/apparmor.d/bwrap

L’absence de sortie signifie que le profil a été chargé. Relancez le contrôle bwrap. Il doit afficher sandbox ok. Les conversions fonctionnent alors.

Debian 12 ne présente pas ce problème. Son noyau autorise les user namespaces des utilisateurs non privilégiés, et le paquet bubblewrap définit kernel.unprivileged_userns_clone sur 1 au démarrage. Le contrôle ci-dessus réussit donc sans profil. Le script d’installation actuel installe un profil AppArmor spécifique à l’application pour sa propre copie de bubblewrap.

Un convertisseur public est un parseur exposé à des inconnus

C’est la raison d’être du reste de cet article. Un convertisseur de fichiers accessible depuis Internet accepte un fichier arbitraire envoyé par une personne anonyme, puis le transmet à LibreOffice, ImageMagick, FFmpeg ou Ghostscript. Ces logiciels reposent sur de grandes bases de code en C et C++, qui présentent depuis longtemps des failles dans les parseurs. L’expéditeur choisit le format. Il choisit donc aussi le parseur exécuté et le chemin de code utilisé.

HRConvert2 v3.7.4 isole Tesseract, pdftotext, ImageMagick et d’autres outils de conversion dans un sandbox. En revanche, son moteur de conversion de documents utilise un listener LibreOffice persistant situé en dehors de ce sandbox. Les commandes exécutées dans le sandbox reçoivent un répertoire d’entrée en lecture seule et un répertoire de sortie accessible en écriture. Lorsque les deux fichiers partagent un répertoire, ce répertoire est monté avec des droits d’écriture. L’accès au réseau est isolé, sauf si l’appelant l’active explicitement. C’est plus important qu’il n’y paraît. ImageMagick et Ghostscript acceptent tous deux des références qui récupèrent une URL. Un convertisseur peut ainsi devenir un outil de server-side request forgery (SSRF) permettant d’atteindre un endpoint de métadonnées cloud depuis votre réseau. Sans réseau dans le namespace, la récupération ne peut pas avoir lieu.

Le refus constitue l’autre aspect du mécanisme : lorsque le sandboxing est obligatoire, un serveur qui ne peut pas créer de sandbox refuse les conversions qui en dépendent. Dans les versions spécifiées ici, les conversions de documents font exception. C’est également pourquoi l’étape AppArmor précédente n’est pas facultative et pourquoi $RequireSandboxOnDocker mérite d’être examiné avant d’exposer le conteneur.

Renforcer la sécurité d’ImageMagick avec policy.xml

Le fichier de policy d’ImageMagick constitue une seconde couche de protection sous le sandbox. Il est utile de le configurer. Sur Ubuntu 24.04 avec ImageMagick 6, le fichier se trouve à /etc/ImageMagick-6/policy.xml. Affichez la configuration actuellement active :

identify -list policy

Le projet fournit une policy à l’emplacement Documentation/Build/policy.xml. Elle constitue un bon modèle. Elle bloque les coders PS, PS2, PS3, EPS, XPS et MVG, ainsi que les delegates URL, HTTPS, HTTP et gs, tout en autorisant PDF :

<policy domain="coder" rights="none" pattern="PS" />
<policy domain="coder" rights="none" pattern="MVG" />
<policy domain="delegate" rights="none" pattern="URL" />
<policy domain="delegate" rights="none" pattern="gs" />
<policy domain="coder" rights="read|write" pattern="PDF" />

La ligne gs est importante. ImageMagick n’interprète pas directement le PostScript. Il appelle Ghostscript. Bloquer ce delegate empêche également les conversions standard de PDF en image qui nécessitent Ghostscript, même lorsque le coder PDF est autorisé.

Cette policy définit aussi des limites de ressources. C’est ainsi qu’une image spécialement conçue ne peut pas saturer la machine :

<policy domain="resource" name="memory" value="256MiB"/>
<policy domain="resource" name="map" value="512MiB"/>
<policy domain="resource" name="disk" value="1GiB"/>
<policy domain="resource" name="width" value="16KP"/>
<policy domain="resource" name="height" value="16KP"/>
<policy domain="resource" name="area" value="128MP"/>

Une bombe de décompression est un fichier minuscule qui déclare des dimensions gigantesques. Les limites width et height rejettent les images qui dépassent ces dimensions. La limite area contrôle la quantité de surface d’image conservée en mémoire ; les images plus grandes utilisent le cache sur disque au lieu d’être rejetées uniquement parce qu’elles dépassent cette limite.

Il existe également un piège dans l’autre sens. Si la policy active bloque complètement le coder PDF, le traitement des PDF échoue avec attempt to perform an operation not allowed by the security policy 'PDF'. Ce message indique que la policy fonctionne. Réautoriser ce coder est une décision à prendre délibérément. Lorsque vous le faites, laissez le delegate gs bloqué.

Ce que coûte la chaîne de dépendances sur un petit VPS

Au repos, rien de tout cela n’est coûteux. Le listener de documents peut rester actif entre les conversions. Les binaires de conversion ne sont donc pas tous absents au repos. Le coût principal apparaît lorsqu’un fichier arrive.

La conversion d’un document utilise LibreOffice via le listener persistant. Une conversion d’image applique, avec la policy ci-dessus, une limite de cache de pixels de 256 MiB de mémoire et une memory map de 512 MiB. Il s’agit de plafonds, pas d’allocations fixes. Le nombre de threads vidéo de FFmpeg dépend du codec et de sa prise en charge du multithreading. Le memory_limit de PHP est défini à 512M dans la configuration du projet. Ces valeurs se cumulent pendant un même job, en plus des besoins du système d’exploitation et du serveur web.

Évitez un VPS de 1 GB pour les conversions de documents. Vérifiez après coup qu’un processus n’a pas été tué par manque de mémoire avec dmesg -T | grep -i "killed process".

Il s’agit de recommandations de dimensionnement, pas d’un benchmark : 4 GB de RAM et deux cœurs offrent un fonctionnement confortable pour une petite équipe. 2 GB avec un fichier d’échange peuvent suffire si la charge porte sur des documents et des images et si vous acceptez l’attente. Un fichier d’échange n’accélère pas une conversion. Il transforme un pic de charge lent en problème non fatal. C’est la différence entre une page bloquée et une panne. Prévoyez plus d’espace disque que nécessaire en apparence. L’image de 3 GB, une limite d’upload élevée et le fichier converti remplissent ensemble le disque bien avant les autres ressources.

Les conversions produisent naturellement des pics de charge. Deux personnes qui envoient une vidéo au même moment se partagent le CPU, entre elles et avec les autres requêtes. Dans v3.7.4, aucune job queue ne se trouve devant ce traitement. Les limites sont donc votre seul moyen de contrôle.

Définir les limites qui empêchent un seul upload de remplir le disque

Commencez par réduire les valeurs PHP. Des valeurs comme upload_max_filesize = 512M, post_max_size = 512M et max_file_uploads = 20 constituent un point de départ raisonnable pour un serveur partagé avec 4 GB. La limite POST inclut tous les fichiers et la surcharge multipart ; chaque fichier doit donc rester en dessous de cette limite. max_execution_time = 1200 définit une limite d’exécution des scripts de vingt minutes, et non un délai d’attente pour l’upload. Dans un build PHP standard non ZTS sous Linux, le temps passé dans les commandes de conversion externes est également exclu. Le core v3.7.4 appelle aussi set_time_limit(0), ce qui supprime cette limite d’exécution. Le traitement des entrées et les timeouts du serveur web sont des contrôles distincts.

Appliquez ensuite la taille et le débit au niveau du proxy, avant que la requête n’atteigne PHP :

limit_req_zone $binary_remote_addr zone=convert:10m rate=6r/m;

server {
    listen 443 ssl;
    server_name convert.example.com;

    client_max_body_size 512M;
    client_body_timeout 300s;

    location / {
        limit_req zone=convert burst=4 nodelay;
        proxy_pass http://127.0.0.1:8080;
        proxy_read_timeout 1200s;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

client_max_body_size limite l’ensemble du corps de la requête, surcharge multipart comprise. Laissez donc une marge au-dessus de la taille du plus gros fichier que vous souhaitez convertir ; sinon nginx renvoie 413 Request Entity Too Large et PHP ne reçoit jamais l’upload. proxy_read_timeout doit couvrir le plus long intervalle sans données de réponse de l’upstream. Une conversion qui envoie régulièrement des données peut donc durer plus longtemps que ce timeout au total ; un upstream silencieux qui le dépasse perd la connexion. client_body_timeout mesure de la même manière l’intervalle entre les lectures du corps de la requête, et non la durée totale de l’upload. Le reste de ce server block, notamment la terminaison TLS (transport layer security), est présenté dans une configuration de reverse proxy nginx expliquée ligne par ligne.

Supprimer les fichiers convertis

Chaque conversion laisse une copie d’un fichier sensible dans un répertoire lisible par le serveur web. Le nettoyage distingue un convertisseur d’une archive contenant tout ce que n’importe qui y a déjà converti.

$DeleteThreshold dans Resources/config.php correspond à l’âge, en minutes, auquel une session expire. La valeur par défaut est 60. Réduisez-la à 15 lorsque le contenu est sensible. Le nettoyage lui-même est un argument de ligne de commande du composant principal, et l’implémentation de la version v3.7.4 nécessite root :

sudo php /path/to/HRConvert2/convertCore.php -c
sudo php /path/to/HRConvert2/convertCore.php -c=15

-c supprime les sessions expirées dans les deux emplacements de données en utilisant le seuil configuré. -c=15 utilise quinze minutes pour cette exécution uniquement. -c=now supprime toutes les sessions, quel que soit leur âge, y compris celle qu’un utilisateur est en train de convertir. Réservez donc cette commande à la maintenance. Les mêmes arguments fonctionnent dans le conteneur via docker exec.

Planifiez le nettoyage avec un timer afin qu’il ne dépende jamais du chargement d’une page par quelqu’un. Une ligne dans /etc/cron.d/hrconvert2 suffit :

*/10 * * * * root php /path/to/HRConvert2/convertCore.php -c

Vérifiez le résultat quelques minutes plus tard avec ls /DATA/HRConvert2 et observez la disparition des anciens répertoires de session. Comme le serveur web possède ce répertoire, c’est exactement ce compte qu’obtiendrait un attaquant exploitant le parseur. Ce compte ne doit donc posséder aucun autre élément intéressant. Comptes utilisateur avec le principe du moindre privilège sur un VPS présente le principe général. Il s’applique ici plus que d’habitude.

Placez-le derrière une authentification, sauf si l’objectif est de le rendre public

L’installation par défaut ne crée aucun compte, volontairement. Toute personne qui peut accéder à la page peut envoyer un fichier et exécuter vos binaires de conversion. Les limites de débit ne font que ralentir ces actions. Déterminez donc dans quelle situation vous vous trouvez.

Si le service est destiné à vous-même et à quelques collègues, ne l’exposez pas du tout. Liez le conteneur à l’interface loopback comme indiqué plus haut, puis accédez-y via un réseau privé ou un tunnel SSH. Avec Docker 28.0.0 ou une version ultérieure et sans proxy public, cette publication sur loopback empêche les hôtes distants d’atteindre directement le convertisseur. Si ces collègues doivent pouvoir l’ouvrir dans un navigateur sans que vous publiiez un nom d’hôte ni ouvriez un port, héberger le service comme onion service v3 conserve le convertisseur lié à loopback tout en leur fournissant une adresse à visiter.

S’il doit être accessible depuis un navigateur, placez une authentification devant le proxy. L’authentification Basic se configure avec deux commandes et empêche les personnes inconnues d’accéder au formulaire d’envoi :

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/.htpasswd alice
location / {
    auth_basic "Converter";
    auth_basic_user_file /etc/nginx/.htpasswd;
    proxy_pass http://127.0.0.1:8080;
}

Rechargez nginx et chargez la page. L’affichage d’une invite indique que cela fonctionne. L’absence d’invite signifie que le bloc location que vous avez modifié ne traite pas la requête. Pour utiliser de vrais comptes plutôt qu’un mot de passe partagé, terminez l’authentification auprès d’un fournisseur single sign-on : un serveur Authentik SSO auto-hébergé fournit une authentification forward devant une application qui ne possède pas son propre mécanisme de connexion.

Si l’objectif est de rendre le convertisseur réellement public, acceptez les conséquences et prévoyez les mesures nécessaires. Partez du principe que le sandbox sera sondé. Épinglez le tag de l’image, maintenez une policy ImageMagick stricte, limitez la taille des envois et exécutez le service sur un VPS qui n’héberge rien d’autre d’important pour vous.

Modes de défaillance et messages affichés

Les conversions qui nécessitent une sandbox échouent immédiatement. La sandbox ne peut pas être créée. Sur Ubuntu 24.04, vérifiez le profil AppArmor. Dans l’image Docker 3.7 épinglée, vérifiez --security-opt seccomp=unconfined et, si nécessaire, --security-opt apparmor=unconfined. Le refus dépend de $RequireSandbox ou de $RequireSandboxOnDocker ; par défaut, le conteneur épinglé autorise les conversions sans sandbox. Dans ces versions, les conversions de documents ne nécessitent pas de sandbox.

Seules les conversions d’images échouent. Bubblewrap is missing or non functional, so this image conversion cannot be isolated! signifie que bwrap est absent ou inaccessible via le PATH dont dispose l’utilisateur du serveur web.

Un format échoue et les autres fonctionnent. Il s’agit d’un binaire manquant, signalé clairement par : ImageMagick may not be installed, or may not be reachable on the system path used by the web server user. Le même message existe pour FFmpeg et LibreOffice. Exécutez convertCore.php -v pour voir ce que l’installation peut trouver. N’oubliez pas que le PATH du worker Apache n’est pas celui de votre shell de connexion.

Le traitement des PDF échoue avec une erreur de policy. attempt to perform an operation not allowed by the security policy 'PDF' provient de policy.xml d’ImageMagick, et non de HRConvert2.

Les chargements volumineux renvoient une erreur 413. La directive nginx client_max_body_size est inférieure à la taille du corps de la requête. La chaîne comporte trois limites : une dans nginx et deux dans PHP. La plus petite s’applique.

Les conversions s’arrêtent sans modification évidente. The device where data is stored has an insufficient amount of storage space available. Vérifiez l’espace libre et assurez-vous que le nettoyage est bien exécuté.

Le nettoyage génère des erreurs dans le journal. Could not clean the temporary location! et Could not clean the convert location! indiquent un problème de chemin ou de permissions. Vérifiez l’emplacement temporaire ainsi que $ConvertLoc ; l’utilisateur du serveur web doit disposer des droits de lecture et d’écriture sur ces emplacements.

FAQ

Est-il sûr d’exposer un convertisseur de fichiers auto-hébergé sur Internet ?

C’est suffisamment sûr uniquement si vous le traitez comme un parseur exposé à des inconnus. Chaque fichier envoyé est transmis à LibreOffice, ImageMagick, FFmpeg ou Ghostscript, et l’utilisateur choisit lequel sera utilisé. Dans v3.7.4, bubblewrap isole de nombreux outils de conversion, mais le document listener persistant s’exécute en dehors de ce sandbox. Exiger le sandboxing refuse les conversions concernées lorsque l’isolation est indisponible ; cela ne couvre pas le document listener. Il reste préférable d’exiger une authentification, de limiter la taille des envois et d’exécuter le service sur un VPS qui ne contient aucune autre donnée importante.

Pourquoi chaque conversion échoue-t-elle sur une nouvelle installation d’Ubuntu 24.04 ?

Ubuntu 24.04 restreint les user namespaces non privilégiés via AppArmor, et bubblewrap en a besoin pour créer son sandbox. Les conversions qui l’utilisent échouent lorsqu’il ne peut pas démarrer ; les conversions de documents de v3.7.4 font exception. Écrivez un profil AppArmor pour /usr/bin/bwrap avec flags=(unconfined), chargez-le avec sudo apparmor_parser -r /etc/apparmor.d/bwrap, puis vérifiez-le avec bwrap --ro-bind / / --dev /dev /bin/true. Debian 12 autorise par défaut les user namespaces non privilégiés et ne nécessite pas cette étape.

Pourquoi les conversions échouent-elles dans Docker alors qu’elles fonctionnent sur une installation normale ?

Le profil seccomp par défaut de Docker bloque les appels système utilisés par bubblewrap. Le sandbox ne peut donc pas être créé dans le conteneur. Pour l’image 3.7 figée ici, démarrez-la avec --security-opt seccomp=unconfined, comme le recommandent les commentaires de config.php pour cette version. À partir de v3.8.0, le projet documente plutôt --cap-add SYS_ADMIN. Notez que $RequireSandboxOnDocker vaut FALSE par défaut dans l’image 3.7 figée. Un conteneur lancé sans ce flag peut donc effectuer des conversions sans sandbox. Définissez-le sur TRUE une fois le flag seccomp en place.

De quelle quantité de RAM un serveur de conversion de fichiers a-t-il besoin ?

La consommation est faible au repos, mais une conversion en cours utilise davantage de ressources. LibreOffice utilise un listener persistant. Le pixel cache d’ImageMagick est limité à 256 MiB de mémoire et à une map de 512 MiB par la policy fournie. La limite propre à PHP est de 512M. Ces limites ne correspondent pas à des allocations fixes et ne constituent pas une mesure de la consommation totale. Prévoyez 4 GB et deux cores pour une petite équipe. Consultez dmesg -T | grep -i "killed process" lorsqu’une conversion s’arrête sans afficher de message.

Où vont les fichiers convertis et quand sont-ils supprimés ?

Ils sont placés dans le répertoire de travail indiqué par $ConvertLoc dans Resources/config.php, dont la valeur par défaut est /DATA/HRConvert2. $DeleteThreshold définit l’âge, en minutes, auquel une session expire. Sa valeur par défaut est 60. Le nettoyage s’exécute en ligne de commande avec root : sudo php convertCore.php -c supprime les sessions expirées, tandis que -c=now supprime immédiatement toutes les sessions, y compris les sessions actives. Ajoutez -c à une entrée cron de root ou à un timer systemd afin que la suppression ne dépende pas de la visite d’un utilisateur sur le site.

Cet article vous a-t-il été utile ?