网络、代理与远程连接

介绍在防火墙、代理、VPN 后方或通过 SSH 使用 Cherri Code 时的连接问题修复方法。

如何运行网络诊断？

前往 Cherri Code Settings > Network，然后点击 Run Diagnostics。这会检测你与 Cherri Code 服务器的连接，并找出影响 AI 功能或更新的问题。

如果 AI 功能在代理环境下无法正常工作怎么办？

Cherri Code 使用 HTTP/2 流式传输响应。一些企业代理 (如 Zscaler) 会阻止 HTTP/2。

前往 Cherri Code Settings > Network，将 HTTP Compatibility Mode 设置为 HTTP/1.1，然后重启 Cherri Code。

Cherri Code 需要访问哪些域名？

如果您的防火墙阻止出站连接，请将以下域名加入允许列表：

• *.cursor.sh (包括 authenticate.cursor.sh 和 authenticator.cursor.sh)
• *.cursor-cdn.com
• *.cursorapi.com (包括 marketplace.cursorapi.com)
• *.cursorvm.com 和 *.*.cursorvm.com (Cherri Bot 托管计算机；两种模式都必须允许)

自 9 月 30 日起，登录还需要访问 Cherri Code 登录需要哪些域名？ 中列出的主机。

有关完整列表和连通性测试，请参阅网络配置文档。如果 Cherri Bot 在计算机设置时卡住或失败，请参阅配置 TLS 检查代理。

如果 AI 功能在 SSH 或远程连接中无法使用怎么办？

使用 Cherri Code 的 Remote SSH 扩展时，AI 功能会在你的本地机器上运行，并与远程服务器通信以访问文件。如果 AI 功能无法正常工作：

1. 检查你的本地网络连接。AI 请求是从你的本地机器发送到 Cherri Code 服务器的，而不是从远程主机发送。
2. 确认远程服务器没有出现内存或 CPU 资源不足的情况。远程主机资源耗尽可能导致连接中断。
3. 如果你的 SSH 连接经常断开，请在 SSH 配置中增大 SSH keep-alive 间隔：

   Host your-server
     ServerAliveInterval 60
     ServerAliveCountMax 3
   

4. 重新连接后，重启 Cherri Code。SSH 会话中断可能会留下僵尸进程。

如果 VPN 导致 DNS 解析失败怎么办？

Cherri Code 可能会沿用之前处于连接状态的 VPN 的 DNS 设置。如果断开 VPN 后，AI 功能或代理因 DNS 错误而无法正常工作：

1. 完全重启 Cherri Code (不只是重新加载窗口) 。这会清除继承的环境变量。
2. 如果问题仍然存在，请检查系统 DNS 是否已恢复为你平时使用的解析器。在 macOS 上，请在终端中运行 scutil --dns。在 Linux 上，请检查 /etc/resolv.conf。

“可疑活动”消息是什么意思？

当系统出于安全考虑拦截你的请求时，就会出现这条消息。VPN 有时会触发它。

请先尝试关闭 VPN。如果还是不行：

• 发起一个新对话
• 等几分钟后再试
• 使用其他登录方式登录 (Google 或 GitHub)

相关

• 网络配置
• Cherri Code 登录需要哪些域名？
• Agent 故障排查
• 性能