ProxySwitcher 1.0.2 — инструкция

ЗАПУСК

Для первой установки распакуйте полный ZIP в новую отдельную папку на локальном стационарном
NTFS-диске. Можно выбрать свою папку с пробелами и кириллицей. Приложение
работает из неё, не создаёт другую установку в Program Files и не исправляет
ACL. Сетевые/съёмные диски, SUBST и пути через ссылки не поддерживаются.
Запускайте только корневой ProxySwitcher.exe обычным двойным щелчком.

Корневой launcher, интерфейс и координатор обновления работают без прав
администратора. Отдельный сетевой брокер ProxySwitcher.Broker.exe запрашивает
обычное подтверждение Windows UAC один раз после подтверждённой готовности окна.
Прокси и TUN при этом не запускаются. Подключение, отключение, перестройка
маршрутов при включении/выключении стороннего VPN и работа в трее используют
тот же компонент без повторного запроса прав. Повторный запуск корневого
ProxySwitcher.exe разворачивает уже запущенное окно из трея. Отмена UAC или
потеря компонента не вызывают повторного повышения; перезапустите приложение
для новой попытки разрешения. Пока системный запрос Windows не завершён,
приложение дожидается его асинхронно и не создаёт второй запрос.
Собственных дополнительных окон и консоли сетевого компонента нет.
Windows может показать отдельное предупреждение о происхождении файла или
неизвестном издателе; подпись описания выпуска не является Authenticode EXE.
Не отключайте UAC и не запускайте внутренние файлы вручную.
Проверяются подписи описания выпуска, хеши и целостность файлов; недостающие
или изменённые файлы могут остановить запуск. Не удаляйте bootstrap.json,
current.json, .updates и releases, в том числе прежнюю начальную версию.

НАСТРОЙКА

В «Прокси» создайте профиль вручную или вставьте готовую строку прокси из буфера
обмена кнопкой «Вставить из буфера». Прокси по умолчанию в новой поставке нет.
Пароль сохраняется только при включённом переключателе и шифруется Windows DPAPI
для вашей учётной записи. Экспорт и резервные копии не содержат логин и пароль.

В «Библиотеке» включайте нужные сервисы кнопкой «Добавить», дополняйте
обновлённые пресеты кнопкой «Дополнить» или убирайте их кнопкой «Убрать» —
изменения сохраняются автоматически. Доступны Google Gemini, Google Antigravity,
ChatGPT + Codex, Claude, Instagram, YouTube, Steam, BLEACH Rebirth of Souls,
мессенджеры (Telegram, Viber, WhatsApp, Teams, Discord, Slack) и браузеры
(Chrome, Firefox, Edge, Яндекс Браузер). На каждой карточке доступен флажок
«Блокировать без прокси»: пока работает ProxySwitcher (в том числе в трее),
трафик отмеченной карточки блокируется при отключённом прокси или обрыве связи
и не выходит с вашего реального IP. Правило браузера выбирает весь его IPv4.

Именованные наборы правил независимы от профилей прокси. Свяжите набор с
нужным профилем, выберите профиль на «Подключении» и нажмите кнопку на карте.
Правки не меняют уже работающий сеанс: остановите его и подключите заново.
Для новых соединений может потребоваться перезапуск выбранного приложения.

РЕЖИМЫ И ОГРАНИЧЕНИЯ

Выбранный IPv4 TCP идёт через прокси. Неподдерживаемый выбранный IPv4 UDP,
QUIC и ICMP блокируется. В режиме «Проксировать весь ПК» это относится ко
всему перехваченному интернет-IPv4, с исключениями локальной сети и самого
транспорта. Режим меняется вне сеанса и не стирает выборочные правила.
Собственные IPv4-адреса компьютера, loopback, multicast и служебная IPv4-сеть
адаптера не перехватываются.
Непроксируемый IPv4 следует актуальным маршрутам Windows, в том числе
маршрутам другого VPN (PlanetVPN, OpenVPN, WireGuard), независимо от порядка
их запуска. По умолчанию само подключение к вашему прокси направляется
напрямую через физический интерфейс провайдера (мимо активного VPN); чтобы
пускать трафик к прокси внутри VPN-туннеля, включите флажок «Пускать
подключение к прокси через активный VPN» в настройках профиля «Прокси».
При включении или выключении стороннего VPN во время сеанса ProxySwitcher
автоматически пересчитывает маршрутную таблицу и обновляет привязки без
разрыва сессии и без повторного UAC. Настройки другого VPN автоматически не
меняются. IPv6 не перехватывается в TUN; при необходимости во вкладке
«Правила» можно включить опцию «Подавлять IPv6 DNS (AAAA) для выбранных правил»,
чтобы выбранные домены и приложения использовали защищённый IPv4-маршрут.
После аварии системного kill switch нет. Это не полноценный VPN с поддержкой
любых протоколов.

HTTP не шифрует транспорт; HTTPS всегда использует TLS. SOCKS4/5 с TLS
работает только при поддержке TLS сервером. Клиент не может добавить
шифрование серверу, который его не поддерживает. Имя и цепочка сертификата
проверяются. Автоматической смены протокола и прямого fallback нет.

