Skip to content

Codex 安装前的网络准备:包管理器走代理与下载失败处理 ​

Codex 安装前的网络准备很重要:安装失败绝大多数是网络问题而不是安装命令错了。终端里的包管理器(如 npm)默认不走系统代理,下载海外资源会很慢或直接超时。安装前先让终端走代理:设置 HTTPS_PROXY 环境变量,或在客户端开 TUN 模式。

具体安装命令以官方文档为准,本文只讲网络准备。

速读要点

  • 安装失败绝大多数是终端没走代理,不是命令错
  • 环境变量只在当前终端窗口生效,sudo 要加 -E
  • 安装阶段看带宽和稳定性,对地区没有登录阶段严格

Codex 安装前的网络准备:先检查三件事 ​

  1. 客户端已连接且节点可用。 浏览器能打开海外网站。
  2. 知道客户端的本地端口。 Clash 系客户端默认通常是 7890,以客户端设置页显示为准。
  3. 终端能走代理。 在终端里执行 curl -I https://registry.npmjs.org,几秒内返回状态码就是通的;卡住说明终端没走代理。

让包管理器走代理:环境变量或 TUN ​

在终端里执行,再在同一窗口运行安装命令:

bash
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

预期:之后的下载速度明显提升。想长期生效,写进 ~/.zshrc 或 ~/.bashrc。Windows PowerShell 用 $env:HTTPS_PROXY="http://127.0.0.1:7890"。

不想改环境变量的,在客户端里开 TUN 模式,所有程序流量自动走节点。两种方法选一种即可,详见TUN 与代理模式。

部分包管理器有自己的代理设置,环境变量不生效时查对应工具的 proxy 配置项。

核对点:终端里 curl -I https://registry.npmjs.org 几秒内返回 200 一类状态码,才算终端已走代理。

三种环境的走代理分支 ​

环境做法注意
本机终端(macOS、Linux、PowerShell)export HTTPS_PROXY / $env:HTTPS_PROXY新窗口要重新设置
包管理器自带代理配置npm config set proxy、pip 的 proxy 参数等与环境变量二选一,别两边都设
Docker 或远程开发容器容器内 127.0.0.1 是容器自己,指向宿主地址客户端开「允许局域网连接」

下载失败的 10 秒自检 ​

现象最可能原因10 秒自检
下载进度条不动、最后超时终端没走代理curl -I https://registry.npmjs.org 是否秒回
浏览器快、终端慢同上echo $HTTPS_PROXY 是否有输出
下载到一半断掉节点丢包或晚高峰换专线节点或白天重试
提示证书错误客户端开了 TLS 解密或自签证书关掉相关选项
sudo 安装失败、普通用户正常sudo 不继承变量改用 sudo -E

下载失败的排查顺序 ​

  1. 确认环境变量在当前终端窗口已生效:echo $HTTPS_PROXY 有输出。
  2. 端口是否正确:和客户端设置页的混合端口或 HTTP 端口一致。
  3. 节点是否稳定:下载大包中途断掉,换一个晚高峰稳定的节点重试。
  4. 规则模式下资源域名是否走代理:临时切全局测试。
  5. 以上都对仍失败,换地区节点。部分资源 CDN 对某些地区的机房 IP 限速。

节点选择建议 ​

  • 安装阶段看带宽和稳定性,对地区没有登录那么严格,美国、日本、新加坡都可以。
  • 下载大包时选专线或低丢包节点,避免中途断掉重来。
  • 安装完成后登录和使用阶段再按网络环境的要求挑节点。

推荐机场 ​

常见问题 ​

浏览器下载很快,终端很慢? ​

终端没走代理,设环境变量或开 TUN。

设了环境变量没变化? ​

新开的终端窗口不会继承上一个窗口的 export,要重新执行或写进配置文件。

用 sudo 安装时代理失效? ​

sudo 不继承环境变量,用 sudo -E 或在 root 下单独设置。

下一步 ​

相关阅读 ​

本站内容仅供参考,部分链接含推广说明,详见各优惠页。关于本站