Руководство по пользовательскому загрузчику ShareX: ссылки на скриншоты на своём сервере

ShareX — бесплатный инструмент для скриншотов с открытым исходным кодом для Windows, объединяющий захват экрана, запись экрана, обмен файлами и инструменты для повышения продуктивности.

В документации ShareX по пользовательским загрузчикам, прочитанной в октябре 2026 года, описана система, которая позволяет загружать изображения, текст и файлы на хостинги или сокращать и распространять URL. Это руководство следует этой документации: как работает пользовательский загрузчик, как аккуратно его настроить и как при этом сохранить учётные данные в безопасности.

Прочитайте документацию ShareX по пользовательским загрузчикам.

Что такое пользовательский загрузчик на самом деле

Как говорится в документации самого ShareX, функция пользовательского загрузчика в основном используется людьми, которые размещают собственные сервисы. На практике это небольшое определение, которое сообщает ShareX: когда я делаю захват, отправь его на этот URL, используя этот запрос, и найди итоговую ссылку в этой части ответа. Если правильно настроить эти три элемента, ShareX будет незаметно загружать файл и копировать рабочий URL каждый раз, когда вы делаете снимок.

Запрос: методы и типы тела

Пользовательский загрузчик ShareX поддерживает стандартные HTTP-методы — GET, POST, PUT, PATCH и DELETE. Как правило, согласно документации: если запрос содержит только параметры и не имеет тела, GET предпочтителен; если он отправляет файл в виде multipart/form-data, POST — обычный выбор.

Для тела запроса ShareX предлагает несколько типов, чтобы соответствовать тому, что ожидает ваша конечная точка:

• Без тела — только параметры.
• Данные формы (multipart/form-data) — типичный выбор для загрузки файла.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Двоичные данные — необработанный файл в качестве тела.

Документация API вашего сервера сообщает, какой метод и тип тела он ожидает; вы просто отражаете это в определении ShareX.

Разбор ответа: где ссылка?

После загрузки ваша конечная точка отвечает — обычно в формате JSON, XML или обычного текста — и вам нужно указать ShareX, в каком поле находится итоговый URL. ShareX предлагает такие способы его извлечения:

• JSON с использованием синтаксиса JsonPath, например {json:data.link} для чтения data.link из ответа в формате JSON.
• XML с использованием XPath, например {xml:/files/file[1]/url}.
• Regex для поиска по шаблону в текстовом ответе.
• Заголовки для чтения URL, возвращённого в заголовке ответа.

Если загрузка проходит успешно, но URL, который копирует ShareX, пустой или некорректный, возможно, парсер указывает на неверное поле. Посмотрите на необработанный ответ, который возвращает ваш сервер, и проследите точный путь к строке URL.

Пошагово: правильная настройка

1. Изучите документацию API вашей конечной точки и отметьте метод, тип тела, имя поля для файла, заголовок авторизации, если он есть, и точное расположение URL в ответе.
2. Сначала сделайте резервную копию текущих настроек ShareX. Экспортируйте существующую конфигурацию назначения, чтобы можно было откатиться, если изменение приведёт к сбою.
3. Создайте пользовательский загрузчик в ShareX (Destinations → Custom uploader settings). Настройте метод запроса, URL назначения, заголовки и тип тела в соответствии с вашей конечной точкой.
4. Настройте парсер ответа с использованием правильного правила JsonPath, XPath, регулярного выражения или заголовка, чтобы ShareX возвращал верный URL.
5. Проверьте на безобидном захвате — одноразовом изображении — и убедитесь, что возвращённая ссылка действительно открывает файл.
6. Проверьте поведение удаления/хранения, если ваша конечная точка поддерживает удаление, чтобы вы знали, как потом удалить загруженный файл.
7. Установите его как активное назначение только после того, как реальная тестовая ссылка сработает от начала до конца.

Обмен и повторное использование конфигураций: файлы .sxcu

Готовый пользовательский загрузчик можно экспортировать как .sxcu файл. Другой пользователь может импортировать его двойным щелчком по файлу, и ShareX автоматически применит конфигурацию назначения. Это упрощает обмен рабочей настройкой между вашими устройствами или с командой — но именно здесь и происходит утечка секретов, поэтому прочитайте следующий раздел, прежде чем кому-либо отправлять такой файл.

Защитите свои секреты

Пользовательский загрузчик часто содержит API-ключи, токены или подписанные учётные данные. Относитесь к файлу .sxcu как к паролю:

• Прежде чем поделиться конфигурацией, удалите или замените реальные учётные данные на заглушки. Файл .sxcu, который вы публикуете, может раскрыть действующий ключ.
• Предпочитайте ограниченные по правам, отзываемые токены вместо долгоживущих мастер-ключей, чтобы утечку было легко локализовать и устранить.
• Всегда загружайте по HTTPS, чтобы учётные данные и файлы не передавались в открытом виде.
• Меняйте всё, что могло быть раскрыто — скриншоты и их конфигурации распространяются дальше, чем вы ожидаете.

Предпочитайте встроенное назначение, если оно есть

Если ваше хранилище — Amazon S3, Google Cloud Storage или Cloudflare R2, следуйте руководству ShareX для этого провайдера, а не создавайте общий HTTP-запрос вручную. Например, руководство ShareX по Amazon S3 охватывает бакет, ключи доступа и необязательный собственный домен. Общий HTTP-загрузчик оставьте для конечных точек, для которых руководства нет.

Maxisnap Studio тоже может загружать на ваш собственный сервер

Maxisnap Studio, единоразовое обновление, добавляет пользовательские бэкенды загрузки — SFTP, FTP, S3-совместимое хранилище и HTTP — так что ваши захваты в Windows загружаются в хранилище, которое вы контролируете. Посмотреть, как устроены варианты загрузки Maxisnap, можно на страницах Загрузка через SFTP и Загрузка в S3/R2 или прочитать более общий обзор Maxisnap и ShareX.

Maxisnap не связан с ShareX. На этой странице ShareX описан так, как его официальный сайт представлял его в октябре 2026 года; актуальные функции, цены и платформы смотрите на официальном сайте. getsharex.com