Composer无法断网安装,因其所有包下载、元数据解析和版本求解均需联网;所谓“断网安装”实为提前缓存全部依赖(vendor+lock+cache),离线时复用,但update或含远程repositories配置时仍必联网。

Composer 无法“断网安装”——它本质是网络依赖型工具,所有包下载、元数据解析、版本约束求解都必须联网。所谓“断网安装”,实际是指提前缓存好全部依赖到本地,之后在无网络环境下复用。这需要分两步:先联网完成完整依赖拉取并固化,再离线复用。关键不是换镜像,而是控制缓存路径和规避网络请求。
为什么换镜像对断网没用
镜像源(如 https://mirrors.aliyun.com/composer/)只是把 packagist.org 的内容同步到国内服务器,仍需实时 HTTP 请求获取 packages.json、dist 包 URL、metadata 等。一旦断网,composer install 会立即报 Connection refused 或 cURL error 7,无论你配的是阿里云还是腾讯云。
真正可行的“类断网”方案:vendor + lock + cache 三件套
要让 Composer 在无网络时成功运行,必须满足三个条件:项目有完整的 composer.lock、vendor/ 目录已存在且未被删、全局或项目级缓存目录里有全部 .zip 或 .tar 包文件。操作要点:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 首次联网安装时,务必加
--prefer-dist(默认行为),确保下载的是压缩包而非 Git 克隆 - 运行
composer install --no-scripts --no-plugins,跳过任何可能触发网络的脚本(如post-install-cmd) - 确认缓存路径:
composer config -g cache-dir,Linux/macOS 默认是~/.composer/cache,Windows 是%USERPROFILE%\AppData\Roaming\Composer\Cache - 把整个
vendor/和~/.composer/cache/打包带走,离线环境里还原到相同路径 - 离线运行前,用
composer config -g http-basic.github.com "" ""清掉可能触发 GitHub 认证的配置(否则会卡在 auth prompt)
容易被忽略的两个硬性限制
即使缓存和 vendor 都齐了,以下两种情况仍会强制联网,且无绕过方式:
-
composer update:永远需要联网获取最新元数据,断网必失败;install才能纯离线 - 项目
composer.json中定义了"type": "package"或自定义"repositories"指向远程 URL:Composer 启动时就会尝试 HEAD 请求校验,断网即中断
如果你的 composer.json 里有这类配置,离线前必须手动注释掉或删掉,否则 install 会直接退出。

















