使用VSCode通过Remote-SSH连接远程服务器详细教程

使用VSCode通过Remote-SSH连接远程服务器详细教程

引用

CSDN

1.

https://blog.csdn.net/qq_22841387/article/details/143094904

在日常开发中，许多开发者需要远程连接服务器进行代码编辑和调试。Visual Studio Code（VSCode）提供了一个非常强大的扩展——Remote-SSH，它允许我们通过SSH协议直接连接远程服务器，在本地编辑服务器上的代码，极大提高了开发效率。本文将详细讲解如何使用VSCode连接远程服务器，涵盖从插件安装到连接服务器的整个流程。

一、前提条件

1. 本地环境准备

在开始之前，确保你的本地环境满足以下条件：

1. Visual Studio Code已安装，版本最好是最新稳定版，确保可以支持最新的Remote-SSH功能。
2. SSH客户端已正确安装并配置：

• Linux和Mac系统自带OpenSSH客户端，一般不需要额外安装。
• Windows用户需要通过PowerShell或Windows设置中启用OpenSSH，或者使用Git Bash或WSL提供的SSH客户端。可以通过如下命令确认SSH是否可用：

ssh -V

如果未安装，可以通过Windows的可选功能中启用或使用choco安装：

choco install openssh

2. 远程服务器准备

确保你拥有以下远程服务器的信息：

1. SSH访问权限：

• 远程服务器支持SSH协议。
• 你有服务器的IP地址、用户名和密码，或SSH密钥。

2. 防火墙配置：

• 确保服务器的SSH端口（通常为22）对你的本地IP开放。如果使用自定义端口，需要知道该端口号。

3. 服务器配置：

• Linux系统的服务器通常默认支持SSH，但一些轻量级发行版可能需要提前安装并启用OpenSSH服务器：

sudo apt install openssh-server  # Debian/Ubuntu系列
sudo systemctl enable ssh
sudo systemctl start ssh

二、步骤详解

1. 安装Remote-SSH插件

打开VSCode，点击左侧活动栏最下方的扩展(Extensions)图标，或者按Ctrl+Shift+X快捷键调出扩展商店。在搜索栏中输入“Remote - SSH”，并点击安装来安装该扩展。安装完成后，VSCode的左下角会出现一个绿色的远程连接按钮，表明插件安装成功。

2. 启动Remote-SSH连接

插件安装完成后，点击左下角的绿色图标，这将打开Remote-SSH的操作菜单。

在弹出的菜单中，选择Connect to Host，即“连接到主机”。

3. 添加新的SSH主机

点击Add New SSH Host，也就是“添加新的SSH主机”选项，准备配置你要连接的远程服务器。

4. 输入SSH连接命令

接下来，VSCode会要求你输入远程服务器的SSH命令。格式如下：

ssh 用户名@服务器IP地址

例如，如果服务器的IP地址是192.168.0.1，用户名是user，你需要输入的命令是：

ssh user@192.168.0.1

• 如果服务器使用的是自定义端口（如2200），你需要指定端口：

ssh user@192.168.0.1 -p 2200

5. 选择SSH配置文件位置

输入SSH命令后，VSCode会提示你选择存放SSH主机配置信息的文件位置。建议选择默认的SSH配置文件，通常是**~/.ssh/config**。

如果你之前没有配置过，可以直接选择该文件。它会自动生成配置项，方便后续连接。配置文件**~/.ssh/config**的示例如下：

Host myserver
    HostName 192.168.0.1
    User user
    Port 2200  # 如果不是默认端口，则手动添加该行

• Host字段是一个别名，方便你后续通过ssh myserver连接到该服务器。
• HostName表示远程服务器的IP地址或域名。
• User是登录的用户名。

6. 连接远程主机

添加SSH主机后，VSCode会提示你返回Remote-SSH菜单，选择刚刚添加的主机进行连接。点击主机名称后，VSCode将自动打开一个新窗口并尝试连接到远程服务器。

7. 选择远程操作系统

连接服务器后，VSCode会询问远程服务器的操作系统类型。根据服务器的操作系统（通常是Linux），选择对应的选项。

8. 输入SSH密码

如果是首次连接该服务器，系统会要求你输入SSH密码（或者在使用密钥的情况下，可能需要输入密钥的密码）。输入密码后，按回车即可。

9. 连接成功

当连接成功后，VSCode左下角会显示远程服务器的名称，表示已经成功连接上远程服务器。

三、常见问题及解决方案

1. SSH连接失败或超时

• 可能原因：

• 防火墙阻止了SSH端口（默认22）的访问。

• SSH服务未在服务器上启动。

• 使用了错误的IP地址或用户名。

• 解决方案：

• 检查服务器的SSH端口是否开放，可以使用以下命令测试：

telnet 192.168.0.1 22

• 确保服务器上运行了SSH服务：

sudo systemctl status ssh

• 确认SSH账号信息是否正确，确保公钥和私钥对匹配。

2. 密钥认证失败

• 可能原因：密钥权限不正确，或公钥未正确添加到远程服务器的**~/.ssh/authorized_keys**文件中。

• 解决方案：

• 确保私钥文件的权限为600：

chmod 600 ~/.ssh/id_rsa

• 确保公钥正确地添加到了远程服务器的**~/.ssh/authorized_keys**中，并且权限设置为600。

3. 远程文件过大导致操作缓慢

• 可能原因：如果你在编辑非常大的文件，或者远程服务器网络带宽较低，操作可能会变慢。

• 解决方案：在VSCode中，可以设置文件大小警告阈值，并使用压缩文件传输等方式优化性能。还可以使用rsync等工具手动同步大文件。

四、提高远程开发效率的技巧

1. 使用VSCode终端：在连接远程服务器后，你可以直接使用VSCode的集成终端运行服务器上的命令，避免频繁切换窗口。
2. 远程调试：VSCode支持通过Remote-SSH进行远程调试，你可以直接在远程服务器上调试应用程序，尤其是Node.js、Python、Java等语言的开发。
3. Git版本控制：你可以直接在VSCode中使用Git进行版本控制，所有操作都会在远程服务器上执行，这使得你可以在远程环境中直接提交代码。
4. 同步设置：VSCode提供了设置同步功能，可以在本地和远程服务器之间保持一致的开发配置，从而提高工作效率。

通过以上详细的配置和使用步骤，你可以顺利地通过VSCode的Remote-SSH插件连接到远程服务器，并在本地进行高效的远程开发。希望这篇教程能帮助你解决在实际开发中遇到的各种问题，提升工作效率。