Linux 服务器 Puppeteer 环境搭建指南：CentOS / Rocky yum 依赖完整配置教程

在 Linux 系统（特别是以 yum 作为包管理工具的 CentOS、Rocky Linux 以及部分阿里云服务器环境）上运行 Puppeteer 时，通常需要提前安装 Chromium 所依赖的系统库，否则可能会出现浏览器无法启动或运行异常的问题。

Puppeteer 本质上是通过 Node.js 控制 Chromium 的自动化工具，而 Chromium 在无界面服务器环境中运行时，对图形渲染库、字体库以及沙箱机制都有一定的依赖。因此，在服务器上部署 Puppeteer，完整而稳定的运行环境往往比单纯安装浏览器本身更加重要。

下面是一套相对完整的 yum 依赖安装命令，可以在多数基于 RPM 的 Linux 系统中使用：

sudo yum install -y \
alsa-lib atk cups-libs gtk3 libXcomposite libXcursor libXdamage \
libXext libXi libXtst pango GConf2 nss nspr libXScrnSaver \
libdrm mesa-libgbm xorg-x11-fonts-Type1 xorg-x11-fonts-75dpi \
xorg-x11-fonts-cyrillic xorg-x11-fonts-misc \
libxkbcommon libxshmfence \
ttf-fonts \
glibc \
libstdc++

⭐ 服务器环境下的字体支持

在服务器环境中运行浏览器自动化任务时，字体缺失是导致页面渲染异常，尤其是中文内容乱码的常见原因之一。因此通常会额外安装一组常用的中文字体包：

sudo yum install -y ipa-gothic-fonts wqy-zenhei-fonts

其中包含了较为通用的亚洲字符渲染字体，可以提升多语言页面的显示兼容性。

⭐ Chromium 启动异常时补充依赖

如果 Puppeteer 在启动 Chromium 时仍然出现运行失败的情况，可以再检查以下组件是否已经安装：

sudo yum install -y libappindicator-gtk3
sudo yum install -y libnotify

这些库主要用于补充桌面通知以及部分 GTK 运行时支持，在某些精简化服务器镜像中可能缺失。

✅ 依赖完整性验证

安装完成后，可以通过检查动态链接库的方式确认 Chromium 运行环境是否就绪：

ldd chrome | grep "not found"

如果命令执行后没有返回缺失库信息，通常说明系统依赖已经满足要求，Chromium 可以正常启动。

在生产环境中部署 Puppeteer 时，服务器操作系统版本、glibc 兼容性以及字体支持都会对运行稳定性产生影响。提前构建完整的运行依赖，可以减少后续调试和浏览器自动化任务执行过程中的问题。