Chromy生产环境部署完全指南Linux无头运行、cleanup()资源清理与稳定性实践【免费下载链接】chromyChromy is a library for operating headless chrome. 项目地址: https://gitcode.com/gh_mirrors/ch/chromyChromy是一个用于操控无头浏览器Headless Chrome的 Node.js 库它通过 Chrome DevTools Protocol 直接与浏览器通信无需 Xvfb 等虚拟屏幕依赖因此天生适合在 Linux 服务器上部署。本文面向新手带你完成 Chromy 无头模式的 Linux 部署、掌握cleanup()资源清理的正确姿势并给出一份可直接照做的生产稳定性实践清单。一、部署前准备Linux 无头运行的两个前提 Chromy 运行在服务器上只需要满足两个硬性条件依赖版本要求说明Node.js6 及以上安装后执行npm i chromyChrome60 及以上无头模式自 Chrome 59 起受支持建议装最新版安装时最容易被忽视的是Chrome 可执行文件路径的指定。Chromy 支持两种方式定位浏览器二者在 src/index.js 中按优先级合并构造函数选项chromePath显式传入 Chrome 可执行文件路径环境变量CHROME_PATH适合 Docker、CI/CD 等部署场景一次设置全局生效。 新手提示Debian/Ubuntu 系服务器上可用google-chrome-stableCentOS 系可装chromium。装完后用google-chrome-stable --version确认版本 ≥ 60。二、无头模式是如何自动生效的无需手动加参数很多教程会让你手动拼一堆--headless启动参数但 Chromy 已经帮你封装好了。打开启动器封装 src/util.js可以看到它的默认行为visible: false默认值自动追加--headless、--hide-scrollbars、--mute-audio三个参数浏览器完全在后台运行不占用任何显示资源Linux 平台自动加--no-sandbox源码中明确处理了这一平台差异见 src/util.js 中process.platform linux分支避免容器或 root 环境下 Chromium 沙箱报错内置一组生产友好的启动参数禁用后台网络、同步、弹窗拦截等干扰项减少服务器上的副作用。此外你仍可通过chromeFlags选项自定义追加参数每项必须以--开头否则 Chromy 会主动抛错。如果想复用已启动的浏览器实例而不是新起一个把launchBrowser设为false即可此时通过host默认 localhost和port默认 9222远程连接。三、cleanup() 资源清理防止 Chrome 进程泄漏的关键 这是生产部署中最重要的一节。Chromy 内部用一个全局instances数组登记所有已启动的浏览器实例见 src/index.js 中的instances.push(this)并据此提供两级清理 API1. 单实例收尾chromy.close()每个任务结束时调用close()它会关闭 CDP 连接、杀掉由 Chromy 启动的 Chrome 进程、移除 SIGINT 监听器并把实例从登记表中摘除。这是最常用的收尾动作示例写法可参考 examples/basic.js。2. 全局一键清场Chromy.cleanup()静态方法当你不确定自己创建了多少个实例比如多线程任务、批量截图服务时cleanup()会遍历所有登记实例并并发调用close()实现见 src/index.js 中的static async cleanup()。官方推荐的配合方式如下process.on(SIGINT, async () { await Chromy.cleanup() process.exit(1) })⚠️ 一个容易踩的坑Chromy 自身也会注册 SIGINT 处理器。当你调用start()启动浏览器后按下 CtrlC 时它会自动close()并退出退出码 130。所以正常流程下忘了 close通常会被兜底但如果你的服务以守护进程方式长期运行、频繁创建实例务必在每次任务结束时显式close()并周期性调用Chromy.cleanup()防止异常路径漏掉的实例累积否则服务器内存会被残留的 Chrome 进程悄悄吃光。四、稳定性实践超时、错误分类与进程监控 ️1. 用超时限流别让任务挂死Chromy 为三类高风险操作各自提供独立超时默认均为 30 秒可在构造时按需调整选项作用对应错误类型waitTimeoutwait()等待超时WaitTimeoutErrorgotoTimeoutgoto()页面加载超时GotoTimeoutErrorevaluateTimeoutevaluate()脚本执行超时EvaluateTimeoutError所有超时错误都继承自统一的TimeoutError基类错误定义集中在 src/error.js。生产代码里建议按错误名精确分支WaitTimeoutError通常意味着页面结构变更可重试或告警GotoTimeoutError多为网络问题适合指数退避重试。2. 用心跳检测脚本巡检无头环境仓库自带 scripts/status.js它分别在无头模式与可见模式下启动 Chrome探测printToPDF、getWindowForTarget等关键能力是否可用。把它纳入部署后的冒烟测试能快速验证服务器上的 Chrome 是否完整支持无头打印等功能pdf()仅在无头模式可用Chrome 60。3. 长任务监控建议通过getDOMCounters()定期采样 DOM 节点与 JS 监听器数量节点数异常膨胀往往是页面脚本泄漏的信号批量任务如 examples/screenshot.js 所示的多截图场景建议串行化 每轮close()避免并发打开过多浏览器实例。五、生产上线清单 ✅部署完成前逐项打勾Chrome ≥ 60 已安装CHROME_PATH或chromePath已配置使用默认visible: false未手动引入 Xvfb 依赖每个任务结束时显式chromy.close()异常路径走finally兜底进程级注册SIGINT→Chromy.cleanup()waitTimeout / gotoTimeout / evaluateTimeout按业务 SLA 调优超时错误按类型分支处理重试 / 告警部署后跑一次scripts/status.js冒烟验证六、延伸阅读 完整 API 与选项说明README.md核心实现实例登记与 cleanup 逻辑src/index.js启动参数与 Linux 平台处理src/util.js错误类型定义src/error.js测试用例可当作最小可运行示例test/更新历史CHANGELOG.md按以上步骤配置后Chromy 就能以极低的资源占用在 Linux 服务器上长期稳定运行无头浏览器任务。记住两条铁律能 close 就 close兜底交给 cleanup()。【免费下载链接】chromyChromy is a library for operating headless chrome. 项目地址: https://gitcode.com/gh_mirrors/ch/chromy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考