Tor Bridge Launcher is a portable Windows application that starts an external Tor Expert Bundle and exposes a local SOCKS5 proxy for browser extensions such as ZeroOmega.
This is not a VPN service and it does not contain Tor itself. Tor builds multi-relay circuits; the launcher shows the observed exit country and approximate measurements for the current circuit.
| Property | Behavior |
|---|---|
| Portable data | Settings, runtime files, Electron profile, and custom languages stay in data/ next to the launcher. No application settings are written to AppData. |
| External Tor | tor.exe, GeoIP files, bridges, and pluggable transports come from a separately downloaded Tor Expert Bundle. |
| Local proxy | SOCKS5 listens only on 127.0.0.1:19050; ControlPort listens only on 127.0.0.1:19051. |
| Static mode | Browser and launcher tests share a long-lived exit circuit where possible. A country can be requested explicitly. |
| Automatic mode | The launcher requests a new circuit after a check error or two consecutive tests below 500 Kbit/s. High latency alone does not trigger a change. |
| Diagnostics | A local report masks bridge lines, certificates, and fingerprints. |
| Languages | The first launch uses English. The Language selector changes the interface immediately without restarting Tor. |
- Download and extract the portable launcher ZIP. Do not run it from inside the ZIP file.
- Use Download Tor Expert Bundle in the launcher, or download the current Windows x64 Expert Bundle from the official Tor Project page.
- Extract the Expert Bundle next to the launcher, or put it anywhere and use Choose folder to select the extracted Bundle root or its
tordirectory. - Click Connect Tor.
- Configure a ZeroOmega profile with the values below.
| ZeroOmega field | Value |
|---|---|
| Protocol | SOCKS5 |
| Server | 127.0.0.1 |
| Port | 19050 |
| Username and password | Leave empty |
| Remote DNS / DNS through proxy | Enable when the extension offers it |
Never bind this proxy to 0.0.0.0 and do not open its port in a router.
Tor-Bridge-Launcher-Portable/
├── Tor Bridge Launcher.exe
├── data/ # created by the launcher; portable settings and runtime state
│ ├── settings.json
│ └── locales/ # optional user-supplied translation JSON files
└── tor-expert-bundle-windows-x86_64-*/
├── data/
│ ├── geoip
│ └── geoip6
└── tor/
├── tor.exe
└── pluggable_transports/
The Expert Bundle is intentionally not bundled into the launcher. It can therefore be updated independently.
Static — shared exit configures Tor to share the same SOCKS identity for the browser and launcher measurements. The launcher retains this circuit for new streams as long as it remains usable. After the initial connection check, static mode creates no scheduled measurement traffic and does not automatically request another circuit; use Check now only when you want a new manual measurement. When a country is selected, it is requested as an exit-country preference and takes effect only after reconnecting Tor.
Automatic leaves exit country unrestricted. The launcher checks the current route periodically and asks Tor for a new circuit when a test errors or two consecutive completed speed tests are below 500 Kbit/s. Tor can always replace a circuit itself if a relay or bridge path fails. Existing long-lived browser connections may keep their former circuit until the page reconnects.
Changing modes while Tor is running shows a confirmation dialog. Select Restart Tor and apply to make the selected mode actually take effect, or Cancel to keep the active configuration.
Paste one bridge per line. The Bridge prefix is optional; the launcher adds it only to its generated Tor configuration. Use bridges from the Tor Project or another source you trust. Bridge credentials are masked in copied and saved diagnostic reports.
The Language selector is always named Language. English is used on a fresh portable installation. Russian is included as an additional built-in translation.
A person can create another translation without editing source code or rebuilding the application: copy src/locales/template.example.json from the source release to data/locales/<code>.json, set $meta.code and $meta.name, translate the values, restart the launcher, and select it under Language. Missing values fall back safely to English.
See docs/TRANSLATING.md and docs/LOCALIZATION_CONTRACT.md for the JSON contract, placeholder rules, and contribution workflow.
Use Diagnostics → Copy report or Save .txt to collect local troubleshooting information. The report states whether Tor is running, the selected mode, the external Bundle name, the local ports, and the latest masked log lines. Do not publish a diagnostic report until you have reviewed its contents.
pnpm install
pnpm lint
pnpm test
pnpm dist:winpnpm test validates the English and Russian locale structure and tests custom locale loading, Tor configuration, bridge parsing, exit statistics, circuit handling, and diagnostic masking. Windows output is generated under dist/win-unpacked/ by pnpm dist:win.
See LICENSE and NOTICE.md. Tor Expert Bundle, Tor, bridges, and external websites are not included in this repository or portable launcher archive.
Tor Bridge Launcher — переносимое Windows-приложение, которое запускает внешний Tor Expert Bundle и предоставляет локальный SOCKS5-прокси для браузерных расширений, например ZeroOmega.
Это не VPN-сервис и Tor не включён в лаунчер. Tor строит цепочки через несколько реле; приложение показывает наблюдаемую страну выхода и ориентировочные измерения для текущей цепочки.
| Свойство | Как работает |
|---|---|
| Portable-данные | Настройки, рабочие файлы, Electron-профиль и пользовательские языки остаются в data/ рядом с лаунчером. Настройки приложения не записываются в AppData. |
| Внешний Tor | tor.exe, GeoIP-файлы, мосты и pluggable transports берутся из отдельно скачанного Tor Expert Bundle. |
| Локальный прокси | SOCKS5 слушает только 127.0.0.1:19050; ControlPort слушает только 127.0.0.1:19051. |
| Статичный режим | Браузер и тесты используют один долгоживущий выходной канал, пока он работоспособен. Можно запросить конкретную страну выхода. |
| Автоматический режим | Лаунчер просит Tor создать новую цепочку при ошибке проверки либо двух подряд результатах ниже 500 Кбит/с. Одна высокая задержка не вызывает смену. |
| Диагностика | Локальный отчёт маскирует строки мостов, сертификаты и отпечатки. |
| Языки | При первом запуске используется английский. Селектор Language меняет интерфейс сразу, без перезапуска Tor. |
- Скачайте и распакуйте portable ZIP лаунчера. Не запускайте программу прямо из ZIP-архива.
- Нажмите в лаунчере Download Tor Expert Bundle либо скачайте актуальный Windows x64 Expert Bundle с официальной страницы Tor Project.
- Распакуйте Expert Bundle рядом с лаунчером либо в любую папку, затем выберите корневую папку Bundle или папку
torчерез Choose folder. - Нажмите Connect Tor.
- Создайте и выберите профиль ZeroOmega со значениями ниже.
| Поле ZeroOmega | Значение |
|---|---|
| Протокол | SOCKS5 |
| Сервер | 127.0.0.1 |
| Порт | 19050 |
| Логин и пароль | Оставьте пустыми |
| Удалённый DNS / DNS через прокси | Включите, если расширение предоставляет эту настройку |
Никогда не меняйте привязку этого прокси на 0.0.0.0 и не открывайте его порт в роутере.
Tor-Bridge-Launcher-Portable/
├── Tor Bridge Launcher.exe
├── data/ # создаётся лаунчером: portable-настройки и рабочее состояние
│ ├── settings.json
│ └── locales/ # необязательные пользовательские JSON-переводы
└── tor-expert-bundle-windows-x86_64-*/
├── data/
│ ├── geoip
│ └── geoip6
└── tor/
├── tor.exe
└── pluggable_transports/
Expert Bundle намеренно не включён в лаунчер, поэтому его можно обновлять независимо.
Static — shared exit настраивает Tor так, чтобы браузер и измерения лаунчера по возможности использовали одну SOCKS-идентичность. Лаунчер удерживает эту цепочку для новых потоков, пока она остаётся пригодной. После первого теста подключения статичный режим не создаёт фоновые запросы измерения и не запрашивает новую цепочку автоматически; используйте Check now, только когда хотите получить новое ручное измерение. При выборе страны Tor получает её как предпочтение для выходного реле; ограничение начинает действовать только после переподключения Tor.
Automatic не ограничивает страну выхода. Лаунчер периодически проверяет текущий маршрут и просит Tor создать новую цепочку при ошибке проверки либо двух подряд завершённых проверках скорости ниже 500 Кбит/с. Tor всегда может заменить цепочку самостоятельно при проблеме с реле или мостом. Долгие уже открытые соединения браузера могут оставаться на прежней цепочке до переподключения страницы.
При смене режима во время работы Tor появляется подтверждение. Нажмите Restart Tor and apply, чтобы настройки нового режима действительно вступили в силу, либо Cancel, чтобы оставить действующую конфигурацию.
Вставляйте по одному мосту в строку. Префикс Bridge необязателен: лаунчер добавит его только в сгенерированную конфигурацию Tor. Используйте мосты с Tor Project или другого источника, которому доверяете. Учётные данные мостов маскируются в копируемых и сохранённых диагностических отчётах.
Селектор языка всегда называется Language. На новой portable-установке по умолчанию используется английский, а русский уже встроен как дополнительный перевод.
Новый язык можно создать без изменения исходного кода и пересборки приложения: скопируйте locales/translation-template.json из portable-архива в data/locales/<code>.json, укажите $meta.code и $meta.name, переведите значения, перезапустите лаунчер и выберите язык через Language. Недостающие значения безопасно подставляются на английском.
Подробности о формате JSON, плейсхолдерах и отправке перевода находятся в docs/TRANSLATING.md и docs/LOCALIZATION_CONTRACT.md.
Используйте Diagnostics → Copy report или Save .txt, чтобы собрать локальную информацию для поиска проблемы. В отчёте указываются состояние Tor, выбранный режим, имя внешнего Bundle, локальные порты и последние замаскированные строки журнала. Перед публикацией отчёта обязательно проверьте его содержимое самостоятельно.
pnpm install
pnpm lint
pnpm test
pnpm dist:winpnpm test проверяет структуру английской и русской локалей, загрузку пользовательских локалей, конфигурацию Tor, разбор мостов, статистику выходов, обработку цепочек и маскирование диагностики. Windows-сборка создаётся в dist/win-unpacked/ командой pnpm dist:win.
Смотрите LICENSE и NOTICE.md. Tor Expert Bundle, Tor, мосты и внешние сайты не включены в этот репозиторий или portable-архив лаунчера.