网络 (Network)
配置代理和自定义证书
OpenCode 支持标准代理环境变量以及适用于企业网络环境的自定义证书。
代理 (Proxy)
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 服务器进行通信。你必须为此连接绕过代理(NO_PROXY),以防止路由循环。你可以使用 CLI 标志来配置服务器的端口和主机名。
身份验证 (Authenticate)
如果你的代理需要基本身份验证(Basic Authentication),请在 URL 中包含凭据。
终端窗口示例:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
注意: 避免硬编码密码。建议使用环境变量或安全的凭据存储方式。
对于需要 NTLM 或 Kerberos 等高级身份验证的代理,请考虑使用支持你身份验证方法的 LLM 网关(LLM Gateway)。
自定义证书 (Custom certificates)
如果你的企业在 HTTPS 连接中使用自定义 CA(证书颁发机构),请配置 OpenCode 信任它们。
终端窗口示例:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
此设置同时适用于代理连接和直接 API 访问。