cursor连接远程服务器出现无法与建立连接:未能下载 VS Code 服务器(Failed to fetch)解决方案

📅 2026/7/3 12:38:38
cursor连接远程服务器出现无法与建立连接:未能下载 VS Code 服务器(Failed to fetch)解决方案
cursor连接远程服务器出现无法与建立连接未能下载 VS Code 服务器(Failed to fetch)解决方案问题描述在使用 Cursor 的 Remote SSH 功能连接远程服务器时出现以下报错无法与xxx.xxx.xxx.xxx建立连接未能下载 VS Code 服务器(Failed to fetch)或英文版Could not establish connection to xxx.xxx.xxx.xxx: Failed to download VS Code Server (Failed to fetch)具体现象Cursor 能成功 SSH 连接到服务器但在正在下载 VS Code Server阶段卡住最终超时报错Failed to fetch重试多次结果一样原因分析Cursor 的 Remote SSH 功能需要在远程服务器上安装一个轻量级的 VS Code Server用于处理代码编辑、文件操作和终端交互。这个 Server 的安装包托管在update.code.visualstudio.com或cursor.sh的 CDN 上。国内远程服务器连接失败的原因通常是原因说明服务器无法访问外网国内云服务器如阿里云轻量、腾讯云可能默认没有外网访问权限CDN 被屏蔽cursor.sh或vscode-update.azurewebsites.net在某些地区不可达DNS 解析失败服务器 DNS 无法解析 Cursor 更新服务器域名代理未配置服务器需要通过代理访问外网但 Cursor 不知道代理配置解决方案方案一手动上传 VS Code Server最稳定步骤1在本地找到 VS Code Server 的 commit id# 在 Cursor 中查看Help → About找到 Commit ID # 或者在终端查看 cat /Applications/Cursor.app/Contents/Resources/app/product.json | grep -o commit: [^]*步骤2在本地下载对应版本的 Server 包# 替换 COMMIT_ID 为实际值 COMMIT_IDabc123def456 # 下载 Linux x64 版本的 Server curl -L https://update.code.visualstudio.com/commit:${COMMIT_ID}/server-linux-x64/stable \ -o vscode-server-linux-x64.tar.gz步骤3上传到远程服务器并解压# 上传到服务器 scp vscode-server-linux-x64.tar.gz useryour-server:~/ # SSH 到服务器 ssh useryour-server # 解压到指定路径 mkdir -p ~/.cursor-server/bin/${COMMIT_ID} tar -xzf ~/vscode-server-linux-x64.tar.gz -C ~/.cursor-server/bin/${COMMIT_ID} --strip-components1 # 权限处理 chmod x ~/.cursor-server/bin/${COMMIT_ID}/server.sh chmod x ~/.cursor-server/bin/${COMMIT_ID}/bin/cursor-server chmod x ~/.cursor-server/bin/${COMMIT_ID}/node步骤4创建标记文件touch ~/.cursor-server/bin/${COMMIT_ID}/0步骤5在 Cursor 中重新连接此时 Cursor 检测到 Server 已存在会跳过下载步骤直接启动。方案二在远程服务器上配置代理# SSH 到服务器后 # 设置 HTTP 代理 export HTTP_PROXYhttp://your-proxy-server:port export HTTPS_PROXYhttp://your-proxy-server:port # 或者在 ~/.bashrc 中永久设置 echo export HTTP_PROXYhttp://your-proxy-server:port ~/.bashrc echo export HTTPS_PROXYhttp://your-proxy-server:port ~/.bashrc source ~/.bashrc注意Cursor Remote SSH 启动的是一个非登录 Shell可能不会自动加载.bashrc。可以在.bash_profile中也设置一份或者使用方案一手动安装。方案三使用国内镜像下载# 在远程服务器上执行 # 使用 jsdelivr CDN 镜像 COMMIT_ID你的commit_id wget https://cdn.jsdelivr.net/gh/cursor-server-mirror/server-linux-x64-${COMMIT_ID}.tar.gz # 或者使用代理下载 wget -e https_proxyhttp://your-proxy:port \ https://update.code.visualstudio.com/commit:${COMMIT_ID}/server-linux-x64/stable方案四验证网络连接# 在远程服务器上测试是否能访问 Cursor 更新服务器 curl -I https://cursor.sh curl -I https://update.code.visualstudio.com # 测试 DNS nslookup cursor.sh nslookup update.code.visualstudio.com # 如果 DNS 解析失败修改 /etc/resolv.conf echo nameserver 8.8.8.8 | sudo tee /etc/resolv.conf总结遇到Failed to fetch错误推荐优先级方案一手动上传最稳定一次操作永久解决方案四检查网络快速排查有时重启服务器就能恢复网络方案二配置代理如果服务器本身没有外网权限必须配代理方案三国内镜像备选方案适合批量部署场景如果频繁在不同服务器上使用 Cursor Remote建议用方案一在本地保存一份 Server 包每次直接 scp 上传即可。