Браузерное расширение: тур
Расширение — это URnetwork внутри браузера, а веб-приложение ur.io — его панель управления: один продукт, две половины. Эта страница — глубокое погружение: прокси-механика в каждом браузере, органы управления с заводскими умолчаниями, что kill switch (аварийный стоп) обещает и чего не обещает, и что проверять, когда что-то ломается. О сети за всем этим — кто такие провайдеры и что видит каждая сторона — читайте обзор. Ссылки магазинов, вход и первое подключение — в начале работы в браузере.
Рамка, которую надо держать всегда: это браузерный прокси, а не VPN. Прокси — посредник, который ходит на сайты за браузер, поэтому сайты видят его адрес вместо вашего. Расширение настраивает собственные прокси-параметры браузера, поэтому управляет ровно тем, что отправляет этот браузер, — не больше. Покрыто: каждая вкладка и каждое окно этого браузера, инкогнито тоже — на Chromium всегда, на Firefox после того, как вы разрешите работу в приватных окнах. Не покрыто: другие браузеры, ваша почтовая программа, системные обновления, всё остальное — как незащищённое, так и неполоманное. Ставьте его в каждый браузер отдельно; покрытие всего устройства — работа приложений URnetwork (Android, iOS, macOS, Windows, Linux): тот же аккаунт, тот же kill switch, слоем ниже.

