在Docker中通过Jenkins运行Maven遇依赖下载失败及未知主机错误求助

你遇到的核心问题是Docker容器内无法解析Maven仓库的域名，错误提示里的Unknown host mvn是关键信号——这和你用root还是jenkins用户执行命令没关系，主要是容器的网络或配置出了问题。我给你一步步排查和解决的思路：

1. 先验证容器的DNS解析能力 #

首先要确认容器能不能正常解析公网域名。你可以临时启动一个和Maven镜像同环境的容器，执行DNS测试命令：

docker run --rm maven:latest nslookup repo.maven.apache.org

如果返回“NXDOMAIN”或者类似无法解析的结果，说明容器的DNS配置有问题。

解决办法：

• 临时方案：运行Maven容器时手动指定可靠的DNS服务器，比如谷歌的8.8.8.8：

  docker run --dns 8.8.8.8 -v /your/project/path:/app -w /app maven:latest mvn clean install
  

• 永久方案：修改Docker daemon的配置文件（通常是/etc/docker/daemon.json），添加默认DNS：

  {
    "dns": ["8.8.8.8", "8.8.4.4"]
  }
  

  保存后重启Docker服务：systemctl restart docker

2. 检查容器的网络连通性 #

如果DNS解析正常，但还是无法下载，那要确认容器能不能访问公网：

docker run --rm maven:latest ping 8.8.8.8

如果ping不通，说明容器的网络有阻断：

• 检查Jenkins宿主机的防火墙规则，是否允许Docker容器访问外网；
• 如果Jenkins用了自定义Docker网络，确认该网络的连通性，比如切换到默认的bridge网络测试；
• 排查宿主机本身的网络是否正常，比如宿主机能不能ping通公网。

3. 检查Maven配置文件（settings.xml） #

有时候问题出在Maven的仓库地址配置错误——比如不小心把仓库URL写成了http://mvn/...这种不完整的地址，导致解析失败。

你需要检查：

• Jenkins中配置的Maven settings（在Jenkins全局工具配置里）；
• 或者Docker镜像自带的settings.xml（通常在/usr/share/maven/conf/settings.xml）；
• 还有项目根目录下的pom.xml里的仓库配置，确保所有仓库地址都是完整的域名（比如https://repo.maven.apache.org/maven2）。

4. 处理代理环境的情况 #

如果你的Jenkins环境需要通过代理才能访问外网，那Docker容器里也需要配置代理：

• 临时方案：运行容器时通过环境变量传递代理信息：

  docker run -e HTTP_PROXY=http://your-proxy:port -e HTTPS_PROXY=http://your-proxy:port -v /your/project/path:/app -w /app maven:latest mvn clean install
  

• 永久方案：在Maven的settings.xml里配置代理节点：

  <proxies>
    <proxy>
      <id>example-proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>your-proxy</host>
      <port>port</port>
    </proxy>
  </proxies>
  

按照这个顺序排查，应该能快速定位到问题所在——毕竟Unknown host的核心就是域名解析或网络连通的问题，和用户权限无关。

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