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

ShareX è uno strumento di screenshot gratuito e open source per Windows che combina cattura dello schermo, registrazione dello schermo, condivisione di file e strumenti di produttività.

La documentazione di ShareX sui caricatori personalizzati, letta a ottobre 2026, descrive un sistema che permette di caricare immagini, testo e file su servizi di hosting o di accorciare e condividere URL. Questa guida segue quella documentazione: come funziona il caricatore personalizzato, come impostarne uno in modo pulito e come tenere al sicuro le tue credenziali mentre lo fai.

Leggi la documentazione di ShareX sui caricatori personalizzati.

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 richiesta e 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 offre questi 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.

Se il caricamento riesce ma l'URL che ShareX copia è vuoto o malformato, il parser potrebbe puntare al campo sbagliato. Guarda la risposta grezza che il tuo server restituisce e traccia il percorso esatto fino 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 archivio è Amazon S3, Google Cloud Storage o Cloudflare R2, segui la guida di ShareX per quel fornitore invece di costruire a mano una richiesta HTTP generica. La guida di ShareX per Amazon S3, per esempio, copre il bucket, le chiavi di accesso e un dominio personalizzato facoltativo. Riserva il caricatore HTTP personalizzato generico agli endpoint che non hanno una guida.

Maxisnap Studio può anche caricare sul tuo server

Maxisnap Studio, un upgrade unico, aggiunge backend di caricamento personalizzati — SFTP, FTP, compatibile con S3 e HTTP — così le tue catture Windows vengono caricate su archiviazione che controlli. Puoi vedere come sono strutturate le opzioni di caricamento di Maxisnap sulla pagina Upload SFTP e Upload S3 / R2 pagine, o leggi il più ampio Panoramica di Maxisnap e ShareX.

Maxisnap non è affiliato a ShareX. Questa pagina descrive ShareX come lo presentava il suo sito ufficiale a ottobre 2026; consulta il sito ufficiale per funzionalità, prezzi e piattaforme attuali. getsharex.com