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 - 永久生效:
- 编辑
/etc/sysctl.conf文件,添加一行配置:kernel.unprivileged_userns_clone=1 - 执行
sysctl -p让配置立即生效
- 编辑
注意事项
- 不建议长期使用
--no-sandbox启动参数,该配置会关闭Chrome的安全沙箱防护,若访问不可信页面会存在严重的远程代码执行风险,仅可用于本地临时调试场景。
内容的提问来源于stack exchange,提问作者MemZ
相关产品推荐
相关产品推荐

