Guia de Upload Personalizado do ShareX: Links de Screenshots Auto-hospedados

O ShareX é uma ferramenta de captura de tela gratuita e de código aberto para Windows que combina captura de tela, gravação de tela, compartilhamento de arquivos e ferramentas de produtividade.

A documentação do carregador personalizado do ShareX, lida em outubro de 2026, descreve um sistema que permite enviar imagens, texto e arquivos para serviços de hospedagem ou encurtar e compartilhar URLs. Este guia segue essa documentação: como o carregador personalizado funciona, como configurar um de forma limpa e como manter suas credenciais seguras enquanto faz isso.

Leia a documentação do carregador personalizado do ShareX.

O que um carregador personalizado realmente é

Conforme a própria documentação do ShareX coloca, o recurso de carregador personalizado é principalmente usado por pessoas que hospemdam seus próprios serviços. Na prática, é uma pequena definição que diz ao ShareX: quando eu capturar algo, enviar para este URL, usando este pedido, e encontre o link resultante em esta parte da resposta. Obtenha essas três coisas certas e o ShareX carrega silenciosamente e copia um URL funcionando toda vez que você recorta.

A solicitação: métodos e tipos de corpo

O ShareX custom uploader suporta os métodos HTTP padrão — GET, POST, PUT, PATCH e DELETE. Como regra geral dos documentos: se a solicitação apenas carrega parâmetros e nenhum corpo, GET é preferido; se enviar um arquivo como multipart/form-data, POST é a escolha usual.

Para o corpo da solicitação, o ShareX oferece vários tipos para que ele possa corresponder ao que seu endpoint espera:

• Sem corpo — apenas parâmetros.
• Dados de formulário (multipart/form-data) — a escolha típica para fazer upload de um arquivo.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binário — o arquivo bruto como corpo.

A documentação da API do seu servidor diz qual método e tipo de corpo espera; você está simplesmente espelhando isso na definição do ShareX.

Analisando a resposta: onde está o link?

Após o upload, seu endpoint responde — geralmente com JSON, XML ou texto simples — e você precisa dizer ao ShareX qual campo contém a URL final. O ShareX oferece estas maneiras de extraí-la:

• JSON usando sintaxe JsonPath, por exemplo, {json:data.link} para ler data.link de uma resposta JSON.
• XML usando XPath, por exemplo, {xml:/files/file[1]/url}.
• Regex para correspondência de padrão de uma resposta texto simples.
• Headers para ler um URL retornado em um header de resposta.

Se o upload for bem-sucedido, mas a URL que o ShareX copia estiver vazia ou malformada, o parser pode estar apontando para o campo errado. Olhe a resposta bruta que seu servidor retorna e rastreie o caminho exato até a string da URL.

Step-by-step: uma configuração limpa

1. Leia a documentação da API do seu endpoint e observe o método, o tipo de corpo, o nome do campo para o arquivo, qualquer header de autenticação e a localização exata do URL na resposta.
2. Faça backup de suas configurações atuais do ShareX primeiro. Exporte sua configuração de destino existente para que você possa reverter se uma mudança se comportar mal.
3. Crie o carregador personalizado em ShareX (Destinos → Configurações de carregador personalizado). Configure o método de solicitação, URL de destino, headers e tipo de corpo para corresponder ao seu endpoint.
4. Configure o parser de resposta usando a JsonPath, XPath, regex ou regra de header correta para que o ShareX retorne o URL correto.
5. Teste com uma captura inofensiva — uma imagem descartável — e confirme que o link retornado realmente abre o arquivo.
6. Verifique o comportamento de exclusão/retenção se seu endpoint suporta exclusão, para que você saiba como remover um upload posteriormente.
7. Configure-o como seu destino ativo apenas uma vez que um link de teste real funciona de ponta a ponta.

Compartilhando e reutilizando configs: arquivos .sxcu

Uma carregador personalizado terminado pode ser exportado como um .sxcu arquivo. Outro usuário pode importá-lo clicando duas vezes no arquivo, e o ShareX aplica a configuração de destino automaticamente. Isso torna fácil compartilhar uma configuração funcionando entre suas próprias máquinas ou com uma equipe — mas é exatamente onde os segredos vazam, então leia a próxima seção antes de enviar um para qualquer pessoa.

Proteja seus segredos

Um carregador personalizado geralmente contém chaves de API, tokens ou credenciais assinadas. Trate um .sxcu arquivo como uma senha:

• Antes de compartilhar uma config, remova ou substitua credenciais reais com placeholders. Um .sxcu você publica publicamente pode expor uma chave ao vivo.
• Prefira tokens com escopo e revogáveis sobre chaves mestras de longa vida, então um vazamento é contido e fácil de rotacionar.
• Sempre envie sobre HTTPS para que credenciais e arquivos não sejam enviados em texto claro.
• Rotacione qualquer coisa que pode ter sido exposta — capturas e suas configs viajam mais do que você espera.

Prefira um destino integrado quando houver um

Se o seu armazenamento é Amazon S3, Google Cloud Storage ou Cloudflare R2, siga o guia do ShareX para esse provedor em vez de construir uma solicitação HTTP genérica à mão. O guia do Amazon S3 do ShareX, por exemplo, cobre o bucket, as chaves de acesso e um domínio personalizado opcional. Mantenha o carregador HTTP personalizado genérico para endpoints que não têm guia.

O Maxisnap Studio também pode enviar para o seu próprio servidor

Maxisnap Studio, um upgrade único, adiciona backends de upload personalizados — SFTP, FTP, S3-compatível e HTTP — para que suas capturas do Windows sejam enviadas para um armazenamento que você controla. Você pode ver como as opções de upload do Maxisnap estão estruturadas nas páginas Upload por SFTP e Upload para S3 / R2 ou leia a mais ampla Visão geral de Maxisnap e ShareX.

O Maxisnap não é afiliado ao ShareX. Esta página descreve o ShareX como seu site oficial o apresentava em outubro de 2026; consulte o site oficial para ver recursos, preços e plataformas atuais. getsharex.com