Skip to content

About

PAC-расширение для выборочного доступа через прокси в Chromium и Firefox

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

 
 

Repository files navigation

Логотип Unroute Unroute

Версия: 3.0.0 · Chromium и Firefox · GPL-3.0-or-later

Unroute — кроссбраузерное расширение Manifest V3 для Chromium и Firefox. Оно устанавливает PAC-скрипт в настройки браузера и по его правилам направляет отдельные сайты напрямую (DIRECT) или через прокси.

Статус проекта и условия использования

Автор разрабатывает Unroute прежде всего для собственных задач и публикует его для тех, кому он может быть полезен. Это личный проект, а не сервис с обязательствами перед пользователями.

Контакт автора: sod.stack@gmail.com. Наличие контакта не означает гарантированной поддержки или ответа.

  • Поддержка, сроки ответа, совместимость с будущими версиями браузеров, исправление ошибок и выпуск обновлений не гарантируются.
  • Предложения и сообщения об ошибках можно оставлять, но они не обязывают автора реализовывать запрошенные функции или изменения. Приоритеты и объём работ автор определяет самостоятельно.
  • Расширение предоставляется «как есть», без гарантий доступности сайтов, непрерывности работы, безопасности сторонних сервисов или пригодности для конкретной задачи.
  • Пользователь самостоятельно выбирает PAC-источники и прокси, оценивает риски и соблюдает применимое законодательство и правила своей сети.
  • В максимальной степени, допускаемой применимым законодательством, автор не несёт ответственности за использование расширения, действия пользователя, работу сторонних сервисов, потерю данных и связанные убытки. Это условие не исключает ответственность, которую нельзя исключить по закону; условия лицензии приведены в LICENSE.

Сторонние PAC-источники

«Антизапрет» и «Антицензорити» — самостоятельные сторонние проекты, не управляемые автором Unroute. Упоминание и наличие их пресетов не означают аффилированности, проверки безопасности или гарантии их работы.

При использовании соответствующего режима Unroute загружает и обновляет PAC-скрипт проекта; отдельные расширения этих проектов не устанавливаются. PAC определяет маршруты и может направлять браузерные соединения через указанные в нём сторонние прокси.

Автор Unroute не контролирует содержимое и изменения этих PAC-скриптов, распространяемые сторонними проектами материалы, их инфраструктуру, состав прокси, обработку и сбор данных. Автор не гарантирует, что сторонние проекты и операторы прокси не ведут журналирование и не собирают сведения о соединениях. Их актуальные условия и политику обработки данных пользователь проверяет самостоятельно.

Использование сторонних PAC-источников и прокси — решение пользователя на свой страх и риск. Ограничение ответственности действует в пределах, допускаемых законом. Источник PAC получает запросы на загрузку и обновление; оператор прокси может получать адреса подключений и метаданные, а при незашифрованном HTTP — содержимое трафика. Подробнее: политика приватности.

Поддерживаемые браузеры

Интерфейс поддерживает русский и английский языки. Язык выбирается автоматически по языку браузера; для остальных языков используется русский.

  • Chromium 108+: Google Chrome, Microsoft Edge, Brave, Яндекс.Браузер, Opera и Vivaldi;
  • Firefox Desktop 140+.

Firefox для Android не поддерживается: используемая настройка PAC через proxy.settings недоступна на этой платформе.

Фактическая совместимость может зависеть от версии, платформы и политики браузера. В Firefox пользователь должен отдельно разрешить расширению работу в приватных окнах: Firefox требует этот доступ для изменения общих настроек прокси, даже если приватные окна не используются.

Важно: это не VPN. Расширение управляет только трафиком браузера, не влияет на другие приложения и не гарантирует доступность каждого сайта, анонимность или сокрытие IP для соединений, которые PAC оставляет прямыми.

