Docker环境下Jenkins构建安装pngquant失败求助（附依赖列表）

遇到pngquant安装失败的情况，大多是因为系统缺少必要依赖、npm权限不足或者预编译二进制包下载失败导致的，下面给你几个针对性的解决方案：

方案1：直接安装系统级的pngquant（最省心） #

image-webpack-loader会优先使用系统中已安装的pngquant，跳过npm包的下载编译步骤。根据你的Jenkins镜像系统类型执行对应的命令：

如果你用的是Debian/Ubuntu系的Jenkins镜像（比如官方jenkins/jenkins:lts） #

在构建脚本的最开头添加：

# 切换到root用户执行安装（Jenkins默认用jenkins用户，权限不够）
sudo apt-get update && sudo apt-get install -y pngquant

如果你用的是Alpine系的轻量Jenkins镜像 #

执行：

sudo apk add --no-cache pngquant

方案2：解决npm安装权限与网络问题 #

如果不想安装系统级工具，可以调整npm的安装参数，解决权限和预编译包下载的问题：

1. 添加权限参数：Jenkins运行用户通常没有root权限，安装pngquant-bin的脚本需要特殊权限，所以安装时加上：

npm install --unsafe-perm=true --allow-root

--unsafe-perm会让npm以root权限运行安装脚本，避免权限被限制。

2. 配置国内镜像加速下载：如果是网络问题导致预编译包下载失败，可以在执行npm install前设置pngquant-bin的镜像源：

# 临时设置镜像源
npm config set pngquant-bin_binary_host_mirror=https://npm.taobao.org/mirrors/pngquant-bin/
# 然后执行安装
npm install

或者把这个配置写到项目的.npmrc文件里，永久生效：

pngquant-bin_binary_host_mirror=https://npm.taobao.org/mirrors/pngquant-bin/

方案3：安装编译依赖，允许从源码编译 #

如果预编译包下载失败，npm会尝试从源码编译pngquant，但需要系统有编译环境。同样根据系统类型安装依赖：

Debian/Ubuntu系 #

sudo apt-get update && sudo apt-get install -y build-essential libpng-dev make gcc

Alpine系 #

sudo apk add --no-cache build-base libpng-dev make gcc

安装完这些依赖后，再执行npm install就能让npm自动从源码编译pngquant了。

额外建议：把依赖预装到Jenkins镜像里 #

如果你的Jenkins是长期使用的，建议直接修改Dockerfile，把需要的依赖预先安装好，避免每次构建都重复执行安装命令：

# 基于官方Jenkins LTS镜像
FROM jenkins/jenkins:lts

# 切换到root用户安装依赖
USER root
RUN apt-get update && apt-get install -y pngquant build-essential libpng-dev
# 切回jenkins用户
USER jenkins

重新构建镜像后，后续的构建任务就不会再遇到pngquant的安装问题了。

内容的提问来源于stack exchange，提问作者HarveyD