Docker构建FFmpeg镜像时libx265未安装，容器内执行make install却生效

核心排查方向 #

1. FFmpeg编译配置未正确关联libx265 #

编译FFmpeg时必须显式指定--enable-libx265参数，若配置日志未出现libx265 detected相关内容，说明依赖未被正确识别。

2. 动态库加载或缓存问题 #

Docker构建过程中，动态库缓存未更新可能导致FFmpeg安装后无法找到libx265；或编译时的库路径与运行时搜索路径不匹配。

3. 组件编译顺序冲突 #

若先编译安装VVenC再安装libx265，可能导致FFmpeg配置阶段优先调用VVenC组件，忽略系统级libx265。

具体修复步骤 #

步骤1：完整安装libx265依赖 #

在Dockerfile中同时安装开发包与运行时依赖：

RUN apt-get update && apt-get install -y --no-install-recommends \
    libx265-dev \
    libx265-192 \
    && rm -rf /var/lib/apt/lists/*

步骤2：调整编译顺序与FFmpeg配置参数 #

先安装所有基础依赖，再编译VVenC，最后编译FFmpeg并显式启用libx265：

# 安装编译基础工具与依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    git \
    cmake \
    pkg-config \
    yasm \
    libx265-dev \
    libx265-192 \
    && rm -rf /var/lib/apt/lists/*

# 编译安装VVenC
RUN git clone https://github.com/fraunhoferhhi/vvenc.git && \
    cd vvenc && mkdir build && cd build && \
    cmake .. && make -j$(nproc) && make install && \
    cd ../.. && rm -rf vvenc

# 编译安装FFmpeg，显式配置libx265
RUN git clone https://git.ffmpeg.org/ffmpeg.git && \
    cd ffmpeg && \
    ./configure \
        --enable-gpl \
        --enable-libx265 \
        --enable-shared \
        --disable-static \
        --prefix=/usr/local && \
    make -j$(nproc) && make install && \
    # 更新动态库缓存
    ldconfig && \
    cd .. && rm -rf ffmpeg

步骤3：验证配置阶段的libx265识别 #

在Dockerfile中添加配置日志检查，确保FFmpeg正确识别libx265：

RUN cd ffmpeg && \
    ./configure \
        --enable-gpl \
        --enable-libx265 \
        --enable-shared \
        --disable-static \
        --prefix=/usr/local 2>&1 | grep -i x265 && \
    make -j$(nproc) && make install && \
    ldconfig

若未检测到libx265，需指定pkg-config搜索路径：

RUN echo "PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/lib/x86_64-linux-gnu/pkgconfig" >> /etc/profile && \
    source /etc/profile

步骤4：规避Docker构建缓存干扰 #

在安装依赖前添加--no-cache参数，或用ARG变量触发缓存失效：

ARG BUILD_DATE=unknown
RUN apt-get update --no-cache && apt-get install -y --no-install-recommends \
    libx265-dev \
    libx265-192 \
    && rm -rf /var/lib/apt/lists/*

验证方法 #

构建镜像后进入容器，执行以下命令：

ffmpeg -codecs | grep x265

正常输出应包含EV.L. h265 H.265 / HEVC (High Efficiency Video Coding)，其中E表示编码器可用。

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