Что умеет расширение

  • Загружать и применять PAC от «Антизапрета» или «Антицензорити».

  • Работать только с добавленными пользователем сайтами и собственными прокси.

  • Загружать готовый пользовательский PAC по прямой ссылке.

  • Для выбранного домена принудительно включать прокси, прямое подключение или снова передавать решение PAC.

  • Подключать прокси HTTP, HTTPS, SOCKS4 и SOCKS5, в том числе локальные Tor и WARP.

  • Давать прокси уникальные имена и направлять разные домены через разные серверы; переносить сайты по одному или группой и фильтровать список по прокси.

  • Проверять доступность пользовательских прокси и поддерживать HTTP/HTTPS-прокси с логином и паролем.

  • Импортировать и экспортировать списки доменов в формате .txt.

  • Показывать локальный журнал ошибок PAC, прокси и авторизации с копированием отдельных записей и экспортом журнала.

  • Предупреждать о потере контроля над настройками прокси или сбоях обновления PAC.

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

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

  1. Установите расширение и откройте его окно с панели браузера. В Firefox также разрешите ему работу в приватных окнах.
  2. На вкладке PAC выберите источник. Для первого запуска обычно достаточно «Антизапрета» или «Антицензорити» — добавлять собственный прокси для них не обязательно.
  3. Дождитесь сообщения об успешном применении PAC.
  4. Если отдельный сайт открывается неправильно, используйте селектор в popup или откройте Сайты → Ручные правила:
    • Прокси — принудительно использовать настроенный пользовательский прокси;
    • Напрямую — не использовать прокси;
    • По PAC — вернуть решение выбранному PAC-скрипту.
  5. Диагностика доступна во вкладках Логи и Проверка.

После изменения правил расширение пересобирает и повторно применяет PAC автоматически.

В popup подключение сайта выбирается одним селектором под доменом: «Автоматически — по PAC», «Без прокси» или «Прокси: название». Отдельной панели из трёх дублирующих кнопок нет. Селектор доступен и без собственных профилей; существующая общая цепочка и недоступный профиль показываются явно, без подмены на другой маршрут. Полные имена профилей доступны в широком селекторе сайта.

Маршрутизация всей страницы включается только при настроенном собственном прокси, Tor или WARP. Без них выбор подключения меняет только правило основного домена, а остальные ресурсы обрабатываются стандартным PAC как раньше. DevTools открывать не нужно. После смены режима перезагрузите страницу: уже начатые соединения не переключаются задним числом.

В секции «Автоматические ресурсы» есть одна общая настройка: «Как у сайта / Без прокси». По умолчанию авторесурсы наследуют маршрут основного домена. В режиме «Без прокси» они идут напрямую, основной домен сохраняет свой маршрут. Настройка не сбрасывается и не скрывается, когда сам сайт подключён без прокси: она определяет поведение ресурсов после следующего изменения подключения сайта. Переключателей наследования у отдельных ресурсов нет: точечные назначения создают ручные исключения. Ручные точные и wildcard-правила сохраняются в обоих режимах.

В списке ресурсов автоматические строки показывают «Автоматически», а настроенный маршрут и его источник — в подсказке. Ручные исключения показывают конкретный прокси, «Без прокси» или «Общий список прокси» и значок закрепления. Недоступное назначение всегда обозначается явно, даже если оно автоматическое. Выбор того же прокси, который ресурс использует автоматически, создаёт ручное исключение; совпадение ID не означает наследование. Сам основной домен не дублируется в списке ресурсов.

Действие «Убрать исключение» удаляет только точное ручное назначение ресурса. Оставшийся ручной wildcard продолжает действовать; иначе применяется общая настройка ресурсов. Для wildcard без точного исключения такой сброс не предлагается. После успешных изменений появляется компактная строка «Изменения сохранены · Перезагрузить»; пока настройки ожидают применения, действие перезагрузки недоступно.

Chromium: при включённом наследовании выбор прокси или «Без прокси» переключает основной домен и принадлежащие этому сайту обнаруженные авторесурсы. При выключенном авторесурсы остаются прямыми. Новые домены обрабатываются пакетно; первый запрос к ещё неизвестному домену использует обычный PAC, поэтому после изменения перезагрузите сайт. Независимые ручные правила ресурсов сохраняются, включая поддомены самого сайта, wildcard, прямые и старые правила без конкретного профиля. Общий CDN остаётся глобальным доменным правилом: автоматическое обнаружение другого сайта не перехватывает его назначение. «Автоматически — по PAC» возвращает маршрут сайта к PAC, не затрагивая ручные правила ресурсов; их автоматические маршруты определяются общей настройкой ресурсов. При отключении прокси привязки не удаляются автоматически.

