中文
文档
网络

网络

配置代理和自定义证书。

OpenCode 支持标准代理环境变量和自定义证书,适用于企业网络环境。

代理

OpenCode 遵循标准代理环境变量。

# HTTPS 代理(推荐)
export HTTPS_PROXY=https://proxy.example.com:8080
 
# HTTP 代理(如果 HTTPS 不可用)
export HTTP_PROXY=http://proxy.example.com:8080
 
# 绕过本地服务器的代理(必需)
export NO_PROXY=localhost,127.0.0.1
⚠️

TUI 与本地 HTTP 服务器通信。你必须为此连接绕过代理,以防止路由循环。

你可以使用 CLI 标志 配置服务器的端口和主机名。

认证

如果你的代理需要基本认证,请在 URL 中包含凭据。

export HTTPS_PROXY=http://username:[email protected]:8080
⚠️

避免硬编码密码。使用环境变量或安全的凭据存储。

对于需要高级认证(如 NTLM 或 Kerberos)的代理,请考虑使用支持你的认证方式的 LLM Gateway。

自定义证书

如果你的企业使用自定义 CA 进行 HTTPS 连接,请配置 OpenCode 信任它们。

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

这适用于代理连接和直接 API 访问。