VSCode中Remote-SSH远程连接Linux

最新推荐文章于 2024-09-26 10:40:48 发布

沐风_ZTL

最新推荐文章于 2024-09-26 10:40:48 发布

阅读量2.2k

点赞数 1

本文链接：https://blog.csdn.net/taylor_0522/article/details/118733368

版权

本文详细介绍了如何在VSCode中安装和配置Remote-SSH插件，以便连接到Linux服务器进行远程开发。步骤包括安装Remote-SSH插件、配置SSH设置、在Linux服务器上安装和配置OpenSSH-Server，以及使用密码或密钥进行身份验证。此外，还解决了可能出现的连接问题，如权限错误和管道错误，并提供了相应的解决方案。

摘要由CSDN通过智能技术生成

安装Remote-SSH并配置

首先打开你的VSCode，找到Extensions，搜索Remote，下载Remote-Developoment插件，会自动安装其他的Remote插件，其中会包含Remote-SSH：

Remote-SSH

进入设置，搜索ssh，找到并选中拓展中的Remote-SSH中的ShowLoginTerminal选项，因为在连接的时候，终端会让你输入yes或者密码等

插件设置

接着，需要配置你的Linux服务器地址信息，按CTRL+SHIFT+P,搜索ssh，找到Open Configuration File选项

搜索ssh

接着输入自己的地址信息：

地址信息

Linux安装OpenSSH-Server和配置

Ubuntu

bash

//安装openssh-server组件
sudo apt-get install openssh-server

//重启ssh服务
sudo service ssh --full-restart

//设置ssh字启动
sudo systemctl enable ssh

CentOS

bash

//安装
yum install -y openssl openssh-server

//重启sshd服务
systemctl restart sshd.service

//自动启动
systemctl enable sshd

编辑配置文件

备份配置文件

bash

sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.backup

编辑配置文件

bash

sudo vim /etc/ssh/sshd_config

配置文件中添加如下配置：
端口可以自定义

配置信息

使用密码登录

配置信息

保存后，重启sshd服务器，重启命令上面已给出。

使用密码连接SSH

找到你配置的Linux服务器：

连接服务器

输入密码，再回车：

输入密码【注意：最新配置 vscode 1.58.2 时，发现输入密码改在集成终端命令行了】

然后打开文件夹即可开始编写代码：

打开文件夹

使用CTRL + SHIFT + ~可以调出终端，就可以在终端操作命令，打开文件就可以写代码了。

使用密钥免密码登录

客户端配置
确保本地Windows操作系统已经安装了ssh
生成SSH秘钥对：

windows进入cmd命令行

ssh-keygen -t rsa -b 4096

(-b 4096表示生成的rsa秘钥对的长度是4096个bit) 在输入该指令后,会让我们指定秘钥文件的生成目录，可以直接回车跳过，生成的目录在c:\user\WINDSUN\.ssh这个目录下生成：id-rsa和id-rsa.pub两个文件, 第一个是私钥文件,第二个是公钥文件，用户名称是你自己的电脑用户名

服务器端配置

检测ssh服务是否启动

netstat -ntlp | grep ssh

将客户端生成的公钥文件id-rsa.pub拷贝到服务端用户根目录的.ssh文件夹下，进入.ssh中将公钥的内容拷贝到authorized_keys文件中【若无 .ssh 使用mkdir .ssh 创建】

cp id_rsa.pub authorized_keys

然后设置相应文件的权限

chmod 700 .ssh
chmod 600 .ssh/authorized_keys

客户端VS的Remote-SSH插件配置
设置vscode的Remote - SSH插件配置文件：

【注意：IdentityFile C:\Users\WINDSUN\.ssh\id_rsa 为客户端windows中生成的公私钥路径】

Host Aliyun
    HostName X.X.X.X
    User XXX
    IdentityFile  C:\Users\WINDSUN\.ssh\id_rsa

遇到的问题

如果报管道错误，可能是以下问题

你的Linux服务器的ssh配置有问题，通过修改配置测试是否解决问题。
删除在服务器上创建的“ .vscode-server”目录。这是在主目录中创建的隐藏目录（您可以使用“ ls -la”显示我相信的所有文件）。可能是一些不正确的数据被缓存在那里，因此删除目录将使您的情况更加整洁。删除后，可以尝试通过vscode上的remote-ssh重新连接。
如果还是不行，可以尝试重新使用ftp将本地公钥上传到Linux上，然后将其复制到authorized_keys文件中，设置权限，重启SSH服务器，重新连接
如果服务器没有.vscode-server文件夹，但是还是连不上，就是你SSH的问题了。

如果是Bad owner or permissions 即对某个文件没有访问权限，原因是 Windows 10 version 1803 自带了openssh客户端，自带的客户端存在这个问题vscode的官方文档给出了相应的解决方式，参考 Local SSH file and folder permissions，如果还是不行，直接安装Git，Git自带openssh-client，可以将ssh-client 指向为git软件中的ssh程序。
1. 打开Git Bash查看ssh可执行文件的安装路径：where ssh.exe
  
  bash
```
$ where ssh.exe
C:\Program Files\Git\usr\bin\ssh.exe
C:\Windows\System32\OpenSSH\ssh.exe
```
  第二个路径即为windows自带的ssh-client。
2. 将windows自带的ssh-client其卸载掉，参考 mircosoft官方的介绍卸载 OpenSSH-Client
  
  bash
```
# Uninstall the OpenSSH Client
Remove-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
```
3. 然后将git软件携带相应的ssh-client可执行文件路径设置到系统的环境变量中。找到系统变量的Path，删除原来的OpenSSH，加入C:\Program Files\Git\usr\bin\ssh.exe即可。

注意事项

在使用公钥第一次连接到Linux时候，可能会让你输入密码，连接完成后，会在你的用户.ssh目录中中生成一个文件known_hosts，这个目录中还有公钥和私钥id-rsa.pub和id-rsa，然后将公钥上传到服务器上，重新重复上面的复制到.ssh/authorized_keys，并且重新设置权限，再重新尝试连接到Linux，就不需要再输入密码了

参考链接：https://www.cnblogs.com/WindSun/p/12142621.html