ShareX Custom Uploader Gids: Zelfgehoste Schermafbeelding Links

Een van de redenen waarom power-gebruikers ervan houden ShareX is dat het je schermafbeeldingen niet in iemand anders' cloud slot. Met een aangepaste uploader kan ShareX elke vastlegging naar een bestemming jij beheer — je eigen server, een object-opslagbucket, of een link-verkortings-eindpunt — en geef je automatisch een shareable URL. Deze gids legt uit hoe het aangepaste uploader-systeem werkt, hoe je er één correct opzet, en hoe je je geloofsbrieven veilig houdt terwijl je dat doet.

Wat een aangepaste uploader werkelijk is

Zoals ShareX's eigen documentatie stelt, wordt de functie voor aangepaste uploader vooral gebruikt door mensen die hun eigen services hosten. In de praktijk is het een kleine definitie die ShareX zegt: wanneer ik iets vast leg, stuur het naar deze URL, met behulp van dit verzoek, en vind de resulterende link in dit deel van de response. Krijg die drie dingen goed en ShareX uploadt stilzwijgend en kopieert een werkende URL telkens wanneer je vast legt.

Het verzoek: methodes en lichaamstypen

ShareX's aangepaste uploader ondersteunt de standaard HTTP-methoden — GET, POST, PUT, PATCH en DELETE. Als vuistregel uit de documentatie: als het verzoek alleen parameters heeft en geen lichaam, GET is voorkeur; als het een bestand als verzonden multipart/form-data, POST is de gebruikelijke keuze.

Voor het verzoek-lichaam biedt ShareX verschillende typen zodat het kan aansluiten bij wat je eindpunt verwacht:

• Geen body — alleen parameters.
• Formuliergegevens (multipart/form-data) — de typische keuze voor het uploaden van een bestand.
• Formulier URL gecodeerd (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binair — het ruwe bestand als het lichaam.

Je server's API-documentatie vertelt je welke methode en lichaamstype het verwacht; je weerspiegelt eenvoudig dat in de ShareX-definitie.

De response parseren: waar is de link?

Na de upload geeft je eindpunt antwoord — meestal met JSON, XML of platte tekst — en je moet ShareX zeggen welk veld de uiteindelijke URL bevat. ShareX geeft je vier manieren om het uit te pakken:

• JSON JsonPath-syntaxis gebruiken, bijv. {json:data.link} te lezen data.link uit een JSON-response.
• XML met behulp van XPath, bijv. {xml:/files/file[1]/url}.
• Regex voor patroonwedstrijding een platte-tekst response.
• Headers om een URL te lezen die in een response-header wordt geretourneerd.

Dit is de stap die mensen het meest verkeerd doen: de upload slaagt, maar de "URL" die ShareX kopieert is leeg of misvormend omdat de parser naar het verkeerde veld wijst. Wanneer dat gebeurt, bekijk de ruwe response die je server teruggeeft en trace het exacte pad naar de URL-string.

Stap-voor-stap: een schone opzet

1. Lees je eindpunt's API-documenten en noteer de methode, het lichaamstype, de veldnaam voor het bestand, elke auth-header en de exacte locatie van de URL in de response.
2. Maak eerst een back-up van uw huidige ShareX-instellingen. Exporteer je bestaande bestemming-configuratie zodat je kan terugvallen als een wijziging misslaat.
3. Maak de aangepaste uploader in ShareX (Bestemmingen → Aangepaste uploader-instellingen). Stel de verzoek-methode, bestemming URL, headers en lichaamstype in zodat deze overeenkomt met je eindpunt.
4. Configureer de response-parser met behulp van de juiste JsonPath, XPath, regex of headerregel zodat ShareX de juiste URL teruggeeft.
5. Test met een ongevaarlijke vastlegging — een wegwerp-afbeelding — en bevestig dat de geretourneerde link werkelijk het bestand opent.
6. Verwijder/retentie gedrag controleren als je eindpunt verwijdering ondersteunt, zodat je weet hoe je een upload later kunt verwijderen.
7. Stel het in als je actieve bestemming alleen zodra een echte test-link end-to-end werkt.

Configs delen en hergebruiken: .sxcu-bestanden

Een afgewerkt aangepaste uploader kan worden geëxporteerd als een .sxcu bestand. Een ander gebruiker kan het importeren door het bestand dubbel te klikken, en ShareX past de bestemmingsconfiguratie automatisch toe. Dat maakt het gemakkelijk om een werkende opzet over je eigen machines of met een team te delen — maar het is ook precies waar geheimen lekken, dus lees de volgende sectie voordat je er een naar iemand stuurt.

Bescherm je geheimen

Een aangepaste uploader bevat vaak API-sleutels, tokens of ondertekende geloofsbrieven. Behandel een .sxcu bestand als wachtwoord:

• Voordat je een config deelt, verwijder of vervang echte geloofsbrieven met aanduidingen. Een .sxcu je post openbaar kan een live sleutel blootgesteld.
• Kies scoped, revocable-tokens meer dan lange-leven master-sleutels, dus een lek is ingeperkt en gemakkelijk te roteren.
• Altijd uploaden via HTTPS dus geloofsbrieven en bestanden worden niet in het duidelijk verzonden.
• Roteer alles wat mogelijk is blootgesteld — schermafbeeldingen en hun configs reizen verder dan je verwacht.

Kies een ingebouwde bestemming wanneer er één is

Als je opslag Amazon S3, Google Cloud Storage of Cloudflare R2 is, gebruik je ShareX's specifieke ingebouwde gids voor die provider in plaats van handmatig een generiek HTTP-verzoek op te stellen. De ingebouwde bestemmingen handelen provider-specifieke ondertekening en aangepaste domeinopstelling voor je af, wat minder bewegende onderdelen en minder plekken om fouten te maken. Reserveer de generieke HTTP aangepaste uploader voor eindpunten die geen ingebouwde optie hebben.

Als je liever niet handmatig verzoeken configureert

De aangepaste uploader is krachtig precies omdat het volledig configureerbaar is — die flexibiliteit is het punt, en voor zelf-hosters is het ideaal. Als je je eigen opslag graag eigenaar bent maar liever point-and-pick een backend dan HTTP-verzoeken schrijven en response-parsers, kan een meer begeleide opzet tijd besparen. Maxisnap Studio, een eenmalige upgrade, voegt aangepaste upload backends toe — SFTP, FTP, S3-compatibel en HTTP — dus je Windows-vastleggingen uploaden naar opslag die je beheert met een eenvoudiger configuratiestroom. Het is een ander afweging van ShareX's volledig open request-builder, gericht op mensen die eigenaarschap willen zonder het request-niveau detail. Je kunt zien hoe Maxisnap's upload-opties zijn gestructureerd op de SFTP-upload en S3-/R2-upload pagina's, of lees de bredere Maxisnap en ShareX overzicht.

ShareX is een handelsmerk van de desbetreffende eigenaar; Amazon S3, Google Cloud Storage en Cloudflare R2 zijn handelsmerken van hun respectieve eigenaars. ShareX-functiedetails werden op 17 augustus 2026 gecontroleerd tegen ShareX's officiële documentatie en kunnen veranderen. Maxisnap is een onafhankelijk product en is niet gelieerd aan, goedgekeurd door of gesponsord door een van deze projecten of bedrijven.