把依赖包和私有源都准备好之后,离线环境里执行 composer install 仍报 curl error 60、could not resolve host 或 could not fetch packages.json,最常见的其实是漏设了一个环境变量。

必须显式关闭网络
Composer 不会因为断网自动降级到离线模式,它会坚持请求 https://repo.packagist.org/packages.json 直到硬性失败。因此离线前必须显式设置 COMPOSER_DISABLE_NETWORK=1:Linux/macOS 用 export,Windows CMD 用 set,PowerShell 用 $env:COMPOSER_DISABLE_NETWORK="1"。这个变量要在 composer install 之前生效,并且对插件调用的所有子命令都起作用;只写在单条命令前,在某些 shell 下不生效,建议放进 shell 配置或 CI 脚本开头。
清理全局镜像与 lock 来源
即使关了网络,全局配置里残留的私有源或旧镜像仍会触发 fallback 连接,Composer 此时不是跳过而是直接报错退出,所以要把全局镜像与代理配置一并清掉。同时确认 composer.lock 只包含 dist 来源,并强制使用 --no-plugins、--no-scripts、--no-autoloader 三个参数,避免插件与脚本在离线阶段再次发起请求。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。

离线安装的成功前提因此有四层:环境变量、全局配置、lock 文件来源、命令行参数,任何一层留了口子都会表现成「明明配了离线源却还在联网」。环境变量名与参数在不同 Composer 版本间略有差异,落地时对照所用版本的文档确认即可。










