Docker容器中LuaRocks安装lpdf依赖时PDFLIB头文件缺失问题求助

• 先安装系统级PDFlib依赖
  lpdf是PDFlib的Lua绑定，必须先让系统具备PDFlib的头文件和库文件。根据你使用的Docker镜像系统选择对应命令：

  • Debian/Ubuntu系镜像：

    apt-get update && apt-get install -y libpdflib-dev
    

  • Alpine系镜像：

    apk add --no-cache pdflib-dev
    

  优先用系统包管理器安装，比手动编译更省心。

• 安装lpdf时指定PDFlib路径
  如果luarocks无法自动识别PDFlib位置，安装时加上PDFLIB_DIR参数。系统包安装的PDFlib一般在/usr目录下，所以执行：

  luarocks install lpdf PDFLIB_DIR=/usr
  

• 把步骤写入Dockerfile实现自动化
  给你一个Debian系的Dockerfile示例，构建镜像时会自动完成所有安装步骤：

  FROM debian:bookworm-slim
  
  # 安装基础工具、LuaRocks和PDFlib依赖
  RUN apt-get update && apt-get install -y --no-install-recommends \
      lua5.4 luarocks libpdflib-dev \
      && rm -rf /var/lib/apt/lists/*
  
  # 安装lpdf
  RUN luarocks install lpdf PDFLIB_DIR=/usr
  

• 系统包无PDFlib时的手动编译方案
  要是官方源找不到PDFlib，就手动下载源码编译安装：

  # 下载兼容lpdf的PDFlib源码版本（示例用9.1.0）
  wget https://www.pdflib.com/binaries/PDFlib/9.1.0/PDFlib-9.1.0.tar.gz
  tar -xzf PDFlib-9.1.0.tar.gz
  cd PDFlib-9.1.0
  ./configure --prefix=/usr/local
  make && make install
  

  之后安装lpdf时指定编译后的路径：

  luarocks install lpdf PDFLIB_DIR=/usr/local
  

内容的提问来源于stack exchange，提问作者N.Ekanayake