如何给已经运行中的 Docker 容器添加或者修改端口映射？

容器还没有构建

如果你的容器还没有构建时，想添加端口映射时，你只需要在创建容器的时候添加 -p 参数，想添加几个端口映射就追加几个 -p 参数。类似于如下示例：

docker run --name your-container-name \
-v /Users/xxx/glory/codes/dfo/api_hyperf:/api_hyperf \
-p 9502:9502 \
-p 9503:9503 \
-p 9504:9504 \
-p 9505:9505 -it \
--entrypoint /bin/sh \
alex/alex_api:v1.0

容器已经构建，但是想修改或者添加端口时

先停止掉正在运行的容器。

以下内容都是以容器 id 为 cbe26510c276 进行操作的，请务必将容器 id 换成你自己需要修改的容器 id。

docker stop {容器的名称或者 id }
# 比如：
docker stop cbe26510c276

查看容器完整的 hash_of_the_container 数值

docker inspect {容器的名称或者 id } | grep Id

# 比如：
docker inspect cbe26510c276 | grep Id
# 会得到如下结果：
# "Id": "cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00"

打开 hostconfig.json 配置文件

vim /var/lib/docker/containers/{hash_of_the_container}/hostconfig.json
# 比如：
vim /var/lib/docker/containers/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00/hostconfig.json

如果你不想先查看完整的容器 hash_of_the_container 数值，你也可以直接先切换到当前容器相关目录中 cd /var/lib/docker/containers/{hash_of_the_container}* ， 然后再去编辑 hostconfig.json 配置文件。

cd /var/lib/docker/containers/{hash_of_the_container}*
# 比如：
cd /var/lib/docker/containers/cbe26510c276*
# 然后再去编辑 `hostconfig.json` 配置文件
vim hostconfig.json

修改 hostconfig.json 配置文件

在 hostconfig.json 配置文件中，找到 "PortBindings":{} 这个配置项，然后进行修改。我这里添加了两个端口映射，分别将宿主机的 8502 端口以及 8505 端口映射到容器的 8502 端口和 8505 端口。

HostPort 对应的端口代表 宿主机 的端口。
建议容器使用什么端口，宿主机就映射什么端口，方便以后管理。当然，具体情况，具体分析。

{
    "Binds": [
        "/data/portal_api_dfo_hyperf/:/portal_api_dfo_hyperf"
    ],
    "ContainerIDFile": "",
    "LxcConf": [],
    "Memory": 0,
    "MemorySwap": 0,
    "CpuShares": 0,
    "CpusetCpus": "",
    "Privileged": false,
    "PortBindings": {
        "8502/tcp": [
            {
                "HostIp": "",
                "HostPort": "8502"
            }
        ],
        "8505/tcp": [
            {
                "HostIp": "",
                "HostPort": "8505"
            }
        ]
    },
    "Links": null,
    "PublishAllPorts": false,
    "Dns": null,
    "DnsSearch": null,
    "ExtraHosts": null,
    "VolumesFrom": null,
    "Devices": [],
    "NetworkMode": "bridge",
    "IpcMode": "",
    "PidMode": "",
    "CapAdd": null,
    "CapDrop": null,
    "RestartPolicy": {
        "Name": "no",
        "MaximumRetryCount": 0
    },
    "SecurityOpt": null,
    "ReadonlyRootfs": false,
    "Ulimits": null,
    "LogConfig": {
        "Type": "",
        "Config": null
    },
    "CgroupParent": ""
}

如果 config.v2.json 配置文件或者 config.json 配置文件中也记录了端口，也需要进行修改，如果没有，就不需要改。
只需要修改 "ExposedPorts": {} 相关之处。

{
    "State": {
        "Running": false,
        "Paused": false,
        "Restarting": false,
        "OOMKilled": false,
        "Dead": false,
        "Pid": 0,
        "ExitCode": 137,
        "Error": "",
        "StartedAt": "2021-05-17T07:48:26.743090016Z",
        "FinishedAt": "2021-07-02T06:05:33.025441199Z"
    },
    "ID": "cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00",
    "Created": "2020-12-23T07:02:00.997803339Z",
    "Path": "/bin/sh",
    "Args": [],
    "Config": {
        "Hostname": "cbe26510c276",
        "Domainname": "",
        "User": "",
        "Memory": 0,
        "MemorySwap": 0,
        "CpuShares": 0,
        "Cpuset": "",
        "AttachStdin": true,
        "AttachStdout": true,
        "AttachStderr": true,
        "PortSpecs": null,
        "ExposedPorts": {
            "8502/tcp": {},
            "8505/tcp": {}
        },
        "Tty": true,
        "OpenStdin": true,
        "StdinOnce": true,
        "Env": [
            "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
            "SW_VERSION=v4.5.10",
            "COMPOSER_VERSION=2.0.8",
            "PHPIZE_DEPS=autoconf dpkg-dev dpkg file g++ gcc libc-dev make php7-dev php7-pear pkgconf re2c pcre-dev pcre2-dev zlib-dev libtool automake"
        ],
        "Cmd": null,
        "Image": "hyperf/hyperf:7.4-alpine-v3.11-swoole",
        "Volumes": null,
        "WorkingDir": "",
        "Entrypoint": [
            "/bin/sh"
        ],
        "NetworkDisabled": false,
        "MacAddress": "",
        "OnBuild": null,
        "Labels": {
            "license": "MIT",
            "maintainer": "Hyperf Developers <group@hyperf.io>",
            "version": "1.0"
        }
    },
    "Image": "f503e215646f50e5242a6bdf1c6a9a176910c99600b3472b390892f59c87c3a1",
    "NetworkSettings": {
        "IPAddress": "",
        "IPPrefixLen": 0,
        "MacAddress": "",
        "LinkLocalIPv6Address": "",
        "LinkLocalIPv6PrefixLen": 0,
        "GlobalIPv6Address": "",
        "GlobalIPv6PrefixLen": 0,
        "Gateway": "",
        "IPv6Gateway": "",
        "Bridge": "",
        "PortMapping": null,
        "Ports": null
    },
    "ResolvConfPath": "/var/lib/docker/containers/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00/resolv.conf",
    "HostnamePath": "/var/lib/docker/containers/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00/hostname",
    "HostsPath": "/var/lib/docker/containers/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00/hosts",
    "LogPath": "/var/lib/docker/containers/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00/cbe26510c276fa9a4487a8c2af8cbb49410f2a5305149d2b26eb8ce37c777d00-json.log",
    "Name": "/portal_api_dfo_hyperf",
    "Driver": "aufs",
    "ExecDriver": "native-0.2",
    "MountLabel": "",
    "ProcessLabel": "",
    "AppArmorProfile": "",
    "RestartCount": 0,
    "UpdateDns": false,
    "Volumes": {
        "/portal_api_dfo_hyperf": "/data/portal_api_dfo_hyperf"
    },
    "VolumesRW": {
        "/portal_api_dfo_hyperf": true
    },
    "AppliedVolumesFrom": null
}

最后重启 docker，然后查看容器相关配置信息是否已经修改完毕

# 重启 docker
service docker restart 
# 或者
systemctl restart docker

# 查看容器相关配置信息
docker inspect {容器的名称或者 id }
# 比如：
docker inspect cbe26510c276

# 配置符合你的要求后，再次启动容器
docker start {容器的名称或者 id }
# 比如：
docker start cbe26510c276