为何Docker容器无法通过主机名ping通Jenkins边车容器？

你的问题核心是Jenkins流水线中，自定义Docker网络内的容器无法通过容器名解析对方，只能用IP通信。这是因为Jenkins的inside()方法默认会修改容器的DNS配置，导致无法使用Docker内置的DNS服务来解析容器名。

解决方案1：改用withRun() + docker exec替代inside() #

inside()方法是Jenkins插件封装的容器交互方式，会自动注入一些主机配置（比如DNS），干扰Docker自定义网络的DNS解析。换成withRun()启动容器，再用docker exec执行命令，就能正常使用容器名解析：

node {
    // 创建自定义网络（不存在则创建）
    sh 'docker network inspect my-network >/dev/null 2>&1 || docker network create --driver bridge my-network'

    docker.image('alpine:latest').withRun('--name container1 --network my-network', 'tail -f /dev/null') { c ->
        sh 'docker ps --filter network=my-network'

        // 启动container2并通过exec执行ping
        docker.image('alpine:latest').withRun('--name container2 --user root --network my-network', 'tail -f /dev/null') { c2 ->
            sh """
                timeout 10s sh -c "until docker exec container2 ping container1 -c 1; do sleep 1; done"
            """
        }
    }
    // 可选：清理临时容器
    sh 'docker rm -f container1 container2 2>/dev/null || true'
}

解决方案2：给inside()指定Docker内置DNS #

如果一定要用inside()，可以在启动参数里强制指定Docker的内置DNS服务器（127.0.0.11），让容器能解析自定义网络内的容器名：

node {
    sh 'docker network inspect my-network >/dev/null 2>&1 || docker network create --driver bridge my-network'

    docker.image('alpine:latest').withRun('--name container1 --network my-network', 'tail -f /dev/null') { c ->
        sh 'docker ps --filter network=my-network'

        docker.image('alpine:latest').inside('--user root:root --network my-network --dns 127.0.0.11') {
            sh """
                timeout 10s sh -c "until ping container1; do sleep 1 ; done"
            """
        }
    }
}

关键说明 #

• Docker自定义网络的容器名解析依赖内置的DNS服务（127.0.0.11），而Jenkins的inside()默认会把容器的DNS改成主机的DNS，导致无法解析容器名。
• 你提到的--link参数确实已废弃，自定义网络是正确的替代方案，但要确保容器的DNS配置正确指向Docker内置DNS。

内容的提问来源于stack exchange，提问作者jewbix.cube