Alpine 3.16+ 中 apk add composer 必然失败，因官方已移除该包；必须用 curl 安装并提前安装 git、unzip、curl，且需多阶段构建、严格清理缓存与冗余文件，否则镜像体积虚增超100MB。
Alpine 3.16+ 中 apk add composer 必然失败，这不是配置问题，是 Alpine 官方主动移除该包；必须用 curl 安装，且构建阶段要严格隔离、运行阶段要彻底清理，否则镜像体积会虚增 100MB 以上。
为什么 apk add composer 在 Alpine 3.16+ 上一定报错
错误信息是 ERROR: unable to select packages，不是网络或权限问题。Alpine 维护者明确将 Composer 归类为“PHP 应用层工具”，拒绝纳入系统包管理器分发——它对 git、unzip 的版本要求与 musl 环境存在兼容性冲突。即使你从旧版镜像拉取到 v1.x 版本，也会因缺 ext-phar 或 zlib 支持直接报 Class 'Phar' not found。
安装前必须装齐 git、unzip、curl，装完立刻删
官方安装命令 curl -sS https://getcomposer.org/installer | php 在 Alpine 上静默失败的主因，是底层工具缺失：拉私有仓库依赖 git，解压 ZIP 包依赖 unzip，HTTPS 下载依赖 curl。不提前装，composer install 会卡在 Cloning into 或 failed to extract。
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
-
apk add --no-cache git unzip curl—— 必须带--no-cache，否则/var/cache/apk/会残留进镜像层 - 装完立即执行
apk del --purge git unzip curl—— 否则这些工具连同 musl libc、BusyBox 全打进最终镜像 - 别跳过
ca-certificates：apk add --no-cache ca-certificates防止 HTTPS 握手失败
多阶段构建中 composer install 的执行顺序不能错
缓存是否生效，完全取决于 COPY 和 RUN 的顺序。错一步，整个 vendor 层就失效重装。
- 先
COPY composer.json composer.lock ./—— 单独这一步，不带其他文件 - 紧跟着
RUN composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction—— 缺--no-interaction遇到私有包会挂起；缺--no-dev会让vendor/多出测试、文档、bin 脚本等非运行内容 - 再
COPY . .（或只复制源码子目录）—— 避免覆盖已缓存的vendor/层 - builder 阶段末尾加清理：
RUN rm -rf /tmp/* /root/.composer /var/cache/apk/*
最终镜像里最常被忽略的“隐形体积杀手”
很多人以为 COPY --from=builder 就万事大吉，但路径写错或漏清理，会导致大量无用文件残留。
-
COPY --from=builder /app .是典型错误 —— 它会把.git、tests/、docs/、vendor/bin/全拖进来 - 正确写法：
COPY --from=builder /app/vendor /var/www/html/vendor+COPY . /var/www/html - 检查 final 镜像是否含以下内容：
/root/.composer、/tmp/composer*、vendor/bin/、vendor/*/tests—— 这些都不该存在 - 换源不是可选项：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾斜杠），否则国内环境基本卡死
