网络、代理与 VPC 问题

​

连接超时或失败

• 确认本机可访问外部网络，能解析并连接服务域名。
• 若在企业网络或受限环境中，通常需要配置代理（见下文）。
• 临时网络波动可稍后重试；general.retryFetchErrors（默认开启）会自动重试部分 fetch 错误。

​

代理配置

export HTTPS_PROXY="http://proxy.example.com:8080"
export HTTP_PROXY="http://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1,.internal.example.com"

• HTTPS_PROXY / HTTP_PROXY：分别用于 HTTPS / HTTP 请求。
• NO_PROXY：逗号分隔的主机列表，这些主机不走代理。
• 大小写均可（HTTPS_PROXY 与 https_proxy 都识别）。
• 修改环境变量后重启 Qoder CLI 使其生效。

​

DNS 解析问题

• 若域名解析异常，可通过 advanced.dnsResolutionOrder 配置项调整解析顺序。
• 修改后需重启生效。

​

证书问题

• 企业代理常做 TLS 拦截，需将企业根证书加入系统信任库。
• 出现 unable to verify the first certificate 一类错误时，用环境变量指定额外受信任证书：
  Copy

  export NODE_EXTRA_CA_CERTS=/path/to/corp-root-ca.pem
  
  也可用 SSL_CERT_FILE 指定证书文件路径。详见 网络、代理与 VPC 的证书配置小节。
• 确认系统时间正确——时间偏差会导致证书校验失败。

​

VPC / 私有部署

• CN 版私有部署可通过 vpcInstanceName 配置项指定实例名，公共域名会映射到对应的每实例私有主机。
• 修改后需重启生效。
• 确认到私有网关的网络可达。

​

下一步

• 网络配置指南：网络、代理与 VPC。
• 登录网络问题：登录与认证问题。