自建局域网Composer镜像配置探讨-composer-PHP中文网

composer config -g repo.packagist 对私有镜像无效，因其仅替换元数据入口（packages.json），不修改包的 dist.url 字段，而 zip 文件仍从原始源（如 github）下载，局域网无法访问；私有镜像需确保所有 dist.url 指向内部 http 服务且 web 服务器正确暴露静态文件。

自建局域网composer镜像配置探讨

composer config -g repo.packagist 为什么对私有镜像无效

这条命令只改元数据入口，不触碰 ZIP 包下载路径——satis 生成的 dist/ 下 ZIP 文件必须能被 HTTP 直接 GET 到，而 composer config -g repo.packagist 完全不控制 dist.url 字段。它只替换 packages.json 的获取地址，所有包的 dist.url 仍来自原始源（比如 GitHub），局域网根本打不开。

验证方式很简单：composer show monolog/monolog --verbose，看输出里的 dist.url 字段是不是还指向 https://github.com/...。如果是，说明镜像没真正接管下载链路。

私有镜像不是“换源”就能用，而是要让每个包的 dist.url 指向你自己的 HTTP 服务（如 https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip）
composer config -g repo.packagist 只影响 packages.json 元数据拉取，和 ZIP 下载无关
CI 或多用户环境（如宝塔 www 用户）默认读不到你的全局配置，更没法覆盖 dist.url

satis build 后 composer install 报 404 的真实原因

satis 不是 Web 服务，只是静态文件生成器。它不会监听端口、不启动进程，只把 packages.json 和 ZIP 写进 output-dir。404 不是网络不通，是 Web 服务器没正确暴露这些文件。

关键配置点必须全部对齐：

Workflow Decomposer

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

下载

Nginx 的 root 必须精确指向 satis.json 中 output-dir 的子目录 web，例如：root /var/www/satis/web;
必须显式声明 JSON MIME 类型：types { application/json json; }，否则返回 text/plain，Composer 拒收
镜像 URL 必须以 / 结尾："url": "https://pkgs.internal/"，少一个斜杠会拼成 https://pkgs.internalpackages.json
检查 SELinux 状态或文件权限：ls -l /var/www/satis/web/dist/ 是否可被 Web 用户读取