要让 Composer 支持自建 GitLab 实例，需配置 gitlab-domains 并设置访问令牌。1. 在 composer.json 中添加 config.gitlab-domains 指定私有域名；2. 创建 GitLab Personal Access Token 并用 composer config -a http-basic.gitlab.example.com 配置认证；3. 在 repositories 中添加私有仓库 VCS 地址；4. 运行 composer install -v 验证克隆是否成功，确保无 403 错误且配置生效。
要让 Composer 支持自建的 GitLab 实例，需要配置 gitlab-domains 选项，使 Composer 能正确识别私有 GitLab 上的项目仓库并进行鉴权拉取。这在使用私有包或内部组件时非常关键。
1. 配置 gitlab-domains
Composer 默认只信任 gitlab.com，如果你使用的是公司自建的 GitLab（如 gitlab.example.com），必须将域名添加到 gitlab-domains 列表中。
在项目的 composer.json 文件中添加如下配置：
这样 Composer 就知道该域名是一个有效的 GitLab 实例，并启用对应的克隆和认证机制。
2. 设置 GitLab 访问令牌（Personal Access Token）
Composer 需要通过令牌访问私有仓库。你需要在自建 GitLab 中创建一个 Personal Access Token：
- 登录 GitLab，进入 User Settings > Access Tokens
- 生成一个具有
read_repository权限的 token - 保存生成的 token 字符串
然后在本地运行命令配置 Composer 使用该 token：
composer config -a http-basic.gitlab.example.com注意：虽然叫 http-basic，但 GitLab 实际上会将其作为用户名 + token 的组合处理。
3. 在 composer.json 中引用私有包
确保你的依赖项指向正确的 GitLab 仓库地址，格式为：
{ "require": { "vendor/private-package": "^1.0" }, "repositories": [ { "type": "vcs", "url": "https://gitlab.example.com/vendor/private-package.git" } ] }Composer 会根据配置自动通过 HTTPS 克隆，并使用之前设置的 token 进行认证。
4. 验证配置是否生效
运行以下命令测试是否能正常访问：
composer install -v如果看到克隆过程没有报 403 或无法访问错误，说明配置成功。也可以使用：
composer config --list查看当前配置中是否包含正确的 gitlab-domains 和 http-basic 信息。
基本上就这些。只要域名配置正确、token 有效、仓库地址无误，Composer 就能顺利从自建 GitLab 拉取代码。不复杂但容易忽略权限和域名拼写。
