如何在私有网络环境下搭建自定义Composer镜像服务器-composer-PHP中文网

换源是唯一可靠解法，因composer死守https://repo.packagist.org且不fallback；国内镜像仅缓存元数据不托管zip包，需自建satis私有源并严格配置url斜杠、nginx mime类型及repositories顺序。

如何在私有网络环境下搭建自定义composer镜像服务器

内网服务器跑 composer install 卡住或报错，不是因为“没网”，而是它死守 https://repo.packagist.org 不放，且不 fallback —— 换源是唯一可靠解法，其他如改 DNS、加 hosts、开代理，都绕不开这个硬限制。

为什么不能只用 `composer config -g repo.packagist` 指向一个镜像地址

这个命令只替换元数据入口（packages.json），但 ZIP 包仍从原始 dist.url 下载。比如某个包的 dist.url 是 https://github.com/monolog/monolog/releases/download/2.10.0/monolog-2.10.0.zip，Composer 会直接请求 GitHub，而你的内网根本打不开它。

国内公开镜像（阿里云、USTC）只缓存 packages.json 和 provider-*.json，不托管 ZIP 文件
真正全量可控，必须自己生成并托管 ZIP + 元数据，即用 satis 或 packagist-mirror
若强行用反向代理镜像官方源，需透传 X-OAuth-Scopes 头，否则 GitHub/GitLab 的 ZIP 下载必 403

`satis build` 后 `composer install` 仍 404 的真实原因

不是网络不通，是 Web 服务没正确暴露静态文件 —— satis 只生成文件，不启动服务。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Nginx root 必须精确指向 satis.json 中 output-dir 的路径，例如 root /var/www/satis/web;
必须显式声明 JSON MIME 类型：types { application/json json; }，否则返回 text/plain，Composer 直接拒收
镜像 URL 必须以 / 结尾：写成 "url": "https://pkgs.internal/"，写成 "url": "https://pkgs.internal" 会导致 Composer 拼出 https://pkgs.internalpackages.json
dist/ 下 ZIP 路径要可直连 GET，例如 https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip，检查 SELinux、文件权限、Nginx 是否能读取该路径

项目里怎么写 `repositories` 才真正生效

必须写在你要装私有包的那个项目的根级 composer.json 里，不是 Satis 自己的配置文件，也不是包自己的 composer.json。

类型必须是 "type": "composer"，URL 是托管 packages.json 的根地址（含末尾 /）
务必加上 "packagist.org": false，否则同名包会从官方源拉取，覆盖你的私有版本
私有源必须放在 repositories 数组第一位，Composer 按顺序查找，不会合并同名包
漏掉任意一项，composer require acme/utils 就会报 Could not find package acme/utils

私有 Git 仓库构建失败却静默跳过

satis build 不报错，但包没进 packages.json，下游完全感知不到 —— 这是最隐蔽的坑。

HTTPS 私有仓库：运行 satis build 的用户需提前执行 git config --global credential.helper store 并输一次密码；或改用 token，写进 satis.json 的 config.github-oauth
SSH 私有仓库：确保运行用户能 ssh -T git@gitlab.internal 连通，且 ~/.ssh/config 配好 Host 别名和 key 路径
包被 skip：检查目标仓库是否有合法 composer.json；是否打了符合语义化格式的 tag（v2.1.0 或 2.1.0），dev-main 默认不收录，除非设 "minimum-stability": "dev"
"require-all": true 和 "require": {} 绝对不能混用，Satis 会静默跳过部分包，不提示任何冲突