端口映射是开发与部署容器化应用时至关重要的环节。通常，我们在创建容器时建立容器内部端口与宿主机端口之间的连接。然而，在某些情况下，我们需要向正在运行的容器动态添加新的端口映射。这在开发、调试或临时暴露新服务端点时尤其有用。本文将详细介绍如何在不停止容器的情况下动态添加端口映射。

1. 背景知识

容器端口映射的基本原理

在 Docker 中，容器内部端口与宿主机端口之间通过端口映射建立连接。通常，我们在启动容器时使用 -p 或 --publish 参数指定端口映射，示例如下：

docker run -d -p 8080:80 nginx

上述命令将宿主机的 8080 端口映射到容器内的 80 端口。这样，外部用户就可以通过宿主机的 8080 端口访问容器内运行的 Web 服务。

动态添加端口映射的挑战

容器启动后，Docker 通常不支持动态添加新的端口映射。也就是说，容器初始的端口映射在整个生命周期内固定不变。如果需要添加更多端口映射，传统方法是停止并重启容器，但这会导致服务中断，在生产环境中不可接受。

2. 实现方案

要为正在运行的容器动态添加端口映射，可以采用以下几种方法：

2.1 使用 docker network 创建代理容器

在与原容器相同的网络中创建一个新的代理容器，并将新的端口映射添加到代理容器中。具体步骤如下：首先，在与原容器相同的网络上创建代理容器：

docker run -d --name proxy-container --net container:your-container nginx

然后，向代理容器添加所需的端口映射：

docker run -d -p 8081:81 --net container:your-container nginx

使用此方法无需修改原容器即可添加新的端口映射，但会引入一个额外的容器实例，并且可能不适用于所有场景。

2.2 使用 iptables 手动添加端口转发规则

通过修改 iptables，可以将宿主机特定端口的请求转发到运行中的 Docker 容器内部端口。例如，要将宿主机的 8081 端口映射到容器的 81 端口，可使用以下命令：

iptables -t nat -A DOCKER -p tcp --dport 8081 -j DNAT --to-destination <container_ip>:81

其中 <container_ip> 是容器的内部 IP 地址，可通过 docker inspect 命令获取。此方法添加端口映射非常灵活，但需要熟悉 iptables，且由于复杂性，不建议在生产环境中频繁使用。

2.3 使用 socat 创建端口转发

socat 是一个通用的网络工具，可以在宿主机和容器之间建立端口转发。运行以下命令即可将宿主机特定端口转发到容器内的指定端口：

socat TCP-LISTEN:8081,fork TCP:<container_ip>:81

此方法的优点是不需要停止容器。但 socat 是一个额外的进程，需要注意其性能与稳定性。其他端口转发工具也能实现类似效果。

2.4 使用 Docker Compose 动态更新服务

如果你的应用使用 Docker Compose 管理容器，可以通过更新 docker-compose.yml 文件并执行 docker-compose up 来添加新的端口映射。此方法方便且统一管理，但每次更新都需要重新应用 Compose 文件，可能导致短暂的服务中断。

2.5 强制修改容器配置文件

首先，直接修改 /var/lib/docker/containers/<container_id>/config.v2.json 文件，添加将宿主机 8081 端口映射到容器 81 端口的配置。注意需要修改两个部分。在一个部分中，只需添加 HostPort 8081：

    "ExposedPorts": {
      "8080/tcp": {}
      "8081/tcp": {}
    },

在另一个部分中，需要添加完整的映射关系：

   "Ports": {
      "80/tcp": [
        {
          "HostIp": "0.0.0.0",
          "HostPort": "8080"
        },
      ],
      "81/tcp": [
        {
          "HostIp": "0.0.0.0",
          "HostPort": "8081"
        },
      ]
    },

此外，还需要修改 /var/lib/docker/containers/<container_id>/hostconfig.json，添加新的映射：

  "PortBindings": {
    "80/tcp": [
      {
        "HostIp": "",
        "HostPort": "8080"
      },
     "81/tcp": [
      {
        "HostIp": "",
        "HostPort": "8081"
      }
    ]
  },

最后，需要重启 dockerd：

sudo systemctl restart docker

此方法可以永久地为容器添加端口映射，但由于重启 dockerd 会导致宿主机上所有容器停止。如果容器没有配置自动启动，dockerd 重启后它们不会自动启动。虽然该方法有效，但对正在运行的容器影响较大，不建议在生产环境中使用。

3. 结论

尽管 Docker 本身不支持动态添加容器端口映射，但上述方法可以在一定程度上实现该功能。每种方法各有优缺点，开发者可根据具体需求选择最合适的方案。在生产环境中，推荐使用代理容器或 Docker Compose，因为它们相对简单且风险较低。对于需要频繁更改端口映射的应用，建议在设计阶段考虑灵活的网络架构，以避免在容器运行时频繁修改端口映射，从而减少服务中断。

你可以访问 Novita AI 了解更多信息。