~/content/network

Network

配置代理和自定义证书。

last_updated: "2026-01-20"

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


##代理

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

bash
# HTTPS proxy (recommended)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP proxy (if HTTPS not available)
export HTTP_PROXY=http://proxy.example.com:8080

# Bypass proxy for local server (required)
export NO_PROXY=localhost,127.0.0.1

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

您可以使用 CLI flags 配置服务器的端口和主机名。


###身份验证

如果您的代理需要基本身份验证,请在 URL 中包含凭据。

bash
export HTTPS_PROXY=http://username:password@proxy.example.com:8080

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

对于需要高级身份验证(如 NTLM 或 Kerberos)的代理,请考虑使用支持您的身份验证方法的 LLM Gateway。


##自定义证书

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

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

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

Comments (Coming Soon)

Configure Giscus in environment variables to enable comments.