海外部署必须切换回官方源或可信海外镜像，因国内镜像存在证书不信任、DNS解析失败、同步延迟及secure-http拦截等问题，强行使用会导致install失败或拉取损坏包。
海外部署时 Composer 镜像不是“换一个国内地址就行”，而是必须切换回官方源或选用可信的海外镜像，否则可能因证书、DNS、同步延迟或协议限制导致 composer install 失败或拉取到过期/损坏包。
为什么海外服务器不能硬套国内镜像
阿里云、腾讯云等国内镜像服务面向中国大陆用户优化，海外服务器常见问题包括：
-
SSL certificate problem：部分海外主机系统 CA 证书库老旧，不信任国内镜像所用的云厂商证书 -
Could not resolve host: mirrors.aliyun.com：某些海外 VPS（如 OVH、Hetzner）DNS 默认屏蔽或解析缓慢 - 同步延迟：国内镜像通常有 10–30 分钟同步窗口，新发布的包在海外部署时可能查不到
-
secure-http强制拦截：Composer 2.2+ 默认开启secure-http=true，而部分海外镜像（如某些自建 proxy）只支持 HTTP，会直接拒绝连接
海外部署推荐的镜像配置方式
优先使用官方源；若需加速且确认环境兼容，再选以下方案：
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 --unset repo.packagist（清空全局镜像），或显式设为：composer config -g repo.packagist composer https://packagist.org/ - 用 GitHub Packages 作补充（适合含私有包项目）：
composer config -g repositories.github composer https://github.com/—— 注意这不是 Packagist 镜像，仅用于托管在 GitHub 的私有仓库 - 自建轻量镜像（仅限中大型团队）：用
packagist-mirror工具同步官方元数据，部署在 AWS us-east-1 或 GCP us-central1，URL 写成https://your-mirror.example.com/，末尾必须带/ - 禁用
secure-http是高危操作，仅测试环境临时用：composer config -g secure-http false，生产环境禁止
验证海外环境是否真走目标源
别依赖 composer config -g repo.packagist 输出，要实测请求路径：
- 运行
composer diagnose -v，看输出中Repo行是否显示你设的 URL（不是packagist.org） - 加
-vvv跑一次composer update --dry-run，搜日志里GET请求的域名，例如：GET https://packagist.org/packages.json或GET https://your-mirror.example.com/packages.json - 如果看到
Could not fetch https://mirrors.xxx.com/...，说明镜像不可达，立刻切回官方源，不要强行重试
Docker 和 CI 环境的特殊处理
海外 CI（如 GitHub Actions、GitLab CI）默认无用户家目录，composer config -g 写入的配置不持久：
- GitHub Actions 中，应在
composer install前加一步：run: composer config -g repo.packagist composer https://packagist.org/ - GitLab CI 中，把配置命令写进
.gitlab-ci.yml的before_script，避免缓存污染 - Docker 构建时，
RUN指令中配置必须放在composer install之前，且建议加--no-cache避免复用旧层中的错误配置 - 所有海外构建都应加
COMPOSER_MEMORY_LIMIT=-1，防止因内存不足中断导致元数据解析失败
海外部署最常被忽略的是 DNS 和 TLS 协议兼容性——哪怕镜像 URL 完全正确，只要 curl -I https://your-mirror.example.com/ 返回 4xx/5xx 或超时，composer 就不会尝试 fallback，而是直接报错退出。先通 curl，再信 composer。
