Skip to content

About

Censor Tracker is a censorship circumvention extension for Google Chrome and Mozilla Firefox.

Resources

Stars

29 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Квокка Censor Tracker

Censor Tracker — это мощное браузерное расширение для обхода цензуры.

Помимо этого, оно позволяет использовать собственные прокси и поддерживает Vless, Vmess и Shadowsocks в браузере через внешний клиент Censor Tracker Proxy.

English · Русский

Chrome Web Store Firefox Add-ons

Установка

Сборки этого форка прикреплены к каждому релизу на GitHub. Оригинальное расширение также доступно в официальных магазинах — ссылки на бейджах выше.

Firefox

Если к релизу приложен файл .xpi — скачайте его и откройте в Firefox: он подписан Mozilla, поэтому ставится в обычный Firefox. Как вариант: about:addons → ⚙️ → «Установить дополнение из файла…».

⚠️ Сейчас .xpi к релизам не прикладывается. В репозитории не настроены ключи подписи AMO, поэтому CI выкладывает только неподписанный .zip (шаг подписи пропускается, о чём пишет в лог сборки). Стабильный Firefox отклоняет неподписанные дополнения с ошибкой «дополнение, по-видимому, повреждено», так что .zip ставится только одним из двух способов:

  • временно — about:debugging#/runtime/this-firefox → «Загрузить временное дополнение…» → выберите .zip. Слетит при перезапуске браузера;
  • постоянно — в Firefox Developer Edition, Nightly или ESR, выставив на странице about:config параметр xpinstall.signatures.required в false. В обычном Firefox этот параметр не действует.

Как настроить подпись, чтобы .xpi появлялся автоматически, — в разделе «Установка релиза в Firefox».

Chrome / Chromium (Chrome, Edge, Opera, Brave, Yandex, Vivaldi)

  1. Скачайте из последнего релиза файл .zip и распакуйте его.
  2. Откройте chrome://extensions/ и включите Режим разработчика.
  3. Нажмите «Загрузить распакованное расширение» и выберите распакованную папку.

Возможности

Censor Tracker предлагает ряд полезных возможностей, среди которых:

  • Гибкая настройка прокси
  • Маршрутизация прокси по странам
  • Настраиваемые списки проксирования и исключений
  • Встроенная устойчивость к цензуре
  • Предупреждения о сайтах, передающих данные пользователей третьим лицам
  • Поддержка прокси Vless, Vmess и Shadowsocks (требуется Censor Tracker Proxy)

Что нового

В этом форке добавлено несколько улучшений надёжности и удобства поверх оригинального расширения:

Работает во всех современных браузерах

