Docker构建时mise install超时失败，求助排查原因

问题场景 #

基于Ubuntu 24.04/Debian镜像编写Dockerfile，安装依赖后通过curl安装mise，执行mise install ruby@3、mise install node等任意工具安装命令均会超时；使用mise.toml执行mise install也触发同样问题。该现象仅在Docker构建过程中出现，主机终端执行完全正常，切换到Fedora 39镜像则可正常运行。

可能的原因及解决方法 #

• DNS解析异常：Ubuntu/Debian基础镜像默认DNS配置可能存在解析延迟或失败，导致mise无法正常连接资源服务器。
  解决：Dockerfile中手动指定可靠DNS，或者构建时传入参数：

  # 在Dockerfile中设置
  RUN echo "nameserver 8.8.8.8" > /etc/resolv.conf
  

  或者构建命令：

  docker build --dns 8.8.8.8 .
  

• CA证书缺失导致HTTPS连接失败：Ubuntu/Debian镜像可能缺少必要的CA证书，使得mise无法建立安全的HTTPS连接下载资源。
  解决：安装并更新CA证书：

  RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates && update-ca-certificates
  

• 默认下载源访问缓慢：mise默认的工具下载源在Ubuntu/Debian容器内访问速度过慢，引发超时。
  解决：手动指定镜像源，可通过环境变量或mise.toml配置：

  # Dockerfile中设置环境变量
  ENV MISE_NODE_MIRROR=https://npmmirror.com/mirrors/node
  ENV MISE_RUBY_MIRROR=https://cache.ruby-lang.org/pub/ruby
  

  或者在mise.toml中添加：

  [env]
  MISE_NODE_MIRROR = "https://npmmirror.com/mirrors/node"
  

• Docker网络模式限制：默认的容器网络模式可能存在出站请求限制，导致连接超时。
  解决：尝试使用host网络模式构建（注意该模式下容器与主机共享网络，需考虑安全风险）：

  docker build --network host .
  

• TCP参数配置差异：Ubuntu/Debian容器默认的TCP参数配置可能导致连接重试次数或超时时间不合理，引发连接失败。
  解决：调整TCP参数：

  RUN echo "net.ipv4.tcp_syn_retries = 3" >> /etc/sysctl.conf && sysctl -p
  

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