Remote-SSH连接下VSCode插件更新超时的解决方法

落雪酱_6894

落雪酱_6894

2026-08-19

819人浏览

原创

remote-ssh插件更新超时是因为远程服务器无法直连marketplace,需配置http_proxy环境变量或ssh端口转发,或改用国内镜像源;修改后必须重连ssh而非重载窗口。

remote-ssh连接下vscode插件更新超时的解决方法

Remote-SSH 连接后插件更新卡住或报 timeout,根本不是本地网络问题,而是远程服务器压根没连上 Marketplace —— 它在用自己的网络发起请求,且默认不走你本地配的代理。

为什么 remote 插件更新会超时

VSCode Remote-SSH 的插件安装/更新行为发生在远程机器上:它会从远程服务器直接访问 https://marketplace.visualstudio.com。如果该服务器本身无法访问外网(如内网环境、ARM 板如 Orange Pi、无代理的云主机),就会卡在 “Installing…” 或直接报 connect ECONNREFUSED / request timed out。

常见误判点:

  • 你在本地 settings.json 里写了 http.proxy,但它对远程端完全无效
  • 远程终端里 curl https://marketplace.visualstudio.com 卡住,就说明问题已定位
  • 别信“重装插件”或“清缓存”,没网络权限,重装只是重复失败

远程端手动配置 HTTP_PROXY 环境变量

这是最直接、兼容性最好的方式,适用于所有 shell(bash/zsh)和 vscode-server 启动流程。

在远程服务器上执行:

echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
source ~/.bashrc

然后必须断开并重新连接 Remote-SSH(不是 reload window),否则 vscode-server 不会加载新环境变量。

注意:

  • 地址必须用 127.0.0.1,别写 localhost(某些代理监听不支持 IPv6 回环)
  • 确保代理服务(如 Clash、Sing-Box)在远程服务器能访问到——但通常不能,所以更常用的是「本地代理 + SSH 端口转发」方案(见下一条)
  • Windows 用户若用 WSL 远程,还要确认 WSL 能访问 Windows 主机的 127.0.0.1:7890(需关闭防火墙或加例外)

用 SSH RemoteForward 把本地代理透传给远程

当远程服务器本身不能直连代理(比如 Orange Pi、树莓派、无公网出口的跳板机),就得把本地电脑的代理端口“映射过去”。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

步骤分三步:

  • 在本地 ~/.ssh/config 对应 Host 块中加:
    RemoteForward 127.0.0.1:10808 127.0.0.1:7890
  • 远程服务器上设置:
    export HTTP_PROXY=http://127.0.0.1:10808
    export HTTPS_PROXY=http://127.0.0.1:10808
  • 重启 Remote-SSH 连接(触发端口转发建立)

验证是否生效:
在远程终端运行 curl -vI https://api.github.com,看到 且响应头含 <code>Via: 字段,说明流量确实经过了你的本地代理。

换 extensions.gallery.serviceUrl 镜像源(免代理方案)

如果你的远程服务器能访问国内镜像(如 Azure CDN),可绕过代理依赖,更稳定。

在远程机器的 VSCode 设置中(即 Remote Machine Settings),打开 settings.json,加入:

"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"

注意末尾斜杠不能少,否则 404;该地址目前仍有效(截至 2026 年 8 月)。

这个方案的局限:

  • 部分私有扩展或预发布版本可能不在镜像中
  • 如果远程服务器连 vscode.cdn.azure.cn 也超时(如某些企业防火墙拦截 CDN 域名),就得退回前两种方案

真正容易被忽略的是:远程端的 HTTP_PROXY 必须由 shell 初始化脚本加载,而不是靠 VSCode GUI 启动时读取 —— 所以改完 .bashrc 后不重连,等于没改。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1215

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2492

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1849

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2567

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1798

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1222

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1096

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

434

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程