私有仓库URL必须显式使用https://协议,否则Composer可能走HTTP或报404;VCS类型需设为"vcs"且含.git后缀,Composer源则type须为"composer"、URL末尾必须带斜杠,并在同级声明"packagist.org": false。

私有仓库配置必须显式声明 https 协议
Composer 默认不会自动将私有仓库 URL 升级为 HTTPS,哪怕你只填了域名(如 gitlab.example.com),它仍可能走 HTTP 或报 404。必须在 composer.json 的 repositories 中完整写明 https:// 开头的地址:
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/group/private-package.git"
}
]
}
如果用的是 Packagist 类型私仓(如 Satis、Private Packagist),URL 同样要带 https://,否则 Composer 会尝试 HTTP 请求并失败(尤其在强制 HTTPS 的反向代理后)。
git 驱动下 HTTPS 认证失败的典型表现与修复
当你执行 composer install 时,如果看到类似 fatal: unable to access 'https://...': SSL certificate problem 或 Could not fetch https://..., will skip,说明 Git 层 HTTPS 认证卡住了。常见原因和应对方式:
- 私有 Git 服务器使用自签名证书 → 在系统级或 Git 全局配置中禁用 SSL 验证(仅限内网可信环境):
git config --global http.sslVerify false - 需要 Token 或 Basic Auth → 把凭证嵌入 URL:
https://token:x-oauth-basic@gitlab.example.com/group/pkg.git(注意:Token 必须是 Git 操作权限的 Personal Access Token,不是 API Token) - Git 使用系统 cURL,但系统 CA 证书过旧 → 更新系统证书包(如 Ubuntu 上
sudo apt update && sudo apt install ca-certificates)
HTTP_PROXY / HTTPS_PROXY 环境变量干扰 HTTPS 连接
很多内网环境会设置 HTTP_PROXY,但 Composer 的 Git 操作(通过 git clone)默认不走该代理;而 PHP 的 stream context 又可能走。结果就是部分请求走代理、部分直连,导致 HTTPS 握手失败或超时。排查方法:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 临时取消代理:
unset HTTP_PROXY HTTPS_PROXY再运行composer install - 若必须走代理,请确保代理支持 CONNECT 方法,并在 Git 中显式配置:
git config --global http.https://gitlab.example.com.proxy http://proxy.internal:8080 - 避免混用:不要同时设
HTTP_PROXY和 Git 的http.proxy,容易冲突
私仓域名被本地 /etc/hosts 或 DNS 解析为内网 IP,但证书 CN 不匹配
这是最容易被忽略的坑:你用 https://gitlab.example.com 配置仓库,DNS 或 /etc/hosts 把它解析到 192.168.10.5,但服务器证书的 CN 是 gitlab.example.com —— 表面看没问题,实际 OpenSSL 会校验 SNI 和证书 Subject Alternative Name(SAN)。一旦证书没包含该 IP 或通配符不匹配,就会报 Certificate verification failed。
解决办法只有两个:
- 重签证书,把内网 IP 加进 SAN 字段(推荐)
- 改用域名访问且确保 DNS 解析到公网 IP(比如让内网机器也走公网 DNS,再通过防火墙策略放行)
别试图用 sslverify=false 绕过 —— 它只关掉证书链验证,不解决 CN/SAN 不匹配问题。

















