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

파워 유저가 사랑하는 이유 중 하나 ShareX 는 스크린샷을 다른 사람의 클라우드에 잠그지 않는다는 것입니다. 사용자 정의 업로더를 사용하면 ShareX는 모든 캡처를 대상으로 푸시할 수 있습니다. 내가 제어를 유지합니다. 자신의 서버, 개체 저장소 버킷 또는 링크 단축 엔드포인트를 제어할 수 있으며, 자동으로 공유 가능한 URL을 반환합니다. 이 가이드는 사용자 정의 업로더 시스템이 어떻게 작동하는지, 깔끔하게 설정하는 방법, 그리고 설정하는 동안 자격 증명을 안전하게 유지하는 방법을 설명합니다.

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

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의 해당 공급자에 대한 전용 기본 제공 가이드를 사용하세요. 기본 제공 대상은 공급자별 서명 및 사용자 정의 도메인 설정을 처리하므로 이동 부분이 적고 실수할 수 있는 곳이 적습니다. 기본 제공 옵션이 없는 엔드포인트에 대해 일반 HTTP 사용자 정의 업로더를 예약하세요.

손으로 구성된 요청을 선호하지 않으면

사용자 정의 업로더는 완전히 구성 가능하기 때문에 강력합니다. 유연성이 포인트이며, 자신의 저장소를 소유하고 있는 자가 호스팅하는 사람에게는 이상적입니다. HTTP 요청 및 응답 파서를 작성하는 대신 포인트 앤드 픽 백엔드를 선호한다면, 더 안내된 설정이 시간을 절약할 수 있습니다. Maxisnap Studio, 일회성 업그레이드는 사용자 정의 업로드 백엔드를 추가합니다 — SFTP, FTP, S3 호환 및 HTTP — 따라서 Windows 캡처가 더 간단한 구성 흐름으로 제어할 수 있는 저장소에 업로드됩니다. 이것은 ShareX의 완전히 개방된 요청 빌더와는 다른 절충안이며, 요청 수준의 세부 정보 없이 소유권을 원하는 사람들을 위한 것입니다. Maxisnap의 업로드 옵션이 어떻게 구성되어 있는지 다음에서 확인할 수 있습니다. SFTP 업로드 과 S3 / R2 업로드 페이지 또는 더 넓은 읽기를 참조하세요. Maxisnap 및 ShareX 개요입니다.

ShareX는 해당 소유자의 상표입니다. Amazon S3, Google Cloud Storage 및 Cloudflare R2는 각각의 소유자의 상표입니다. ShareX 기능 세부정보는 2026년 8월 17일 ShareX의 공식 문서에 대해 확인되었으며 변경될 수 있습니다. Maxisnap은 독립적인 제품이며 이러한 프로젝트나 회사와 제휴되어 있지 않으며, 보증되지 않으며, 후원되지 않습니다.