Censor Tracker — это мощное браузерное расширение для обхода цензуры.
Помимо этого, оно позволяет использовать собственные прокси и поддерживает Vless, Vmess и Shadowsocks в браузере через внешний клиент Censor Tracker Proxy.
English · Русский
Сборки этого форка прикреплены к каждому релизу на GitHub. Оригинальное расширение также доступно в официальных магазинах — ссылки на бейджах выше.
Если к релизу приложен файл .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».
- Скачайте из последнего релиза файл
.zipи распакуйте его. - Откройте
chrome://extensions/и включите Режим разработчика. - Нажмите «Загрузить распакованное расширение» и выберите распакованную папку.
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 отказывается устанавливать неподписанные дополнения и
показывает вводящее в заблуждение сообщение «это дополнение, по-видимому,
повреждено». Поэтому обычный .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 AMOWEB_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.