当前位置:首页 > 系统教程 > 正文

VSCode远程开发:使用SSH连接Ubuntu

VSCode远程开发:使用SSH连接Ubuntu

超简单详细教程,小白也能轻松搞定

本文将详细介绍如何使用VSCode通过SSH远程连接Ubuntu,搭建远程开发环境。无论你是初学者还是有经验的开发者,都能按照步骤成功连接。

1. 准备工作:安装VSCode和Remote-SSH插件

首先,你需要在本地电脑上安装VSCode(Visual Studio Code)。下载地址:官网。安装完成后,打开VSCode,点击左侧扩展图标,搜索“Remote-SSH”插件,由Microsoft提供,点击安装。这个插件是VSCode远程开发的核心,支持通过SSH连接远程主机。

2. Ubuntu端配置:开启SSH服务

确保你的Ubuntu系统已经安装了SSH服务。打开终端,输入以下命令检查SSH状态:sudo systemctl status ssh。如果未安装,执行:sudo apt update && sudo apt install openssh-server -y。安装后启动SSH:sudo systemctl start ssh,并设置开机自启:sudo systemctl enable ssh。然后获取Ubuntu的IP地址:ip a,记下inet地址(如192.168.x.x)。

3. 防火墙设置(可选)

如果Ubuntu启用了防火墙(ufw),需要开放SSH端口(默认22):sudo ufw allow ssh。确保防火墙允许SSH连接。

4. VSCode连接Ubuntu

回到VSCode,点击左侧的“远程资源管理器”图标(或按Ctrl+Shift+P,输入Remote-SSH: Connect to Host)。选择“Add New SSH Host”,输入:ssh 用户名@IP地址,例如ssh user@192.168.1.100。按Enter,选择SSH配置文件保存位置(默认即可)。然后点击连接,选择Linux平台,输入密码,即可建立连接。成功后,VSCode底部状态栏会显示“SSH: IP地址”,此时你可以在VSCode中直接操作远程文件,就像在本地一样,享受SSH连接Ubuntu带来的便利。

VSCode远程开发:使用SSH连接Ubuntu VSCode远程开发  SSH连接Ubuntu 远程开发环境 Remote-SSH插件 第1张

5. 配置免密登录(进阶)

为了避免每次输入密码,可以配置SSH密钥对。在本地生成密钥:ssh-keygen -t rsa,然后将公钥复制到Ubuntu:ssh-copy-id 用户名@IP地址。之后连接就无需密码,提升远程开发环境的使用体验。

常见问题

  • 连接超时:检查IP地址是否正确,Ubuntu是否在同一网络,防火墙是否开放22端口。
  • 权限拒绝:确保用户名和密码正确,或者SSH配置允许密码认证。
  • 插件无法使用:重新安装Remote-SSH插件,或更新VSCode。

通过以上步骤,你已经成功使用VSCode的SSH远程连接功能,搭建了强大的VSCode远程开发环境。现在可以开始在远程Ubuntu上进行编码了!