0

0

VSCode如何进行远程开发与服务器连接【教程】

狼影

狼影

发布时间:2026-01-23 09:00:17

|

690人浏览过

|

来源于php中文网

原创

VSCode远程开发需Remote-SSH插件、本地SSH配置和服务器sshd服务三者协同;常见问题包括sshd未启动、防火墙阻断、SSH配置错误、vscode-server依赖缺失或权限不足。

vscode如何进行远程开发与服务器连接【教程】

VSCode 远程开发不是靠插件“一键连上”,而是依赖 Remote - SSH 扩展 + 本地 SSH 配置 + 服务器端 sshd 正常运行;连不上基本是这三者中某一个没对齐。

确保服务器已启用 SSH 且端口可访问

很多新手卡在第一步:以为装了 OpenSSH 就自动能连,其实 sshd 可能根本没启动,或防火墙/云平台安全组拦住了端口。

  • 登录服务器后执行 sudo systemctl status sshd,确认状态为 active (running)
  • 检查监听端口:sudo ss -tuln | grep ':22'(或你自定义的端口),确保有 LISTEN
  • 云服务器(如阿里云、AWS)必须在安全组中放行对应端口(默认 22),仅开放本地网络或公司 IP 段更安全
  • 若改过 SSH 端口(如 Port 2222),VSCode 连接时必须显式指定,不能只填 IP

VSCode 中正确配置 Remote-SSH 连接信息

Remote - SSH 插件本身不存密码,它读取的是本地 ~/.ssh/config 或用户手动输入的连接串;格式错一个字符(比如少个空格、多一个冒号)就会报 Failed to connect to the remote extension host

  • 推荐用 ~/.ssh/config 管理连接,例如:
Host myserver
    HostName 192.168.1.100
    User ubuntu
    Port 22
    IdentityFile ~/.ssh/id_rsa
  • 在 VSCode 命令面板(Ctrl+Shift+P)中运行 Remote-SSH: Connect to Host...,选 myserver 即可
  • 如果首次连接提示 “Are you sure you want to continue connecting?”,输 yes —— 这是正常 SSH 首次信任指纹流程,不是错误
  • 避免直接在连接框里输 user@host:port,容易漏掉 IdentityFile 或权限问题,config 文件方式更可控

远程 VSCode Server 启动失败的常见原因

连接 SSH 成功 ≠ 远程开发环境就绪。VSCode 会在服务器上自动部署一个轻量服务端(vscode-server),它依赖 curltarunzip 和基础 libc,缺一不可。

PHP Apache和MySQL 网页开发初步
PHP Apache和MySQL 网页开发初步

本书全面介绍PHP脚本语言和MySOL数据库这两种目前最流行的开源软件,主要包括PHP和MySQL基本概念、PHP扩展与应用库、日期和时间功能、PHP数据对象扩展、PHP的mysqli扩展、MySQL 5的存储例程、解发器和视图等。本书帮助读者学习PHP编程语言和MySQL数据库服务器的最佳实践,了解如何创建数据库驱动的动态Web应用程序。

下载
  • 报错 Command 'code' not foundFailed to fetch remote environment:检查服务器是否安装了 curlwhich curl)和 tartar --version
  • 使用 Alpine Linux 或最小化镜像(如 debian-slim)时,glibc 缺失会导致 vscode-server 启动崩溃,需换用标准镜像或手动安装兼容库
  • 磁盘空间不足(/tmp 或用户家目录满)也会让下载/解压失败,看日志里是否有 No space left on device
  • 某些企业服务器禁用了 ~/.vscode-server 目录的执行权限,需联系管理员确认 noexec 是否挂载在 home 分区

连接后文件浏览慢、终端卡顿怎么办

这不是 VSCode 本身的问题,而是 SSH 通道带宽或远程文件系统响应拖慢了协议层;尤其打开大项目或 NFS 挂载目录时明显。

  • ~/.ssh/config 对应 Host 块中添加:TCPKeepAlive yesServerAliveInterval 60,防意外断连
  • 关闭 VSCode 的文件监视器("files.watcherExclude")可大幅降低 CPU 和 IO 压力,例如排除 node_modules 和构建产物目录
  • 不要在远程窗口里开本地路径(如 /mnt/share)下的超大仓库——VSCode 会尝试递归扫描,改成只打开实际需要的子目录
  • 终端卡顿大概率是服务器 bash/zsh 启动脚本太重(比如每次加载 SDK、conda 环境),建议精简 ~/.bashrc 中非交互式场景不需要的部分

真正难调的往往不是“怎么连”,而是服务器环境是否干净、SSH 配置是否被其他工具(如 moshtmux)干扰、以及 VSCode 自动部署的 vscode-server 版本与远程系统 ABI 是否兼容——这些细节不报明确错误,但会让连接反复失败或功能异常。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

437

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

175

2023.10.30

java break和continue
java break和continue

本专题整合了java break和continue的区别相关内容,阅读专题下面的文章了解更多详细内容。

256

2025.10.24

vscode
vscode

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

589

2023.06.30

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

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

221

2023.07.21

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

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

390

2024.03.14

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

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

376

2024.03.14

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

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

549

2024.03.15

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

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

精品课程

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

共48课时 | 7.6万人学习

Git 教程
Git 教程

共21课时 | 2.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号