Определение среды выполнения больше не путает Chromium (который, начиная с версии 148, тоже предоставляет пространство имён browser в service worker'ах) с Firefox. Теперь расширение корректно запускается в Chrome, Edge, Opera, Yandex, Brave, Vivaldi и других браузерах на Chromium, а также в Firefox и Safari.

Интерфейс больше не «умирает» при падении прокси

  • Попап обёрнут в защитную обработку ошибок и всегда становится видимым, даже если фоновая проверка завершилась с ошибкой — больше никакого пустого попапа, когда прокси или бэкенд недоступны.
  • Каждый сетевой запрос (синхронизация конфига, получение прокси, списки реестра/исключений и keep-alive пинг) ограничен таймаутом, поэтому мёртвая или медленная прокся не может «подвесить» фоновые задачи или заморозить GUI.
  • Исправлена опечатка (browser.storag.local), из-за которой молча ломалась синхронизация глобального списка игнорируемых хостов, а также падение, когда выбранной страны не было в удалённом конфиге.

Восстановление при недоступной прокси

  • Падение собственной прокси больше не игнорируется. Раньше обработчик ошибок прокси сразу выходил, если использовалась собственная прокся, поэтому мёртвая прокся в цепочке (особенно вместе с режимом «проксировать весь трафик») оставляла браузер без интернета, а расширение — без реакции. Теперь цепочка перепроверяется, мёртвые узлы снимаются с галочки, и трафик идёт через те, что отвечают. Сами прокси из списка не удаляются.
  • Нет больше Error on connection to null. Если сервер, на котором произошла ошибка, не был записан в хранилище, он определяется по настроенному адресу, а пересинхронизация конфига запускается в любом случае — именно она и чинит состояние «прокси не настроена».
  • Восстановление ограничено по частоте. Недоступная прокся заставляет браузер сообщать об ошибке на каждый запрос; раньше каждая такая ошибка запускала полный цикл пересинхронизации, и расширение буксовало вместо того, чтобы переподключиться. Теперь — не чаще одного раза в 30 секунд.
  • Обработчик не падает в Firefox. proxy.onError передаёт объект Error, а не { error }; чтение несуществующего поля роняло обработчик. Форматы событий всех браузеров теперь нормализуются.
  • Чистая консоль ошибок расширения. Chromium (и особенно Opera, где кнопка «Ошибки» видна сразу) собирает в список ошибок расширения любые console.warn и console.error. Из-за этого обычные сообщения вроде «PAC has been set successfully!» или «telegra.ph added to the custom registry» выглядели как сбои. Информационные сообщения переведены в console.log, так что в списке остаются только настоящие ошибки.
  • Регистрация обработчиков в Chromium защищена проверками. Отсутствие какого-либо API больше не роняет весь service worker на этапе загрузки — а вместе с ним и все остальные обработчики.

Любая прокси задаётся легко — теперь со списком

Поле собственной прокси принимает практически любой распространённый формат и автоматически определяет протокол, например socks5://user:pass@1.2.3.4:1080, https://proxy:8443 или просто 1.2.3.4:1080.

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

Менеджер списка прокси

Многопоточная проверка прокси и готовые подписки

Проверка прокси на работоспособность:

  • Многопоточно. Прокси проверяются параллельно (а не по одной), поэтому большой список обрабатывается заметно быстрее; у каждой строки виден статус — рабочий (с задержкой в мс) или нерабочий, плюс прогресс-бар по ходу проверки.
  • Трафик не пропадает. Во время проверки всё ваше обычное проксирование продолжает идти через включённую проксю/цепочку — через тестируемые прокси заворачиваются только служебные проверочные адреса. В Chromium PAC ставится в режиме mandatory: если сам скрипт не удалось выполнить, браузер не откатится молча на прямые соединения и не выдаст мёртвую проксю за живую.
  • Кнопки «Остановить» и «Удалить нерабочие». Проверку можно прервать в любой момент; нерабочие удаляются вручную одной кнопкой или сразу по ходу проверки.
  • Готовые подписки. В блоке источников один клик добавляет проверенный, регулярно обновляемый публичный список (monosans — с валидацией, ежечасно; Proxifly — каждые ~5 минут; TheSpeedX — ежедневно).
  • Сворачиваемые списки. Блоки «Мои прокси» и «Источники» можно свернуть, чтобы они не занимали пол-экрана; состояние запоминается.

Фильтр прокси по странам — ещё до проверки

Страна прокси определяется по её IP-адресу через geo-IP, то есть известна до того, как к прокси кто-либо подключился. Это позволяет отсеивать ненужные страны заранее, не тратя на них ни слот проверки, ни таймаут:

  • Кнопка «Определить страны». Одним нажатием подтягивает страну для всех прокси, у которых она ещё не известна (запросы батчами, результат кэшируется), и показывает прогресс.
  • Чёрный список стран. Укажите страны (RU, CN, IR) — прокси из них удаляются сразу и не проверяются вообще.
  • Белый список стран. Обратный режим: оставлять только перечисленные страны, всё остальное удалять.
  • «Оставить только эту страну». Отдельный выпадающий список показывает страны, реально встречающиеся в вашем списке (с флагом и количеством прокси); выбираете одну — все остальные удаляются.
  • Применяется автоматически. Фильтр можно включить для прокси, приходящих из подписок и вставляемых из буфера обмена: страна отсеивается до проверки на работоспособность. Перед запуском «Проверить все» фильтр отрабатывает первым.
  • Прокси с неопределившейся страной по умолчанию сохраняются (чтобы режим «оставить только NL» не удалял записи, которые geo-IP просто не смог разрешить) — их удаление включается отдельной галочкой.
  • Фильтр по стране выхода — уже после проверки. Страна, где прокси находится, и страна, из которой трафик выходит, — разные вещи, и сайт видит вторую. Она известна для проверенных прокси, поэтому рядом появился второй выпадающий список: он показывает страны выхода, реально встретившиеся в вашем списке, и позволяет как оставить только прокси с этой страной выхода, так и удалить именно их. Непроверенные прокси страны выхода не имеют и не трогаются (их удаление включается той же галочкой выше).

Помощник по добавлению связанных доменов в один клик

Чтобы открыть один сайт, часто нужно проксировать целый набор доменов CDN/API, а не один. Теперь попап может просканировать текущую страницу и показать все домены, от которых она зависит, в виде списка с галочками — поставьте галочку, чтобы добавить домен в список проксирования (снимите, чтобы убрать). Прокси применяется мгновенно.

Помощник по связанным доменам

Альтернативный источник списка блокировок

Если стандартный реестр заблокированных ресурсов недоступен, в Расширенных настройках можно указать собственное зеркало. Поддерживаются: JSON-массив доменов, JSON-объект с полем domains/data, JSON-массив объектов или текстовый список, разделённый переносами строк/запятыми.

Альтернативный источник списка блокировок

Прокси с логином и паролем

Прокси, требующая авторизации, задаётся в обычном виде — socks5://user:pass@1.2.3.4:1080 — и расширение само отвечает на запрос браузера, не показывая пользователю системное окно ввода пароля. Отвечает только на запросы от самой прокси и только на те, что пришли от адреса из вашего списка: сайт, ответивший 401, чужих учётных данных не получит.

⚠️ Ограничение Chromium, а не расширения. Chrome и другие браузеры на Chromium не поддерживают аутентификацию SOCKS вообще: при рукопожатии они предлагают только метод «без аутентификации», поэтому такая прокся подключается без логина и отказывает. Расширение не может это обойти, поэтому помечает каждую такую запись прямо в списке, чтобы не выглядело, будто прокси просто «нерабочая». В Firefox SOCKS с логином работает. HTTP/HTTPS-прокси с логином работают в обоих браузерах.

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

Список «Игнорируемые сайты» теперь хранит адреса, а не только домены. Раньше всё введённое пропускалось через тот же фильтр, что и список блокировок, а он оставляет лишь регистрируемые домены — поэтому 192.168.1.1, localhost и nas молча исчезали при сохранении.

Сам список теперь проверяется при маршрутизации, а не только вычитается из списка блокировок. Прежде он ни на что не влиял в режиме «проксировать ВЕСЬ трафик» — вычитать там не из чего. Запись покрывает и поддомены: example.com исключает и cdn.example.com.

Локальные и приватные адреса не проксируются ни в одном режиме: через удалённую проксю до домашней сети всё равно не достучаться, а попытка ведёт ровно к тому, что роутер, NAS или принтер перестают открываться, пока расширение не выключишь. Браузеры сами обходят только localhost и loopback — RFC 1918 в их встроенных исключениях нет, так что этим занимается расширение: приватные диапазоны, CGNAT 100.64.0.0/10 (его же раздаёт Tailscale), локальные суффиксы .lan, .internal, .home.arpa и остальные, а также IPv6 ULA и link-local.

Автоматическая сборка релизов под все браузеры

GitHub Actions workflow (.github/workflows/release.yml) собирает и упаковывает расширение для всех поддерживаемых браузеров. Пуш тега вида v* создаёт готовые к загрузке ZIP-пакеты и прикрепляет их к GitHub Release; этот же workflow можно запустить вручную, чтобы скачать артефакты сборки.

Разрешения

Censor Tracker требует следующие разрешения:

  • alarms — периодические задачи: синхронизация базы и повторный запрос списка прокси-серверов.
  • activeTab — определение сайтов-ОРИ (актуально в первую очередь для пользователей из России).
  • clipboardRead / clipboardWrite — вставка списка прокси из буфера обмена и копирование прокси для обмена.
  • management — выявление конфликтов разрешений (например, с другими расширениями).
  • notifications — показ уведомлений.
  • proxy — настройка и использование прокси-серверов Censor Tracker.
  • scripting (Chromium) — сканирование активной вкладки (только при нажатии «Просканировать страницу») для поиска связанных доменов.
  • storage — сохранение настроек пользователя.
  • tabs (Firefox) — определение сайта в текущей вкладке для попапа.
  • unlimitedStorage — хранение базы заблокированных сайтов (из-за её большого размера).
  • webNavigation (Chromium) — отслеживание переходов по страницам, чтобы вовремя показать предупреждение и обновить состояние попапа.
  • webRequest — ответ на запрос логина и пароля от прокси и отслеживание сетевых ошибок, по которым определяется недоступная прокси.
  • webRequestAuthProvider (Chromium) — без этого разрешения в Manifest V3 нельзя подписаться на onAuthRequired, то есть прокси с логином не заработает.
  • webRequestBlocking (Firefox) — то же самое для Manifest V2.
  • <all_urls> — проксирование сайтов, получение списков прокси-серверов и определение страны пользователя (нужно для проксирования по странам).

Требования

Censor Tracker работает со следующими версиями браузеров:

  • Mozilla Firefox 91.1 и выше
  • Chromium (Google Chrome, Brave, Edge, Opera и др.) 94 и выше

Эти же числа записаны в манифестах (browser_specific_settings.gecko.strict_min_version и minimum_chrome_version) и в целях транспиляции (.babelrc), так что браузер не предложит установить сборку, которую не сможет выполнить. Меняя одно, меняйте все три.

Разработка

📘 Перед правкой маршрутизации (PAC-генератор, списки проксирования и исключений, аутентификация на прокси) прочитайте SKILL.md — справочник по тому, как Chromium и Firefox на самом деле применяют проксирование, со ссылками на официальную документацию и разбором ошибок, на которых этот проект уже обжигался.

Убедитесь, что у вас установлены нужные версии node и npm:

  • node v17.4.0 или выше
  • npm 8.3.1 или выше

Опционально может пригодиться:

Сначала установите зависимости:

~ npm install

Сборка расширения для Chrome:

~ npm run build:chrome
~ cd dist/chrome

Сборка для Firefox:

~ npm run build:firefox
~ cd dist/firefox

Готовые к публикации ZIP-пакеты для обоих браузеров:

~ npm run release

Устранение неполадок: если при сборке через npm возникает ошибка, убедитесь, что ваш shell поддерживает переменные окружения для отдельных команд (то есть что-то вроде NODE_ENV=production npm run build:firefox:prod).

Установка релиза в Firefox

Стабильный Firefox отказывается устанавливать неподписанные дополнения и показывает вводящее в заблуждение сообщение «это дополнение, по-видимому, повреждено». Поэтому обычный .zip, который создаёт npm run release:firefox, напрямую установить нельзя — его сначала должна подписать Mozilla. Если к релизу на GitHub приложен файл .xpi, устанавливайте его, а не .zip.

.xpi появляется в релизе только при настроенной подписи. Без ключей AMO шаг подписи пропускается (сборка при этом не падает), и в релиз попадает лишь неподписанный .zip — именно это происходит в репозитории сейчас. Поставить такой .zip можно временно через about:debugging (см. ниже) или в Firefox Developer Edition / Nightly / ESR с xpinstall.signatures.required, выставленным в false.

Чтобы получить подписанный .xpi, CI запускает web-ext sign на канале --channel=unlisted. Для этого нужны два секрета репозитория (Settings → Secrets and variables → Actions):

  • WEB_EXT_API_KEY — JWT issuer из API AMO
  • WEB_EXT_API_SECRET — JWT secret из API AMO

Сгенерировать пару можно на https://addons.mozilla.org/developers/addon/api/key/. Идентификатор дополнения для подписи задаётся в browser_specific_settings.gecko.id в файле src/firefox/manifest/firefox.json — не меняйте его между релизами, иначе обновления не будут применяться. Подписать можно и локально:

~ npm run build:firefox:prod
~ WEB_EXT_API_KEY=... WEB_EXT_API_SECRET=... npm run sign:firefox

Для быстрой проверки без подписи загрузите распакованную сборку через about:debugging → Этот Firefox → Загрузить временное дополнение… (выберите dist/firefox/prod/manifest.json); оно работает до перезапуска Firefox.

Лицензия

Censor Tracker распространяется по лицензии MIT. Подробнее см. LICENSE.

About

Censor Tracker is a censorship circumvention extension for Google Chrome and Mozilla Firefox.

Resources

Stars

29 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages