ShareX 사용자 정의 업로더 가이드. 자체 호스팅 스크린샷 링크

ShareX는 화면 캡처, 화면 녹화, 파일 공유, 생산성 도구를 하나로 묶은 Windows용 무료 오픈소스 스크린샷 도구입니다.

2026년 10월에 확인한 ShareX의 사용자 정의 업로더 문서는 이미지, 텍스트, 파일을 호스팅 서비스에 업로드하거나 URL을 단축해 공유할 수 있는 시스템을 설명합니다. 이 가이드는 그 문서를 따라 사용자 정의 업로더가 어떻게 작동하는지, 깔끔하게 설정하는 방법, 그리고 설정하는 동안 자격 증명을 안전하게 지키는 방법을 설명합니다.

ShareX의 사용자 정의 업로더 문서를 읽어 보세요.

사용자 정의 업로더가 실제로 무엇인지

ShareX의 자체 문서에 따르면, 사용자 정의 업로더 기능은 주로 자신의 서비스를 호스팅하는 사람들이 사용합니다. 실제로 작은 정의이며 ShareX에 지시합니다. 캡처할 때 이 URL, 사용 이 요청및 결과 링크 찾기 응답의 이 부분. 이 세 가지를 올바르게 얻으면 ShareX는 조용히 업로드하고 스니핑할 때마다 작동하는 URL을 복사합니다.

요청: 메서드 및 본문 유형

ShareX의 사용자 정의 업로더는 표준 HTTP 메서드를 지원합니다 — GET, POST, PUT, PATCH 및 DELETE. 문서의 일반 규칙로서: 요청이 본문 없이 매개변수만 전달하는 경우, GET 이 권장됩니다. 파일을 전송할 때 사용하는 형식이 다음과 같다면: multipart/form-data, POST가 일반적인 선택입니다.

요청 본문의 경우, ShareX는 엔드포인트가 기대하는 것과 일치할 수 있도록 여러 유형을 제공합니다.

• 본문 없음 — 매개변수만.
• 양식 데이터(multipart/form-data) — 파일을 업로드하는 일반적인 선택.
• 양식 URL 인코딩 (application/x-www-form-urlencoded).
• JSON(application/json).
• XML(application/xml).
• 이진 원시 파일을 본문으로.

서버의 API 문서는 어떤 메서드와 본문 유형을 예상하는지 알려줍니다. ShareX 정의에서 단순히 미러링하고 있습니다.

응답 파싱: 링크는 어디입니까?

업로드가 끝나면 엔드포인트가 응답하며(보통 JSON, XML 또는 일반 텍스트), 최종 URL이 들어 있는 필드를 ShareX에 알려 주어야 합니다. ShareX는 이를 추출하는 다음 방법들을 제공합니다:

• JSON JsonPath 구문 사용(예: {json:data.link} 읽으려면 data.link JSON 응답에서입니다.
• XML XPath 구문 사용. 예: {xml:/files/file[1]/url}.
• 정규 표현식 일반 텍스트 응답을 위한 패턴 매칭의 경우.
• 헤더 응답 헤더에서 반환된 URL을 읽으려면.

업로드는 성공했지만 ShareX가 복사한 URL이 비어 있거나 형식이 잘못되었다면, 파서가 잘못된 필드를 가리키고 있을 수 있습니다. 서버가 반환하는 원시 응답을 확인하고 URL 문자열까지의 정확한 경로를 따라가 보세요.

단계별: 깨끗한 설정

1. 엔드포인트의 API 문서 읽기 메서드를 기록하고, 본문 유형, 파일의 필드 이름, 모든 인증 헤더 및 응답에서 URL의 정확한 위치입니다.
2. 먼저 현재 ShareX 설정을 백업하세요. 변경이 잘못 동작할 경우를 대비해 기존 목적지 구성을 내보내세요.
3. 사용자 정의 업로더 생성 ShareX에서(대상 → 사용자 정의 업로더 설정). 요청 메서드, 대상 URL, 헤더 및 본문 유형을 엔드포인트와 일치하도록 설정하세요.
4. 응답 파서 구성 올바른 JsonPath, XPath, 정규 표현식, 또는 헤더 규칙을 사용하여 ShareX가 올바른 URL을 반환하도록 하세요.
5. 무해한 캡처로 테스트 — 테스트 이미지 — 반환된 링크가 실제로 파일을 엽니다.
6. 삭제/보유 동작 검증 나중에 업로드를 제거하는 방법을 알 수 있도록 엔드포인트에서 삭제를 지원하는 경우
7. 활성 대상으로 설정 오직 실제 테스트 링크가 끝에서 끝까지 작동할 때만.

.sxcu 파일 공유 및 재사용 구성

완성된 사용자 정의 업로더는 다음과 같이 내보낼 수 있습니다. .sxcu 파일입니다. 다른 사용자는 파일을 더블 클릭하여 가져올 수 있으며, ShareX가 대상 구성을 자동으로 적용합니다. 이를 통해 자신의 컴퓨터나 팀 간에 작동하는 설정을 쉽게 공유할 수 있습니다. 하지만 이것이 정확히 비밀이 누출되는 곳이므로 누군가에게 보내기 전에 다음 섹션을 읽으세요.

비밀을 보호하세요.

사용자 지정 업로더는 종종 API 키, 토큰 또는 서명된 자격증명을 포함합니다. 이를 .sxcu 파일 같은 암호:

• 구성을 공유하기 전에 실제 자격 증명을 제거하거나 교체하세요. 자리 표시자 포함. A .sxcu 공개적으로 게시할 수 있으면 라이브 키를 노출합니다.
• 범위가 있는 취소 가능한 토큰 선호 장기간 유지되는 마스터 키에 비해 누출이 포함되고 회전하기 쉽습니다.
• 항상 HTTPS를 통해 업로드 따라서 자격 증명과 파일이 평문으로 전송되지 않습니다.
• 노출되었을 수 있는 회전 — 스크린샷과 구성이 예상보다 훨씬 멀리 이동합니다.

기본 제공 목적지가 있을 때 선호합니다.

저장소가 Amazon S3, Google Cloud Storage 또는 Cloudflare R2라면, 일반 HTTP 요청을 직접 구성하는 대신 해당 공급자에 대한 ShareX의 가이드를 따르세요. 예를 들어 ShareX의 Amazon S3 가이드는 버킷, 액세스 키, 선택적인 사용자 정의 도메인을 다룹니다. 일반 HTTP 사용자 정의 업로더는 가이드가 없는 엔드포인트에 사용하세요.

Maxisnap Studio는 직접 운영하는 서버에도 업로드할 수 있습니다

Maxisnap Studio, 일회성 업그레이드는 사용자 정의 업로드 백엔드를 추가합니다 — SFTP, FTP, S3 호환 및 HTTP — 따라서 Windows 캡처가 직접 관리하는 저장소에 업로드됩니다. Maxisnap의 업로드 옵션이 어떻게 구성되어 있는지는 다음 페이지에서 확인할 수 있습니다: SFTP 업로드 및 S3 / R2 업로드 페이지. 더 폭넓은 내용은 다음 글을 참고하세요: Maxisnap 및 ShareX 개요.

Maxisnap은 ShareX와 제휴 관계가 없습니다. 이 페이지는 ShareX를 공식 사이트가 2026년 10월에 소개한 내용을 기준으로 설명합니다. 최신 기능, 요금제, 지원 플랫폼은 공식 사이트에서 확인하시기 바랍니다. getsharex.com