Guía de cargador personalizado de ShareX: Enlaces de captura de pantalla autohospedados

Una de las razones por las que los usuarios avanzados aman ShareX es que no bloquea tus capturas en la nube de otra persona. Con un cargador personalizado, ShareX puede enviar cada captura a un destino tú controla — tu propio servidor, un depósito de almacenamiento de objetos o un punto final de acortamiento de enlaces — y te devuelve una URL compartible automáticamente. Esta guía explica cómo funciona el sistema de cargador personalizado, cómo configurar uno limpiamente, y cómo mantener tus credenciales seguras mientras lo haces.

Qué es realmente un cargador personalizado

Como dice la propia documentación de ShareX, la característica del cargador personalizado se usa principalmente por personas que alojan sus propios servicios. En la práctica es una pequeña definición que le dice a ShareX: cuando capturo algo, envíalo a esta URL, usando esta solicitud, y encuentra el enlace resultante en esta parte de la respuesta. Obtén esas tres cosas bien y ShareX carga silenciosamente y copia una URL de trabajo cada vez que capturas.

La solicitud: métodos y tipos de cuerpo

Los métodos HTTP estándar soportados de ShareX son — GET, POST, PUT, PATCH y DELETE. Como regla general de los documentos: si la solicitud solo lleva parámetros y sin cuerpo, GET se prefiere; si envía un archivo como multipart/form-data, POST es la opción habitual.

Para el cuerpo de la solicitud, ShareX ofrece varios tipos para que pueda coincidir con lo que tu punto final espera:

• Sin cuerpo — solo parámetros.
• Datos de formulario (multipart/form-data) — la opción típica para cargar un archivo.
• Codificado en forma URL (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Binario — el archivo sin procesar como cuerpo.

La documentación de API de tu servidor te dice qué método y tipo de cuerpo espera; simplemente estás reflejando eso en la definición de ShareX.

Análisis de la respuesta: ¿dónde está el enlace?

Después de la carga, tu punto final responde — generalmente con JSON, XML o texto plano — y necesitas decirle a ShareX qué campo contiene la URL final. ShareX te proporciona cuatro formas de extraerla:

• JSON usando sintaxis JsonPath, por ejemplo, {json:data.link} para leer data.link de una respuesta JSON.
• XML usando XPath, por ejemplo, {xml:/files/file[1]/url}.
• Regex para coincidencia de patrones de una respuesta de texto plano.
• Encabezados para leer una URL devuelta en un encabezado de respuesta.

Este es el paso que la mayoría de las personas hacen mal: la carga es exitosa, pero la "URL" que ShareX copia está vacía o con formato incorrecto porque el parser apunta al campo incorrecto. Cuando eso sucede, mira la respuesta sin procesar que devuelve tu servidor y rastrea la ruta exacta a la cadena de URL.

Paso a paso: una configuración limpia

1. Lee la documentación de API de tu punto final y anota el método, el tipo de cuerpo, el nombre del campo del archivo, cualquier encabezado de autenticación y la ubicación exacta de la URL en la respuesta.
2. Copia de seguridad de tu configuración actual de ShareX primero. Exporta tu configuración de destino existente para poder revertir si un cambio se comporta mal.
3. Crea el cargador personalizado en ShareX (Destinos → Configuración de cargador personalizado). Establece el método de solicitud, la URL de destino, los encabezados y el tipo de cuerpo para que coincidan con tu punto final.
4. Configura el analizador de respuesta usando la regla JsonPath, XPath, regex o encabezado correcta para que ShareX devuelva la URL correcta.
5. Prueba con una captura inofensiva — una imagen desechable — y confirma que el enlace devuelto realmente abre el archivo.
6. Verifica el comportamiento de eliminación/retención si tu punto final admite eliminación, para que sepas cómo eliminar una carga más tarde.
7. Establécelo como tu destino activo solo una vez que un enlace de prueba real funcione de extremo a extremo.

Compartir y reutilizar configuraciones: archivos .sxcu

Un cargador personalizado terminado puede exportarse como un .sxcu archivo. Otro usuario puede importarlo haciendo doble clic en el archivo, y ShareX aplica la configuración de destino automáticamente. Eso hace que sea fácil compartir una configuración funcional en tus propias máquinas o con un equipo — pero es exactamente donde se filtran los secretos, así que lee la siguiente sección antes de enviar uno a alguien.

Protege tus secretos

Un cargador personalizado a menudo contiene claves API, tokens o credenciales firmadas. Trata un .sxcu archivo como una contraseña:

• Antes de compartir una configuración, retira o reemplaza credenciales reales con marcadores de posición. Un .sxcu que publiques públicamente puede exponer una clave en vivo.
• Prefiere tokens limitados y revocables sobre claves maestras de larga duración, así que una fuga se contiene y es fácil de rotar.
• Siempre carga sobre HTTPS para que las credenciales y archivos no se envíen en texto plano.
• Rota cualquier cosa que puede haber sido expuesta — las capturas y sus configuraciones viajan más lejos de lo que esperas.

Prefiere un destino integrado cuando hay uno

Si tu almacenamiento es Amazon S3, Google Cloud Storage o Cloudflare R2, usa la guía dedicada integrada de ShareX para ese proveedor en lugar de construir una solicitud HTTP genérica a mano. Los destinos integrados manejan la firma específica del proveedor y la configuración de dominio personalizado para ti, lo que significa menos piezas móviles y menos lugares donde cometer un error. Reserva el cargador HTTP genérico personalizado para puntos finales que no tengan una opción integrada.

Si prefieres no configurar solicitudes manualmente

El cargador personalizado es poderoso precisamente porque es totalmente configurable — esa flexibilidad es el punto, y para alojadores propios es ideal. Si te gusta poseer tu almacenamiento pero preferirías elegir un backend en lugar de crear solicitudes HTTP y parsers de respuesta, una configuración más guiada puede ahorrar tiempo. Maxisnap Studio, una actualización única, agrega backends de carga personalizados — SFTP, FTP, compatible con S3 e HTTP — así que tus capturas de Windows se cargan al almacenamiento que controlas con un flujo de configuración más simple. Es un tradeoff diferente al constructor de solicitudes totalmente abierto de ShareX, dirigido a personas que quieren propiedad sin el detalle a nivel de solicitud. Puedes ver cómo se estructuran las opciones de carga de Maxisnap en el Subida por SFTP y Subida a S3 / R2 páginas, o lee la más amplia Resumen de Maxisnap y ShareX.

ShareX es una marca registrada de su propietario respectivo; Amazon S3, Google Cloud Storage y Cloudflare R2 son marcas registradas de sus propietarios respectivos. Los detalles de las características de ShareX fueron verificados contra la documentación oficial de ShareX el August 17, 2026 y pueden cambiar. Maxisnap es un producto independiente y no está afiliado con, respaldado por o patrocinado por ninguno de estos proyectos o compañías.