Cursor 如何配置 HTTP 代理支持 SSH 隧道?

文章导读
当 Cursor 需要访问公司内网或远程服务器的代码托管服务,而网络策略禁止直连,仅允许通过 SSH 通道访问时,就需要把 SSH 隧道转换为本地 HTTP 代理。判断条件很简单:如果直接设置 HTTP 代理地址后连接超时,同时确认 SSH 可以登录目标机器,那么考虑使用 SSH 隧道。此外,终端环境通常没有图形化代理设置,这是最常见的触发场景。
📋 目录
  1. A 先判断是不是需要走 SSH 隧道
  2. B 用 SSH 端口转发把远程 HTTP 代理映射到本地
  3. C 配置 Cursor 并验证代理是否真的可用
  4. D 容易忽略的连接维护和认证细节
  5. E 排查到其他情况时的下一步
A A

先判断是不是需要走 SSH 隧道

当 Cursor 需要访问公司内网或远程服务器的代码托管服务,而网络策略禁止直连,仅允许通过 SSH 通道访问时,就需要把 SSH 隧道转换为本地 HTTP 代理。判断条件很简单:如果直接设置 HTTP 代理地址后连接超时,同时确认 SSH 可以登录目标机器,那么考虑使用 SSH 隧道。此外,终端环境通常没有图形化代理设置,这是最常见的触发场景。

在这个场景里,核心不是让 Cursor 直接发起 SSH 连接,而是让本地多出一个 HTTP 代理端口,Cursor 以为自己在走正常 HTTP 代理,实际上流量通过 SSH 加密到达远程主机,再由远程主机访问目标服务。这样做的优势是不需要修改 Cursor 的协议实现,只要它支持 HTTP 代理就能工作。

用 SSH 端口转发把远程 HTTP 代理映射到本地

如果远程服务器上已经运行了一个 HTTP 代理(比如监听在 127.0.0.1:3128),最稳妥的做法是使用 SSH 本地端口转发,把这个端口映射到本地。命令大致如下:

ssh -L 8080:127.0.0.1:3128 user@remote -N -o ServerAliveInterval=30

这里 `-L 8080:127.0.0.1:3128` 表示在本地打开 8080 端口,所有发往这个端口的请求都会通过 SSH 隧道转发到远程主机的 `127.0.0.1:3128`。注意目标地址必须是远程主机能访问的地址,通常是 `127.0.0.1`,因为代理服务通常只绑定本机。`-N` 表示只做转发,不执行命令;`-o ServerAliveInterval=30` 用来定期发送心跳包,避免空闲连接被断开。

如果远程服务器上没有现成的 HTTP 代理,需要先在远程机器上准备一个代理服务,例如小巧的 tinyproxy,并确保它只监听在 127.0.0.1 上,然后再用上面的命令把端口映射回来。这里要注意,tinyproxy 的默认端口通常是 8888,你可以在它的配置文件中修改。

配置 Cursor 并验证代理是否真的可用

在 Cursor 里,代理设置一般在应用的 Preferences 或 Settings 中,搜索 “proxy” 可以找到。如果没有现成入口,也可以通过设置系统环境变量 `HTTP_PROXY` 和 `HTTPS_PROXY` 后再启动 Cursor,例如在 `.bashrc` 里写 `export HTTP_PROXY=http://127.0.0.1:8080`。不过,环境变量能否被 Cursor 完整继承,取决于你用终端启动还是直接从应用菜单打开,这点需要留意。

配置完成后,可以用终端验证代理是否可用。在浏览器中直接访问 `http://localhost:8080` 可能没有响应,因为代理不是 Web 服务器。更高效的验证是使用 `curl -x http://127.0.0.1:8080 https://api.github.com`,如果返回正常 JSON,则说明隧道正常。然后再打开 Cursor,观察是否能拉取远程仓库或登录账户,如果仍超时,继续检查端口映射和防火墙。

Cursor 如何配置 HTTP 代理支持 SSH 隧道?

容易忽略的连接维护和认证细节

SSH 连接断开后代理立即失效,建议使用 `autossh` 维持连接,或在前台保留。另一个坑是远程 HTTP 代理可能只监听 127.0.0.1,所以映射时必须使用 `127.0.0.1`,否则连接拒绝。还有代理认证问题:如果远程代理需要用户名密码,必须使用 `http://user:pass@127.0.0.1:8080` 形式,但这样会暴露密码,开发环境尽量使用 `~/.ssh/config` 中的配置并配合 ProxyCommand 处理。

这里特别要提一下 `~/.ssh/config` 的用法。你可以为这台跳板机单独定义一个 Host 别名,把端口转发参数固化下来,比如:

Host jump
    HostName remote.example.com
    User user
    LocalForward 8080 127.0.0.1:3128
    ServerAliveInterval 30

之后只要执行 `ssh jump -N`,本地 8080 就会自动映射。这样即使 Cursor 需要重启,也不会因为命令行参数记不全而中断。另外,如果你的远程代理本身要求认证,先确认它是 Basic Auth 还是 NTLM,不同认证方式对 URL 格式的要求不同。在不确定的时候,先用 curl 带用户名密码测试一次,确认能通过后再填到 Cursor 里。

排查到其他情况时的下一步

如果验证 curl 能通,但 Cursor 里仍然不行,常见原因有两个:一是 Cursor 没有正确读取到代理配置,二是它可能忽略了本地回环地址。你可以先用抓包工具或 `lsof -i :8080` 确认本地端口确实被 ssh 进程占用,然后在 Cursor 里尝试把代理地址从 `localhost` 换成 `127.0.0.1`,或者反过来试。有些 Electron 应用会默认忽略系统代理,需要手动在设置里填写。

还有一个容易被忽略的是防火墙策略。SSH 隧道跑到远程主机后,远程 HTTP 代理需要能访问最终目标地址(例如内网的 Git 服务)。如果远程代理部署在 DMZ 区,它自身可能没有权限访问更后面的内网。这种情况需要联系网络管理员确认路由和访问控制列表。另外,如果在 Windows 上使用,OpenSSH 客户端和服务器的版本可能会影响 LocalForward 的行为,需要确认你的 Windows 版本是否内置了 OpenSSH,还是需要用 Git Bash 里的 ssh 命令。

配置 SSH 隧道给 Cursor 用,本质上是在本地模拟一个稳定的 HTTP 代理入口。判断的关键始终是:SSH 能通,目标服务能通,然后才轮到 Cursor 的配置。按照上述检查顺序,多数问题都能定位到具体环节。