离线环境下Composer本身不可动态安装,必须在联网机预生成composer.phar并拷入内网机赋权运行;项目依赖需提前用Satis等工具构建含ZIP包的私有镜像源,配置本地repositories并禁用packagist,确保packages.json、dist包路径及Web权限三者均可达。

局域网断网时无法安装 Composer 本身——composer.phar 是纯 PHP 脚本,不依赖网络即可运行,但“安装”动作(如下载、解包、设权限)必须在有 PHP 环境的机器上提前完成;真·断网环境里,你只能用已准备好的 composer.phar 文件,且所有依赖包都得预先离线打包好。
断网前必须做完:PHP 环境 + composer.phar 二进制预置
没网络就别想动态下载任何东西。以下三件事必须在联网机上做完,并把成果拷进内网:
- 确认目标内网机器已装好 PHP(
php -v可执行),且openssl、zlib、phar扩展已启用(php -m | grep -E "(openssl|zlib|phar)") - 在联网机上执行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php composer-setup.php→ 得到composer.phar - 把
composer.phar拷进内网机任意目录(比如/opt/composer/composer.phar),并加执行权限:chmod +x /opt/composer/composer.phar
验证:在内网机运行 php /opt/composer/composer.phar --version。能输出版本号,说明基础可运行。
内网项目依赖怎么装?不能靠 packagist.org
断网后 composer install 必然失败,除非你已提前准备好全部依赖的 ZIP 包 + 元数据。核心是构建一个本地可服务的 Composer 源,不是改个 URL 就行:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 用
satis或toran-proxy在联网机上构建镜像:指定要包含的包名和版本(如"monolog/monolog": "^2.13"),并**必须启用archive配置**,否则无 ZIP 包,install会静默卡住 -
satis.json中关键段不能少:"archive": { "directory": "dist", "format": "zip", "skip-dev": true } - 构建完检查输出目录下是否存在
dist/monolog/monolog/2.13.0.0/monolog-monolog-xxx.zip—— 没这个文件,后续全白搭 - 把整个 Satis 输出目录(含
packages.json、p/、dist/)拷进内网 Web 服务器根目录(如 Nginx 的root /var/www/satis/;)
内网机的 composer.json 和全局配置怎么写?
项目级配置稍有不慎就会 fallback 到官方源,导致报错或超时:
- 项目
composer.json的repositories必须显式声明为type: "composer",URL 写完整(协议 + 域名 + 末尾斜杠):"repositories": [ { "type": "composer", "url": "http://192.168.1.100/" } ] - 执行
composer config --global repo.packagist false,彻底禁用默认源;只留这一条,否则仍可能尝试连外网 - 别用
artifact类型——它只读本地磁盘路径,不走 HTTP,和“共享源”场景冲突 - 验证是否生效:
composer config --global --list | grep repo应只输出一行repo.packagist=false,且项目中composer install -vvv日志里不再出现packagist.org
Web 服务路径和权限最容易漏检
即使 Satis 构建成功、配置也对,Nginx/Apache 映射错一级目录,就会 404,而 Composer 默认不报明确错误,只提示 “Could not fetch”,让人误以为是网络问题:
- Nginx
root必须指向 Satis 的web/子目录(如root /var/www/satis/web;),不是/var/www/satis—— 否则/packages.json404 - 确保
packages.json、p/monolog/monolog/2.13.0.0.json、dist/monolog/monolog/2.13.0.0/xxx.zip这三类路径都能被浏览器直接访问(HTTP 200) - Web 进程用户(如
www-data)需对web/目录有读权限,否则 ZIP 下载返回 403,composer install卡在 “Downloading” 不报错 - 用
curl -I http://192.168.1.100/packages.json和curl -I http://192.168.1.100/dist/monolog/monolog/2.13.0.0/monolog-monolog-xxx.zip手动测通
真正麻烦的从来不是命令怎么敲,而是 packages.json 能访问、ZIP 包路径能拼出来、Web 权限又刚好够——这三者缺一不可,且 Composer 不会告诉你哪一步断了。










