ShareX Custom-Uploader-Anleitung: Selbst gehostete Screenshot-Links

ShareX ist ein kostenloses, quelloffenes Screenshot-Tool für Windows, das Bildschirmaufnahme, Bildschirmaufzeichnung, Dateifreigabe und Produktivitätswerkzeuge vereint.

Die im Oktober 2026 gelesene Dokumentation von ShareX zu benutzerdefinierten Uploadern beschreibt ein System, mit dem Sie Bilder, Text und Dateien zu Hosting-Diensten hochladen oder URLs kürzen und teilen können. Dieser Leitfaden folgt dieser Dokumentation: wie der benutzerdefinierte Uploader funktioniert, wie Sie einen sauber einrichten und wie Sie dabei Ihre Zugangsdaten sicher halten.

Lesen Sie die Dokumentation von ShareX zu benutzerdefinierten Uploadern.

Was ein Custom Uploader wirklich ist

Wie ShareX's eigene Dokumentation sagt, wird die Custom Uploader Funktion hauptsächlich von Menschen verwendet, die ihre eigenen Dienste hosten. In der Praxis ist es eine kleine Definition, die ShareX sagt: wenn ich etwas erfasse, sende es zu Diese URL, mit Diese Anfrage, Und finde den resultierenden Link in Dieser Teil der Antwort. Bekommen Sie diese drei Sachen richtig, und ShareX lädt leise hoch und kopiert eine funktionierende URL jedes Mal, wenn Sie snippet.

Die Anfrage: Methoden und Körperttypen

ShareX's Custom Uploader unterstützt die Standard-HTTP-Methoden – GET, POST, PUT, PATCH und DELETE. Als Faustregel aus der Dokumentation: Wenn die Anfrage nur Parameter trägt und keinen Körper, GET Wird bevorzugt; wenn es eine Datei als multipart/form-data, POST Ist das Übliche Choix.

Für die Request-Body bietet ShareX mehrere Typen an, damit es zu dem passen kann, das Ihr Endpunkt erwartet:

• Kein Körper – Nur Parameter.
• Formulardaten (multipart/form-data) – Das typische Choix zum Hochladen einer Datei.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binär – Die rohe Datei als Körper.

Die API-Dokumentation Ihres Servers sagt Ihnen, welche Methode und Körpertyp es erwartet; Sie spiegeln das einfach in der ShareX-Definition.

Parsing der Antwort: Wo ist der Link?

Nach dem Upload antwortet Ihr Endpunkt – normalerweise mit JSON, XML oder Klartext – und Sie müssen ShareX mitteilen, welches Feld die endgültige URL enthält. ShareX bietet Ihnen dafür diese Möglichkeiten zur Extraktion:

• JSON Mit JsonPath-Syntax, z.B. {json:data.link} Um zu lesen data.link Aus einer JSON-Antwort.
• XML Mit XPath, z.B. {xml:/files/file[1]/url}.
• Regex Für die Muster-Übereinstimmung einer einfachen Text-Antwort.
• Header Um eine URL zu lesen, die in einem Response-Header zurückgegeben wird.

Wenn der Upload gelingt, die von ShareX kopierte URL aber leer oder falsch formatiert ist, zeigt der Parser möglicherweise auf das falsche Feld. Sehen Sie sich die Rohantwort an, die Ihr Server zurückgibt, und verfolgen Sie den genauen Pfad zur URL-Zeichenfolge.

Schritt für Schritt: Ein sauberes Setup

