如何将Docker Swarm动态容器接入现有网络并实现API调用

错误原因 #

当你用docker stack deploy部署Swarm服务时，Compose文件中定义的网络会自动添加Stack名称作为前缀。你部署时指定的Stack名称是app，所以实际网络名称是app_mynetwork，而非你代码中写的mynetwork，这就是提示“network not found”的根本原因。

验证实际网络名称 #

在Swarm节点上执行以下命令查看所有网络，确认目标网络的真实名称：

docker network ls

你会看到类似app_mynetwork的条目（前缀是你的Stack名称）。

正确实现方式 #

方式一：创建容器时直接指定目标网络（推荐） #

直接在容器创建参数中指定正确的网络名称，无需额外调用network.connect：

const Docker = require("dockerode");

const docker = new Docker({
  socketPath: "/var/run/docker.sock",
});

// 替换为实际的网络名称
const targetNetwork = "app_mynetwork";

const container = await docker.createContainer({
  Image: '1234567890',
  // 方式1：使用NetworkMode指定单网络
  NetworkMode: targetNetwork,
  // 方式2：使用Networks字段（支持多网络，更灵活）
  // Networks: [
  //   {
  //     Target: targetNetwork
  //   }
  // ]
});

await container.start();

方式二：先创建容器再连接网络 #

如果需要动态调整网络，可以先创建容器，再连接到目标网络：

const Docker = require("dockerode");

const docker = new Docker({
  socketPath: "/var/run/docker.sock",
});

const targetNetwork = "app_mynetwork";
const network = docker.getNetwork(targetNetwork);

const container = await docker.createContainer({
  Image: '1234567890',
  // 可使用默认网络，或不指定网络
});

// 连接到目标网络
await network.connect({
  Container: container.id,
});

await container.start();

优化方案：固定网络名称 #

如果你不想依赖Stack前缀，可以在docker-compose.yml中给网络指定固定名称，这样Swarm部署时不会自动添加前缀：

services:
  myapp:
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    networks:
      - mynetwork
    ports:
      - 3000:3000
networks:
  mynetwork:
    name: mynetwork  # 固定网络名称

修改后重新部署Stack，代码中就可以直接使用mynetwork作为网络名称。

额外注意事项 #

• 动态容器接入mynetwork后，即可通过http://myapp:3000访问服务，Swarm的Overlay网络内置服务发现功能。
• 确保myapp容器挂载的/var/run/docker.sock拥有足够的权限操作Docker API（通常默认权限即可）。

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