安装RTMP模块的Nginx镜像启动报docker-entrypoint找不到nginx错误

• 官方nginx:latest镜像内的Nginx为独立编译的发行版本，未纳入Debian apt软件包管理体系，可执行文件位于/usr/sbin/nginx，不跟随apt源的包管理逻辑变动。
• Dockerfile中执行apt install libnginx-mod-rtmp时，该包的依赖项包含apt源内的完整Nginx发行版。安装过程中apt会识别到当前镜像内的Nginx并非来自官方软件源，直接删除原有独立编译版本的Nginx文件；同时因为文件路径权限、版本不匹配问题，apt源的Nginx安装流程无法正常写入可执行文件，最终造成两个版本的Nginx文件均不存在。
• 容器启动的entrypoint脚本完成所有前置配置检查后，执行exec nginx命令启动服务时，自然会触发“nginx: not found”的报错，和你挂载的自定义nginx配置文件没有关联。

• 调整Dockerfile逻辑，避免apt安装流程破坏原有官方Nginx：不再使用apt直接安装rtmp模块包（该操作会自动拉取系统源的Nginx依赖、覆盖原有文件），改为仅下载rtmp模块的deb包、提取对应动态模块文件，拷贝到Nginx的模块加载目录，不触发系统源Nginx的安装流程。
  可直接使用如下Dockerfile构建镜像：

  FROM nginx:latest
  # 仅提取rtmp动态模块，不安装系统源Nginx
  RUN apt update && \
      apt install -y --no-install-recommends dpkg-dev && \
      apt download libnginx-mod-rtmp && \
      dpkg-deb -x libnginx-mod-rtmp.deb /tmp/rtmp_pkg && \
      cp /tmp/rtmp_pkg/usr/lib/nginx/modules/ngx_rtmp_module.so /usr/lib/nginx/modules/ && \
      # 清理临时文件控制镜像体积
      apt remove -y dpkg-dev && apt autoremove -y && \
      rm -rf /var/lib/apt/lists/* /tmp/rtmp_pkg libnginx-mod-rtmp.deb
  

• 自定义Nginx配置适配：在你挂载的nginx.conf配置文件最开头加载RTMP模块，否则模块无法生效：

  # 配置最开头增加模块加载声明
  load_module modules/ngx_rtmp_module.so;
  

• 构建完成后提前验证：执行docker run --rm mynginx:latest nginx -v确认Nginx可执行文件正常存在、版本输出正常，再执行原有的启动命令即可。

注意：原Dockerfile中安装的build-essential libpcre3 libpcre3-dev libssl-dev包，官方Nginx镜像已经预装了对应的运行依赖，完全不需要额外安装，反而会增大镜像体积、引入不必要的版本冲突。

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