Настройки одним взглядом
Расширение намеренно держит поверхность маленькой. Два контрола, оба в попапе:
| Настройка | По умолчанию | Эффект | Главная цена |
|---|---|---|---|
| Kill switch | Выкл | блокирует трафик браузера при обрыве прокси, вместо отката на ваше прямое подключение | вкладки падают с ошибкой во время сбоя |
| Переопределение геолокации (Geolocation override) | Выкл | геолокационный API браузера сообщает город вашего выхода вместо вашей реальной позиции | сайтам, которым нужна ваша настоящая локация, требуется его выключить; для актуальности нужна открытая вкладка ur.io |
Оговорки к таблице:
- Двух переключателей из приложений здесь нет по замыслу. Постквантового шифрования (Post Quantum Encryption) нет, потому что у расширения нет сеанса клиент↔провайдер, который можно запечатать; полное исключение — в разделе «Сбор данных» ниже. И нет переключателя Строгая анонимизация (Strong Anonymization), потому что прямой режим принудительно выключен на размещённом прокси-устройстве, на котором работает расширение: ни одному провайдеру никогда не может достаться ваш реальный адрес.
- Если вы включили kill switch, он переживает перезапуски браузера, поэтому сбой держит вас заблокированным, а не раскрытым, пока вы не отключитесь или путь не восстановится.
- Закончившиеся данные — не сбой, и переключатель этого не решает: в каком бы положении он ни был, прокси остаётся на месте, и попап об этом сообщает (см. раздел Данные закончились).
Как это работает
Расширение — Manifest V3 в каждом браузере. Каждая установка держит один хостируемый прокси URnetwork за раз: он создаётся при первом подключении и применяется заново при следующих, и браузер получает этот единственный прокси. Сантехника различается, потому что различаются API браузеров:
- Chrome и Edge (и семейство Chromium вообще) используют API прокси-настроек: расширение ставит этот прокси единственным фиксированным прокси браузера, со списком исключений для локальных адресов и API URnetwork. Установка его забирает конфигурацию прокси браузера — поэтому же два прокси-расширения не могут сосуществовать (см. устранение неполадок): расширение ставит прокси, только пока браузер это позволяет, а если настройку с приоритетом держит другое расширение или её фиксирует правило, оно не подключается, и попап сообщает, какой это случай. У фиксированного прокси нет собственного запасного пути, поэтому, когда он не отвечает, запросы отказывают — до тех пор, пока не вмешаются проверки здоровья ниже. Настройки ОС расширение не трогает никогда, а его настройка отменяется чисто: отключение снимает захват, так что снова действуют собственные прокси-настройки браузера (системный или корпоративный прокси либо никакого), а удаление убирает его.
- У Firefox нет эквивалентной передачи настроек, поэтому он использует
proxy.: с расширением сверяются на каждый запрос, и оно отвечает этим единственным прокси. Пока kill switch выключен, как он и поставляется, в ответе за прокси следуетonRequest direct, поэтому запрос, который прокси не может провезти, уходит напрямую; со взведённым ответ — один прокси, и пока он лежит, запросы отказывают.
Версии для Safari нет, потому что в Safari нет этих API. На устройствах Apple всё, включая Safari, покрывает приложение.
Браузинг выходит через небольшое окно провайдеров сразу: устройств участников, чьи владельцы согласились и участвуют в протоколе UR. «Ваш IP выхода» — множественное число, а закрепление по сайтам держит каждый сайт на одном выходе, поэтому ваш банк видит один устойчивый адрес.
URnetwork SDK едет внутри пакета расширения как WebAssembly. Выделение прокси, список локаций и вызовы API — всё выполняется локально. Ничего исполняемого не подтягивается на лету; что отревьюил магазин, то и работает.
Веб-приложение — панель управления расширением; они один продукт. Войдите один раз на ur.io — и страница с расширением говорят по документированному мосту: короткий протокол глаголов (SETUP, CONNECT, DISCONNECT, SET_LOCATION, kill switch, синхронизация геолокации) поверх window. — единственного канала, который работает одинаково в Chrome, Edge, Brave и Firefox. SETUP передаёт вошедшую сессию прямо в руки — поэтому настройка из приложения никогда не спрашивает у вас код авторизации. Разделение труда настоящее: расширение чеканит прокси-сессию и устанавливает браузерный прокси, а приложение держит живое устройство. Смена локации в приложении перенаправляет его без переподключения браузера, и каждая поверхность показывает, что вы сделали в другой.
Мост намеренно узкий. Он работает только на страницах ur.io и manager.; никакой другой сайт не может говорить с расширением. Один другой скрипт загружается на каждой странице — переопределение геолокации, — и он остаётся инертным, с нетронутыми нативными функциями, пока вы его не включите (ниже).
Для входа нужен аккаунт, поскольку использование учитывается по аккаунтам: почта или телефон с паролем, один из SSO-вариантов ur.io, подпись кошелька или код авторизации, сгенерированный на устройстве, где вы уже вошли. Пути без почты здесь — кошелёк и код авторизации; Мгновенный аккаунт (Instant Account) без почты в одно касание создаётся в приложениях для телефона и десктопа, и расширение подхватывает этот аккаунт, как любой другой. Бесплатный тариф — дневной лимит данных; Pro добавляет к нему большой месячный ($5/месяц или $40/год; текущие цифры на ur.io/products).
Семантика kill switch
Что он делает: если прокси-соединение обрывается при включённом kill switch, расширение блокирует трафик браузера, а не даёт браузеру тихо откатиться на ваше прямое подключение и раскрыть ваш реальный адрес посреди сеанса.
- Он выключен по умолчанию: включите его в попапе, и подпись сменится с При сбое возможна утечка трафика (Traffic may leak on failure) на Блокирует трафик при сбое (Blocks traffic on failure).
- Принуждение — собственное прокси-правило браузера: взведённое, оно не имеет лазейки «иначе иди напрямую», поэтому запросы отказывают, а не откатываются. Оно переживает перезапуски браузера. Вы возвращаетесь заблокированным, а не раскрытым.
- Если он сработал, останавливается только этот браузер (вкладки падают с ошибкой; попап показывает почему). Остальной компьютер через него и не ходил.
- Оставить его выключенным — значит отказывать в открытую: оборванное соединение возвращает вас к собственному подключению браузера, у большинства прямому, — видимо в попапе, но беззвучно во вкладках. Приемлемо только там, где утечка — неудобство, а не вред.
- Закончившиеся данные — исключение, которое действует при любом положении переключателя: прокси остаётся на месте, и ничто не откатывается (см. раздел Данные закончились).
- Предел охвата: он блокирует трафик браузера — всё, чем расширение может управлять; это не системный файрвол. Локальные адреса (localhost, принтеры) намеренно идут мимо, а WebRTC (голос/видео в браузере) может открывать соединения, игнорирующие прокси-настройки, — дыра каждого прокси-расширения; браузеры умеют его ограничивать.
Переопределение геолокации
Два сигнала: ваш IP-адрес теперь говорит «Амстердам», но геолокационный API браузера, отвечающий по сигналам ОС вроде ближайших Wi-Fi, всё ещё сообщает, где ваше тело. Сайты, сравнивающие эти два сигнала, видят противоречие. Переопределение чинит второй сигнал, чтобы обе истории сходились:
- Выключено по умолчанию. Ничего не меняется, пока вы не включите его в попапе.
- Включённое, оно отвечает на
document_во всех фреймах, поэтому геолокационный API выдаёт локацию вашего выхода раньше, чем любой скрипт страницы успевает спросить, включая iframes, пытающиеся его обогнать. Координаты — город вашего самого старого подключённого провайдера, и до расширения они доходят по мосту приложения: расширение не держит собственного устройства, поэтому актуальность позиции поддерживает открытая вкладка ur.io.start - Выключенное, оно не говорит вообще ничего: страница сохраняет родную геолокацию, и ни одному сайту не вручается свежий сигнал, что у вас стоит расширение. Выключайте его, когда хотите, чтобы сайты видели вашу реальную локацию (карты, доставка).
Проверки здоровья и деградированное состояние
Пока вы подключены, расширение раз в минуту забирает лёгкий эндпоинт (my-ip-info в API URnetwork) через прокси — пренебрежимо мало даже на фоне бесплатного лимита, — и ещё раз сразу же, как только браузер сообщит об ошибке прокси. Это доказывает, что путь работает из конца в конец, а не просто что настройки применились. Запрос, который сбоит или длится дольше восьми секунд, считается сбоем, а успех обнуляет счёт. Одновременно идёт только одна проверка: ошибки прокси, пришедшие во время неё, к ней и присоединяются. Во время сбоя отказывают запросы каждой страницы, а с ними и собственный запрос проверки, поэтому сбой засчитывается не чаще раза в 45 секунд, а ошибка прокси в этот промежуток проверку не запускает: всплеск ошибок засчитывается один раз, а три сбоя подряд занимают те же две минуты, что и по расписанию. После трёх сбоев решает kill switch:
- Выключен, как поставляется: расширение снимает прокси, освобождая прокси-настройку браузера, и браузер подключается без URnetwork. Ничто не переподключается само: попап показывает Отключено (Disconnected) с причиной под кнопкой, а новое подключение снова применяет прокси установки или создаёт новый, если на сервере его больше нет.
- Включён: прокси остаётся на месте, и трафик браузера стоит, пока прокси не ответит. Это и есть деградированное состояние: строка статуса попапа показывает Прокси не отвечает (Proxy not answering), а под кнопкой — причину. Тем временем ничто не переподключается; следующая успешная проверка возвращает его в Подключено (Connected).
До третьего сбоя запросы браузера на Chromium отказывают на молчащем прокси при любом положении переключателя, потому что у фиксированного прокси нет собственного запасного пути. В Firefox с выключенным kill switch каждый запрос сам откатывается на прямое соединение, поэтому проверки проходят по прямому пути, и прокси остаётся на месте; признак этого — заметка в попапе Прокси активен, но сеть недоступна. (см. устранение неполадок).
Деградировано — не утечка. Вы всё ещё нацелены на прокси, и мёртвый путь блокирует, а не раскрывает. Чтобы ходить по сайтам до восстановления, отключитесь: так вы вернётесь к собственному подключению браузера.
Неудачная проверка сначала выясняет, остались ли у аккаунта данные, и аккаунт без них — не мёртвый путь: см. следующий раздел.
Данные закончились
Когда ваши данные заканчиваются, прокси ничего не передаёт, пока данные не вернутся, и расширение поступает так же, как приложения URnetwork: держит прокси на месте, предупреждает вас и оставляет отключение за вами. Из-за нехватки данных оно никогда не откатывается на ваше прямое подключение, при любом положении kill switch, поскольку отключение, которого вы не делали, могло бы привести к утечке вашего трафика. В Firefox на всё это время выключается и откат каждого запроса на прямое соединение.
Расширение отличает это от неотвечающего прокси так: когда проверка не проходит, оно читает баланс вашего аккаунта. Остаток меньше 1 MiB означает, что данные закончились: ниже этого порога сервер отказывает в новых подключениях, и так же это оценивает экран подключения ur.io. Тогда попап показывает:
- Недостаточный баланс данных (Insufficient balance) в строке статуса и над предупреждением или, на Pro, Достигнут лимит данных (Data limit reached);
- когда данные вернутся: Бесплатные данные обновятся через 5 ч 12 мин., с обратным отсчётом до 00:00 UTC, или, на Pro, что пакет данных добавит больше прямо сейчас;
- Страницы в этом браузере не будут загружаться, пока не появятся данные или пока вы не отключитесь.;
- Получить Pro (Get Pro) — на Pro не показывается — и Купить данные (Buy data), которые открывают ur.io. Через удерживаемый прокси ur.io тоже не загрузится, поэтому в предупреждении написано Чтобы повысить тариф, сначала выберите «Отключить». До этого оплата не пройдёт. (на Pro — Чтобы купить данные, …). После того как вы отключитесь, предупреждение остаётся в открытом попапе, так что его ссылки загружаются.
Ещё расширение присылает одно уведомление браузера на каждый такой эпизод, и только если браузер уже разрешает ему показывать уведомления: этого разрешения расширение никогда не запрашивает. Предупреждение снимается при следующей пройденной проверке (данные вернулись: бесплатное обновление, повышение тарифа или пакет данных), при балансе, в котором снова есть данные, или при подключении либо отключении. Если баланс не пришёл, предупреждение остаётся. Если данные вернулись, а прокси всё равно не отвечает, сбои отсчитываются с этого момента, как описано выше.
Сбор данных: никакого
- Листинг для Firefox объявляет это в манифесте, машиночитаемо:
data_— none. Это заявление, принуждаемое магазином, а не обещание на странице о приватности.collection_ permissions - Расширение говорит только с API URnetwork ради выделения вашего прокси — те же вызовы, что делает любой клиент. Ни аналитики, ни телеметрии, ни сбора истории посещений нигде.
- Разрешения на хосты различаются по браузерам, и не случайно. В Chrome расширение запрашивает доступ только к API-хостам URnetwork (
api.,bringyour.com api-v4.bringyour.com); API прокси-настроек не нуждается в том, чтобы видеть ваши запросы. В Firefox расширению нужен<all_urls>:proxy.сверяется с расширением по каждому запросу, который может маршрутизировать, и Firefox требует для этого доступа к хостам. Более широкое разрешение там — цена прокси-API Firefox, а не захват данных.onRequest - Никакая третья сторона расширение не оценивала. Android-приложение URnetwork прошло оценку Leviathan Security Group MASA AL2 в мае 2025 года — фиксированный чек-лист безопасности Google для мобильных приложений, — а независимая фирма в апреле–мае 2025 года провела тест на проникновение веб-приложения и API; ни то ни другое не покрывает расширение, и ни один независимый аудит не покрывает протокол и серверный код оператора. Что эта страница предлагает взамен — фальсифицируемо: эти разрешения читаются в вашей собственной установленной копии, ничего не подтягивается на лету, и исходники публичны. Заявления, которые можно проверить, а не сертификат.
Что держит сервис: ваш аккаунт и поштучный реестр счётчиков байтов по устройствам (это лимиты и учёт провайдеров), никогда — назначения или URL; адрес клиента, хранимый как односторонний хеш с ключом от вашего блока IP, а не сам адрес; и приблизительный город из географического запроса. Провайдеры выводят трафик, не узнавая ваш реальный адрес, и видят только метаданные уровня интернет-провайдера (имена сайтов, никогда не страницы и не пароли — те остаются запечатанными HTTPS); сайты видят только выход.
Но будьте точны насчёт середины. У сети три режима, и браузер всегда занимает только один из них:
| Режим | Видит оператор | Видит провайдер | Доступно здесь |
|---|---|---|---|
| Ретранслируемый стандартный | ваш аккаунт и исходное подключение, на каких провайдерах вы сидите, и назначения и байты пакетов внутри | назначения, которые он выводит, и идентификатор устройства/контракта, не ваш реальный IP | да: единственный режим браузера |
| Ретранслируемый запечатанный | то же, но вместо назначений — шифртекст с его таймингом и объёмом | как выше | нет: сеанс приложений с шифрованием до провайдера — там это переключатель, который поставляется выключенным, — не имеет браузерного эквивалента |
| Прямой | меньше участия в ретрансляции | ваш реальный IP и назначения, которые он выводит | нет: принудительно выключен на размещённом прокси-устройстве, на котором работает расширение |
Первая строка — позиция браузера, и контраст с приложениями резкий, а не мягкий: они могут запечатать сеанс клиент↔провайдер — переключателем, который поставляется выключенным, — а у браузера там нечего запечатывать. И не может быть: браузер говорит на собственном прокси-протоколе и не может выполнять движок сети, поэтому ваше клиентское устройство работает удалённо внутри оператора, который переводит между двумя протоколами, — запечатывание, начатое с такого устройства, началось бы у оператора, той самой стороны, которую запечатывание существует ослеплять. Реализация обменяла запечатывание на саму возможность добраться до браузера. Гарантия здесь — про хранение, а не про шифрование. Любой браузерный прокси вручает каждое назначение эндпоинту, который набирает, поэтому оператор обрабатывает ваши в пути; за этим стоит прокси-путь данных, который не пишет ни одного лога, — что закреплено регрессионным тестом в открытом коде, — и реестр, в котором некуда положить назначение. Переключатель Строгая анонимизация из приложений так же отсутствует и так же не нужен: с принудительно выключенным прямым режимом ни одному провайдеру никогда не может достаться ваш реальный адрес.
Что сама сеть может и не может видеть, когда ваш трафик уже течёт, — читайте обзор. Модель угроз идёт дальше и называет отсутствующее запечатывание браузерного пути одним из собственных отказов.
Устранение неполадок
«Не удалось подключиться. Проверьте свой аккаунт.» или причина от сервера
Неудачное подключение показывает причину под кнопкой, вместе с Повторить попытку. Если сервер отказал в прокси, причина — его собственная, и она говорит, что делать: достигнут лимит активных прокси вашего тарифа — удалите ненужный на странице Прокси (Proxies) на ur.io или перейдите на тариф выше; или достигнут его лимит новых прокси в минуту — попробуйте снова через минуту (см. ограничения). Не удалось подключиться. Проверьте свой аккаунт. появляется, когда причина не пришла:
- Убедитесь, что можете войти на ur.io, и проверьте тариф.
- Выйдите из расширения и войдите снова, чтобы обновить учётные данные.
Неудачное подключение к другой локации, если дело не в лимите вашего тарифа, оставляет браузер на прежнем прокси: попап остаётся в состоянии Подключено, показывает причину вместе с Браузер по-прежнему подключён к прежней локации. и сохраняет кнопку «Отключить» (Disconnect).
«Прокси перестал отвечать, поэтому расширение его отключило. Этот браузер подключается без URnetwork, пока вы снова не подключитесь.»
Проверки здоровья сбоили три раза подряд при выключенном kill switch, поэтому расширение сняло прокси, и этот браузер подключается по собственным настройкам, без URnetwork. Попап показывает это под Отключено (Disconnected), даже если в тот момент он был закрыт, пока вы не подключитесь снова. Вероятно, изменилась ваша нижележащая сеть (сменили сеть, ноутбук уснул, враждебный Wi-Fi). Закончившиеся данные к этому не приводят: для них есть своё предупреждение (см. раздел Данные закончились). Подключитесь снова из попапа; если повторяется в одной сети, эта сеть может блокировать прокси-порты.
«Недостаточный баланс данных» или «Достигнут лимит данных»
У вашего аккаунта закончились данные, и прокси удерживает трафик этого браузера, пока данные не вернутся или вы не отключитесь (см. раздел Данные закончились). Чтобы получить Pro или пакет данных, сначала нажмите «Отключить», затем Получить Pro или Купить данные: через удерживаемый прокси ur.io не загрузится. Или дождитесь бесплатного обновления в 00:00 UTC; следующая пройденная проверка вернёт попап в состояние Подключено, и делать ничего не придётся.
Другое расширение управляет прокси
Управлять прокси-настройками браузера может только одно расширение за раз (в Chrome выигрывает установленное последним). На Chromium расширение проверяет, кто держит настройку: если её с приоритетом держит другое расширение, строка статуса показывает Другое расширение управляет прокси (Another extension controls the proxy) с сообщением Другое расширение управляет настройками прокси в этом браузере, поэтому URnetwork не может подключиться. Чтобы пользоваться URnetwork, отключите это расширение., подключение отклоняется ещё до того, как что-либо будет настроено, и при запуске браузера ничто не переподключается поверх него. Если URnetwork была подключена, когда другое расширение перехватило управление, кнопка «Отключить» снимает настройку URnetwork, оставшуюся под ним, так что она не вернётся, когда другое расширение уйдёт. chrome:// называет текущего держателя; отключите другое. Когда настройки прокси фиксирует правило администратора, строка статуса показывает Прокси управляется правилом (Proxy managed by policy), и расширение не может подключиться в этом браузере.
В Firefox каждое расширение отвечает по каждому запросу, и Firefox не сообщает, какие ещё дополнения это делают: проверьте установленные дополнения с разрешением на прокси. Выдают это строка IP в попапе, чья точка становится серой, когда ваши запросы выходят не через URnetwork, и следующая за этим заметка Прокси активен, но сеть недоступна. (см. «Чтение статуса»).
Порталы авторизации (captive portals)
Wi-Fi отеля и аэропорта требует входа через страницу-портал до того, как заработает интернет, а с поднятым прокси (особенно взведённым) портал не может загрузиться. Застрять намертво нельзя: отключение локально и не требует сети. Отключите расширение, завершите вход на портале, затем подключитесь снова. Присуще каждому прокси и VPN, а не баг расширения.
Чтение статуса
Строка статуса внизу попапа — самая быстрая диагностика. Подписи и сообщения попапа следуют языку браузера; здесь они приведены так, как выглядят по-русски. Пока не ответит фоновая часть расширения, открывшийся попап не показывает ни статуса, ни кнопок «Подключить» (Connect) и «Отключить» — только нейтральную кнопку.
- Отключено (Disconnected): прокси снят, и браузер подключается по собственным настройкам. Если подключение не удалось или проверки здоровья сняли прокси, причина видна под кнопкой, вместе с Повторить попытку. Попап, открытый после того, как проверки сняли прокси, тоже показывает эту причину, пока вы не подключитесь снова.
- Подключение… (Connecting…): применяется прокси установки или создаётся новый.
- Подключено (Connected): браузер настроен на прокси.
- Прокси не отвечает (Proxy not answering): деградированное состояние. Kill switch включён, и прокси провалил три проверки подряд, поэтому этот браузер заблокирован, пока прокси не ответит или вы не отключитесь. Причина под кнопкой: Прокси не отвечает. Kill switch не пускает браузер в сеть, пока прокси не ответит. Тем временем ничто не переподключается. Попап, открытый во время сбоя, сразу показывает это по последней проверке.
- Недостаточный баланс данных или, на Pro, Достигнут лимит данных: у аккаунта закончились данные, и прокси удерживает трафик этого браузера (см. раздел Данные закончились).
- Другое расширение управляет прокси или Прокси управляется правилом: расширение не может задать прокси браузера (см. «Другое расширение управляет прокси»).
Если изменение переключателя kill switch или синхронизации локации не удаётся сохранить, переключатель возвращается в прежнее положение, а попап сообщает: Не удалось сохранить настройку, поэтому она не изменилась. Повторите попытку.
Под кнопкой может появиться и заметка: Прокси активен, но сеть недоступна. Собственная проверка IP в попапе, каждые 15 секунд, пока он открыт, три раза подряд обнаружила, что ваши запросы выходят не через URnetwork. В Firefox с выключенным kill switch так выглядит мёртвый прокси: запросы ушли напрямую.
Куда дальше
- Начало работы в браузере: ссылки магазинов, вход и первое подключение, включая заметку о приватных окнах.
- Как работает URnetwork: сеть за попапом и откуда берутся провайдеры.
- FAQ: тарифы, лимиты и вопросы аккаунта.