РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ UA PRO

Руководство по началу работы

Начните с первого правила и узнайте об области действия, случайных режимах, резервном применении к ресурсам и переносе конфигурации.

Для версии: 1.4.5 · Обновлено: 16 ноября 2026 г.

Это руководство относится к версии 1.4.5. Проверьте версию в выбранном источнике установки.

UA Pro позволяет задать User-Agent (UA) для всех сайтов, отдельных доменов или одной вкладки. Сначала выберите страницы, на которые действует правило, затем способ формирования UA. При наличии нескольких правил расширение выбирает одно правило главной страницы по приоритету; обычные ресурсы страницы в первую очередь наследуют её UA.

01Что такое UA и ресурсы страницы

UA — это описание идентичности, которое браузер отправляет сайтам; обычно оно содержит сведения о браузере, операционной системе и устройстве. UA Pro может изменять User-Agent обычных веб-запросов и предоставлять соответствующее значение для navigator.userAgent на обычных страницах.

Мобильный UA позволяет увидеть, что сайт возвращает для мобильных UA, но не превращает компьютер в телефон и автоматически не меняет размер экрана, движок браузера, IP-адрес или весь цифровой отпечаток браузера.

Предположим, в адресной строке указано https://shop.example.com/product:

Термин Значение в этом примере
Главная страница Страница товара, открытая в адресной строке
Домен главной страницы shop.example.com, без протокола и пути
Родительский домен По отношению к shop.example.com домен example.com является родительским
Поддомен img.shop.example.com — поддомен домена shop.example.com
Ресурсы страницы Изображения, скрипты, стили, API-запросы, обычные сетевые iframe и другие ресурсы, загружаемые страницей
Домен ресурса Домен назначения запроса ресурса, например cdn.example.net

В этом руководстве «домен главной страницы» означает имя хоста страницы в адресной строке. Это не домен верхнего уровня, такой как .com, и не обязательно зарегистрированный домен, такой как example.com.

02Три независимых понятия настройки

Настройка На какой вопрос отвечает Примеры
Область действия Какие страницы используют это правило? Глобальная область, домен example.com, текущая вкладка
Режим UA Откуда берётся содержимое UA? Встроенный UA, пользовательский UA, добавление текста, случайный UA
Случайный режим Когда при выборе случайного режима выбирается новое значение? При каждой загрузке страницы, для каждой вкладки

Например, «область домена + случайный UA + для каждой вкладки» означает, что каждая вкладка, посещающая страницы в области этого домена, хранит свой случайный результат для правила. Это не означает, что все вкладки домена используют один постоянный UA.

2.1 Область действия

Область действия На что влияет Срок действия и переопределение
Глобальная Обычные страницы сайтов без правила с более высоким приоритетом Настройка сохраняется; может быть переопределена правилом домена или вкладки
Домен Страницы, домен главной страницы которых совпадает с указанным доменом или одним из его поддоменов Настройка сохраняется; может быть переопределена более конкретным правилом домена или правилом вкладки
Вкладка Вкладка, в которой создано правило Наивысший приоритет; продолжает действовать при переходе вкладки на другие сайты и прекращается при её закрытии

«Глобальная область + случайный выбор для каждой вкладки» остаётся глобальным правилом; раздельное хранение результатов не превращает его в правило вкладки с наивысшим приоритетом.

2.2 Режим UA

Режим Как формируется UA Для чего подходит
Встроенный UA Выбирает UA из предустановленных браузеров или устройств Быстрое использование готовой идентичности
Пользовательский Использует введённую вами полную строку UA Использование конкретного UA или сохранение собственного списка UA
Добавление текста Добавляет пробел и указанный текст после стандартного UA браузера Добавление идентифицирующей метки к стандартному UA
Случайный UA Выбирает UA из выбранного набора кандидатов Назначение случайных значений при загрузке страницы или для каждой вкладки

Добавление текста использует стандартный UA браузера, а не переопределённый UA родительского домена или глобальный UA. Например, если глобальное правило задаёт пользовательский UA, а правило домена добавляет MyTest, этот домен использует «стандартный UA браузера + пробел + MyTest». Правила не складываются.

