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

Einer der Gründe, dass Power-User lieben ShareX ist, dass es deine Screenshots nicht in jemandem anderm Cloud sperrt. Mit einem Custom Uploader kann ShareX jede Erfassung zu einem Ziel drücken Sie Kontrolle – deinen eigenen Server, einen Objekt-Speicher-Bucket oder einen Link-Shortening-Endpunkt – und gibt dir automatisch eine teilbare URL zurück. Dieser Leitfaden erklärt, wie das Custom Uploader System funktioniert, wie man einen sauberen einrichtet, und wie man seine Berechtigungsnachweise sicher hält, während man es tut.

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.
• Form data (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 vier 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.

Dies ist der Schritt, den Menschen am häufigsten falsch machen: der Upload gelingt, aber die "URL", die ShareX kopiert, ist leer oder falsch formatiert, weil der Parser auf das falsche Feld zeigt. Wenn das passiert, schauen Sie sich die Raw-Antwort an, die Ihr Server zurückgibt, und verfolgen Sie den exakten Weg 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, verwenden Sie ShareX's gewidmeten integrierten Leitfaden für diesen Anbieter, anstatt eine generische HTTP-Anfrage von Hand zu erstellen. Die integrierten Ziele kümmern sich um anbieter-spezifische Signaturen und Setup für benutzerdefinierte Domänen für Sie, was weniger bewegliche Teile und weniger Orte bedeutet, um einen Fehler zu machen. Behalten Sie den generischen HTTP-Custom-Uploader für Endpunkte auf, die keine integrierte Option haben.

Wenn Sie würden Hand-Konfiguration nicht bevorzugen

Der Custom Uploader ist gerade deshalb mächtig, weil er vollständig konfigurierbar ist – diese Flexibilität ist der Punkt, und für Selbsthosting ist es ideal. Wenn du dein Speicher besitzt, aber würdest HTTP-Anfragen lieber nicht selbst schreiben und Antwort-Parser, ein geführteres Setup kann Zeit sparen. Maxisnap Studio, eine einmalige Upgrade, fügt benutzerdefinierte Upload-Backend hinzu – SFTP, FTP, S3-kompatibel und HTTP – sodass Ihre Windows-Erfassungen auf Speicher hochgeladen werden, den Sie mit einem einfacheren Konfigurationsfluss kontrollieren. Es ist ein anderer Kompromiss vom vollständig offenen Request-Builder von ShareX, gezielt an Menschen, die Besitz ohne Request-Level-Detail mögen. Sie können sehen, wie Maxisnaps Upload-Optionen auf dem strukturiert sind. SFTP-Upload und S3-/R2-Upload Seiten, oder lesen Sie die breitere Maxisnap und ShareX Übersicht.

ShareX ist eine Marke des jeweiligen Eigentümers; Amazon S3, Google Cloud Storage und Cloudflare R2 sind Marken der jeweiligen Eigentümer. ShareX-Funktionsdetails wurden am 17. August 2026 gegen ShareX's offizielle Dokumentation überprüft und können sich ändern. Maxisnap ist ein unabhängiges Produkt und ist nicht verbunden mit, unterstützt von oder gesponsert von einem dieser Projekte oder Unternehmen.