Skip to content

About

Расширение для выборочной маршрутизации через PAC и прокси для обхода интернет-блокировок.

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

 
 

Repository files navigation

Логотип АнтиЧебурнет АнтиЧебурнет

Version License: GPL-3.0 Browsers Telemetry: None

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

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

  • Chromium 102+: Google Chrome, Microsoft Edge, Brave, Яндекс.Браузер, Opera и Vivaldi;
  • Firefox Desktop 140+;
  • Firefox for Android 142+ заявлен в манифесте и требует дополнительной проверки на конкретном устройстве.

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

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

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

  • Загружать и применять PAC от «Антизапрета» или «Антицензорити».
  • Работать только с добавленными пользователем сайтами и собственными прокси.
  • Загружать готовый пользовательский PAC по прямой ссылке.
  • Для выбранного домена принудительно включать прокси, прямое подключение или снова передавать решение PAC.
  • Подключать прокси HTTP, HTTPS, SOCKS4 и SOCKS5, в том числе локальные Tor и WARP.
  • Проверять доступность пользовательских прокси и поддерживать HTTP/HTTPS-прокси с логином и паролем.
  • Импортировать и экспортировать списки доменов в формате .txt.
  • Открывать официальный сервис проверки блокировок Роскомнадзора с адресом текущей страницы, уже подставленным в форму; CAPTCHA и отправка запроса остаются ручными.
  • Показывать локальный журнал ошибок PAC, прокси и авторизации с копированием отдельных записей и экспортом журнала.
  • Предупреждать о потере контроля над настройками прокси или сбоях обновления PAC.

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

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

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

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

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

Chromium: кнопки «Прокси» и «Напрямую» переключают основной домен и все обнаруженные ресурсы. Новые домены добавляются пакетно в обычные списки; существующие правила при автоматическом обнаружении сохраняются. Повторное нажатие переключает весь обнаруженный набор. Правила глобальные: общий CDN получит тот же режим и на других сайтах. «По PAC» удаляет правила сайта и обнаруженных ресурсов. Уже сохранённые правила не удаляются автоматически при отключении собственного прокси.

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

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

Режимы PAC

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

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

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

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

Проверка прокси временно применяет тестовую конфигурацию, выполняет контрольный 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 102 или новее либо Firefox Desktop 140 или новее.

Сборка

git clone https://github.com/xSoDx-stack/runet-censorship-bypass.git
cd runet-censorship-bypass
npm install --prefix extensions/browser/runet-censorship-bypass
npm run build:all

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

extensions/browser/runet-censorship-bypass/build/extension-chromium  # Chromium
extensions/browser/runet-censorship-bypass/build/extension-firefox   # Firefox

Общий проект расширения находится в нейтральном каталоге extensions/browser; платформенные различия накладываются во время сборки. Команда npm run build остаётся Chromium-only для обратной совместимости.

Установка в Chromium

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

Установка в Firefox

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

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

Подписание Firefox-релиза

GitHub Actions отправляет Firefox-сборку в AMO по каналу unlisted, получает подписанный файл anticheburnet-v<version>-firefox-mv3.xpi и прикладывает его к GitHub Release. Подписание выполняется для push в development, тегов v* и ручного запуска workflow; в pull request секреты AMO не используются.

Для workflow должны быть настроены Repository secrets AMO_JWT_ISSUER и AMO_JWT_SECRET. Это выданные AMO API-реквизиты для получения сертификата Mozilla; сам секрет или файл закрытого ключа в Git хранить не нужно. Каждая отправляемая в AMO сборка должна иметь новую версию.

Тот же путь можно проверить локально командой npm run sign:firefox, предварительно задав переменные окружения WEB_EXT_API_KEY и WEB_EXT_API_SECRET. Команда отправляет сборку в AMO и сохраняет подписанный XPI в web-ext-signed-artifacts.

Описание GitHub Release

Перед выпуском новой версии добавьте файл .github/release-notes/v<version>.md, где <version> совпадает с версией в корневом package.json. Опишите изменения пунктами, например:

## Что сделано

- Исправлена проверка домена через Роскомнадзор.
- Снижена нагрузка на браузер при обработке запросов.

Включите этот файл в коммит вместе с изменениями приложения. После пуша в development или пуша тега v<version> workflow проверит сборку и автоматически перенесёт содержимое файла в описание нового релиза. При ручном запуске используется тот же файл. Если описания нет или в нём отсутствуют пункты - ..., проверка завершится с понятной ошибкой до сборки и подписания. Уже опубликованные релизы workflow не перезаписывает.

Команды разработчика

Подготовка для Chrome Web Store и Firefox Add-ons: инструкция и тексты карточек, инструкция для модераторов. Команда npm run store:package собирает ZIP для обоих магазинов и архив исходников в store-artifacts/v<version>/. npm run store:screenshots создаёт изображения карточки в отдельном профиле Chrome.

npm run build                # собрать Chromium (обратная совместимость)
npm run build:chrome         # собрать build/extension-chromium
npm run build:firefox        # собрать build/extension-firefox
npm run build:all            # собрать обе версии
npm run lint                 # запустить ESLint
npm run lint:firefox         # проверить Firefox-сборку через web-ext
npm test                     # запустить модульные тесты
npm run test:browser:chrome  # запустить браузерный smoke-тест Chrome
npm run start:firefox        # собрать и запустить Firefox в тестовом профиле
npm run package:firefox      # собрать Firefox ZIP
npm run sign:firefox         # получить подписанный Mozilla Firefox XPI
npm run version:check        # проверить синхронность версии во всех файлах
npm run bump:patch           # увеличить patch-версию и синхронизировать файлы

Единственный источник версии проекта — поле version в корневом package.json. Если оно было изменено вручную, выполните npm run version:sync. Проверка синхронности также автоматически запускается перед сборкой, тестами и линтингом.

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

Проект является переработанным форком anticensority/runet-censorship-bypass. Исходные авторские права принадлежат авторам оригинального проекта.

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

About

Расширение для выборочной маршрутизации через PAC и прокси для обхода интернет-блокировок.

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages