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

Одна из причин, по которой опытные пользователи любят ShareX в том, что он не привязывает ваши скриншоты к чужому облаку. С помощью пользовательского загрузчика 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-запрос вручную. Встроенные назначения берут на себя специфичную для провайдера подпись запросов и настройку пользовательского домена, что означает меньше движущихся частей и меньше мест для ошибки. Оставьте общий 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 были сверены с официальной документацией ShareX 17 августа 2026 года и могут измениться. Maxisnap является независимым продуктом и не связан, не одобрен и не спонсируется ни одним из этих проектов или компаний.