Configuration serveur headless pour BotBrowser sur Ubuntu

Configuration requise du serveur

• OS : Ubuntu 20.04 ou 22.04 LTS
• RAM : 4 Go minimum (8 Go+ pour instances multiples)
• CPU : 2+ coeurs
• Disque : 10 Go+ d'espace libre

Etape 1 : Installer les dependances

sudo apt-get update
sudo apt-get install -y \
  wget ca-certificates fonts-liberation \
  libasound2 libatk-bridge2.0-0 libatk1.0-0 \
  libcups2 libdbus-1-3 libdrm2 libgbm1 \
  libgtk-3-0 libnspr4 libnss3 \
  libxcomposite1 libxdamage1 libxrandr2 \
  xdg-utils xvfb

Etape 2 : Configurer l'affichage virtuel

Xvfb :10 -screen 0 1920x1080x24 &
export DISPLAY=:10.0

Pour une configuration persistante, creez un service systemd :

# /etc/systemd/system/xvfb.service
[Unit]
Description=X Virtual Frame Buffer
After=network.target

[Service]
ExecStart=/usr/bin/Xvfb :10 -screen 0 1920x1080x24
Restart=always

[Install]
WantedBy=multi-user.target

Etape 3 : Installer BotBrowser

wget https://github.com/botswin/BotBrowser/releases/download/latest/botbrowser-linux.tar.gz
tar -xzf botbrowser-linux.tar.gz -C /opt/botbrowser/
chmod +x /opt/botbrowser/chrome
DISPLAY=:10.0 /opt/botbrowser/chrome --version

Etape 4 : Executer avec Playwright

npm install playwright-core

const { chromium } = require('playwright-core');

(async () => {
  const browser = await chromium.launch({
    executablePath: '/opt/botbrowser/chrome',
    args: [
      '--disable-setuid-sandbox',
      '--bot-profile=/opt/profiles/profile.enc',
    ],
    headless: true,
    defaultViewport: null,
  });

  const page = await (await browser.newContext()).newPage();
  await page.goto('https://example.com');
  console.log('Title:', await page.title());
  await browser.close();
})();

Executez avec : DISPLAY=:10.0 node script.js

Conseils de production

Gestion des processus. Utilisez PM2 ou systemd :

npm install -g pm2
DISPLAY=:10.0 pm2 start script.js --name botbrowser-worker

Instances multiples. Chaque instance necessite son propre --user-data-dir :

for i in $(seq 1 5); do
  DISPLAY=:10.0 /opt/botbrowser/chrome \
    --bot-profile="/opt/profiles/profile-${i}.enc" \
    --user-data-dir="/tmp/bb-session-${i}" &
done

Depannage

"Cannot open display" : Assurez-vous que Xvfb est en cours d'execution et que DISPLAY=:10.0 est defini.

Segfault au demarrage : Executez ldd /opt/botbrowser/chrome | grep "not found" pour trouver les bibliotheques manquantes.

Utilisation memoire elevee : Definissez --js-flags="--max-old-space-size=512" pour limiter le heap JS.

Processus zombies : Appelez toujours browser.close() et gerez SIGTERM.