Набор случайных кандидатов может включать встроенные UA, пользовательский список, список добавляемого текста или сочетание этих источников; можно также выбрать конкретные категории. Текстовые кандидаты сначала объединяются со стандартным UA браузера и затем участвуют в выборе. Если набор пуст или не содержит допустимых значений, правило не может стать действительным правилом главной страницы.

03Приоритет правил главной страницы

Правило вкладки → наиболее конкретное действительное правило домена → правила родительских доменов по уровням → глобальное правило → стандартный UA браузера.

В указанном порядке используется первое включённое правило, способное сформировать допустимый UA; последующие правила с ним не объединяются. Между фиксированными и случайными режимами нет дополнительного приоритета.

Порядок проверки Пример, когда главная страница — news.shop.example.com
1 Правило текущей вкладки
2 Действительное правило для news.shop.example.com
3 Действительное правило для shop.example.com
4 Действительное правило для example.com
5 Действительное глобальное правило
6 Ни одно из перечисленных правил не действует; используется стандартный UA браузера

«Действительное» означает выполнение двух условий: правило включено и может сформировать допустимый непустой UA. Приостановленные правила, недопустимые UA и пустые наборы случайных кандидатов пропускаются.

3.1 Как сопоставляются домены

Если задан example.com, совпадают следующие главные страницы:

Домен главной страницы Совпадает?
example.com Да
www.example.com Да
shop.example.com Да
a.shop.example.com Да
otherexample.com Нет
example.com.other.net Нет
example.net Нет

В поле домена введите example.com; не вводите https://, путь, параметры запроса или порт. Сейчас настройка выполняется для домена, а не для пути URL.

В версии 1.4.5 нет возможности сопоставлять только это точное имя хоста, исключая все поддомены. Если нужно затронуть только ветвь shop.example.com, введите shop.example.com, однако её поддомены также будут включены.

Совместимая форма *.example.com в текущей версии также охватывает сам example.com и его поддомены, а не только поддомены. Если существуют действительные правила example.com и *.example.com, первое имеет приоритет; когда оно приостановлено, может примениться второе. Новым пользователям обычно достаточно обычной формы домена.

3.2 Разница между приостановкой и удалением

Действие или состояние Значение
Приостановить Сохраняет настройку, но временно исключает её из сопоставления; правило можно возобновить
Удалить Удаляет правило; при необходимости его нужно создать заново
Переопределено Правило всё ещё включено, но к текущей странице применяется правило с более высоким приоритетом
Недействительно Текущее содержимое не позволяет сформировать допустимый UA; исправьте содержимое или набор кандидатов

После приостановки или удаления правила расширение продолжает поиск других действительных правил. Поэтому приостановка не является правилом исключения, которое принудительно задаёт странице стандартный UA браузера.

Например, предположим, что единственные включённые и действительные правила — глобальное UA-G, UA-P для example.com и UA-C для shop.example.com:

Действие Результат при открытии shop.example.com
Все три правила включены UA-C
Приостановить правило поддомена UA-P
Также приостановить правило родительского домена UA-G
Также приостановить глобальное правило Стандартный UA браузера
Добавить действительное правило вкладки UA-T Эта вкладка использует UA-T

Здесь UA-G, UA-P, UA-C и UA-T — лишь обозначения разных значений UA.

04Два случайных режима

4.1 При каждой загрузке страницы

При каждой полной сетевой загрузке главной страницы значение выбирается один раз, а обычные ресурсы страницы повторно используют этот результат. При обновлении или полном переходе выбор выполняется снова; запросы ресурсов страницы, например изображений, API и iframe, не вызывают отдельного выбора для главной страницы.

Например, пусть набор кандидатов содержит UA-A, UA-B и UA-C:

Действие Один из возможных результатов
Открыть страницу впервые Главный документ и обычные ресурсы используют UA-A
Страница запрашивает изображения и API По-прежнему UA-A
Меняется только якорь или внутренний маршрут SPA По-прежнему UA-A
Обновить страницу Новый выбор; может использоваться UA-C
Выполнить полный переход на другую страницу, которая по-прежнему соответствует этому правилу Новый выбор; может использоваться UA-B

