单纯换镜像源对Docker构建加速效果有限，因容器不读宿主机配置，必须在Dockerfile中显式执行RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/并清缓存，否则仍直连packagist.org。
单纯换 Composer 镜像源对 Docker 构建加速效果非常有限——容器内不读宿主机配置，composer install 默认仍直连 packagist.org，卡在 Downloading https://packagist.org/packages.json 是常态。
为什么宿主机配了镜像，Docker 构建还是慢？
构建阶段的 composer install 在临时容器里执行，它完全隔离于你的本地环境。你在终端运行的 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 只写进 ~/.composer/config.json，而这个文件不会自动复制进构建上下文。
- 错误现象：日志里反复出现
Downloading https://packagist.org/xxx或长时间停在Loading composer repositories - 根本原因：Dockerfile 里没显式配置镜像源，容器启动后默认走官方源，国内访问极慢甚至超时
- 验证方法：在
RUN composer install前加一行RUN composer config -g repo.packagist，输出若仍是https://packagist.org，说明没生效
Dockerfile 中必须写的三类镜像配置方式
只有把镜像源“写进构建流程”，才能真正提速。以下三种方式可直接复用，推荐按优先级选用：
-
RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/：最稳妥，全局生效，适用于所有后续composer命令 -
COPY .composer/config.json /root/.composer/config.json：适合已有预配置好的config.json文件，避免命令拼错风险 -
RUN composer install --repository=https://mirrors.aliyun.com/composer/：参数直连，语义清晰、不依赖全局状态，CI 场景更可复现
注意：--repository 参数只对当次命令有效；--global 必须在 RUN 指令中执行，不能靠 ENTRYPOINT 或运行时补。
立即学习“PHP免费学习笔记（深入）”；
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
镜像源配置常踩的三个硬伤
90% 的“配了还是慢”问题，源于命令写错但 Composer 静默忽略：
- 键名写成
repos.packagist（多一个s）→ Composer 2.x 完全不识别，回退官方源 - 漏掉中间的
composer类型参数：composer config -g repo.packagist https://...❌，必须是composer config -g repo.packagist composer https://...✅ - URL 缺末尾斜杠：
https://mirrors.aliyun.com/composer❌ → 路径拼接出错，返回 404；正确写法是https://mirrors.aliyun.com/composer/✅
验证是否真生效：composer config -g repo.packagist 输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null 或仍为 packagist.org 都说明失败。
别让镜像源优化白忙活：缓存链断裂比网络还致命
即使用了阿里云镜像，如果 Dockerfile 写法不当，每次代码变更仍会触发全量重装——这时镜像源再快也没用。
-
COPY composer.json composer.lock ./必须放在RUN composer install之前，且位置尽量靠前 - 严禁在
COPY composer.json composer.lock ./和RUN composer install之间插入任何其他RUN指令（如RUN chmod、RUN mkdir），否则破坏 layer 缓存 - 加上
--no-dev --optimize-autoloader --no-scripts参数，跳过非必要操作，缩短单次执行时间 - 若依赖里含
git地址或dev-master，镜像源无效——这类包需单独处理，不能只指望换源
最易被忽略的一点：镜像源只加速下载环节，但 Resolving dependencies 卡住，大概率是 composer.json 版本约束太宽、PHP 内存不足或启用了 xdebug，和镜像无关。
