容器中composer config -g白设，因每次启动新建~/.composer且未挂载；必须在Dockerfile构建阶段执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/并clear-cache，或改用项目级repositories数组配置确保跨环境生效。
直接在容器里执行 composer config -g 不会同步镜像源到其他环境，它只改当前容器的 ~/.composer/config.json，而这个路径在每次 docker run 后都是全新的——除非你显式挂载了宿主机目录或用了多阶段构建的缓存层。
为什么 composer config -g 在容器里设了也白设
常见错误现象：docker run --rm -v $(pwd):/app php:8.2-cli composer install 依然卡在 Loading composer repositories；composer config -g repo.packagist 输出为空或仍是 https://packagist.org。
根本原因：官方 PHP 镜像（如 php:8.2-cli）默认没初始化 ~/.composer 目录，composer config -g 会静默失败；且容器每次启动都用新用户、新家目录，配置不持久。
- 基础镜像中
composer可能未安装，或装在非标准路径（比如 Alpine 里没unzip就装不上） - 运行用户（如
root）对/root/.composer有写权限，但 PHP 进程实际以www-data或自定义 UID 运行，读不到该路径 - 没配
ca-certificates（尤其 Alpine），HTTPS 握手失败，报SSL certificate problem却不提示具体原因
Dockerfile 中预设镜像源的正确写法
必须在构建阶段就写入全局配置，并清除旧缓存，否则 composer install 仍走默认源。
关键点：
- URL 末尾必须带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（否则请求变成/composerpackages.json，404） - 命令必须显式指定
composer类型：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Alpine 镜像要先装证书：
RUN apk add --no-cache ca-certificates - 紧接在
composer install前加composer clear-cache，否则缓存中的旧元数据会覆盖新配置
示例片段：
FROM php:8.2-cli-bullseye
RUN apt-get update && apt-get install -y unzip curl
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ && \
composer clear-cache多阶段构建中镜像源为何失效
builder 阶段配了源，final 阶段 composer install 却又卡住——这不是配置漏了，是环境断层了。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
典型问题：
- builder 用
php:8.2-cli-bullseye，final 用php:8.2-fpm-alpine：PHP 小版本虽同，但发行版不同，autoload_classmap.php路径生成逻辑不一致，导致 vendor 下的类加载失败 - builder 阶段
COPY composer.json composer.lock ./顺序反了（lock在后），触发了隐式update，绕过 lock 文件约束 - final 阶段没重新执行
composer config -g，也没挂载/root/.composer，它压根没配置
解决办法：builder 和 final 必须用完全一致的基础镜像（包括 tag 和发行版），且 final 阶段若需运行 Composer（如热更新），应复用 builder 的 .composer 目录或通过 COPY --from=builder /root/.composer /root/.composer 显式传递。
项目级配置比全局配置更可靠
想让所有开发机、CI、容器都走同一镜像源？别依赖 composer config -g，直接改 composer.json。
Composer 2.2+ 要求 repositories 是数组，且第一项必须显式禁用官方源：
"repositories": [
{"packagist.org": false},
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]注意：
- 不能写成对象形式：
"repositories": {"packagist.org": false, ...}—— 这会被忽略 - 私有 VCS 包要插在第二项之后，不能删掉第一项
- 改完后必须删掉
vendor/和composer.lock，再跑composer install，否则lock里 dist URL 还是https://api.github.com/
真正容易被忽略的是：这个配置一旦提交进 Git，就自动生效于所有环境，不需要任何容器内命令、也不依赖用户家目录是否存在——这才是“同步”的本质。
