news 2026/7/3 12:38:32

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
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.comcursor.sh的 CDN 上。

国内远程服务器连接失败的原因通常是:

原因说明
服务器无法访问外网国内云服务器(如阿里云轻量、腾讯云)可能默认没有外网访问权限
CDN 被屏蔽cursor.shvscode-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_ID="abc123def456" # 下载 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 user@your-server:~/ # SSH 到服务器 ssh user@your-server # 解压到指定路径 mkdir -p ~/.cursor-server/bin/${COMMIT_ID} tar -xzf ~/vscode-server-linux-x64.tar.gz -C ~/.cursor-server/bin/${COMMIT_ID} --strip-components=1 # 权限处理 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_PROXY=http://your-proxy-server:port export HTTPS_PROXY=http://your-proxy-server:port # 或者在 ~/.bashrc 中永久设置 echo 'export HTTP_PROXY=http://your-proxy-server:port' >> ~/.bashrc echo 'export HTTPS_PROXY=http://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_proxy=http://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错误,推荐优先级:

  1. 方案一(手动上传):最稳定,一次操作永久解决
  2. 方案四(检查网络):快速排查,有时重启服务器就能恢复网络
  3. 方案二(配置代理):如果服务器本身没有外网权限,必须配代理
  4. 方案三(国内镜像):备选方案,适合批量部署场景

如果频繁在不同服务器上使用 Cursor Remote,建议用方案一在本地保存一份 Server 包,每次直接 scp 上传即可。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/7/3 12:35:16

3个步骤解决macOS滚动方向混乱:Scroll Reverser深度解析

3个步骤解决macOS滚动方向混乱:Scroll Reverser深度解析 【免费下载链接】Scroll-Reverser Per-device scrolling prefs on macOS. 项目地址: https://gitcode.com/gh_mirrors/sc/Scroll-Reverser 你是否曾经在Mac上同时使用触控板和鼠标时感到困惑&#xff…

作者头像 李华
网站建设 2026/7/3 12:34:53

macOS滚动方向终极控制方案:Scroll Reverser完整使用指南

macOS滚动方向终极控制方案:Scroll Reverser完整使用指南 【免费下载链接】Scroll-Reverser Per-device scrolling prefs on macOS. 项目地址: https://gitcode.com/gh_mirrors/sc/Scroll-Reverser 如果你在Mac上同时使用触控板和鼠标,一定会遇到…

作者头像 李华
网站建设 2026/7/3 12:25:29

3步掌握HsMod插件:彻底改变你的炉石传说游戏体验

3步掌握HsMod插件:彻底改变你的炉石传说游戏体验 【免费下载链接】HsMod Hearthstone Modification Based on BepInEx 项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod HsMod是一款基于BepInEx框架开发的炉石传说功能增强插件,为玩家提供…

作者头像 李华
网站建设 2026/7/3 12:23:09

stortrace:基于eBPF的高性能IO追踪分析工具完全指南

stortrace:基于eBPF的高性能IO追踪分析工具完全指南 【免费下载链接】stortrace High-performance IO tracing and analysis tool based ebpf mechanism. 项目地址: https://gitcode.com/openeuler/stortrace 前往项目官网免费下载:https://ar.op…

作者头像 李华
网站建设 2026/7/3 12:20:02

心脏瓣膜病的症状与临床识别——从“无症状”到典型信号

心脏瓣膜病是常见的心血管疾病之一,指心脏四个瓣膜(二尖瓣、主动脉瓣、三尖瓣、肺动脉瓣)因狭窄或关闭不全导致血流动力学异常。瓣膜病变的早期症状十分隐蔽,常被误认为是“年纪大了”或“太累了”。本文系统梳理瓣膜病的典型症状…

作者头像 李华