Guida ai caricatori personalizzati di ShareX: colleghi di screenshot self-hosted

Una delle ragioni per cui i power user amano ShareX è che non blocca i tuoi screenshot nel cloud di qualcun altro. Con un caricatore personalizzato, ShareX può spingere ogni cattura a una destinazione tu controllo — il tuo server, un bucket di archiviazione di oggetti o un endpoint di accorciamento di link — e ti restituisce un URL condivisibile automaticamente. Questa guida spiega come funziona il sistema del caricatore personalizzato, come impostarne uno correttamente e come mantenere i tuoi credenziali al sicuro mentre lo fai.

Che cosa è in realtà un caricatore personalizzato

Come dice la stessa documentazione di ShareX, la funzione del caricatore personalizzato è utilizzata principalmente da persone che ospitano i loro stessi servizi. In pratica è una piccola definizione che dice a ShareX: quando catturo qualcosa, invialo a questo URL, usando questa richiestae trova il link risultante in questa parte della risposta. Ottieni questi tre cose giuste e ShareX silenziosamente carica e copia un URL funzionante ogni volta che fai uno scatto.

La richiesta: metodi e tipi di corpo

ShareX supporta i metodi HTTP standard — GET, POST, PUT, PATCH e DELETE. Come regola pratica dalla documentazione: se la richiesta porta solo parametri e nessun corpo, GET è preferito; se invia un file come multipart/form-data, POST è la scelta abituale.

Per il corpo della richiesta, ShareX offre diversi tipi in modo che possa corrispondere a qualsiasi cosa il tuo endpoint si aspetta:

• Nessun corpo — solo parametri.
• Dati del modulo (multipart/form-data) — la scelta tipica per il caricamento di un file.
• Codificato da modulo (applicazione/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binario — il file grezzo come corpo.

La documentazione API del tuo server ti dice quale metodo e tipo di corpo si aspetta; stai semplicemente specchiando questo nella definizione ShareX.

Parsing della risposta: dov'è il link?

Dopo il caricamento, il tuo endpoint risponde — di solito con JSON, XML o testo semplice — e devi dire a ShareX quale campo contiene l'URL finale. ShareX ti dà quattro modi per estrarlo:

• JSON usando la sintassi JsonPath, ad es. {json:data.link} da leggere data.link da una risposta JSON.
• XML usando XPath, ad es. {xml:/files/file[1]/url}.
• Regex per il pattern-matching di una risposta in testo semplice.
• Intestazioni per leggere un URL restituito in un'intestazione di risposta.

Questo è il passo che la gente solitamente sbaglia: il caricamento ha successo, ma l'"URL" che ShareX copia è vuoto o malformato perché il parser punta al campo sbagliato. Quando accade, guarda la risposta grezza che il tuo server restituisce e traccia il percorso esatto alla stringa URL.

Passo dopo passo: una configurazione pulita

1. Leggi la documentazione dell'API dell'endpoint e annota il metodo, il tipo di corpo, il nome del campo per il file, qualsiasi intestazione di autenticazione e la posizione esatta dell'URL nella risposta.
2. Esegui il backup delle tue impostazioni ShareX attuali per primo. Esporta la tua configurazione di destinazione esistente in modo che tu possa eseguire il rollback se un cambiamento si comporta male.
3. Crea il caricatore personalizzato in ShareX (Destinazioni → Impostazioni caricatore personalizzato). Imposta il metodo della richiesta, l'URL di destinazione, le intestazioni e il tipo di corpo per corrispondere al tuo endpoint.
4. Configura il parser di risposta usando la regola JsonPath, XPath, regex o intestazione corretta in modo che ShareX restituisca l'URL corretto.
5. Prova con un'acquisizione inoffensiva — un'immagine monouso — e conferma che il collegamento restituito apra effettivamente il file.
6. Verifica il comportamento di eliminazione/conservazione se il tuo endpoint supporta l'eliminazione, così sai come rimuovere un caricamento in seguito.
7. Impostalo come destinazione attiva solo quando un vero link di test funziona da capo a piedi.

Condivisione e riutilizzo di configurazioni: file .sxcu

Un caricatore personalizzato finito può essere esportato come un .sxcu file. Un altro utente può importarlo facendo doppio clic sul file e ShareX applica la configurazione della destinazione automaticamente. Questo lo rende facile condividere una configurazione funzionante tra i tuoi stessi computer o con un team — ma è esattamente dove i segreti trapelano, quindi leggi la sezione successiva prima di inviarne uno a chiunque.

Proteggi i tuoi segreti

Un caricatore personalizzato spesso contiene chiavi API, token o credenziali firmate. Tratta un .sxcu file come una password:

• Prima di condividere una configurazione, spoglia o sostituisci le credenziali reali con segnaposti. Un .sxcu quello che pubblichi pubblicamente può esporre una chiave attiva.
• Preferisci token con ambito e revocabili rispetto alle chiavi master longeve, quindi una perdita è contenuta e facile da ruotare.
• Carica sempre su HTTPS così che le credenziali e i file non vengono inviati in chiaro.
• Ruota tutto ciò che potrebbe essere stato esposto — gli screenshot e le loro configurazioni viaggiano più lontano di quanto ti aspetti.

Preferisci una destinazione integrata quando ce n'è una

Se il tuo archiviazione è Amazon S3, Google Cloud Storage o Cloudflare R2, usa la guida integrata dedicata di ShareX per quel fornitore piuttosto che costruire una richiesta HTTP generica manualmente. Le destinazioni integrate gestiscono la firma specifica del fornitore e l'impostazione del dominio personalizzato per te, che sono meno parti in movimento e meno posti dove fare un errore. Riserva il caricatore HTTP generico per endpoint che non hanno un'opzione integrata.

Se preferisci non configurare manualmente le richieste

Il caricatore personalizzato è potente proprio perché è completamente configurabile — questa flessibilità è il punto, e per i self-hoster è ideale. Se ami possedere il tuo archiviazione ma preferisci scegliere-e-selezionare un backend piuttosto che autore di richieste HTTP e parser di risposta, una configurazione più guidata può risparmiare tempo. Maxisnap Studio, un upgrade unico, aggiunge backend di caricamento personalizzati — SFTP, FTP, compatibile con S3 e HTTP — quindi i tuoi scatti Windows vengono caricati su archiviazione che controlli con un flusso di configurazione più semplice. È un diverso compromesso rispetto al generatore di richieste completamente aperto di ShareX, rivolto a chi vuole proprietà senza il dettaglio a livello di richiesta. Puoi vedere come le opzioni di caricamento di Maxisnap sono strutturate su Upload SFTP e Upload S3 / R2 pagine, o leggi il più ampio Panoramica di Maxisnap e ShareX.

ShareX è un marchio del rispettivo proprietario; Amazon S3, Google Cloud Storage e Cloudflare R2 sono marchi dei rispettivi proprietari. I dettagli della funzione ShareX sono stati controllati rispetto alla documentazione ufficiale di ShareX il 17 agosto 2026 e potrebbero cambiare. Maxisnap è un prodotto indipendente e non è affiliato a, approvato da o sponsorizzato da nessuno di questi progetti o aziende.