改DNS比换镜像源更优先,因为Composer卡在Loading repositories或Downloading时80%是DNS解析失败或超时,而非下载慢;域名如packagist.org、github.com未解析出IP,镜像再快也无效。

为什么改DNS比换镜像源更优先
Composer卡在Loading composer repositories或Downloading https://时,80%不是下载慢,而是DNS解析失败或超时。镜像源URL再快,packagist.org、github.com这些域名都得先解析出IP——如果系统DNS返回unknown host或耗时2秒以上,后续全白搭。
实操建议:
- 先验证:运行
ping packagist.org,若报unknown host,立刻换DNS - Linux/macOS直接改
/etc/resolv.conf,只留两行:nameserver 114.114.114.114和nameserver 223.5.5.5 - 禁用
systemd-resolved(如启用):sudo systemctl disable --now systemd-resolved,否则它会偷偷覆写resolv.conf - Windows用户改网络适配器DNS,或在WSL中单独配置
hosts预绑定关键域名能跳过DNS查询
DNS解析慢的本质是UDP请求+递归查询链路长,而/etc/hosts是零延迟本地映射。对Composer高频访问的域名(mirrors.aliyun.com、packagist.org、github.com),手动绑定IP可彻底绕过DNS层。
实操建议:
- 用
curl -I https://mirrors.aliyun.com/composer/确认当前可用IP(例如223.6.6.6) - 往
/etc/hosts追加(一行一个):223.6.6.6 mirrors.aliyun.com、223.6.6.6 packagist.org、223.6.6.6 github.com、223.6.6.6 githubusercontent.com - 注意:别用
dig或nslookup查到的CDN IP,它们可能带地域调度,要以curl -I实际连接成功的为准 - 改完不用重启,立即生效;但记得
composer clear-cache清掉旧缓存
http.timeout必须调高,且不能只靠process-timeout
http.timeout控制DNS解析、TLS握手、首字节等待、整个body传输的总时间,默认仅300秒。弱网下常卡在TLS握手或首字节,process-timeout管不了这个阶段。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
实操建议:
- 执行
composer config -g http.timeout 600(单位秒),避免因单次HTTP请求超时中断 - 同时设
composer config -g process-timeout 0禁用整条命令超时(CI/CD中建议用环境变量COMPOSER_PROCESS_TIMEOUT=0固化) - 别混淆:git clone卡住跟
http.timeout无关,那是Git自己的超时,需另配git config --global core.sshCommand "ssh -o ConnectTimeout=30" - IPv6 fallback会静默拖慢——用
curl -v https://packagist.org 2>&1 | grep "Connected to"看是否连了IPv6地址,是则考虑在宿主机禁用IPv6或强制走IPv4
Docker容器内Composer DNS问题要分层解决
在Docker Compose或docker run中跑Composer,容器默认继承宿主机DNS,但常被systemd-resolved或NAT转发污染。光改宿主机DNS没用,必须在容器侧显式干预。
实操建议:
- 启动容器时加
--dns 114.114.114.114 --dns 223.5.5.5,不依赖宿主机 - Compose文件中,在服务下写:
dns: ["114.114.114.114", "223.5.5.5"]和dns_search: ["svc.cluster.local"](如有内网后缀) - 避免用
network_mode: host——该模式下dns字段完全失效 - CI/CD流水线(如GitHub Actions)中,必须在每步
run前执行composer config -g命令,不能依赖缓存或本地配置
真正卡住Composer的,从来不是“下载慢”,而是DNS解析那几毫秒的不确定性叠加成几十秒无响应。改DNS、绑hosts、调http.timeout这三步做完,90%的“卡死”现象会消失——剩下的是git clone、autoload生成或挂载目录I/O问题,得另起炉灶。

















