Cursor Remote SSH 连接服务器失败（120s超时）完整排查与解决（含 cursor-server 手动部署）

Cursor Remote SSH 连接服务器失败（120s超时）完整排查与解决（含 cursor-server 手动部署）

发布时间：2026/10/2 6:19:48
Cursor Remote SSH 连接服务器失败（120s超时）完整排查与解决（含 cursor-server 手动部署） 1. Cursor Remote SSH 连接服务器失败 120s 超时到底卡在哪你在本地终端敲ssh myserver一秒就进去了MobaXterm 也连得好好的结果一切换到 Cursor 的 Remote SSH进度条转两分钟最后甩你一句SSH connection timed out after 120s without receiving any data from the remote host。这个场景我太熟了Cursor Remote SSH 连接服务器失败 120s 超时几乎每个第一次把 Cursor 往 Linux 服务器上搬的人都会撞一次。先把结论摆前面普通 SSH 能连不等于 Cursor Remote SSH 能连。这两件事走的根本不是同一条链路。普通 SSH 只做一件事——把你送进远程 shell。而 Cursor Remote SSH 在握手之后还要干一串活在服务器上跑安装脚本、下载cursor-server也就是 rehremote extension host、解压到~/.cursor-server、再启动一个服务进程最后本地通过端口转发跟这个进程通信。这中间任何一环断了你看到的都是同一个 120s 超时报错信息却完全不告诉你断在哪。所以排查思路不能是「SSH 配置是不是写错了」而是要把这条链路拆成四段分别验证第一段SSH 本身通不通。用ssh -v myserver看握手细节能进 shell 就算过。第二段远程 shell 初始化干不干净。Remote SSH 是非交互模式.bashrc里任何echo、conda activate、nvidia-smi的输出都会污染握手通道把协议数据冲掉。第三段cursor-server能不能下载并落地。这一步最容易翻车因为 Cursor 的下载链接用的是SERVER_REAL_COMMIT不是cursor --version里那个 hash拼错了直接AccessDenied。第四段服务进程起来后端口转发通不通。本地要能通过-D动态转发摸到远程的 server 端口。这篇就按这四段走一遍每段给你可复制的命令和该看到的日志。中途我会顺带说一个很多人忽略的点如果你后面想让 Agent 直接调模型能力本地和远程的凭据管理最好统一这块我用 TaoToken 的 API Key 做例子配置片段在第三节。先明确一下适用人群本地 Windows 或 macOS远程是 Linux 服务器用 Cursor 想直接编辑服务器上的项目文件、跑 Agent、看日志不想来回scp。如果你正好卡在 120s 超时往下照着做基本能定位。2. 先分清 SSH 通与 cursor-server 就绪是两码事很多人第一步就误判了。看到 MobaXterm 能连就认定网络和 SSH 没问题于是把精力全花在改~/.ssh/config上改来改去还是超时。问题在于 Cursor Remote SSH 的日志里那句Launching SSH server via shell with command它其实已经把真相写出来了Resolving ssh remote authority myserver Launching SSH server via shell with command: type C:\Users\***\AppData\Local\Temp\cursor_remote_install_xxx.sh | ssh -T -D xxxx myserver bash --login -c bash Waiting for SSH handshake (timeout: 120s) Error installing server: SSH connection timed out after 120s without receiving any data from the remote host注意bash --login -c bash这个调用方式。它不是交互式登录而是登录后直接执行bash中间任何 stdout 输出都会被 Cursor 当成协议数据去解析。你在.bashrc里写一句echo welcome交互式 SSH 里看着挺友好到了这里就是把协议流搅乱。先做基础连通性验证别急着动 Cursor# 带详细日志看握手到认证全过程 ssh -vvv myserver # 非交互式执行一条命令模拟 Cursor 的调用方式 ssh myserver echo READY第二条命令很关键。如果它输出干净的READY说明非交互通道没问题如果输出里混了welcome、conda 提示、nvidia-smi表格那你的.bashrc就是嫌疑犯。标准的保护写法是这样检查你的~/.bashrc开头有没有# If not running interactively, dont do anything case $- in *i*) ;; *) return;; esac有这段非交互调用会直接 return不执行后面的输出。没有就补上或者把echo、conda activate这类语句挪到case判断之后。再验证服务器依赖Cursor 安装脚本要用到这些which tar gzip curl wget # 期望四个路径都打印出来缺哪个装哪个然后测服务器能不能访问下载源curl -I https://downloads.cursor.com # 期望 HTTP/2 200 或 301/302这几步都过了说明 SSH 层和网络层没问题问题在cursor-server的下载与部署。这时候再去看 Cursor 的日志你会发现它卡在Waiting for SSH handshake之后就没动静了——因为它在等服务器把 server 装好并回话而 server 根本没装成功。这里有个认知要纠正cursor-server不是 Cursor 客户端自带的是每次连新机器时按需下载的。下载源、commit 版本、目录结构三者必须对上错一个就是超时或 AccessDenied。下一节讲怎么把这三者对正确。3. 可复制的 SSH 配置与 cursor-server 手动部署片段这一节是全文最该抄的部分。我把它拆成「SSH 配置」「找对 commit」「手动部署」「凭据配置」四块每块都给完整片段。3.1 SSH config 与密钥登录先解决认证方式。密码登录在 Remote SSH 场景下容易出问题改成密钥最稳。本地生成ssh-keygen -t ed25519 -C cursor-remote # 一路回车默认生成到 ~/.ssh/id_ed25519Windows 下查看公钥type %USERPROFILE%\.ssh\id_ed25519.pub把公钥内容写到服务器mkdir -p ~/.ssh nano ~/.ssh/authorized_keys # 粘贴公钥保存退出 chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys本地~/.ssh/config写成这样注意IdentityFile路径按你的系统改Host myserver HostName 192.168.xxx.xxx User your_username Port 22 IdentityFile C:\Users\***\.ssh\id_ed25519 ServerAliveInterval 30 ServerAliveCountMax 6ServerAliveInterval这两行是防长时间无数据被中间设备掐断的Remote SSH 握手期间很有用。改完测ssh myserver # 不输密码直接进 成功3.2 找到真正的 SERVER_REAL_COMMIT这是整个问题的核心突破口。cursor --version输出的 hash 不是下载用的那个。正确做法是让 Cursor 先失败一次然后去本地临时目录翻安装脚本。Windows 资源管理器地址栏输入%TEMP%找cursor_remote_install_*.sh文件用记事本或 VS Code 打开搜索cursor-reh-linux-x64.tar.gz你会看到类似SERVER_COMMIT91c600a1xxxxxxxx SERVER_REAL_COMMITa1b2c3d4e5f6xxxxxxxxxxxxxxxxxxxxxxxx下载链接用的是SERVER_REAL_COMMIT。拼出来https://downloads.cursor.com/production/SERVER_REAL_COMMIT/linux/x64/cursor-reh-linux-x64.tar.gz用错 commit 就会AccessDenied这是很多人卡住的原因。3.3 手动部署 cursor-server本地下载好cursor-reh-linux-x64.tar.gz约 90MB上传到服务器~/然后# 建目录commit 换成你的 SERVER_REAL_COMMIT mkdir -p ~/.cursor-server/bin/linux-x64/SERVER_REAL_COMMIT # 解压strip-components1 去掉顶层目录 tar -xzf ~/cursor-reh-linux-x64.tar.gz \ -C ~/.cursor-server/bin/linux-x64/SERVER_REAL_COMMIT \ --strip-components1 # 确认关键文件在 ls ~/.cursor-server/bin/linux-x64/SERVER_REAL_COMMIT/bin/ # 期望看到 cursor-server 可执行文件3.4 凭据与模型接入配置如果你希望远程 Agent 也能调模型能力本地和远程的凭据要统一管理。我用 TaoToken 的 API Key 做示例它的 Base URL 是https://taotoken.net/api兼容 OpenAI 风格调用。在项目里放一个.env或配置文件{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: claude-sonnet-4-5, timeout: 120 }三件套记牢Base URL、Key、Model ID缺一个调用就报错。Key 在控制台生成地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content生成后别写进代码仓库用环境变量或.gitignore排除。配置完这些再回 Cursor 重连。如果还是超时说明问题不在部署在端口转发或 shell 环境进下一节验证。4. 验证请求与成功失败日志对照部署完不能靠感觉要用日志说话。这一节给你成功和失败两套日志特征对照着看就知道卡在哪。先验证 SSH 非交互通道干净ssh myserver echo READY # 成功只输出 READY # 失败输出里混了 welcome / conda / nvidia-smi再验证 server 目录结构ls -la ~/.cursor-server/bin/linux-x64/SERVER_REAL_COMMIT/ # 成功有 bin/、out/、package.json 等 # 失败目录空或只有压缩包验证端口转发能力模拟 Cursor 的-D动态转发ssh -T -D 1080 myserver echo TUNNEL_OK # 成功输出 TUNNEL_OK # 失败卡住或报 channel 错误然后回 Cursor 重连看输出面板的 Remote SSH 日志。成功日志长这样Resolving ssh remote authority myserver Launching SSH server via shell with command: ... Waiting for SSH handshake (timeout: 120s) SSH server ready, installing server... Server installed at ~/.cursor-server/bin/linux-x64/commit Starting server... Server listening on port xxxxx Forwarding port xxxxx Connected to remote server左下角会出现[SSH: myserver]文件树能展开/home/...Agent 能直接读服务器文件。失败日志对照表日志片段含义对应排查节timed out after 120s without receiving any data握手无数据shell 污染或 server 没起第 2、3 节AccessDenied下载链接 commit 错3.2 节local proxy failed端口转发失败本节reading choices报错模型调用返回格式异常3.4 节401API Key 无效或过期3.4 节OAuth相关认证方式冲突3.1 节验证模型调用是否通用 curl 直接打curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:ping}]} # 成功返回 JSONchoices 里有内容 # 401Key 错reading choices 报错返回体不是预期结构这一步过了说明凭据链路没问题Remote SSH 里的 Agent 也能正常调。想单独验证模型对话可以直接用模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content试一句确认 Key 有效再回 Cursor。5. 本篇常见报错逐条排查这一节把真实会撞到的报错列出来每条给定位动作。别跳着看你的报错大概率在里面。报错一SSH connection timed out after 120s without receiving any data from the remote host这是最泛的报错四个原因都可能。按顺序查先ssh myserver echo READY看输出干不干净再确认~/.cursor-server/bin/linux-x64/commit/目录有内容再ssh -T -D 1080 myserver echo OK测转发。三步定位到具体环节。报错二AccessDenied下载失败commit 用错了。回 3.2 节从cursor_remote_install_*.sh里找SERVER_REAL_COMMIT别用cursor --version的 hash。报错三local proxy failed端口转发没建起来。检查本地 1080 之类端口有没有被占用netstat -ano | findstr 1080Windows或lsof -i:1080macOS。也检查服务器sshd_config里AllowTcpForwarding是不是yes。报错四401 UnauthorizedAPI Key 无效。确认 Key 没多空格、没过期、没被.gitignore漏掉导致读空。重新在控制台生成一个地址https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。报错五reading choices相关解析错误模型返回体不是预期结构。多半是 Base URL 写错比如漏了/api或多了/v1。正确是https://taotoken.net/api调用路径再拼/v1/chat/completions。报错六OAuth认证冲突本地同时配了多种认证方式Cursor 不知道用哪个。清掉~/.ssh/config里多余的IdentityFile只留一个或者用IdentitiesOnly yes强制。报错七连上了但 Agent 读不到文件server 起来了但工作区路径不对。看左下角[SSH: myserver]后面的路径确认是你项目所在目录。不是的话在 Cursor 里File Open Folder重新选。报错八连一会儿就断ServerAliveInterval没配。回 3.1 节加上那两行或者服务器sshd_config里调大ClientAliveInterval。排查顺序建议固定成SSH 通道 → shell 干净度 → server 目录 → 端口转发 → 凭据。每次只改一个变量改完重连看日志别一次改一堆否则你不知道哪个生效了。6. 长期编码与 Agent 场景的接入建议Remote SSH 打通只是第一步。如果你打算长期在服务器上跑 Cursor Agent 做编码有几个习惯能省很多事。第一把cursor-server的 commit 记下来。Cursor 升级后 commit 会变旧目录可能失效重连时又要重新下载。在服务器上留个~/.cursor-server/README记当前 commit 和下载链接下次直接复用。第二凭据统一走环境变量。本地和远程都从同一份配置读 Base URL、Key、Model ID避免两边不一致导致401或reading choices。TaoToken 的接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例照着配比手写稳。第三如果你重度用 Agent 做长期编码任务考虑 Coding Plan地址https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content比按次调用更适合持续跑的场景。Claude Code 类的接入配置在https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content三件套还是 Base URL、Key、Model ID。第四.bashrc的保护段永远别删。每次换服务器第一件事就是检查case $- in *i*)那段在不在这是 Remote SSH 最容易踩的坑没有之一。最后说个我自己的习惯每次连新服务器先手动把cursor-server部署好再让 Cursor 连而不是等它自动下载。自动下载失败时你拿不到有用日志手动部署每一步都有输出出问题一眼能看出卡在哪。这套流程走顺之后120s 超时基本不会再出现就算出现你也能在五分钟内定位到具体环节。