私有仓库不能直接 proxy packagist.org，因其不缓存、不限速、无预同步，反而增加代理开销；必须 proxy 国内已同步镜像（如阿里云），并确保 Nexus 配置末尾斜杠、无认证、启用自动阻塞，且通过深层路径（如 /p2/xxx.json）验证生效。
私有仓库为什么不能直接 proxy packagist.org
把 Nexus 或 Satis 的 Composer proxy 仓库 Remote storage URL 填成 https://packagist.org 是典型错误。它不会变成“加速版官方源”，而是每次请求都反向拉取、不缓存元数据、不预同步，实际效果比直连还差——因为多了一层代理转发 + TLS 握手 + DNS 解析，且 packagist.org 对未登录的爬虫类请求限速严格。
真正可用的 proxy 上游必须是已稳定同步的国内镜像站，比如：
-
https://mirrors.aliyun.com/composer/（末尾斜杠不能少） https://mirrors.tuna.tsinghua.edu.cn/composer/https://repo.huaweicloud.com/composer/
这些地址本身已是完整镜像，Nexus/Satis 只需按需拉取 provider 文件（如 /p2/vendor/package/1.0.0.json），首次访问即触发同步，后续复用本地缓存。
proxy 仓库配置时最容易漏掉的三项
Nexus UI 创建 Composer proxy 类型仓库时，以下三项不手动确认就等于白配：
-
Remote storage URL必须带末尾/，否则所有/p2/xxx.json请求返回 404 -
Authentication保持为空——阿里云/清华等镜像均无需认证，填了反而可能触发 Basic Auth 重定向失败 -
Auto-blocking enabled建议勾选，避免上游临时不可用时阻塞整个构建流程
别点 “Synchronize” 按钮：Composer 镜像采用按需拉取机制，手动同步无效；真正触发同步的是第一次对某个包的 composer install 或 composer require 请求。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
如何验证私有 proxy 是否真正生效
只测首页或 /packages.json 不够，Composer 实际行为集中在深层路径。必须逐项验证：
- 用
curl -I http://your-nexus/p2/laravel/framework/11.0.0.json确认返回200 OK和Content-Type: application/json - 用
curl -I http://your-nexus/dist/laravel/framework/11.0.0.0-zip-hash.zip确认 ZIP 路径可直连、返回application/zip - 在项目中执行
composer config --global repo.packagist composer http://your-nexus/（注意末尾/），再跑composer install -vvv，日志中应出现Reading packages.json from cache at /http---your-nexus-/packages.json
如果其中任一环节失败，问题大概率不在 Nexus，而在后端镜像服务是否已拉取该包——此时应直接访问原始镜像地址（如 https://mirrors.aliyun.com/composer/p2/xxx.json）确认是否存在。
为什么 Nginx 反代私有仓库反而更慢
很多人在 Nexus 前加一层 Nginx，结果更卡。根本原因是 Nginx 默认不识别 Composer 所需的 MIME 类型，也不处理路径重写逻辑：
- 必须在
http或server块中显式声明：types { application/json json; application/zip zip; } -
root必须精确指向镜像 web 目录（如/var/www/nexus/web），不能是父目录或子目录 - 必须设置
absolute_redirect off;，否则/packages.json请求会被重写为完整 URL，导致协议不匹配或跨域失败
Nginx 只负责转发，不参与同步逻辑。如果 /p2/xxx.json 返回 404，不是 Nginx 配错了，而是 Nexus 还没拉到这个包——这时要查 Nexus 日志，看是否有首次拉取记录，而不是反复调 Nginx 配置。
