Guide des ShareX Custom Uploader : Self-Hosted Screenshot Links

L'une des raisons pour lesquelles les utilisateurs avancés aiment ShareX est qu'il ne verrouille pas vos captures d'écran dans le nuage de quelqu'un d'autre. Avec un uploader personnalisé, ShareX peut envoyer chaque capture à une destination vous contrôlez — votre propre serveur, un seau de stockage d'objets ou un point de terminaison de raccourcissement de lien — et vous remettre une URL partageable automatiquement. Ce guide explique comment fonctionne le système d'uploader personnalisé, comment en configurer un correctement, et comment garder vos identifiants de connexion sûrs pendant que vous le faites.

Qu'est-ce qu'un uploader personnalisé réellement

Comme la documentation de ShareX elle-même le dit, la fonctionnalité d'uploader personnalisé est principalement utilisée par les personnes qui hébergent leurs propres services. En pratique, c'est une petite définition qui dit à ShareX : quand j'attrape quelque chose, envoie-le à cette URL, utilisant cette demande, et trouvez le lien résultant en cette partie de la réponse. Obtenez ces trois choses correctes et ShareX télécharge tranquillement et copie une URL de travail chaque fois que vous vous faites couper.

La demande : méthodes et types de corps

ShareX's custom uploader prend en charge les méthodes HTTP standard — GET, POST, PUT, PATCH et DELETE. En règle générale de la documentation : si la demande ne porte que des paramètres et aucun corps, GET est préféré ; s'il envoie un fichier comme multipart/form-data, POST est le choix habituel.

Pour le corps de la demande, ShareX offre plusieurs types afin qu'il puisse correspondre à ce que votre endpoint attend :

• Pas de corps — paramètres uniquement.
• Données de formulaire (multipart/form-data) — le choix typique pour télécharger un fichier.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binaire — le fichier brut en tant que corps.

La documentation API de votre serveur vous indique quelle méthode et quel type de corps elle attend ; vous refléter simplement cela dans la définition ShareX.

Analyse de la réponse : où est le lien ?

Après le téléchargement, votre point de terminaison répond — généralement avec JSON, XML ou texte brut — et vous devez dire à ShareX quel champ contient l'URL finale. ShareX vous donne quatre façons de l'extraire :

• JSON utilisant la syntaxe JsonPath, par exemple {json:data.link} à lire data.link à partir d'une réponse JSON.
• XML utilisant XPath, par exemple {xml:/files/file[1]/url}.
• Regex pour la correspondance de modèles d'une réponse en texte brut.
• En-têtes de lire une URL renvoyée dans un en-tête de réponse.

C'est l'étape que les gens font le plus souvent mal : le téléchargement réussit, mais l'« URL » que ShareX copie est vide ou mal formée parce que l'analyseur pointe sur le mauvais champ. Quand cela se produit, regardez la réponse brute que votre serveur renvoie et suivez le chemin exact vers la chaîne URL.

Étape par étape : une configuration propre

1. Lisez la documentation API de votre endpoint et noter la méthode, le type de corps, le nom du champ pour le fichier, tout en-tête d'authentification et l'emplacement exact de l'URL dans la réponse.
2. Sauvegardez d'abord vos paramètres ShareX actuels. Exportez votre configuration de destination existante afin que vous puissiez revenir en arrière si une modification se comporte mal.
3. Créez l'uploader personnalisé dans ShareX (Destinations → Paramètres d'uploader personnalisé). Définissez la méthode de demande, l'URL de destination, les en-têtes et le type de corps pour correspondre à votre point de terminaison.
4. Configurez l'analyseur de réponse en utilisant la bonne règle JsonPath, XPath, regex ou d'en-tête pour que ShareX renvoie l'URL correcte.
5. Testez avec une capture inoffensive — une image jetable — et confirmez que le lien renvoyé ouvre réellement le fichier.
6. Vérifiez le comportement de suppression/rétention si votre endpoint supporte la suppression, vous savez comment supprimer un téléchargement plus tard.
7. Définissez-le comme votre destination active seulement une fois qu'un lien de test réel fonctionne d'un bout à l'autre.

Partage et réutilisation des configs : fichiers .sxcu

Un uploader personnalisé fini peut être exporté en tant que .sxcu fichier. Un autre utilisateur peut l'importer en double-cliquant sur le fichier, et ShareX applique la configuration de destination automatiquement. Cela le rend facile de partager une configuration qui fonctionne sur vos propres machines ou avec une équipe — mais c'est aussi exactement où les secrets fuient, alors lisez la section suivante avant d'en envoyer un à quelqu'un.

Protégez vos secrets

Un uploader personnalisé contient souvent des clés API, des jetons ou des identifiants signés. Traitez un .sxcu fichier comme un mot de passe :

• Avant de partager une configuration, supprimez ou remplacez les véritables identifiants de connexion avec des espaces réservés. Un .sxcu vous publiez publiquement peut exposer une clé en direct.
• Préférez les jetons limités et révocables plutôt que les clés maîtres de longue durée, donc une fuite est contenue et facile à pivoter.
• Toujours télécharger sur HTTPS les identifiants de connexion et les fichiers ne sont pas envoyés en clair.
• Faites pivoter tout ce qui peut avoir été exposé — les captures d'écran et leurs configs se déplacent plus loin que vous ne l'attendiez.

Préférez une destination intégrée quand il en existe une

Si votre stockage est Amazon S3, Google Cloud Storage ou Cloudflare R2, utilisez le guide intégré dédié de ShareX pour ce fournisseur plutôt que de construire une demande HTTP générique à la main. Les destinations intégrées gèrent la signature spécifique au fournisseur et la configuration de domaine personnalisé pour vous, ce qui est moins de pièces mobiles et moins d'endroits où faire une erreur. Réservez l'uploader HTTP personnalisé générique pour les points de terminaison qui n'ont pas d'option intégrée.

Si vous préférez ne pas configurer manuellement les demandes

L'uploader personnalisé est puissant précisément parce qu'il est entièrement configurable — cette flexibilité est le point, et pour les auto-hébergeurs c'est idéal. Si vous aimez posséder votre stockage mais préfériez pointer-et-cliquer sur un backend plutôt que d'écrire des requêtes HTTP et des analyseurs de réponses, une configuration plus guidée peut gagner du temps. Maxisnap Studio, une mise à niveau unique, ajoute des backends de téléchargement personnalisé — SFTP, FTP, S3-compatible et HTTP — donc vos captures Windows téléchargent sur le stockage que vous contrôlez avec un flux de configuration plus simple. C'est un compromis différent du constructeur de requêtes entièrement ouvert de ShareX, destiné aux personnes qui veulent la propriété sans le détail au niveau des requêtes. Vous pouvez voir comment les options de téléchargement de Maxisnap sont structurées sur le Téléversement SFTP et Téléversement S3 / R2 pages, ou lire le Aperçu de Maxisnap et ShareX.

ShareX est une marque de son propriétaire respectif ; Amazon S3, Google Cloud Storage et Cloudflare R2 sont des marques de leurs propriétaires respectifs. Les détails des fonctionnalités de ShareX ont été vérifiés par rapport à la documentation officielle de ShareX le 17 août 2026 et peuvent changer. Maxisnap est un produit indépendant et n'est pas affilié à, approuvé par ou parrainé par l'un de ces projets ou entreprises.