Быстрый старт

Что понадобится

Для работы нужна 64-битная операционная система и доступ к сети.

Платформа Минимальная версия Требования
macOS 10.15 Catalina или новее Apple Silicon (ARM64), Xcode Command Line Tools
Windows Windows 10 версии 1803 или новее x64, WebView2, Microsoft Visual C++ Redistributable
Linux Ubuntu 22.04+ (AMD/ARM) WebKitGTK 4.1, GTK 3, OpenSSL, libfuse2 (только AppImage)

На Linux также нужен способ получить права администратора: pkexec, графический sudo (zenity, kdialog или yad) либо обычный sudo.

VPN-клиенты, антивирусы и корпоративные прокси, которые перехватывают тот же трафик, могут конфликтовать с приложением.

Установка

macOS

Откройте .dmg и перетащите приложение в Applications.

Windows

Запустите установщик -setup.exe.

Linux

Приложение поставляется как AppImage. Браузер сохраняет файл без бита выполнения, поэтому его нужно выставить вручную:

chmod +x Solpuga_<version>_aarch64.AppImage
./Solpuga_<version>_aarch64.AppImage

Без chmod +x запуск завершится ошибкой Permission denied.

  • chmod +x не помог? Файл лежит на разделе, смонтированном с noexec — например, в общей папке виртуальной машины или в /tmp на некоторых системах. Перенесите его в домашний каталог.
  • Ubuntu 24.04 и новее требует FUSE 2: sudo apt install libfuse2t64. Без неё AppImage сообщает dlopen(): error loading libfuse.so.2.
  • Не запускайте приложение через sudo. От root оно записывает свой CA и настройки в /root, поэтому мастер установки сертификата и перехваченный трафик не совпадут с тем, что вы видите при обычном запуске.

Первый запуск

1. Установите сертификат

HTTPS расшифровывается только после того, как собственный корневой сертификат приложения установлен и помечен доверенным на вашем компьютере. Каждая установка создаёт свой сертификат.

Мастер находится в меню SSL Сертификат и делает работу за вас; операционная система может запросить пароль администратора.

Подробнее — в разделе Установка сертификата.

2. Включите перехват

Запустите перехват в главном окне.

Системный прокси настраивается автоматически — менять настройки вручную не нужно. Если это не удалось, прокси всё равно слушает: направьте браузер или приложение на него вручную, по адресу и порту, которые он сообщает.

Перехват также можно запускать и останавливать из иконки в системном трее.

3. Откройте браузер или приложение

Откройте сайт или приложение, трафик которого нужно посмотреть. Запросы появляются по мере поступления, а для выбранного видны заголовки, тело, статус, тайминг и остальные детали.

Что именно записывается — в разделе Перехват и просмотр трафика.

Адрес и порт

По умолчанию прокси слушает на всех сетевых интерфейсах (0.0.0.0), порт 7070.

И то, и другое меняется в Настройки → Прокси.

Linux: консольные и Flatpak-приложения

Консольные утилиты и Flatpak-приложения не читают системные настройки прокси GNOME, поэтому в режиме системного прокси их трафик идёт мимо Solpuga. Перехватить его можно двумя способами.

Прозрачный режим. В Настройки → Прокси → Режим перехвата выберите Прозрачный режим — все приложения. Тогда в прокси перенаправляется HTTP/HTTPS-трафик всех приложений. При первом включении система запросит пароль администратора, чтобы установить сетевую службу Solpuga.

Ручная настройка. Оставьте режим Системный прокси и направьте консольные и Flatpak-приложения через Solpuga сами. В командах указан порт по умолчанию — 7070; если вы меняли его в Настройки → Прокси, подставьте свой. В no_proxy через запятую перечислены хосты, к которым запросы идут напрямую.

Текущая оболочка и приложения, запущенные из неё:

export http_proxy=http://127.0.0.1:7070
export https_proxy=http://127.0.0.1:7070
export no_proxy='localhost,127.0.0.1'

Приложения, которые вы запустите позже в этом сеансе:

systemctl --user set-environment http_proxy=http://127.0.0.1:7070 https_proxy=http://127.0.0.1:7070 no_proxy='localhost,127.0.0.1'

Разовый запуск Flatpak-приложения — замените <app-id> на его ID:

flatpak run --env=http_proxy=http://127.0.0.1:7070 --env=https_proxy=http://127.0.0.1:7070 --env=no_proxy='localhost,127.0.0.1' <app-id>

Когда закончите перехват, отмените настройку сеанса:

systemctl --user unset-environment http_proxy https_proxy no_proxy

В той оболочке, где вы задавали переменные, выполните unset http_proxy https_proxy no_proxy или закройте её.

Версии Solpuga до 1.0.1 включительно предлагали для Flatpak-приложений не разовый запуск, а постоянное переопределение flatpak override. Если вы его задали, Flatpak-приложения отправляют запросы на порт Solpuga, даже когда перехват выключен. Проверьте:

flatpak override --user --show

Если в списке только http_proxy и https_proxy, удалите переопределение:

flatpak override --user --reset

Если там есть и другие настройки, удалите только эти две строки из файла ~/.local/share/flatpak/overrides/global.

Что дальше