You need to enable JavaScript to run this app. Puppeteer启动Chrome报No usable sandbox错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Puppeteer启动Chrome报No usable sandbox错误如何解决?

问题说明

你遇到的错误是Linux环境下Chrome运行依赖的沙箱机制未正确配置导致的启动失败,核心报错如下:

[0702/102126.236473:FATAL:zygote_host_impl_linux.cc(116)] No usable sandbox!

正规解决方案

以下为官方推荐的两种正规修复方案,均不需要关闭沙箱安全机制:

方案1:配置SUID沙箱(适合内核版本较低、无法启用用户命名空间的场景)

  • 找到Puppeteer配套安装的Chromium目录,定位其中的chrome_sandbox二进制文件,默认路径为node_modules/puppeteer/.local-chromium/<系统架构对应目录>/chrome-linux/chrome_sandbox
  • 切换到root用户执行以下命令配置权限:
chown root:root /path/to/chrome_sandbox
chmod 4755 /path/to/chrome_sandbox
  • 在启动Node服务前配置环境变量指定沙箱路径:
export CHROME_DEVEL_SANDBOX=/path/to/chrome_sandbox

也可以将该环境变量配置到你的服务启动脚本中,避免每次手动设置。

方案2:开启内核用户命名空间(推荐,内核版本≥3.8优先使用)

该方案无需修改Chromium相关文件,系统级配置一次即可永久生效:

  • 临时生效(重启后恢复):
    sysctl -w kernel.unprivileged_userns_clone=1
  • 永久生效:
    1. 编辑/etc/sysctl.conf文件,添加一行配置:kernel.unprivileged_userns_clone=1
    2. 执行sysctl -p让配置立即生效
注意事项
  • 不建议长期使用--no-sandbox启动参数,该配置会关闭Chrome的安全沙箱防护,若访问不可信页面会存在严重的远程代码执行风险,仅可用于本地临时调试场景。

内容的提问来源于stack exchange,提问作者MemZ

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.12 03:33:03