1. Lesen Sie Ihre Endpunkt-API-Dokumentation Und beachten Sie die Methode, den Körpertyp, den Feldnamen für die Datei, einen Auth-Header und den genauen Standort der URL in der Antwort.
2. Sichern Sie Ihre aktuellen ShareX-Einstellungen zuerst. Exportieren Sie Ihre vorhandene Zielkonfiguration, damit Sie zurückrollen können, wenn eine Änderung sich misbehaves.
3. Erstellen Sie den Custom Uploader In ShareX (Ziele → Custom Uploader Einstellungen). Stellen Sie die Request-Methode, Ziel-URL, Header und Körpertyp ein, um Ihrem Endpunkt zu entsprechen.
4. Konfigurieren Sie den Response-Parser Mit dem richtigen JsonPath, XPath, Regex oder Header-Regel, daher ShareX die richtige URL zurückgibt.
5. Mit einem harmlosen Erfassung testen – ein throwaway Bild – und bestätigen Sie, dass der zurückgegebene Link die Datei tatsächlich öffnet.
6. Überprüfen Sie Lösch-/Aufbewahrungsverhalten Wenn Ihr Endpunkt Löschung unterstützt, daher wissen Sie, wie Sie einen Upload später entfernen.
7. Stellen Sie es als Ihr aktives Ziel ein Nur wenn ein echtes Test-Link-End-to-End funktioniert.

Teilen und Wiederverwenden von Konfigurationen: .sxcu Dateien

Ein fertiger Custom Uploader kann als ein .sxcu Datei. Ein anderer Benutzer kann es importieren, indem er auf die Datei doppelklickt, und ShareX wendet die Zielkonfiguration automatisch an. Das macht es einfach, eine funktionierende Einrichtung auf Ihren eigenen Maschinen oder mit einem Team zu teilen – aber es ist auch genau dort, wo Geheimnisse lecken, also lesen Sie den nächsten Abschnitt, bevor Sie einen an jemanden senden.

Schütze deine Geheimnisse

Ein Custom Uploader enthält häufig API-Schlüssel, Tokens oder signierte Anmeldedaten. Behandeln Sie einen .sxcu Datei wie ein Passwort:

• Bevor Sie eine Config teilen, streifen Sie oder ersetzen Sie echte Anmeldedaten Mit Platzhaltern. Ein .sxcu Du veröffentlichst öffentlich kann einen Live-Schlüssel freilegen.
• Bevorzugen Sie scoped, widerrufbare Tokens über lang-lebte Meisterschlüssel, daher ist ein Leck enthalten und einfach zu drehen.
• Immer über HTTPS hochladen Daher werden Anmeldedaten und Dateien nicht im Klartext gesendet.
• Drehen Sie alles, das möglicherweise freigelegt wurde – Screenshots und ihre Configs reisen weiter als Sie erwarten.

Bevorzugen Sie ein eingebautes Ziel, wenn es eines gibt

Wenn Ihr Speicher Amazon S3, Google Cloud Storage oder Cloudflare R2 ist, folgen Sie der Anleitung von ShareX für diesen Anbieter, statt eine generische HTTP-Anfrage von Hand zu erstellen. Die Anleitung von ShareX zu Amazon S3 behandelt zum Beispiel den Bucket, die Zugriffsschlüssel und eine optionale eigene Domain. Behalten Sie den generischen benutzerdefinierten HTTP-Uploader für Endpunkte vor, für die es keine Anleitung gibt.

Maxisnap Studio kann auch auf Ihren eigenen Server hochladen

Maxisnap Studio, eine einmalige Upgrade, fügt benutzerdefinierte Upload-Backend hinzu – SFTP, FTP, S3-kompatibel und HTTP – sodass Ihre Windows-Aufnahmen in einen Speicher hochgeladen werden, den Sie kontrollieren. Wie die Upload-Optionen von Maxisnap aufgebaut sind, sehen Sie auf den Seiten zu SFTP-Upload und S3-/R2-Upload, oder lesen Sie die umfassendere Maxisnap und ShareX Übersicht.

Maxisnap ist nicht mit ShareX verbunden. Diese Seite beschreibt ShareX so, wie die offizielle Website es im Oktober 2026 dargestellt hat; aktuelle Funktionen, Preise und Plattformen finden Sie auf der offiziellen Website. getsharex.com