如何去除Dockerode捕获的Docker容器日志中的意外控制字符

你看到的\u0001\u0000\u0000\u0000\u0000\u0000\u0000\b这类控制字符，是Docker日志帧的头部元数据。当容器未开启TTY（Tty: false）时，Docker会为每条日志添加8字节的头部：前4字节标识流类型（0x01对应stdout，0x02对应stderr），后4字节用小端序记录日志内容的长度，用来区分标准输出和错误输出。

以下两种方案可以帮你获取干净的日志内容：

方案1：手动解析日志帧（推荐，支持区分流） #

编写解析函数剥离日志帧头部，只保留实际输出内容。修改后的代码如下：

import Docker from "dockerode";

const docker = new Docker({ socketPath: "//./pipe/docker_engine" });

// 解析Docker日志帧，去除头部元数据
const parseDockerLogFrame = (buffer) => {
  let offset = 0;
  const output = [];
  
  while (offset < buffer.length) {
    // 读取后4字节的内容长度（小端序）
    const contentLength = buffer.readUInt32LE(offset + 4);
    offset += 8;
    
    // 提取并拼接实际日志内容
    const content = buffer.toString("utf8", offset, offset + contentLength);
    output.push(content);
    offset += contentLength;
  }
  
  return output.join("");
};

const startContainer = async (command) => {
  let codeOutput = "";
  let container;
  try {
    container = await docker.createContainer({
      Image: "image-name",
      Cmd: ["bash", "-c", command],
      Tty: false,
    });

    await container.start();
    const stream = await container.logs({
      stdout: true,
      stderr: true,
      follow: true,
    });

    stream.on("data", (data) => {
      // 处理日志数据，剥离头部
      codeOutput += parseDockerLogFrame(data);
    });
  } catch (error) {
    throw new Error(`Error occurred while starting container: ${error}`);
  }

  try {
    await container.wait();
    await container.remove();
  } catch (error) {
    throw new Error(`Error occurred while removing container: ${error}`);
  }

  return codeOutput;
};

export default { startContainer };

方案2：开启TTY模式（简单但有局限） #

如果不需要区分标准输出和错误输出，可以将容器的Tty参数设为true，此时Docker不会添加日志帧头部，直接输出原始内容：

container = await docker.createContainer({
  Image: "image-name",
  Cmd: ["bash", "-c", command],
  Tty: true, // 开启TTY模式
});

注意：开启TTY后，stdout和stderr会混合输出，无法区分；同时可能会保留终端相关的控制字符，适合输出纯文本的简单场景。

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