私有仓必须是静态文件集合(如Satis生成的packages.json+dist/ZIP),否则仍会联网;需禁用packagist.org、URL以/结尾、dist路径为相对地址、Web服务可访问ZIP且启用openssl/zlib扩展。

断网时用 Composer 私有仓安装依赖,前提是私有仓本身已离线可用——即它不是指向 packagist.org 的代理镜像,而是静态文件集合(如 Satis 生成的 packages.json + dist/ ZIP 包)。否则,哪怕配置了 repositories,composer install 仍会尝试联网请求元数据或下载资源。
为什么私有仓配置了还报 Connection refused
常见原因是私有仓 URL 被设为内网域名或路径(如 http://repo.internal 或 file:///srv/composer-mirror),但目标机 DNS 不通、Web 服务未启动,或用了不支持的协议。Composer 默认只支持 http、https 和 packagist 类型仓库;file:// 协议虽能用,但要求路径绝对且可读,且必须加 "options": {"ssl": {"verify_peer": false}} 才能绕过证书校验(仅限测试)。
- 用
curl -I http://your-private-repo/packages.json在目标机验证是否能直接访问 - 若用 Nginx/Apache,确认
index.php未被启用(Satis 输出是纯静态文件,不需要 PHP 解析) - 避免在
repositories中混用type: "composer"和type: "package",后者需手动写死所有依赖,易漏
composer.json 里怎么写私有仓地址才真正离线
必须显式禁用 Packagist,并只保留你的私有源。否则 Composer 仍会 fallback 到官方源触发联网。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 在项目根目录的
composer.json中写:{ "repositories": [ { "type": "composer", "url": "http://192.168.10.50/packages" } ], "packagist.org": false } -
"packagist.org": false是硬性要求,不是注释;漏掉这行,composer install会在解析依赖时偷偷连外网 - URL 必须以
/结尾(如"http://192.168.10.50/packages/"),否则 Composer 会拼出错路径请求packages.json
断网后运行 install 还卡在 Downloading?检查这三件事
即使仓库地址正确,composer install 仍可能卡住,本质是它试图下载 dist 包时找不到本地缓存或校验失败。
- 确认私有仓的
packages.json中每个包的dist.url字段指向的是相对路径(如"dist/url": "/dist/vendor-name-package-name-zip-hash.zip"),而非绝对外网地址 - 运行
composer install --no-plugins --no-scripts --no-dev --optimize-autoloader -v,看最后请求的是哪个 URL —— 如果是https://github.com/...,说明 Satis 构建时没强制走--prefer-dist,得重跑php bin/satis build satis.json output/ - 目标机 PHP 需启用
openssl和zlib扩展,否则解压 ZIP 失败会静默卡住,无错误提示
最易被忽略的一点:Satis 生成的 dist/ 目录必须和 packages.json 同级,且 Web 服务器要能直接通过 HTTP 访问到 ZIP 文件。少一个文件、路径错一级、MIME 类型没配对(应为 application/zip),都会让 Composer 在校验哈希阶段失败并退出,而不是报错。

















