如何通过修改Hosts加速Composer镜像源同步-composer-PHP中文网

改 hosts 文件对镜像源加速无效，因 mirrors.aliyun.com 等已由 CDN 优化解析极快；真正需绑定的是 github.com、raw.githubusercontent.com 等镜像未覆盖的硬编码外网域名，且须严格遵循格式、权限与缓存刷新规范。

如何通过修改hosts加速composer镜像源同步

改 hosts 文件本身不能加速 Composer 镜像源同步——镜像源域名（如 mirrors.aliyun.com）通常解析极快，且 CDN 节点已优化；真正卡在 DNS 的是 packagist.org 或硬编码的 github.com/raw.githubusercontent.com 这类未被镜像代理的地址。强行绑定镜像域名反而容易因 IP 过期或 CDN 路由失效导致 503 或连接重置。

为什么绑 `mirrors.aliyun.com` 多数时候没用

阿里云、腾讯云等镜像站使用的是全球 Anycast + 多节点 CDN，nslookup mirrors.aliyun.com 返回的 IP 因地区、运营商、甚至时刻不同而变化。你今天绑的 IP，明天可能已下线或被限流。更关键的是：Composer 请求镜像时走的是 HTTPS，只要域名能解析，后续 TLS 握手和内容分发都由 CDN 自动调度，本地绑定固定 IP 反而绕过最优节点。

常见错误现象：

ping mirrors.aliyun.com 通，但 curl -I https://mirrors.aliyun.com/composer/packages.json 返回 503
绑定后 composer install 日志里出现 SSL certificate problem: unable to get local issuer certificate
同一台机器，换网络（比如从公司 Wi-Fi 切到手机热点）后镜像请求直接超时

该绑谁？只绑那些镜像不覆盖的硬编码外网域名

Composer 镜像只接管 repo.packagist.org 的元数据和 dist 包下载，但以下地址它完全不管，会直连：

github.com（用于 vcs 类型依赖、私有仓库克隆）
raw.githubusercontent.com（常见于配置文件、模板、脚本加载）
api.github.com（某些插件做 rate limit 检查）
gitlab.com 或其他私有 Git 域名（若项目 composer.json 里写了自定义 repositories）

这些才是 Could not resolve host 的高发区。验证方式：

composer install -vvv 2>&1 | grep -E "Downloading|Cloning" | tail -5

如果末尾出现类似 Downloading https://raw.githubusercontent.com/xxx/config.json，就该优先绑这行里的域名。

绑定时必须避开的三个坑

不是加了 IP 就生效，三者任一出错，hosts 就形同虚设：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

Windows 下必须用“以管理员身份运行”记事本编辑 C:\Windows\System32\drivers\etc\hosts，否则保存静默失败
Linux/macOS 必须用 sudo vim /etc/hosts，普通用户写入会被忽略
IP 和域名之间只能用英文空格或 Tab，不能用中文空格、冒号、等号或全角符号；每行只写一个映射，例如 185.199.108.133 raw.githubusercontent.com 是对的，185.199.108.133 raw.githubusercontent.com github.com 是错的

获取可用 IP 的安全方式（别抄旧帖）：

dig raw.githubusercontent.com @1.1.1.1 +short | head -n1

拿到 IP 后，立刻用 nslookup raw.githubusercontent.com 127.0.0.1 验证是否返回该 IP；不一致说明系统缓存未刷新或 hosts 格式错误。

改完 `hosts` 后必须 flush DNS 缓存

操作系统 DNS 缓存不刷新，curl 和 PHP 的 cURL 仍会走旧记录，导致请求发向被污染或不可达的地址：

Windows：ipconfig /flushdns（CMD/PowerShell 均需管理员权限）
macOS：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder（Ventura+ 必须两步）
Linux（systemd-resolved）：sudo systemd-resolve --flush-caches

验证是否真正生效的唯一方式是：

php -r "var_dump(gethostbyname('raw.githubusercontent.com'));"

输出必须和你写进 hosts 的 IP 完全一致。PHP 层不走系统 DNS 缓存，这个命令比 ping 更真实反映 Composer 实际行为。

最常被忽略的一点：改 hosts 是临时止血，不是长期方案。IP 会变、CDN 策略会调、某些镜像站（如华为云）明确要求走其 DNS 才能命中最优节点。真要稳定，优先用 composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/ 配全局镜像，再配合 composer clear-cache，把问题收束在 Composer 自己的控制范围内。