«Новый выбор» не означает, что значение обязательно изменится. Аналогично, если кнопка браузера «Назад» или «Вперёд» восстанавливает документ непосредственно из кеша без новой сетевой загрузки главного документа, это нельзя считать новым выбором.

При перенаправлениях применимое правило по-прежнему определяется страницей назначения. В рамках одного перехода и одного правила каждый этап перенаправления не вызывает повторного выбора; если домен назначения соответствует другому правилу, применяется оно.

4.2 Для каждой вкладки

Случайный результат хранится отдельно для каждой пары «правило + вкладка». Пока настройка не изменена и вкладка не закрыта, обновления и полные переходы в рамках того же правила используют этот результат.

Например, настройте случайный режим «Для каждой вкладки» для example.com:

Действие Один из возможных результатов
Вкладка 1 открывает example.com Это правило привязывает UA-A к вкладке 1
Вкладка 1 обновляется или переходит на shop.example.com, более конкретного правила нет Продолжает использовать UA-A
Вкладка 2 открывает example.com Для вкладки 2 сохраняется привязка; это может быть UA-B или снова UA-A
Вкладка 1 переходит на other.net, для которого нет правила, при этом глобального правила тоже нет Используется стандартный UA браузера
Вкладка 1 возвращается на example.com Восстанавливается исходный UA-A этого правила
Закрыть вкладку 1 и открыть снова Исходная привязка вкладки очищается и может быть назначена заново

Если существует отдельное правило shop.example.com, то даже при выборе одного набора кандидатов это разные правила, которые хранят случайные привязки отдельно. После изменения параметров правила или библиотеки кандидатов, а также после перезапуска браузера случайные результаты могут быть назначены заново.

4.3 Сочетания области действия и режима

Таблица ниже описывает поведение после того, как правило получило приоритет для главной страницы. К фиксированным режимам относятся встроенный UA, пользовательский UA и добавление текста.

Область действия Фиксированные режимы Случайный выбор при каждой загрузке страницы Случайный выбор для каждой вкладки
Глобальная Соответствующие страницы используют UA этого правила Выбор при каждой сетевой загрузке главной страницы Каждая вкладка хранит свою привязку для этого глобального правила
Домен Страницы соответствующего домена и его поддоменов используют этот UA Выбор при каждой сетевой загрузке главной страницы в соответствующей области Каждая вкладка хранит свою привязку для этого правила домена
Вкладка Эта вкладка использует данный UA, в том числе после перехода на другие сайты В этой вкладке выбор выполняется при каждой сетевой загрузке главной страницы Вкладка сохраняет фиксированный случайный результат для правила при обновлениях и переходах между сайтами

Во всех сочетаниях обычные ресурсы страницы в первую очередь наследуют UA главной страницы. Случайный режим определяет срок действия значения и не меняет приоритет правил.

05Ресурсы страницы и резервное применение по домену ресурса

5.1 При наличии правила главной страницы ресурсы в первую очередь наследуют его

Предположим, существуют следующие правила:

  • shop.example.com → UA-Shop.
  • cdn.example.net → UA-CDN.

Если открыть shop.example.com и страница загрузит cdn.example.net/photo.png, изображение использует UA-Shop. Даже если у домена назначения ресурса есть собственное правило, оно не переопределяет правило главной страницы. Это позволяет главному документу и обычным ресурсам страницы использовать один UA.

Если открыть cdn.example.net непосредственно в адресной строке новой вкладки, он станет доменом главной страницы и сможет соответствовать собственному правилу UA-CDN.

5.2 Когда действует переключатель резервного применения

Резервное правило домена ресурса в разделе «Ещё» по умолчанию выключено. Это независимый глобальный переключатель, который применяется ко всем режимам UA.

Он действует только тогда, когда у главной страницы нет действительного UA для вкладки, домена или глобального правила, и позволяет ресурсам искать действительное правило домена по собственному домену назначения. Для доменов ресурсов действует та же логика: более конкретное правило имеет приоритет, а при приостановке дочернего правила наследуется родительское.

