Перейти к содержимому
MultiloginБаза знаний

Настройте агент для режима headless и автозапуска в Linux

На Ubuntu вы можете сделать так, чтобы агент Multilogin запускался автоматически в режиме headless, создавая два сервиса systemd: один для Xvfb и один для агента Multilogin. Xvfb предоставляет виртуальный дисплей, необходимый агенту, в то время как systemd автоматически запускает оба сервиса при включении сервера.

Обратите внимание, что статья написана для Ubuntu. Другие дистрибутивы официально не поддерживаются.

Шаг 1: настройка Xvfb 

Xvfb (X Virtual Framebuffer) — это сервер отображения, позволяющий графическим приложениям работать в средах без физического дисплея путем создания виртуального экрана в памяти. Он необходим для корректной работы агента.

  1. Открыть терминал.
  2. Создайте файл службы Xvfb через ввод следующий команды:
    sudo nano /etc/systemd/system/xvfb.service
  3. Добавьте содержимое в файл службы (и обязательно замените YOUR_USERNAME на ваше имя пользователя в операционной системе Linux):
    [Unit]
    Description=MLX XVFB
    After=network.target
    
    [Service]
    Type=simple
    User=YOUR_USERNAME
    ExecStart=/usr/bin/Xvfb :99 -screen 0 1920x1080x24
    Restart=always
    
    [Install]
    WantedBy=multi-user.target

    В ExecStart мы настраиваем разрешение, количество дисплеев и каталог для Xvfb.

  4. Нажмите CTRL+X, затем Y и Enter, чтобы закрыть и сохранить.

Шаг 2: настройка агента для автоматического запуска

  1. Открыть терминал.
  2. Создайте файл службы Xvfb через ввод следующей команды:
    sudo nano /etc/systemd/system/mlx.service
  3. Добавьте содержимое в файл службы (и обязательно замените YOUR_USERNAME на ваше имя пользователя в операционной системе Linux):
    [Unit]
    Description=MLX Agent
    After=xvfb.service
    Requires=xvfb.service
    
    [Service]
    Type=simple
    User=YOUR_USERNAME
    Environment=HOME=/home/YOUR_USERNAME
    Environment=DISPLAY=:99
    ExecStartPre=-/usr/bin/pkill -9 -f mlx
    ExecStartPre=-/bin/rm -f /home/YOUR_USERNAME/mlx/agent.lock /home/YOUR_USERNAME/mlx/profiles.lock /home/YOUR_USERNAME/mlx/launcher.lock
    ExecStart=/usr/bin/mlx
    Restart=on-failure
    RestartSec=5
    
    [Install]
    WantedBy=multi-user.target

    Давайте разберемся, что делает эта услуга:

    В [Unit] мы ожидаем завершения работы службы Xvfb, чтобы избежать ошибок отображения.
    В разделе [Service] мы задаем пользователя, директории home и переменную отображения. Переменная отображения задается в службе агента, а не в Xvfb, иначе агент не смог бы ее использовать.
    Затем с помощью команды ExecStartPre мы завершаем все оставшиеся процессы агента и удаляем файлы .lock  — это полезно в случае перезапуска службы.
    ExectStart — это путь к исполняемому файлу агента в Linux .

  4. Нажмите CTRL+X, затем Y и Enter, чтобы закрыть и сохранить.

Шаг 3: включите и загрузите службы

  1. Перезагрузить daemon (фоновую службу, которая загружает другие службы):
    sudo systemctl daemon-reload
  2. Включите агенты Xvfb и Multilogin в качестве служб:
    sudo systemctl enable xvfb.service mlx.service
  3. Для запуска служб используйте systemctl (утилиту управления системными службами):
    sudo systemctl start xvfb.service
    sudo systemctl start mlx.service
    Поздравляем! Теперь агент и Xvfb будут запускаться при загрузке операционной системы.

Для управления службами используйте systemctl

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

Проверить статус службы

Давайте получим статус сервиса с помощью:

sudo systemctl status xvfb.service

Вы увидите действия службы Xvfb. Вы также можете изменить xvfb.service на имя вашей службы, если оно отличается.

Выведите журналы

Выведите журналы действий службы с помощью команды journalctl:

journalctl -u mlx.service

Вы также можете ограничить количество строк. С помощью этой команды вы можете ограничить количество строк до 100:

journalctl -u mlx.service -n 100

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

journalctl -u mlx.service --since "30 minutes ago"

-f используется для отображения логов в реальном времени:

journalctl -u mlx.service -f

Будьте в курсе

Следите за обновлениями, общайтесь и смотрите примеры.

Открыть новостиКанал в TelegramЗадать вопросЧат в TelegramПосмотреть кейсыСообщество в Discord