«Ваш новый IP» — внешний IPv4, проверенный HTTPS-запросом через текущий
прокси после успешного подключения. Он не записывается в профили/логи и
очищается при остановке. При ошибке IP не выдумывается и напрямую не
проверяется. Доступность IP-сервиса не доказывает доступность всех целей.
Страна профиля — выбранная вами метка; карта иллюстрирует маршрут между
странами, а не реальный путь пакетов. Страна клиента определяется прямым
ограниченным HTTPS-запросом к api.country.is без сохранения IP.

СОЕДИНЕНИЯ, СИСТЕМА И ОШИБКИ

«Соединения» открывается с фильтром «Через прокси». Можно вручную выбрать
«Все маршруты»/«Напрямую», поиск и активные записи. Это ограниченные
наблюдения ядра, а не полный аудит Windows: короткие соединения могут
отсутствовать, неизвестный маршрут не равен DIRECT.

В «Системе» находятся версия, проверка/установка обновлений, тема и действие
крестика. «Запускать при входе в Windows» добавляет запуск окна из этой папки в
пользовательский автозапуск реестра (HKCU\...\Run) без необходимости прав
администратора при переключении. «Автоматически подключаться к прокси при запуске»
выполняет одну автоматическую попытку подключения к выбранному сохранённому
профилю (с сохранённым паролем, если указан логин) после готовности сетевого
компонента. При наличии новой версии при старте появляется диалог с предложением
обновиться сразу или позже через раздел «Система». Трей оставляет приложение
работающим; явный выход или отключение завершает сетевой сеанс.

Обновления проверяются при запуске и раз в два часа. В «Системе» нажмите
«Обновить»: загрузка идёт внутри приложения с показом байтов и прогресса,
затем появляется этап проверки файлов. Само завершение загрузки ещё не
означает готовность: проверяются HTTPS, подпись издателя, размер, SHA-256
и версия, после чего пакет сохраняется для перезапуска. Браузер и ручная
распаковка для совместимых обновлений не нужны.

После проверки доступны «Перезапустить сейчас» и «Позже». Для перезапуска
сначала отключите прокси; несохранённые изменения обрабатываются перед
закрытием окна. До передачи запроса подтверждаются остановка ядра и завершение
сетевого компонента. Неизвестный результат не считается успешной остановкой:
обновление не передаётся, а окно остаётся открытым. Координатор дождётся завершения старого окна и помощника,
применит пакет и откроет новую версию. «Позже» ничего не перезапускает:
приложение продолжает работать, проверенная загрузка сохраняется.
После обычного выхода и следующего запуска готовый пакет проверяется
заново; сам по себе запуск его не применяет. Выберите «Перезапустить сейчас»,
когда будете готовы. Если срок описания выпуска истёк или пакет повреждён,
нужны новая проверка обновлений и явная загрузка. Если после отправки запроса
перезапуска результат неизвестен, не повторяйте запрос в этом запуске:
координатор мог его принять, и при закрытии окна обновление может примениться.
Следуйте сообщению приложения.

Переход с уже установленной 0.6.1 выполняется прямо из её «Системы» через
проверку обновлений и кнопку «Обновить», без ручной распаковки архива.
Первый переход использует прежний интерфейс 0.6.1: новые проценты и выбор
«Перезапустить сейчас / Позже» доступны в 0.7.0 для последующих обновлений.
Сохраняются папка, постоянный загрузчик, прежние версии и пользовательские данные.
Новая версия подтверждается после готовности окна; при незавершённом
подтверждении проверенное восстановление выбирает прежнюю версию. После
сохранённого подтверждения завершает новую. Не удаляйте .updates вручную.

Папка принадлежит пользователю. Локальная защита от понижения не мешает
владельцу заменить весь каталог старой подлинной копией. Если злоумышленник
заменил самый первый launcher до запуска, его собственные проверки не
создают независимую доверенную точку. Получайте архив из доверенного места.
Подпись и удержанные файлы защищают проверяемую цепочку после запуска.

Локальные обработанные журналы: %LOCALAPPDATA%\ProxySwitcher\diagnostics.
Они автоматически не отправляются наружу. При ошибке отдельной цели другие
соединения могут продолжать работать. При транспортном отказе шлюз закрывает
новые запросы, а ядро может удерживать выбранный IPv4 до ручного отключения.
IPv6 всё это время остаётся в сети Windows. При ошибке остановки не запускайте
конкурирующую копию; закройте выбранные приложения и следуйте статусу.

ЛИЦЕНЗИИ

Используется неизменённый sing-box 1.14.3. Лицензии находятся рядом с ядром
и в licenses. Соответствующие исходники только открытого ядра, зависимости
и инструкции сборки доступны отдельным архивом:
https://update.nuclearpolygon.ru/sources/sing-box-1.14.3-corresponding-source.zip
Передавайте его вместе с бинарным ZIP. .NET 8.0.32 входит в поставку, SDK нет.