Есть ли у главной страницы действительный UA? Переключатель Соответствует ли сам ресурс действительному правилу домена? UA обычных ресурсов
Да Выключен или включён Да или нет Наследует UA главной страницы
Нет Выключен Да или нет Стандартный UA браузера
Нет Включён Да UA, сформированный правилом домена ресурса
Нет Включён Нет Стандартный UA браузера

Если у главной страницы нет действительного правила, её главный документ по-прежнему использует стандартный UA браузера; резервное применение к ресурсам никогда не назначает значение главной странице в обратном порядке. Действительное глобальное правило также означает, что «у главной страницы есть действительный UA», поэтому оно не позволяет резервному применению управлять обычными ресурсами.

5.3 Пример резервного применения

Откройте news.example.org при отсутствии правила вкладки, правила домена главной страницы и глобального правила. Также существует cdn.example.net → UA-CDN:

Запрос Резервное применение выключено Резервное применение включено
Главный документ news.example.org Стандартный UA Стандартный UA
API news.example.org/api Стандартный UA Стандартный UA
cdn.example.net/app.js Стандартный UA UA-CDN
img.cdn.example.net/photo.png Стандартный UA UA-CDN, унаследованный от правила родительского домена ресурса
other.net/font.woff, подходящего правила нет Стандартный UA Стандартный UA

Если добавить глобальный UA-G, все обычные запросы выше будут управляться UA-G главной страницы, а UA-CDN ресурса больше не будет применяться.

5.4 Резервное применение со случайными режимами

Режим правила домена ресурса Как получается значение, когда резервное применение разрешено
Фиксированные режимы Используется UA, заданный в правиле ресурса
Случайный выбор при каждой загрузке страницы Результат хранится для пары «данная загрузка страницы + правило ресурса»; ресурсы этой загрузки, соответствующие одному правилу, используют общий результат
Случайный выбор для каждой вкладки Результат хранится для пары «вкладка страницы + правило ресурса»; та же вкладка продолжает использовать его после обновлений

Например, если cdn.example.net использует случайный режим и img.cdn.example.net, и js.cdn.example.net наследуют его, они используют одну привязку. Если у img.cdn.example.net есть собственное действительное правило, оно является другим правилом и может использовать другой UA.

Другие вкладки, посещающие домен ресурса, не перезаписывают случайные привязки ресурсов, уже сохранённые для текущей страницы. При включённом резервном применении разные правила ресурсов на одной странице могут использовать разные UA; если обычная страница должна оставаться согласованной в целом, обычно оставляйте переключатель выключенным, как по умолчанию.

06Создание первого правила

  1. Откройте сайт, который хотите настроить, и нажмите значок UA Pro на панели инструментов.
  2. Если доступна кнопка настройки правила для текущего сайта, нажмите её; также можно создать новое правило через раздел «Ещё».
  3. Выберите область действия. Для временной проверки только в текущей вкладке выберите «Вкладка»; для нескольких вкладок одного сайта — «Домен»; для использования по умолчанию на всех сайтах — «Все сайты».
  4. Если выбран домен, проверьте поле домена. Например, находясь на www.example.com и желая включить shop.example.com, введите example.com.
  5. Выберите режим. Для «Встроенный» выберите браузер или устройство; для «Пользовательский» введите полный UA; для «Добавить текст» введите только добавляемый текст; для «Случайный» выберите набор кандидатов и случайный режим.
  6. В разделе «Проверка и применение» проверьте область и содержимое, затем нажмите «Применить» или «Сохранить и применить». Дождитесь подтверждения «Правило сохранено и включено.»
  7. Обновите страницу и проверьте действующее правило на главном экране. Уже открытые страницы необходимо обновить, чтобы и главный документ, и скрипты использовали новый UA.

В списке правил можно редактировать, приостанавливать, возобновлять и удалять правила. Правило, переопределённое другим, остаётся включённым, но сейчас не имеет приоритета; приостановленное правило не участвует в сопоставлении. Если появляется предупреждение об отсутствии действительного UA, проверьте пользовательское содержимое или набор случайных кандидатов.

Пользовательский UA должен состоять из одной строки допустимого содержимого заголовка запроса без переводов строк и управляющих символов. Новое пользовательское содержимое или добавляемый текст можно сохранить в список по категориям для последующего выбора или использования в качестве случайных кандидатов.

