群晖DSM无法直接安装Composer，因其非标准Linux系统、PHP精简且/usr/local/bin只读；唯一稳定方案是用Docker运行预装Composer的PHP镜像，并严格配置用户权限、挂载路径与仓库源。
为什么不能直接在DSM终端装Composer
群晖DSM不是标准Linux发行版，没有apt/yum包管理器，自带PHP是精简版——缺json、mbstring、phar扩展，allow_url_fopen=Off且/usr/local/bin挂载为只读。你执行curl -sS https://getcomposer.org/installer | php会卡在SSL握手失败、扩展缺失或file_put_contents(): Permission denied。这不是配置问题，是系统设计限制。
用Docker跑Composer才是唯一稳定路径
推荐镜像：php:8.2-cli（x86_64）或php:8.2-cli-bookworm（ARM64），它预装composer可执行文件，无需手动安装。关键不是“能不能跑”，而是“生成的文件权限是否匹配DSM用户”：
-
--rm：命令结束自动删容器，避免残留 -
-u $(id -u):$(id -g)：让composer.json、vendor/等文件归属当前DSM用户（如admin），否则后续git commit或VS Code编辑会报权限拒绝 -
-v /volume1/web/project:/app：挂载点必须以/volume1/开头，群晖Docker不认其他路径 -
-w /app：工作目录设为挂载目标，否则composer create-project会写到容器根目录
示例：在/volume1/web/laravel初始化项目docker run --rm -u $(id -u):$(id -g) -v /volume1/web/laravel:/app -w /app php:8.2-cli composer create-project laravel/laravel .
换国内源必须进容器改配置，不能只改宿主机
Composer源配置存在容器内PHP环境里，宿主机改~/.composer/config.json完全无效。正确做法是进容器执行composer config：
- 临时换源（单次命令生效）：
docker run --rm -u $(id -u):$(id -g) -v /volume1/web/project:/app -w /app php:8.2-cli composer config repo.packagist composer https://packagist.phpcomposer.com - 持久化换源（写入容器内的全局配置）：
docker run --rm -u $(id -u):$(id -g) -v /volume1/web/project:/app -w /app php:8.2-cli composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
docker run --rm -v /volume1/web/project:/app -w /app php:8.2-cli composer config -g repo.packagist（注意这里没加-u，因为只是读配置，不涉及文件写入）
阿里云源地址是https://mirrors.aliyun.com/composer/，腾讯云是https://mirrors.cloud.tencent.com/composer/。别用过期的phpcomposer.com，它已停服。
私有仓库配置要带认证，且必须用完整URL
群晖上配私有Packagist或Satis仓库，最容易漏掉两点：一是没传auth.json，二是URL少https://前缀导致解析失败。正确流程：
- 先在宿主机创建
/volume1/web/project/auth.json，内容为：{"http-basic": {"your-private-repo.com": {"username": "xxx", "password": "yyy"}} - 挂载进容器并配置：
docker run --rm -u $(id -u):$(id -g) -v /volume1/web/project:/app -v /volume1/web/project/auth.json:/root/.composer/auth.json -w /app php:8.2-cli composer config -g repos.private composer https://your-private-repo.com - 运行
install时必须显式指定仓库：docker run --rm -u $(id -u):$(id -g) -v /volume1/web/project:/app -v /volume1/web/project/auth.json:/root/.composer/auth.json -w /app php:8.2-cli composer install --repository-url=https://your-private-repo.com
注意：auth.json路径必须映射到容器内/root/.composer/auth.json，因为composer config -g默认读这个位置；--repository-url参数不能省，否则仍走Packagist官方源。
真正麻烦的不是换源，而是每次docker run都要重复写一长串参数。建议把常用命令写成shell脚本或alias，但别忘了-u和-v路径——漏掉任何一个，生成的vendor/就可能属于root，后续操作全卡住。
