在 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:手动下载(推荐用于生产环境)
- 访问 Chrome for Testing 或旧版的 ChromeDriver 下载页。
- 根据 Chrome 主版本号下载对应的 Linux 64-bit 驱动。
- 解压并重命名到系统路径:
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. 最佳实践建议
- 使用非 Root 用户:虽然
--no-sandbox允许 root 运行,但出于安全考虑,建议在云服务器上创建一个普通用户(如automation-user)来运行测试脚本。 - 资源限制:在 CI/CD 流水线中,并发运行多个 Chrome 实例时,注意 CPU 和内存限制。每个无头 Chrome 实例大约占用 100-300MB 内存,取决于网页复杂度。
- Docker 优化:如果是在 Docker 容器中运行,建议使用官方镜像
selenium/node-chrome或自建精简镜像,避免安装不必要的 GUI 组件。 - 监控日志:Chrome 无头模式出错时不会弹出 GUI 错误框,务必查看标准输出/错误日志 (
stderr) 或使用--log-level=INFO参数捕获详细日志。
通过以上步骤,你可以在 Ubuntu 服务器上稳定地运行 Chrome 进行自动化测试。如果遇到特定版本的兼容性问题,优先检查 Chrome 与 Chromedriver 的主版本号是否对齐。
云技术博客