Firefox: при включённом наследовании ресурсы вкладки следуют маршруту основного домена, включая вложенные страницы и HTTP(S)/WebSocket-запросы. При выключенном автоматические ресурсы идут напрямую. Явное ручное правило домена запроса имеет приоритет в обоих случаях: DIRECT, конкретный прокси или старая общая цепочка. Автоматически обнаруженное правило CDN не навязывает маршрут другим вкладкам, но его явно изменённое назначение учитывается. Домены ресурсов автоматически не добавляются в списки Firefox: общий CDN может идти через разные прокси в разных вкладках. Для назначенного профиля не добавляются другие пользовательские или публичные PAC-прокси; возможность прямого отката при сетевом отказе определяется Proxy Or Die. Неизвестный или выключенный назначенный профиль блокирует маршрут без подмены. Без правила сайта и при включённом наследовании сохраняется обычное поведение PAC. Спекулятивные соединения и запросы без достоверного tabId обрабатываются обычным PAC. При отключении расширения или потере контроля вкладочная маршрутизация не применяется.

Настройка задаётся по доменам. Запросы к самому hostname основного сайта используют его маршрут: отделить такие ресурсы от основного домена этим переключателем нельзя. В Chromium правила обнаруженных ресурсов глобальны, а не изолированы по вкладке; в Firefox вкладочное разрешение учитывает настройку сайта. Переключатель недоступен при выключенных правилах сайтов, без собственного маршрутизатора и в приватных вкладках.

Для списка обнаруженных ресурсов отслеживаются до 300 доменов на вкладку и до 100 вкладок; при достижении лимита появляется отметка. Локальные адреса и IP-адреса не добавляются автоматически. Ресурсы приватных вкладок не собираются и не сохраняются: в Chromium кнопки меняют только основной домен; в Firefox вся приватная вкладка следует правилу сайта, а основной домен для маршрутизации держится только в памяти. Лимиты списка ресурсов не ограничивают вкладочную маршрутизацию Firefox.

Глобальные опции «Только HTTPS» и «Ограничиться только белым списком» имеют приоритет над вкладочным режимом Firefox: HTTP/WebSocket-запросы при включённом HTTPS-only и адреса вне белого списка остаются прямыми. Кнопки карточки сайта доступны только для доменных имён; IP-правила редактируются в полном списке.

Режимы PAC

Режим Назначение Что учитывать
Антизапрет Маршрутизация по PAC проекта «Антизапрет» Состав правил и работоспособность прокси зависят от внешнего поставщика
Антицензорити Альтернативный PAC с собственной базой адресов и прокси PAC может быть значительно больше и обрабатываться дольше
Только свои сайты Проксирование только доменов, которые пользователь добавил вручную Требуется хотя бы один доступный пользовательский прокси или локальный Tor
Свой PAC по ссылке Использование готового PAC из указанного URL Источник получает запрос на загрузку; поверх его правил применяются пользовательские настройки расширения
Отключить Освобождение настроек прокси Трафик возвращается к настройкам браузера или системы

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

Для встроенных провайдеров установлен лимит загрузки 25 МиБ, для пользовательской ссылки — 10 МиБ. Пользовательский PAC должен содержать функцию FindProxyForURL. Для внешних адресов разрешён только HTTPS; HTTP разрешён только для loopback-адресов (localhost, 127.0.0.1, [::1]), но не для частных сетей. Выбирайте доверенный источник: изменённый или вредоносный PAC способен направить браузерный трафик через посторонний прокси.

Пользовательские прокси и Proxy Or Die

Можно сохранить до 50 пользовательских прокси, включая отключённые фильтрами. Встроенные Tor/WARP не занимают эти места. Превышение отклоняется целиком, без обрезания списка и изменения действующих настроек. Старые списки сверх лимита сохраняются: их можно редактировать и уменьшать, но не увеличивать сверх текущего количества. После уменьшения допустимый порог также снижается, пока не достигнет 50.

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

Независимые листы доменов

В Сайты можно создать отдельные именованные листы или загрузить каждый из своего UTF-8 .txt. Каждому листу назначается один профиль прокси. Нажатие на название открывает привычный редактор только его доменов; импорт внутри листа заменяет только этот лист после подтверждения. Повторы между листами сохраняются независимо.

Приоритет задаётся кнопками ↑/↓: побеждает первый включённый совпавший лист, даже если в нижнем правило специфичнее. Выключенный лист пропускается; недоступный назначенный прокси не подменяется другим. Закреплённые Ручные правила и действия popup перекрывают листы, не изменяя их содержимое. Явный выбор «Автоматически — по PAC» создаёт PAC-исключение поверх листов; для возврата к листам удалите его в ручных правилах.

До 100 листов и 100 000 доменов суммарно; название — до 64 символов, файл — до 5 МиБ. Подробности приоритета, ресурсов, импорта и хранения: Независимые листы доменов.

