Configuracion de servidor headless para BotBrowser en Ubuntu

Requisitos del servidor

• SO: Ubuntu 20.04 o 22.04 LTS
• RAM: 4GB minimo (8GB+ para multiples instancias)
• CPU: 2+ nucleos
• Disco: 10GB+ de espacio libre

Paso 1: Instalar dependencias

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

Paso 2: Configurar display virtual

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

Para configuracion persistente, crea un servicio 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

Paso 3: Instalar 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

Paso 4: Ejecutar con 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();
})();

Ejecutar con: DISPLAY=:10.0 node script.js

Consejos de produccion

Gestion de procesos. Usa PM2 o systemd:

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

Multiples instancias. Cada instancia necesita su propio --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

Solucion de problemas

"Cannot open display": Asegurate de que Xvfb esta ejecutandose y DISPLAY=:10.0 esta establecido.

Segfault al iniciar: Ejecuta ldd /opt/botbrowser/chrome | grep "not found" para encontrar bibliotecas faltantes.

Alto uso de memoria: Establece --js-flags="--max-old-space-size=512" para limitar el heap JS.

Procesos zombie: Siempre llama a browser.close() y gestiona SIGTERM.