改路由器DNS对Composer无效,因其依赖执行环境的系统DNS(如/etc/resolv.conf或Windows适配器设置),而非路由器DNS;应优先修改宿主机、Docker(--dns)、CI或宝塔等实际运行环境的DNS配置,并验证镜像URL末尾斜杠及type值是否正确。

Composer 本身不走路由器 DNS,改路由器 DNS 对它基本没用——真正该调的是运行 Composer 的那台机器的 DNS 设置,或者容器、CI 环境里的 DNS 配置。
为什么改路由器 DNS 对 Composer 无效
Composer 请求包信息(如 packages.json)时,依赖的是执行命令的 PHP 进程所在系统的 DNS 解析行为,而不是你手机或浏览器用的网络出口。路由器 DNS 只影响局域网设备「发起新连接」时的域名解析,但:
- Composer 默认用 PHP 的
file_get_contents或 cURL,走系统/etc/resolv.conf(Linux/macOS)或 Windows 网络适配器设置,不查路由器缓存 - 很多环境(Docker、CI runner、宝塔后台)根本不用路由器 DNS,而是用宿主机或自定义 DNS(比如
--dns 8.8.8.8) - 即使路由器 DNS 换成 114.114.114.114,若宿主机
resolv.conf写死 127.0.0.53(systemd-resolved),照样不生效
真正该改哪几处 DNS
按优先级排序,以下修改才对 Composer 有实际加速效果:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Linux/macOS 终端里跑
composer install:改/etc/resolv.conf或用nmcli设置当前连接的 DNS,推荐8.8.8.8或114.114.114.114 - Docker 容器内运行:启动时加
--dns 8.8.8.8,或在/etc/docker/daemon.json里写"dns": ["8.8.8.8"] - 宝塔/PHP 管理器后台执行:确认执行用户(通常是
www),然后用sudo -u www composer ...,并确保该用户的 shell 环境 DNS 可用 - GitHub Actions / GitLab CI:在 job 中显式设
run: echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf(需permissions: contents: read)
验证 DNS 是否起效的最快方式
别猜,直接用 Composer 依赖的底层命令测:
-
ping packagist.org→ 如果返回unknown host,说明 DNS 解析失败,换 DNS 后重试 -
curl -I https://mirrors.aliyun.com/composer/packages.json→ 必须返回HTTP/2 200,否则不是 DNS 问题,是 TLS 或防火墙拦截 -
composer config -g repo.packagist→ 输出必须是完整 JSON,且url值结尾带/,否则镜像静默失效
最常被忽略的一点:DNS 改对了,但 Composer 还卡在 Loading composer repositories,大概率是因为镜像 URL 少了末尾 /,或 type 没写成 composer——这两个错不会报错,只会静默 fallback 到 packagist.org,让你白调 DNS。