Разные сайты через разные прокси

  1. В Прокси добавьте серверы и при необходимости переименуйте их. ID сохраняется при переименовании; повторяющиеся имена и подключения отклоняются. У Tor и Cloudflare WARP фиксированные системные ID и имена.
  2. Первый добавленный доступный прокси становится выбранным по умолчанию для новых правил. Его можно изменить; существующие привязки при этом не меняются.
  3. В Сайты → Ручные правила → Через прокси выберите назначение перед добавлением или импортом ручных правил. При нескольких доступных серверах селектор отображается явно. Для независимой коллекции с одним прокси создайте отдельный лист на верхнем уровне Сайты.
  4. Для переноса одного сайта используйте его селектор. Для нескольких — отметьте строки либо выберите все найденные, затем задайте новый прокси на панели переноса. Выбор всех найденных охватывает весь результат фильтра, а не только загруженные строки.
  5. Фильтр по прокси сочетается с поиском и происхождением правил. Список остаётся ограниченным по высоте; остальные строки доступны прокруткой.
  6. В popup раскройте «Ресурсы сайта». У каждого домена есть селектор: «Напрямую» (без прокси) и доступные профили прокси. Прямой маршрут можно выбрать и без нескольких профилей. Выбор сохраняет отдельное точное ручное правило этого домена. Для стороннего ресурса это не меняет основной сайт, соседние ресурсы, wildcard-правило или default. Это глобальное правило: оно применяется к этому домену и в других вкладках. Ручной DIRECT сохраняется при смене прокси основного сайта. Подпись «По списку прокси» означает старое правило без назначения конкретного профиля: используется общий список прокси, а не прямое соединение; подробность доступна при наведении. После сохранения можно перезагрузить сайт для обновления существующих соединений.

Новое или изменённое имя прокси ограничено 32 символами после нормализации. В закрытых селекторах popup показывается до 6 видимых символов: пять и «…» для длинного имени. Полные имена доступны в раскрытом списке и при наведении, поэтому одинаковые короткие префиксы не мешают выбирать разные профили. Старые сохранённые длинные имена не обрезаются при загрузке или изменении других настроек; при явном переименовании действует новый лимит.

В настройках старые положительные правила без назначения отображаются как «Общая цепочка (без назначения)», в popup — «По списку прокси»; они сохраняют прежнюю маршрутизацию до явного переноса. Обычный импорт не переназначает уже существующие сайты. Перенос входит в историю последних пяти операций; отмена не затирает более поздние решения и не восстанавливает удалённый профиль.

Если обработка правил сайтов отключена, селекторы ресурсов в popup недоступны и показывается пояснение. Включите правила в настройках; popup не включает их скрыто вместе со всеми ранее сохранёнными сайтами.

Удаление используемого прокси требует явной замены. Raw-редактор отклоняет удаление endpoint с привязанными сайтами; изменение списка подключений не считается разрешением переназначить их. Если в raw-режиме удалён непривязанный default, первым доступным оставшимся сервером становится default только для будущих правил. В структурированной форме для удаления default предусмотрен явный выбор замены.

Проверка и ограничения

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

Режим Proxy Or Die запрещает откат к прямому соединению, когда для адреса уже выбран прокси, но прокси недоступен. Это снижает риск непреднамеренного прямого подключения, однако может полностью остановить загрузку ресурса. Домены, явно помеченные пользователем как прямые, продолжают открываться напрямую.

Оператор прокси может видеть адреса подключений и метаданные трафика, а при незашифрованном HTTP — и содержимое. Используйте только серверы, которым доверяете.

Индикация и диагностика

Значок расширения отмечает домены вкладки, для которых использование прокси удалось определить по известному адресу прокси или пользовательскому правилу. Это диагностическая подсказка, а не точный аудит каждого соединения: одна страница может одновременно загружать основной документ напрямую, а изображения, API или другие поддомены — через прокси.

Во вкладке Логи сохраняются ошибки загрузки и применения PAC, проверки прокси, авторизации и потери контроля над настройками. Записи можно фильтровать, копировать по одной или экспортировать целиком.

Если сайт не открывается:

  1. Проверьте дату последнего обновления PAC и вкладку Логи.
  2. Попробуйте другой встроенный PAC-источник.
  3. Если используется собственный прокси, запустите его проверку во вкладке Прокси.
  4. Проверьте, не управляет ли прокси другое расширение или политика браузера.
  5. Временно отключите Proxy Or Die только для диагностики: это может разрешить прямое подключение.

Приватность и сетевые обращения

