V2 网络与后台服务排查

核验日期：2026-11-12。适用 OpenCode V2。 本页依据公开文档整理，未执行第三方安装、登录或模型调用。

先区分提供商访问失败、本地服务无法连接、证书错误和插件认证失败。网络通了不代表账户或插件兼容。

# 代理与本地连接#

在需要代理的 shell 中使用组织批准的代理，并绕过回环地址：

bash
复制
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,::1

上面的地址是占位值。V2 的 CLI 与后台服务通过本地 HTTP 连接；遗漏 NO_PROXY 可能连本机都失败。已在运行的后台服务不会因为另一个 shell 改变量而自动更新。

# 后台服务#

需要持久化代理时，按官方 Network 文档配置 opencode service set env，并重新启动服务。修改受管环境会停止当前服务，先保存工作、确认没有正在进行的任务。CLI 自己设置代理时仍需保留其 NO_PROXY。

# 排查清单#

• 确认 DNS、端口、系统时间及企业证书信任链。
• 检查防病毒软件或 HTTPS 检查代理是否影响连接。
• 对比 CLI 与服务运行环境，检查代理是否错误地接管 localhost。
• 不通过关闭 TLS 校验解决证书错误，不将含密码的代理地址贴到工单。
• TUN/VPN 是系统级网络变更，不是 OpenCode 必装依赖，也不保证解决 OAuth 或账户限制。

来源：Network↗、Troubleshooting↗。