English

---

dropweb proxy — минимальное расширение для Chrome и Firefox (Manifest V3), которое включает и выключает браузерный прокси одной кнопкой. Один локальный профиль (HTTP или SOCKS5), никакого сбора данных, никаких серверов — только чистый переключатель.

---

Возможности

• Один профиль прокси: тип (HTTP или SOCKS5), хост, порт и список исключений
• По умолчанию — HTTP 127.0.0.1:7890, исключения localhost, 127.0.0.1, ::1
• Кнопка-переключатель в попапе; иконка на панели отражает состояние — ч/б когда выключено, цветной логотип dropweb когда включено, оранжевый при проблеме
• Автоматическая защита от утечки WebRTC, пока прокси включён (Chrome — трафик WebRTC идёт через прокси; Firefox — WebRTC отключается)
• Правка профиля на странице настроек; сохранение при включённом прокси сразу применяет изменения
• Родная локализация RU / EN

---

Установка

Расширение ещё не в сторах — загрузите распакованную сборку из Releases или соберите сами (см. ниже).

Chrome / Chromium / Edge

1. Откройте chrome://extensions и включите Режим разработчика (справа вверху).
2. Нажмите Загрузить распакованное расширение и выберите папку chrome-mv3.
3. Откройте попап на панели и нажмите кнопку питания.

Firefox

1. Откройте about:debugging#/runtime/this-firefox.
2. Нажмите Загрузить временное дополнение… и выберите firefox-mv3/manifest.json.
3. Если при включении запрошен доступ в приватных окнах — откройте about:addons, выберите расширение и включите Запускать в приватных окнах.

---

Разрешения и приватность

Расширение не собирает и не передаёт данные — все настройки хранятся локально. Запрашиваются только минимально необходимые разрешения, без доступа к сайтам (host permissions):

• proxy — применять выбранный прокси к сетевым запросам браузера
• storage — хранить профиль и состояние вкл/выкл локально
• privacy — управлять политикой WebRTC, чтобы реальный IP не утекал в обход прокси
• alarms — фоновая проверка доступности, которая обновляет только иконку

Логика fail-closed: «включено» означает, что настройки применены, а не что конечная точка доступна. Проверка доступности носит справочный характер и никогда не блокирует включение/выключение.

Полная политика конфиденциальности — расширение не собирает данные.

---

Сборка из исходников

Нужен Bun.

bun install
bun run build:chrome    # -> .output/chrome-mv3
bun run build:firefox   # -> .output/firefox-mv3
bun run build           # обе сборки

bun run dev             # Chrome с горячей перезагрузкой
bun run check           # Biome + tsc (strict)
bun run test            # юнит-тесты (Vitest)

Лицензия

MIT — свободная лицензия: код можно использовать, изменять и распространять, в том числе в коммерческих целях, с сохранением копирайта. См. LICENSE. Сторонние компоненты — THIRD-PARTY-NOTICES.md.

---

_{dropweb proxy — инструмент для приватности личного трафика. Порядок использования определяется законодательством вашей страны; ответственность за использование несёт пользователь.}