07Включить плавающую панель UA

Откройте Ещё и включите Плавающая панель UA. По умолчанию окно выключено; оно может отображаться на доступных страницах HTTP/HTTPS.

UA страницы: значение, которое JavaScript страницы считывает из navigator.userAgent.

UA запроса: User-Agent, который браузер наблюдал для запроса этого главного документа.

Здесь показан UA текущей страницы в адресной строке браузера. Он не включает UA запросов изображений, скриптов, API и других ресурсов, например ресурсов CDN.

Если оба значения доступны и полностью совпадают, они отображаются в одной строке. Иначе они отображаются отдельно.

Если окно включили после загрузки страницы, обновите страницу, чтобы зафиксировать её главный запрос. Когда запрос недоступен, окно показывает этот статус вместо настроенного значения.

Чтобы переместить окно, перетащите ручку или подпись. Перетаскивайте левую или правую границу для изменения ширины, а верхнюю или нижнюю — для изменения высоты. Двойной щелчок по границе восстанавливает автоматический размер только для соответствующего измерения. Кнопка с полукругом регулирует непрозрачность фона. Кнопка закрытия выключает окно на всех страницах.

Если User-Agent длинный, в узком окне его текст автоматически переносится на следующую строку. При необходимости окно увеличивается по высоте. Если текст выше экрана, прокрутите содержимое окна. Заданные вручную ширина и высота сохраняются до сброса.

При загрузке значений новой страницы окно старается сохранить прежний размер. Оно показывает индикатор загрузки, но никогда не показывает значения предыдущей страницы. При полном переходе страница создаётся заново, поэтому окно может ненадолго исчезнуть.

Изменение правила не меняет уже загруженную страницу или заголовок, отправленный с исходным запросом. Обновите страницу, чтобы проверить новое правило. Прокси или сервер могут изменить заголовки запроса после того, как браузер их зафиксировал. Окно не может отображаться на защищённых страницах браузера или в магазинах расширений.

В меню Ещё также есть Руководство для новых пользователей; нажмите UA Pro внизу этого меню, чтобы открыть сайт.

08Настройка для типичных задач

Цель Как настроить Примечания
Попробовать мобильный UA только в текущей вкладке Вкладка + встроенный мобильный UA Продолжает действовать при переходе вкладки на другие сайты; прекращается после её закрытия
Использовать фиксированный UA для всего сайта Домен example.com + встроенный или пользовательский UA Включает все поддомены; также действует в других вкладках
Использовать другой UA для раздела магазина Сохраните родительское правило и добавьте правило shop.example.com Если нет правила с более высоким приоритетом, дочернее правило имеет приоритет; при его приостановке может примениться родительское
Использовать один UA по умолчанию для всех сайтов, кроме одного Задайте UA-G глобально и UA-D для нужного домена При отсутствии другого правила с более высоким приоритетом нужный домен использует UA-D, а остальные страницы — UA-G
Выбирать случайный UA сайта при каждом обновлении Домен + случайный UA + при каждой загрузке страницы Ресурсы одной загрузки используют общий результат; выбор может повториться
Сохранить стабильный UA сайта в каждой вкладке Домен + случайный UA + для каждой вкладки Каждое правило хранит отдельную привязку в каждой вкладке
Задать UA только для внешних ресурсов по домену назначения Создайте правило домена ресурса и включите резервное применение к ресурсам У страницы, загружающей ресурс, не должно быть действительного UA для вкладки, домена или глобального правила
Временно отключить правило поддомена Нажмите «Приостановить» Страница использует оставшееся действительное правило с наивысшим приоритетом, например правило вкладки, другое подходящее правило домена или глобальное правило. Если ни одно не подходит, используется стандартный UA браузера

09Резервное копирование и перенос

Функции импорта и экспорта в разделе «Ещё» позволяют создать резервную копию или перенести глобальные правила, правила доменов, пользовательскую библиотеку, библиотеку добавляемого текста и состояние переключателя резервного применения по домену ресурса.

Правила вкладок и уже выбранные случайные привязки не входят в этот экспорт постоянной конфигурации. Импорт не восстанавливает исходные вкладки или их случайное состояние.

