群晖NAS上需手动部署Composer并确保PHP CLI启用curl/openssl等扩展，通过SSH配置php.ini、下载composer.phar至用户目录并创建软链，再验证diagnose及项目安装权限。
composer 在群晖 NAS 上不能直接通过套件中心安装，也没有官方支持的 SPK 包——它本质是 PHP 的依赖管理工具，必须手动部署并确保底层 PHP 环境可用。
群晖 DSM 自带的 PHP（用于 Web Station）默认不启用 curl、openssl、json 等扩展，而 composer 启动即报错：PHP extension curl is missing 或 file_get_contents(): SSL operation failed。这是最常卡住的地方。
确认 PHP 环境是否就绪
群晖的 PHP 是“隐藏式”服务：Web Station 开启后才加载，且 CLI（命令行）版本与 Web 使用的可能不同。先 SSH 登录后验证：
php -v php -m | grep -E 'curl|openssl|json|phar|zlib'
若缺失关键扩展，仅靠 Web Station 图形界面勾选无效——必须用命令行启用：
- 进入
/var/packages/WebStation/target/usr/local/etc/php74/conf.d/（路径依 PHP 版本而定，如 php80 则为php80） - 检查是否存在
extension=curl.so等行；若无，手动添加到user-settings.ini - 重启 Web Station：
sudo synoservice --restart pkgctl-WebStation
下载并安装 composer.phar 到全局可执行位置
群晖没有 /usr/local/bin 写入权限（只读文件系统），也不能用 sudo apt install。正确做法是把 composer 放进用户有权限的目录，并加软链：
mkdir -p ~/bin curl -sS https://getcomposer.org/installer | php -- --filename=composer --install-dir=/volume1/homes/yourname/bin chmod +x ~/bin/composer ln -sf /volume1/homes/yourname/bin/composer /usr/local/bin/composer
⚠️ 注意：/usr/local/bin 是符号链接到 /volume1/@appstore/...，实际不可写，但群晖允许在该路径下创建软链。若提示 Operation not permitted，说明你用了 root 用户而非 DSM 用户——请改用你的 DSM 登录用户名（如 admin）执行。
验证 composer 是否真正可用
别只测 composer --version，那只是校验 PHAR 文件头。真实场景中失败多发生在网络请求环节：
- 运行
composer diagnose—— 它会检测 CA 证书、HTTPS 连通性、git命令等 - 常见报错：
The openssl extension is missing, which means that secure HTTPS transfers are impossible.→ 表明 PHP CLI 没加载openssl.so，需检查 CLI 对应的php.ini（通常在/etc/php/cli-php74/php.ini） - 若提示
Could not open input file: composer，说明软链失效或 PATH 未包含/usr/local/bin，临时加：export PATH="/usr/local/bin:$PATH"
在群晖上用 composer 安装项目（如 Cloudreve）的实操要点
群晖的文件系统权限模型和 Linux 不同，composer create-project 很容易因目录不可写失败：
- 务必在共享文件夹内操作，例如：
/volume1/web/cloudreve，而非/root或/tmp - 执行前设置权限：
sudo chown -R admin:users /volume1/web/cloudreve（admin替换为你实际用户名） - 避免使用
--no-interaction直接跳过配置，Cloudreve 首次运行需交互生成.env，否则后续php artisan serve会报Class 'App\\Providers\\AppServiceProvider' not found - 伪静态规则必须手动配进 Web Station 的 Nginx 配置里，
composer本身不处理这个
群晖不是标准 Linux 发行版，它的 PHP 是“阉割+封装”版本，composer 能跑起来只是第一步；真正卡住人的，永远是 PHP CLI 扩展缺失、证书路径错乱、以及文件权限和 Web Server 权限的双重隔离。动手前先 php -i | grep 'Loaded Configuration File'，看清楚你改的是哪个 php.ini。
