必须在webstation绑定的php cli环境下配置composer中文源，否则无效；需用对应php路径执行config命令、验证ssl联网、确保phar.readonly=off、ca证书路径一致及git可用。
composer 在群晖 NAS 上配镜像源，不是改个 config.json 就能生效——**必须跑在 WebStation 绑定的 PHP CLI 环境下，否则配置写对了也白搭**。你看到 composer --version 成功，不代表 composer install 能连上中文源；卡在 https://repo.packagist.org、报 SSL 错误、或根本没走镜像域名，都是环境错配的典型症状。
确认 composer 实际运行的 PHP 环境是否匹配 WebStation
群晖终端里敲 php 默认调用的是系统旧版（比如 PHP 5.6），而你的网站跑在 WebStation 的 PHP 8.2 上——两者扩展、ini 设置、CA 证书路径全都不一样。
- 进 DSM → WebStation → PHP 设置 → 找到你项目绑定的版本（如 PHP 8.2），记下它的
PHP Path（典型路径：/volume1/@appstore/PHP82/usr/bin/php） - SSH 登录后，用该路径验证：
/volume1/@appstore/PHP82/usr/bin/php -v和/volume1/@appstore/PHP82/usr/bin/php -m | grep -E "(phar|openssl|curl|mbstring)" - 缺扩展？回 WebStation 对应 PHP 版本的「扩展」页勾选，然后点「重启该 PHP 版本」（不是重启整个 WebStation）
- 特别检查
phar.readonly = Off：在 WebStation → PHP 设置 → 「自定义设置」里添加这一行，否则composer.phar解包失败
用目标 PHP 路径执行 config 命令，避免写错位置
composer config -g repo.packagist 看似简单，但默认会用系统 php 执行，导致配置写进 root 或错误用户的 ~/.composer/config.json，而 WebStation 进程根本读不到。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要用
composer config -g ...，改用完整路径：/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 执行后检查是否真落到了当前用户家目录：
cat ~/.composer/config.json（注意是admin用户的家目录，不是root） - 阿里云镜像（
https://mirrors.aliyun.com/composer/）目前最稳；清华源偶尔因证书链问题失败 - 如果想验证是否生效，加
-vvv看真实请求：composer install -vvv 2>&1 | grep "Downloading"，日志里出现的域名才是最终生效源
项目级配置比全局更可靠，尤其在多用户或 CI 场景
全局配置写在用户家目录，但群晖 Docker 容器、CI 流水线 runner、甚至某些 WebStation 子进程都可能以不同用户身份运行，根本读不到 ~/.composer/config.json。
- 进项目根目录，运行：
/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 这条命令会安全写入项目
composer.json的repositories字段，key 固定为"packagist"，不破坏已有私有源 - 如果
composer.json里"repositories"是数组（[]），命令会报错；需先手动改成对象（{}）再运行 - 改完删掉
vendor/和composer.lock，再composer install，避免旧 lock 文件残留官方源 hash
Docker 容器内配镜像源不能依赖群晖 UI，必须进容器环境操作
群晖 Docker 应用界面改的是 docker pull 的 registry 源，和 composer install 完全无关。容器里的 composer 不知道宿主机配了啥。
- 构建阶段写死最稳：Dockerfile 里加
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 启动时注入适合已有镜像：
docker run -e COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ ... - 挂载配置文件需注意路径：准备一个
config.json，内容为{"repositories": {"packagist.org": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}}，挂载到容器内对应用户的~/.composer/config.json（如/root/.composer/config.json或/home/www-data/.composer/config.json） - Alpine 镜像务必加
apk add --no-cache ca-certificates，否则必报 SSL certificate problem
composer diagnose 输出的每一行都在说真话**。它会暴露 CA 证书路径不一致、git 不可用、HTTPS 请求失败等底层问题——这些不解决，配再好的镜像源也只是障眼法。
