Dockerode在Node.js中调用createContainer（绑定挂载场景）无错误挂起，容器已创建但未启动

问题分析 #

从你的描述来看，容器已经被Docker daemon创建（docker ps -a能看到Created状态），但docker.createContainer()的异步调用一直挂起、不返回也不报错，这说明Docker daemon在处理你的请求时卡住了，没有给Dockerode返回响应。结合你用了bind mount的场景，最常见的原因是安全限制（比如Ubuntu的AppArmor）、文件系统权限/挂载限制，或者Docker daemon与Dockerode的版本兼容问题。

排查与解决步骤 #

1. 先看Docker daemon日志，定位核心问题

这是最关键的一步，Docker daemon的日志会告诉你它在处理createContainer请求时到底卡在哪里。在你的EC2实例上运行：

journalctl -u docker.service -f

然后触发你的API调用，观察日志输出。如果是权限或安全限制问题，这里会直接给出错误提示（比如AppArmor阻止访问挂载目录）。

2. 测试Docker CLI直接创建容器，排除Dockerode的问题

用Docker CLI手动执行和你代码中一样的容器创建命令，看是否也会卡住：

# 替换成你代码中实际的mountSource路径
docker create --name test-container -v /path/to/your/mnt/containers/xxx:/app imageName

• 如果CLI也卡住：问题出在Docker daemon与挂载目录的交互上，和Dockerode无关，重点排查挂载目录的安全限制或文件系统问题。
• 如果CLI正常完成：那问题可能在Dockerode的版本、配置，或者代码中的参数细节。

3. 排查AppArmor安全限制（Ubuntu默认启用）

Ubuntu默认用AppArmor做强制访问控制，Docker的默认安全配置可能不允许访问你创建的/mnt/containers目录。这是我遇到过类似场景的最常见原因：

• 临时切换AppArmor到“警告模式”测试：

  sudo aa-complain /etc/apparmor.d/docker
  

  然后重新触发你的API调用，如果问题解决，说明就是AppArmor的限制。
• 永久解决：修改Docker的AppArmor规则，允许访问你的挂载目录。编辑/etc/apparmor.d/docker，添加一行：

  /mnt/containers/** rw,
  

  然后重新加载AppArmor规则：

  sudo apparmor_parser -r /etc/apparmor.d/docker
  

4. 检查挂载目录的文件系统与权限细节

虽然你已经设置了0o777权限，但还要注意：

• 挂载目录所在的磁盘是否有特殊挂载选项（比如noexec、nodev）？用mount | grep /mnt查看，如果有这些选项，可能会阻止Docker正常访问目录，尝试换一个目录（比如/home/ubuntu/mnt/containers）测试。
• 确认你的Node.js进程有访问该目录的权限：虽然你创建了目录，但Node.js的运行用户（比如ubuntu或node）是否真的能读写？可以在代码里加一行await fs.promises.access(mountSource, fs.constants.R_OK | fs.constants.W_OK)验证。

5. 检查Dockerode与Docker daemon的版本兼容性

Dockerode的API需要和Docker daemon的版本匹配，如果两者版本差异过大，可能出现请求挂起的问题：

• 查看Docker daemon版本：docker -v
• 查看Dockerode版本：npm list dockerode
• 尝试升级Dockerode到最新版：

  npm install dockerode@latest
  

  或者降级到与Docker daemon版本兼容的版本（参考Dockerode的官方文档）。

6. 简化代码参数，排除资源限制干扰

暂时去掉Memory、NanoCpus等资源限制参数，只保留最核心的容器创建配置（镜像、名称、挂载），看是否还会挂起。有时候资源限制的参数格式错误（比如NanoCpus的取值）也可能导致daemon处理异常。

额外提示 #

你的代码里加了Promise.race的超时逻辑，但如果超时触发后没有被上层代码捕获，可能导致请求看起来“无错误挂起”。确保调用createContainer函数的上层代码有完善的try/catch逻辑，能捕获超时错误。

内容来源于stack exchange