努力
加油

Ubuntu服务器如何配置Chrome浏览器用于自动化测试?

在 Ubuntu 服务器上配置 Chrome 用于自动化测试(通常指 Selenium、Playwright 或 Puppeteer),核心难点在于无头环境(Headless Environment)。服务器没有图形界面(GUI),所以必须让 Chrome 以“无头模式”运行,并处理好依赖库和权限问题。

以下是基于生产环境经验的标准操作流程,分为 Chrome 安装、驱动匹配、依赖解决 和 验证测试 四个步骤。

1. 安装 Google Chrome

不要直接通过 apt install google-chrome-stable 简单安装,因为版本可能过旧且容易缺失依赖。推荐使用官方 .deb 包手动安装,以确保版本可控。

# 1. 下载最新稳定版 Chrome (以当前最新为例,实际使用时请检查官网获取最新链接)
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

# 2. 安装依赖并安装 deb 包
sudo apt-get update
sudo apt-get install -y ./google-chrome-stable_current_amd64.deb

# 3. 验证安装
google-chrome --version

注意:如果你使用的是 Docker 容器或极简 Linux 发行版,可能需要先安装 libnss3, libatk-bridge2.0-0, libcups2 等基础库,否则 Chrome 无法启动。

2. 安装 Chromedriver

关键点:Chromedriver 的版本必须与 Chrome 浏览器的主版本号严格一致。例如,Chrome 是 114.x.x.x,Chromedriver 也必须是 114.x.x.x。

方法 A:手动下载(推荐用于生产环境)

  1. 访问 Chrome for Testing 或旧版的 ChromeDriver 下载页。
  2. 根据 Chrome 主版本号下载对应的 Linux 64-bit 驱动。
  3. 解压并重命名到系统路径:
unzip chromedriver_linux64.zip
sudo mv chromedriver /usr/local/bin/
sudo chmod +x /usr/local/bin/chromedriver

方法 B:使用自动化工具管理(推荐用于开发/CI)

如果使用 Python,可以使用 webdriver-manager;如果使用 Node.js,Puppeteer/Playwright 会自动管理驱动。

# Python 示例
pip install webdriver-manager

3. 关键配置:无头模式与沙箱权限

在服务器环境下,Chrome 默认的安全策略会阻止其启动。你需要传递特定的命令行参数。

必加参数解释:

  • --headless=new:启用新版无头模式(比旧的 --headless 更稳定,渲染更接近真实浏览器)。
  • --no-sandbox:必须。在 root 用户或非特权用户下运行时,Chrome 需要此参数来禁用沙箱。注意:在生产环境中,建议创建非 root 用户运行 Chrome,而不是直接使用 root + no-sandbox,以提高安全性。
  • --disable-gpu:在无头模式下禁用 GPU 提速,避免某些兼容性问题。
  • --disable-dev-shm-usage:解决 /dev/shm 内存不足导致的崩溃问题(尤其在 Docker 中常见)。
  • --remote-debugging-port=9222:可选,用于调试连接。

4. 代码示例验证

以下提供 Python (Selenium) 和 Node.js (Puppeteer) 两种主流语言的快速验证脚本。

Python (Selenium) 示例

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

def test_headless_chrome():
    chrome_options = Options()
    chrome_options.add_argument("--headless=new")
    chrome_options.add_argument("--no-sandbox")
    chrome_options.add_argument("--disable-dev-shm-usage")
    chrome_options.add_argument("--disable-gpu")
    # 添加用户XX,避免被部分网站识别为机器人
    chrome_options.add_argument("--user-agent=Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36")

    # 使用 webdriver-manager 自动处理驱动路径
    driver = webdriver.Chrome(
        service=Service(ChromeDriverManager().install()), 
        options=chrome_options
    )

    try:
        driver.get("https://www.baidu.com")
        print(f"Title: {driver.title}")
        assert "百度" in driver.title
        print("✅ Chrome Headless 测试成功!")
    except Exception as e:
        print(f"❌ 测试失败: {e}")
    finally:
        driver.quit()

if __name__ == "__main__":
    test_headless_chrome()

Node.js (Puppeteer) 示例

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    headless: 'new', // 使用新版无头模式
    args: [
      '--no-sandbox',
      '--disable-setuid-sandbox',
      '--disable-dev-shm-usage',
      '--disable-gpu'
    ],
    executablePath: '/usr/bin/google-chrome-stable' // 如果未加入 PATH,需指定绝对路径
  });

  const page = await browser.newPage();
  await page.goto('https://www.example.com');

  const title = await page.title();
  console.log(`Page Title: ${title}`);

  await browser.close();
})();

5. 常见问题排查 (Troubleshooting)

现象 可能原因 解决方案
cannot find Chrome binary 环境变量未配置 确认 which google-chrome 有输出,或在代码中指定 executablePath
DevToolsActivePort file doesn't exist 端口冲突或未正确关闭 确保没有其他 Chrome 进程残留,或使用 --no-first-run
GLIBCXX_3.4.xx not found 系统库版本过低 Ubuntu 18.04/20.04 通常没问题,若是 CentOS 7 需升级 glibc 或使用兼容版 Chrome
页面加载超时/空白 缺少字体或媒体库 安装 fonts-liberation, libasound2, libgbm1 等依赖
内存溢出 (OOM) /dev/shm 太小 添加 --disable-dev-shm-usage 参数

6. 最佳实践建议

  1. 使用非 Root 用户:虽然 --no-sandbox 允许 root 运行,但出于安全考虑,建议在云服务器上创建一个普通用户(如 automation-user)来运行测试脚本。
  2. 资源限制:在 CI/CD 流水线中,并发运行多个 Chrome 实例时,注意 CPU 和内存限制。每个无头 Chrome 实例大约占用 100-300MB 内存,取决于网页复杂度。
  3. Docker 优化:如果是在 Docker 容器中运行,建议使用官方镜像 selenium/node-chrome 或自建精简镜像,避免安装不必要的 GUI 组件。
  4. 监控日志:Chrome 无头模式出错时不会弹出 GUI 错误框,务必查看标准输出/错误日志 (stderr) 或使用 --log-level=INFO 参数捕获详细日志。

通过以上步骤,你可以在 Ubuntu 服务器上稳定地运行 Chrome 进行自动化测试。如果遇到特定版本的兼容性问题,优先检查 Chrome 与 Chromedriver 的主版本号是否对齐。