Docker容器中FFmpeg音乐机器人内存泄漏问题求助

核心原因 #

• Docker容器的PID 1进程默认是node，它不具备原生init进程（如systemd）的孤儿进程回收能力，导致FFmpeg子进程退出后残留资源无法释放。
• fluent-ffmpeg在容器环境中未被正确清理，进程引用和临时资源没及时释放。
• Ubuntu最新镜像的系统配置与原生环境存在差异，可能导致内存回收机制失效。

解决方案 #

1. 用tini接管PID 1进程 #

tini是专门的容器初始化工具，能自动回收孤儿进程，解决资源泄漏问题。修改Dockerfile：

FROM ubuntu:latest
USER root
WORKDIR /app

# 安装tini
RUN apt-get update && apt-get install -y tini
RUN apt-get install -y curl gnupg
RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash -
RUN apt-get install -y nodejs ffmpeg
COPY . .
RUN mkdir /app/storage/
RUN npm install

# 用tini启动node进程
ENTRYPOINT ["/usr/bin/tini", "--"]
CMD ["node", "."]

2. 强制清理fluent-ffmpeg资源 #

在代码中确保FFmpeg任务结束后彻底销毁进程、释放引用并清理临时文件：

// 示例代码，根据实际逻辑调整
let ffmpegProcess;

function processSong(songPath) {
  ffmpegProcess = ffmpeg(songPath)
    .on('end', () => {
      // 销毁进程+释放引用
      ffmpegProcess.kill('SIGKILL');
      ffmpegProcess = null;
      // 删除临时文件
      fs.unlinkSync(tempOutputPath);
    })
    .on('error', (err) => {
      // 异常时同样清理
      if (ffmpegProcess) {
        ffmpegProcess.kill('SIGKILL');
        ffmpegProcess = null;
      }
      fs.unlinkSync(tempOutputPath);
    })
    .save(tempOutputPath);
}

3. 限制容器资源+优化镜像 #

• 启动容器时强制限制内存，避免内存耗尽：

docker run --memory=512m --memory-swap=512m your-image-tag

• 清理Ubuntu镜像的apt缓存，减少冗余文件：
  在Dockerfile的apt-get install命令后添加：

RUN apt-get clean && rm -rf /var/lib/apt/lists/*

4. 更换轻量基础镜像 #

改用node官方镜像，减少系统层面的兼容性问题：

FROM node:18-bullseye
WORKDIR /app

# 安装FFmpeg和tini
RUN apt-get update && apt-get install -y ffmpeg tini \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

COPY . .
RUN mkdir /app/storage/
RUN npm install

ENTRYPOINT ["/usr/bin/tini", "--"]
CMD ["node", "."]

验证方式 #

处理几首歌曲后，用docker stats查看容器内存变化，再用docker exec <容器ID> ps aux检查是否有残留的FFmpeg进程，确认资源是否正常回收。

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