Tiusx

Docker构建镜像composer/apt-get网络问题频繁失败

· 开发

composerapt-get国内镜像源

适用环境

  • CI/CD流水线（Jenkins/GitLab CI）
  • Dockerfile中执行各类包管理命令

问题现象

执行docker build构建镜像，composer install或者apt‑get update经常报Connection timed out、Could not resolve host。重试多次偶尔成功，流水线稳定性很差。

排查过程

  1. 修改 /etc/docker/daemon.json，配置国内DNS（114.114.114.114）。
  2. 尝试--network=host构建，故障依旧。
  3. 定位根源：海外软件源（packagist.org、deb.debian.org）国内访问抖动大。

根本原因

Docker构建阶段使用默认bridge网络，跨境访问质量差。包管理器下载元数据，轻微网络抖动就直接构建失败。

解决方案

方案一：替换为国内镜像源（最佳实践）

Composer

RUN composer config -g repo.packagist composer https://packagist.phpcomposer.com

Debian/Ubuntu APT

RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list

Alpine APK

RUN sed -i 's/dl‑cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories

方案二：利用Docker层缓存优化

先复制依赖清单文件，安装依赖，再复制业务源码。依赖文件不变就复用缓存层，减少网络下载次数。

COPY composer.json composer.lock ./
RUN composer install
COPY . .

方案三：搭建私有代理仓库

公司内部搭建Nexus/Private Packagist，构建时直接访问内网源。

方案四：构建使用host网络（测试环境）

docker build --network=host -t myapp .

生产构建不建议，会直接暴露宿主机网络。

小结

容器构建网络问题是高频坑。优先替换国内镜像源，配合Docker分层缓存，可以把构建成功率提升到99.9%以上。