群晖Docker界面只能配置Docker镜像源，不影响容器内Composer的Packagist源；真正生效需在Dockerfile中RUN composer config -g repo.packagist、启动时传COMPOSER_REPO_PACKAGIST环境变量或挂载config.json到容器用户HOME目录。
群晖 Docker 容器里没法直接“一键”设 Composer 中文镜像——因为 Composer 不在宿主机运行，而是在你构建的 PHP 容器内部，镜像源必须落在容器环境里才生效。
为什么在群晖 Web 界面改不了 Composer 镜像
群晖 Docker 应用界面改的是 docker pull 的 registry 镜像源（比如 registry.docker-cn.com），只影响镜像下载；它对容器内运行的 composer install 完全无感。Composer 请求的是 Packagist 元数据，走的是 HTTP(S)，和 Docker registry 是两套体系。
- 你在群晖 UI 里加了阿里云 Docker 镜像加速器 →
docker pull php:8.2变快了，但composer require laravel/framework还是直连packagist.org - 群晖没提供“容器内 Composer 配置”入口，所有配置必须在容器启动前或构建时完成
- 试图在容器里执行
composer config -g repo.packagist ...会失败：默认挂载的/root/.composer权限不对，且该路径在 Alpine/Debian 基础镜像中可能根本不存在
真正生效的三种做法（按推荐顺序）
核心原则：镜像源配置必须出现在容器的用户 HOME 目录下、且被 composer 进程实际读到。
-
构建阶段写死（最稳）：在
Dockerfile里用RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/。这样每个镜像都自带镜像源，无需额外操作 -
启动时注入（适合已有镜像）：用
docker run -e COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ ...。PHP 容器启动后，composer会优先读这个环境变量，覆盖默认源 -
挂载配置文件（需手动维护）：准备一个
config.json（内容为{"repositories": {"packagist.org": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}}），挂载到容器内/root/.composer/config.json或/home/www-data/.composer/config.json（取决于容器用户）
容易踩的坑：Alpine 镜像 + 权限 + 缓存三连击
群晖上跑的 PHP 容器多用 Alpine，这里几个关键点不处理就卡死：
-
apk add --no-cache ca-certificates必须有，否则composer报SSL certificate problem - 别用
root用户跑 PHP 容器（群晖默认就是 root），否则vendor/写入没问题，但宿主机挂载目录权限混乱；建议在Dockerfile里加USER 1001，再RUN chown -R 1001:1001 /var/www -
composer clear-cache在容器里执行一次，否则旧缓存仍指向packagist.org，速度没变化；验证方式：进容器跑composer show monolog/monolog -vvv 2>&1 | grep Downloading，看域名是不是mirrors.aliyun.com
群晖 DSM 7.2+ 下快速验证是否生效
别信“命令跑完”，要抓包级证据：
- 进入容器：
docker exec -it <容器名> sh - 清缓存：
composer clear-cache - 触发一次真实请求：
composer show symfony/console 6.4.* --no-plugins -vvv 2>&1 | grep -A1 "Downloading" - 如果看到类似
Downloading https://mirrors.aliyun.com/composer/p2/symfony/console.json，说明成了；如果还是packagist.org或报Could not fetch，回头检查COMPOSER_REPO_PACKAGIST环境变量或config.json挂载路径
复杂点在于：群晖没有 CLI 环境，所有操作得靠 Dockerfile 构建或 docker exec 手动敲；而每次改镜像源都得重建镜像或重启容器——这恰恰说明，它不是“设置”，而是环境定义的一部分。
