You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

npm安装遇ETIMEDOUT错误,有线网络异常求助

解决有线网络下npm命令无响应/ETIMEDOUT问题

1. 检查并清空npm代理设置

有线网络可能自动配置了代理,但npm未识别,导致请求阻塞。先查看当前代理配置:

npm config get proxy
npm config get https-proxy

如果输出非空值,执行以下命令清空代理:

npm config delete proxy
npm config delete https-proxy

之后重新尝试npm命令。

2. 强制npm使用IPv4

部分网络环境下IPv6解析异常,会出现ping无输出但浏览器可通过IPv4访问的情况。给npm强制指定IPv4:

npm config set registry http://registry.npmjs.org/ --ipv4

或执行命令时临时添加参数:

npm install -g npm@latest --ipv4

3. 检查系统hosts文件

有线网络下hosts文件可能被篡改,导致registry.npmjs.org解析错误。打开/etc/hosts文件(Linux系统),检查是否存在该域名的错误映射行,若有则删除,保存后刷新DNS:

sudo systemctl restart systemd-resolved

4. 临时切换npm镜像源测试

如果以上方法无效,临时切换到国内镜像验证是否为网络链路问题:

npm config set registry https://registry.npmmirror.com/

执行npm命令测试,若恢复正常,说明有线网络到官方registry的链路存在故障,可联系网络管理员排查。

5. 检查防火墙规则

有线网络环境下防火墙可能拦截了npm的443端口请求。查看当前防火墙状态:

sudo ufw status

若存在拦截,添加允许规则:

sudo ufw allow out 443/tcp

内容的提问来源于stack exchange,提问作者Jonathan Pinilla

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 16:55:24