Машины и браузеры

Цель

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

Предварительные требования

• Выполнен вход в панель администрирования.
• Текущий аккаунт имеет права, связанные с «Управлением браузерами».
• Подготовлен доступный узел машины или среда выполнения браузера.
• В сервисе администрирования настроен app.keeperbase для хранения пакетов browser client и engine.

Шаги

1. Откройте «Управление браузерами > Список машин».

2. Нажмите «Добавить машину» и заполните адрес и порт.

   • Адрес машины: укажите адрес сервиса keeper. По умолчанию keeper находится на сервере установки; обычно достаточно внутреннего адреса сервера.
   • Порт: по умолчанию 7000.
   • Встроенная версия: при добавлении или обновлении машины система вызывает bind-интерфейс keeper и автоматически сохраняет это значение. На странице его не вводят вручную.

3. Сохраните и убедитесь, что запись машины существует, а сервис keeper доступен и может использоваться для планирования.

4. Откройте «Управление браузерами > Список браузеров».

5. Создайте экземпляр браузера, выберите машину, укажите номер браузера и выберите версию браузера.

   • Машина: созданный браузер будет выполняться на выбранной машине.
   • Номер браузера: выберите уникальное и запоминаемое значение без пробелов, например chrome100.
   • Версия браузера: выберите версию из управления версиями или «Встроенную версию». В этом случае система использует встроенную версию, сохраненную на выбранной машине.
   • Режим сети:
     • Обычная сеть: использует обычную сеть браузера. Можно настроить HTTP/SOCKS5-прокси, подходит для стандартных сценариев.
     • Изолированная сеть: создает отдельную сетевую среду для браузера, полностью управляет сетевым трафиком браузера и поддерживает более полную изоляцию DNS, UDP, WebRTC и другого сетевого поведения. Используйте для сценариев с повышенными требованиями к изоляции.
   • Сетевой слот: обязателен только для изолированной сети. Укажите уникальное число больше 0.
   • Настройка DNS: обязательна только для изолированной сети. Выберите tcp или udp, укажите IP-адрес и порт DNS, затем выберите, использует ли DNS прокси: direct или proxy. direct отправляет DNS-запросы напрямую; proxy отправляет DNS-запросы через прокси.
   • Настройка прокси: обязательна только для изолированной сети. Выберите socks5 или http, затем укажите хост и порт прокси. Имя пользователя и пароль необязательны.

6. После создания браузера можно изменить режим сети и параметры изолированной сети в списке браузеров.

7. Нажмите кнопку «Запустить», пока статус браузера не станет running.

Конфигурация браузера

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

• Базовые настройки:
  • Версия ядра: выберите версию среды выполнения Chromium, используемую экземпляром браузера. Используйте «Редактировать» рядом с полем, чтобы управлять доступными версиями Chromium.
  • ОС: выберите профиль операционной системы. Используйте «Редактировать», чтобы управлять списком ОС.
  • Бренд и версия бренда: выберите бренд браузера, например Google Chrome, Microsoft Edge, Opera или Vivaldi, затем выберите подходящую версию бренда. При смене бренда выбранная версия бренда очищается.
  • Мобильная модель: выберите профиль мобильного устройства, если браузер должен эмулировать мобильную среду. Используйте «Редактировать», чтобы управлять вариантами моделей.
  • Часовой пояс: найдите и выберите часовой пояс браузера или сбросьте его к локальному часовому поясу.
• Расширенные настройки:
  • Параметры запуска: добавляйте, изменяйте или удаляйте аргументы запуска Chromium как пары ключ-значение. Частые значения по умолчанию включают disable-gpu, no-sandbox, ignore-certificate-errors, lang и autoplay-policy. Другие switches командной строки Chromium см. в List of Chromium Command Line Switches.
  • Временный каталог и каталог кэша: задайте, куда браузер записывает временные файлы и данные кэша.
  • Максимальный размер изображения: задайте максимальный размер изображения в пикселях, используемый при получении изображений браузером.
  • Аппаратное ускорение: включайте только если среда выполнения поддерживает стабильное GPU-ускорение.
  • Очистка пользовательских данных: очищайте пользовательские данные браузера, когда требуется чистая сессия.

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

Управление версиями браузера

В «Управление браузерами > Список браузеров» нажмите «Управление версиями», чтобы открыть страницу управления версиями браузера.

На странице отображаются имя версии, статус engine, статус client и действие загрузки.

Статус	Значение
Не загружено	Сервис лицензий вернул эту версию, но пакет такого типа отсутствует в app.keeperbase
Есть обновление	Локальный пакет существует, но в сервисе лицензий buildVersion выше
Последняя версия	Локальный buildVersion больше или равен версии сервиса лицензий, либо локальная версия отсутствует в ответе сервиса

Загрузка выполняется в фоне, а страница показывает прогресс. Поддерживается возобновление через HTTP Range. Файл сначала сохраняется во временный каталог; после завершения переносится в app.keeperbase/<version>/, а старые пакеты того же типа удаляются.

Формат имени файла:

client_<version>_<buildVersion>.tar.gz
engine_<version>_<buildVersion>.tar.gz

Внутренние API Keeper

Сервис администрирования предоставляет внутренние API, чтобы узлы engine и client могли автоматически проверять версии и загружать пакеты. Для этих API нужен внутренний JWT token.

API	Описание
GET /internal/navi/keepers	Собирает локальные пакеты из app.keeperbase и возвращает version, type, buildVersion и fileName
GET /internal/navi/downKeeper?version=<version>&type=<type>	Загружает локальный пакет указанной version и type, поддерживает HTTP Range

Узлы engine и client периодически вызывают /internal/navi/keepers, сравнивают файл BUILD локальной версии и вызывают /internal/navi/downKeeper, если версии нет локально или локальный build ниже.

Проверка результата

• Новая машина отображается в списке машин.
• В списке машин отображается встроенная версия, полученная через keeper bind.
• Новый экземпляр отображается в списке браузеров.
• В списке браузеров отображается версия браузера. Если выбрана «Встроенная версия», также показывается встроенная версия связанной машины.
• В списке браузеров отображаются режим сети и сетевой слот. Для браузеров в изолированной сети нажмите «Сведения о сети», чтобы проверить DNS, использование прокси для DNS и параметры прокси.
• Управление версиями показывает статусы client и engine после сравнения локальных пакетов с сервисом лицензий.
• При доступе пользователя к сайту или рабочему пространству может быть назначена доступная среда браузера.

Частые проблемы

• Экземпляр браузера должен соответствовать узлу машины; недоступная машина или keeper влияет на удаленный доступ.
• Версия браузера, версия бренда и конфигурация ОС влияют на распознавание и совместимость сайтов.
• Если страница версий постоянно показывает «Не загружено», проверьте права app.keeperbase, доступ к сервису лицензий и состояние задачи загрузки.
• Если автообновление не работает, проверьте доступ узлов к /internal/navi/keepers и /internal/navi/downKeeper, а также корректность JWT token.
• Список окон используется для наблюдения за текущими окнами браузера и диагностики занятости.