Можно импортировать локальный файл конфигурации или загрузить конфигурацию по удалённому адресу и подтвердить импорт. Сначала экспортируйте резервную копию. Предоставленный объект глобального правила, правил доменов, пользовательской библиотеки или библиотеки добавляемого текста заменяет соответствующий раздел; если любой из этих четырёх разделов отсутствует или равен null, его существующее значение сохраняется. В частности, null для глобального правила не удаляет существующее правило. Резервное правило домена ресурса включается только при значении поля true; любое другое значение, включая отсутствие поля или null, выключает его после импорта.

В версии 1.4.5 устаревший случайный режим domain рассматривается как «При каждой загрузке страницы»; устаревшие случайные правила без указанной стратегии рассматриваются как «Для каждой вкладки». После переноса проверьте нужный случайный режим в интерфейсе.

10Частые вопросы и ограничения использования

Вопрос Разъяснение
Почему сразу после сохранения страница всё ещё показывает старый UA? Открытые документы не перезагружаются; обновите страницу после успешного сохранения. Также проверьте, не переопределяет ли правило другое правило с более высоким приоритетом
Почему пользовательский UA всё ещё используется после приостановки дочернего правила? Действительное правило вкладки всё ещё может иметь приоритет. Иначе может примениться другое подходящее правило домена или глобальное правило. После изменения правила обновите страницу и проверьте активное правило
Почему правило домена ресурса не работает? Сначала проверьте, есть ли у главной страницы действительный UA, затем включено ли резервное применение к ресурсам и, наконец, действительно ли правило домена ресурса
Почему случайное значение не меняется после обновления? Режим для каждой вкладки специально сохраняет значение; режим при каждой загрузке страницы тоже может повторно выбрать то же значение
Почему вкладки, открытые одновременно, имеют одинаковый UA? Случайные значения могут повторяться; одновременные первые переходы также могут использовать одно заранее выбранное запасное значение
Почему после переключения на мобильный UA страница по-прежнему выглядит как версия для компьютера? Сайты могут также учитывать размер экрана, Client Hints и другие сведения; одно лишь изменение UA не гарантирует другой макет страницы

Для одновременных первых переходов используется подход, сохраняющий штатную навигацию браузера: если несколько новых вкладок одновременно открывают URL напрямую и первый пакет отправляется до установки отдельного правила, они могут использовать один заранее выбранный UA; затем каждая вкладка сохраняет собственную привязку. Расширение не добавляет промежуточный переход и не превращает штатные POST-запросы форм в другой способ навигации.

Основное назначение этой функции — обычные страницы HTTP/HTTPS и их ресурсы. Запросы общего Service Worker не всегда можно отнести к одной вкладке; синхронизация UA для Client Hints, navigator внутри Workers и iframe с документами без сетевой загрузки в этой версии реализована не полностью. Сохранение исходного Server-Timing сайта в этом изменении также пока не реализовано. Не считайте изменение UA полной подменой цифрового отпечатка браузера.

Версия 1.4.5 использует разрешения webRequest и webNavigation для отслеживания навигации главной страницы и фактически отправленного UA. Она не использует разрешения на блокировку запросов или доступ к отладчику.

11Проверка версии и источники

Окончательная проверка версии 1.3.0 проводилась в изолированном тестовом профиле Windows Edge 157.0.4341.42 с локальными сайтами HTTP/HTTPS. Полный прогон HTTPS прошёл 128 случаев с 2527 проверками; регрессионная проверка граничных случаев HTTP прошла 5 случаев с 441 проверкой. Они проверяют описанные выше сочетания правил и указанную границу одновременной работы; это не означает, что проверены все версии браузеров и сайты.

Окно версии 1.4.5 проверялось в изолированных профилях Chrome и Edge с локальными страницами HTTPS. Тесты охватывали навигацию, объединение совпадающих UA страницы и запроса в одну строку, изменение размера и отложенное считывание. Они не охватывают все сайты.

Подробные записи тестов хранятся в материалах проекта. Проверьте доступную для установки версию в Chrome Web Store или на странице автономной загрузки; доступные версии могут отличаться от версии этого руководства.