M1 MacBook上Docker镜像构建停滞问题求助

调试步骤与解决方法 #

1. 开启apt调试日志定位卡点 #

在Dockerfile的apt-get命令前添加verbose参数，明确卡点是源解析还是包下载阶段：

# 输出apt详细执行日志
RUN apt-get update -v
# 或者配置apt调试级别的日志
RUN echo 'Debug::Acquire::Http "true";' > /etc/apt/apt.conf.d/debug.conf
RUN apt-get update && apt-get install -y <你的依赖包>

2. 替换适配amd64的国内apt源 #

国外源在M1的amd64模拟环境下访问速度极慢，直接替换为国内镜像源：

# Debian系统替换为阿里云源
RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list
RUN sed -i 's/security.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list

# Ubuntu系统替换命令：
# RUN sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
# RUN sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list

RUN apt-get update && apt-get install -y <你的依赖包>

3. 优化QEMU模拟性能 #

M1运行amd64镜像依赖QEMU模拟，资源不足或配置不当会导致卡顿：

• 打开Docker Desktop设置，进入「Features in development」，开启Use the new Virtualization framework，提升模拟性能；
• 进入「Resources」，将CPU分配调至4核以上，内存调至8G以上，避免资源瓶颈。

4. 强制apt使用IPv4 #

部分源的IPv6解析存在问题，强制apt走IPv4：

RUN echo 'Acquire::ForceIPv4 "true";' > /etc/apt/apt.conf.d/99force-ipv4
RUN apt-get update && apt-get install -y <你的依赖包>

5. 验证platform配置有效性 #

确认docker-compose.yml中的platform: linux/amd64已生效：

# 构建后检查镜像架构
docker inspect <你的镜像名> | grep Architecture

输出应为"Architecture": "amd64"，若未生效，检查是否所有服务都配置了该字段。

6. 尝试切换原生arm64镜像（优先推荐） #

如果项目依赖的镜像提供arm64版本，直接移除platform: linux/amd64配置，使用原生arm64镜像，彻底避免模拟性能问题：

# docker-compose.yml中移除platform字段，或明确指定arm64镜像
services:
  app:
    image: ubuntu:jammy-arm64

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