Puppeteer在cPanel服务器无法启动，缺失依赖问题求助

AI 小北

2026-8-12

解决cPanel服务器上Puppeteer启动失败（缺失libatk-bridge-2.0.so.0）的方案

针对你在cPanel共享主机上无法安装系统依赖的情况，以下是几个可行的解决办法：

启用无沙箱模式+禁用GPU及不必要的硬件加速
cPanel共享主机通常不支持Chrome的沙箱机制，且硬件资源受限，添加这些启动参数可以绕过系统依赖问题：

const browser = await puppeteer.launch({
  args: [
    '--no-sandbox',
    '--disable-setuid-sandbox',
    '--disable-gpu',
    '--disable-dev-shm-usage', // 解决共享主机/dev/shm空间不足的常见问题
    '--disable-software-rasterizer'
  ]
});

使用静态编译的Chromium二进制文件
官方Puppeteer自带的Chromium依赖系统库，你可以下载无需系统依赖的静态编译版Chromium，上传到cPanel服务器的可访问目录，然后指定executablePath：
```
const browser = await puppeteer.launch({
  executablePath: '/home/oyaaducr/public_html/static-chrome/chrome', // 替换为你上传的实际路径
  args: ['--no-sandbox', '--disable-setuid-sandbox']
});
```
注：静态编译版Chromium无需安装系统依赖，直接可执行。

优化无头模式参数（针对Puppeteer v19+）
使用新版无头模式并减少进程数，进一步降低对系统依赖的要求：

const browser = await puppeteer.launch({
  headless: 'new',
  args: [
    '--no-sandbox',
    '--disable-setuid-sandbox',
    '--disable-gpu',
    '--disable-dev-shm-usage',
    '--no-zygote',
    '--single-process',
    '--disable-extensions',
    '--disable-features=VizDisplayCompositor'
  ]
});