Полная политика приватности описывает локальное хранение, сетевые обращения и передачу данных сторонним сервисам.

В проекте нет аналитических SDK, рекламных счётчиков или отправки истории посещений разработчику. Настройки, правила, сведения о прокси и диагностический журнал хранятся локально в хранилище расширения (storage.local).

При этом расширение не работает полностью офлайн и выполняет необходимые сетевые обращения:

  • загружает PAC с серверов выбранного провайдера или пользовательского URL;
  • при добавлении или явной проверке пользовательского прокси обращается через него к тестовому адресу Cloudflare 1.1.1.1;
  • открывает внешние сайты только по команде пользователя из меню или интерфейса: переводчик или страницу справки;
  • передаёт браузерный трафик через прокси, выбранные PAC-скриптом или пользователем.

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

Разрешения браузера

Разрешение Зачем используется
proxy Установка и обновление PAC-конфигурации браузера
storage, unlimitedStorage Локальное хранение PAC, настроек, правил и журнала
alarms Периодическая фоновая проверка обновлений PAC
tabs Работа с доменом активной вкладки и индикация на значке
webRequest Диагностика сетевых и прокси-ошибок
webRequestAuthProvider Передача логина и пароля пользовательскому прокси
contextMenus Команды расширения в контекстном меню страницы
notifications Включаемые пользователем уведомления о сбоях
<all_urls> Загрузка PAC по выбранному адресу, применение правил ко всем сайтам и проверка сетевых ответов

Доступ webNavigation не запрашивается. В Firefox разрешение на работу в приватных окнах включается пользователем отдельно и необходимо для управления общими настройками прокси.

Установка из исходного кода

Требования

  • Node.js 22.12 или новее;
  • npm 9 или новее;
  • Chromium 108 или новее либо Firefox Desktop 140 или новее.

Сборка

Из корневого каталога исходников:

npm ci
npm run build:all

Готовые распакованные сборки появятся в каталогах:

dist/chromium  # Chromium
dist/firefox   # Firefox

Все команды выполняются из корня проекта. Общий код находится в src/common, особенности Firefox — в src/firefox.

Установка в Chromium

  1. Откройте chrome://extensions/ или соответствующую страницу расширений вашего браузера.
  2. Включите Режим разработчика.
  3. Нажмите Загрузить распакованное расширение.
  4. Выберите каталог dist/chromium, указанный выше.
  5. После следующей сборки нажимайте Обновить на карточке расширения, чтобы браузер загрузил изменения.

Путь распакованной сборки участвует в формировании ID расширения. Подключение сборки из другой папки создаёт отдельную установку с отдельным хранилищем настроек.

Установка в Firefox

ID текущего дополнения: unroute@xsodx-stack.github.io. Пакет с другим ID считается отдельным дополнением: существующая установка не обновится им, а её настройки не перенесутся автоматически.

  1. Откройте about:debugging#/runtime/this-firefox.
  2. Нажмите Загрузить временное дополнение.
  3. Выберите manifest.json в каталоге dist/firefox.
  4. Откройте карточку дополнения в about:addons и разрешите Работу в приватных окнах.
  5. После следующей сборки нажмите Перезагрузить на странице about:debugging.

Для запуска в отдельном тестовом профиле можно использовать npm run start:firefox. Упакованный ZIP создаётся командой npm run package:firefox в каталоге artifacts/firefox. Этот ZIP предназначен для проверки и отправки на подпись: обычные Firefox Release и Beta устанавливают только дополнения, подписанные Mozilla.

Управление и настройки

Кнопка расширения открывает текущий сайт и селектор подключения: Автоматически — по PAC, Без прокси или выбранный профиль. У сайта можно раскрыть список найденных ресурсов и задать им отдельные правила. После изменения перезагрузите страницу. Подробнее: управление сайтом и ресурсами.

В полных настройках доступны PAC, каталог прокси, пользовательские листы, журнал и история. Подробности добавления, проверки и ограничений: руководство по прокси. Настройки оформления включают системную, светлую и тёмную темы и собственный акцент; оформление сохраняется локально и не меняет маршруты.

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

Происхождение проекта и лицензия

Происхождение кода и атрибуция приведены в docs/credits.md. Исходные авторские права и лицензионные уведомления сохраняются.

Код распространяется на условиях GNU General Public License v3.0 or later (GPL-3.0-or-later). Полный текст доступен в файле LICENSE.

About

PAC-расширение для выборочного доступа через прокси в Chromium и Firefox

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages