群晖NAS上唯一稳定运行Composer的方式是使用Docker容器，因其DSM系统非标准Linux、无包管理器、PHP精简且缺扩展；推荐镜像为php:8.2-cli（x86_64）或php:8.2-cli-bookworm（ARM64），需通过docker run挂载目录并指定用户UID/GID以避免权限问题。
群晖NAS上不能直接装Composer，得靠Docker容器跑
群晖的DSM系统不是标准Linux发行版，没有apt/yum包管理器，composer官方不提供ARM/x64架构的独立二进制，也**不支持直接用curl -sS https://getcomposer.org/installer | php在DSM终端里安装**——你会卡在php扩展缺失（如json、mbstring）、openssl配置异常或allow_url_fopen=Off报错上。
真正可行的路径只有一条：用Docker拉一个带PHP和composer的镜像，在容器里执行命令。这不是“替代方案”，是唯一稳定路径。
- 别试图在DSM的SSH里用
php手动装composer.phar——DSM的php是精简版，缺扩展、没phar写权限、PATH也不对 - 别用群晖套件中心里的“PHP”套件——它只提供Web服务环境，没暴露CLI、没装
composer、不开放vendor目录写入 - 推荐镜像：
php:8.2-cli（x86_64）或php:8.2-cli-bookworm（ARM64，适配DS923+/DS1522+等新机型），它自带composer可执行文件
docker run一次性执行composer命令最省事
不需要长期运行容器，也不用进bash交互——绝大多数场景（比如初始化Laravel项目、更新依赖）只要一条docker run就能搞定。关键是要把宿主机目录挂进去、传对用户ID、关掉tty干扰。
例如在共享文件夹/volume1/web/myproject下初始化一个新项目：
docker run --rm -u $(id -u):$(id -g) \ -v /volume1/web/myproject:/app \ -w /app \ php:8.2-cli \ composer create-project laravel/laravel .
-
--rm：命令结束自动删容器，不留垃圾 -
-u $(id -u):$(id -g)：让容器内composer生成的文件归属你当前DSM用户，避免后续git/编辑器权限报错 -
-v路径必须用绝对路径，且/volume1/xxx开头——群晖Docker只认这个根路径下的挂载点 - 如果遇到
file_put_contents(/app/composer.json): Failed to open stream: Permission denied，大概率是-u没加，或挂载目录本身DSM权限没开“写入”（在套件中心→Docker→特权设置里确认）
需要反复用composer？建个alias或者shell脚本
每次敲一长串docker run太累，又不想起守护容器——最轻量的做法是加个shell alias，让composer命令自动转发到容器。
编辑/root/.profile（DSM SSH默认登录是root），加这行：
alias composer='docker run --rm -u $(id -u):$(id -g) -v $(pwd):/app -w /app php:8.2-cli composer'
然后source /root/.profile，之后在任意项目目录下就能直接用composer install、composer update了。
- 注意
$(pwd)是关键——它保证当前路径被挂进容器，不能写死成/volume1/web - 如果用的是ARM64机器（比如DS923+），把镜像名换成
php:8.2-cli-bookworm，否则会报exec format error - 别用
composer global require——全局安装的工具（如laravel/installer）会落在容器临时文件系统里，下次run就没了
vendor目录权限混乱？不是Composer的问题，是挂载方式不对
常见现象：composer install成功，但PHP-FPM访问时提示Class not found，或者git status看到vendor/一堆文件变红色（权限变更）。根本原因不是composer，而是Docker挂载后UID/GID映射错位，导致Web服务（通常是http用户）读不了vendor里由root或其它UID写的文件。
- 解决方法只有两个：始终加
-u $(id -u):$(id -g)；或者在DSM里把Web Station的PHP-FPM用户改成跟你一致（套件中心→Web Station→PHP设置→FPM用户，选你的账户） - 别用
chmod -R 777 vendor硬改——治标不治本，下次composer update又乱 - 如果你用Git同步
vendor（不推荐），记得在.gitignore里加vendor/，否则不同机器UID写出来的文件，Git会当成“内容变更”一直标红
复杂点在于：DSM的UID/GID和Docker容器内PHP进程的UID/GID必须对齐，而这个对齐动作没法靠composer自己完成——它只是个PHP脚本，没权限改系统用户映射。所有权限问题，根源都在docker run -u这一环漏没漏。
