You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Docker入门教程镜像构建失败:STEP 2超时无法获取Alpine包

解决Docker构建时Alpine镜像源超时问题

针对你遇到的Alpine源下载超时问题,提供以下几种可行的解决方法:

1. 更换国内Alpine镜像源

默认官方源在国内访问易出现网络波动,替换为国内镜像源可直接解决超时问题。修改Dockerfile,在执行apk add前先替换源:

# 替换为阿里云Alpine镜像源
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories
RUN apk add --no-cache python2 g++ make

也可选择清华镜像源,替换命令为:

RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories

2. 调整Docker构建的网络配置

  • 使用宿主机网络模式构建:绕过Docker默认网络隔离,让构建过程直接使用宿主机网络环境,命令如下:
    docker build --network host --no-cache .
    
  • 检查代理配置:若Docker daemon配置了代理但代理不可用,会导致源访问失败。可临时移除代理配置,或确认代理地址、端口正常后再构建。

3. 更新Alpine基础镜像版本

你当前使用的Alpine v3.15属于旧版本,官方对旧版本源的维护力度有限,换成最新稳定版(如v3.18或更高)可提升源的稳定性:

# 替换为最新稳定版Alpine镜像
FROM alpine:3.18

之后再执行apk add命令,新的源地址会更稳定。

4. 本地缓存依赖包(备选方案)

若上述方法均无效,可手动下载所需索引文件和依赖包,构建时复制到容器内的APK缓存目录实现本地安装:

  1. 手动下载对应版本的APKINDEX.tar.gz文件和python2、g++、make的APK包
  2. 在Dockerfile中添加COPY命令,将文件复制到容器的/var/cache/apk/目录:
    COPY APKINDEX.tar.gz /var/cache/apk/
    COPY *.apk /var/cache/apk/
    RUN apk add --no-cache python2 g++ make
    

内容的提问来源于stack exchange,提问作者smarn

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.10 22:55:17