Network, Proxy, and VPC Issues

​

Connection Timeouts or Failures

• Verify that your local machine can access the external network, and resolve and connect to the service domains.
• If you are on a corporate network or in a restricted environment, you typically need to configure a proxy (see below).
• For temporary network fluctuations, try again later; general.retryFetchErrors (enabled by default) automatically retries certain fetch errors.

​

Proxy Configuration

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: Used for HTTPS / HTTP requests, respectively.
• NO_PROXY: A comma-separated list of hosts that bypass the proxy.
• Both uppercase and lowercase are supported (both HTTPS_PROXY and https_proxy are recognized).
• Restart Qoder CLI after modifying environment variables for the changes to take effect.

​

DNS Resolution Issues

• If domain resolution is abnormal, you can adjust the DNS resolution order via the advanced.dnsResolutionOrder configuration item.
• A restart is required for changes to take effect.

​

Certificate Issues

• Corporate proxies often perform TLS Interception, requiring the Enterprise root certificate to be added to the System Trust Store.
• When encountering errors such as unable to verify the first certificate, use an environment variable to specify additional trusted certificates:
  Copy

  export NODE_EXTRA_CA_CERTS=/path/to/corp-root-ca.pem
  
  You can also use SSL_CERT_FILE to specify the certificate file path. For details, see the certificate configuration section in Network, Proxy, and VPC.
• Ensure the system time is correct—time skew will cause Certificate validation to fail.

​

VPC / Private Deployment

• For the CN edition Private Deployment, you can specify the instance name via the vpcInstanceName configuration item, and public domains will be mapped to the corresponding per-instance private hosts.
• A restart is required for changes to take effect.
• Verify network reachability to the Private Gateway.

​

Next Steps

• Network configuration guide: Network, Proxy, and VPC.
• Sign-in network issues: Sign-in and Authentication Issues.