vscode 远程 linux(包括离线vscode-server安装，免密登录方法)
vscode 远程 linux(包括离线vscode-server安装,免密登录方法)
本教程前提是安装并配置好 ssh 服务,并且远程主机和本地主机在同一个局域网内.
1. vscode 安装安装远程所需扩展及配置
1.1 安装扩展
在vscode 扩展中搜索Remote - SSH,下载安装
1.2 通过 ssh 远程连接
1.2.1 通过 ssh 连接命令连接
在vscode 中依次点击 远程资源管理器->新建远程,在打开的连接命令窗口中输入命令
ssh <user>@<hostname>:[port]
- user: 是在远程服务器上的用户名
- hostname: 远程服务器的主机名或 IP 地址
- port: SSH 连接的端口号(默认为 22)
输入后按Enter键选择要更新的配置文件,一般选择第一个也就是C:Users${你的用户名}.sshconfig
1.2.2 通过更新 ssh 配置文件连接
在vscode 中依次点击远程资源管理器->打开SSH配置文件选择要更新的 SSH 配置文件,一般选择第一个也就是C:Users${user}.sshconfig,打开后编辑配置并保存:
Host xxx
HostName xxx.xxx.xxx.xxx
Port xx
User xxx
IdentityFile "xxx"
- Host:这是一个主机别名,你可以使用这个别名来代替实际的主机名进行连接.
- HostName:这是指定远程主机的 IP 地址或主机名.
- Port:这是指定 SSH 连接的端口号.
- User:这是指定用于连接远程主机的用户名.
- IdentityFile:这是指定用于身份验证的私钥文件的路径.(免密登录才需要,请看3. 免密登录)
如果要配置多个远程,继续在此文件追加配置即可
1.2.1 或 1.2.2 完成后点击远程资源管理器的刷新,此时远程资源管理器会出现刚配置的远程连接,根据需要选择在当前窗口连接或在新窗口中连接,此时会让你输入密码,然后会在远程端下载所需文件(需要联网),如果无法联网,请看2. 离线下载 vscode-server 并安装
2. 离线下载vscode-server并安装
如果远程端不能联网可以下载包离线安装,下载 vscode-server 的 url 需要和 vscode 客户端版本的 commit-id 对应.通过 vscode 面板的帮助->关于可以获取该信息,复制信息,我当前版本如下(提交后面对应的就是 commit_id):
版本: 1.89.1 (system setup)
提交: dc96b837cf6bb4af9cd736aa3af08cf8279f7685
日期: 2024-05-07T05:13:33.891Z
Electron: 28.2.8
ElectronBuildId: 27744544
Chromium: 120.0.6099.291
Node.js: 18.18.2
V8: 12.0.267.19-electron.0
OS: Windows_NT x64 10.0.19044
2.1 旧版离线包下载
vscode-server 下载地址如下,其中 commit_id 是上面复制的提交 id:
x86:
https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable
arm:
https://update.code.visualstudio.com/commit:${commit_id}/server-linux-arm64/stable
将下载的文件 vscode-server-linux-x64.tar.gz 解压解包后名为 vscode-server-linux-x64 文件夹改名为 ${commit_id} 放在 /home/${user}/.vscode-server/bin/ 目录下.
2.2 新版离线包下载
在某次更新后远程端的 .vscode-server 目录结构发生变化:
📦.vscode-server
┣━ 📁bin # 存放旧方法下的vscode commit相关文件
┃ ┗━ 📁${commit_id1}
┃ ┗━ 📁${commit_id2}
┃ ┗━ ···
┣━ 📁cli # 存放新方法下的vscode commit相关文件
┃ ┗━ 📁servers
┃ ┃ ┗━ 📁Stable-${commit_id}
┃ ┃ ┃ ┗━ 📁server
┃ ┃ ┃ ┗━ ···
┃ ┃ ┗━ ···
┃ ┗━ 📜iru.json # 存放最近的vscode commit_id
┣━ 📜code-${commit_id} # 存放vscode_cli_alpine_x64_cli.tar.gz解压后名为code的文件,并将其改名为code-${commit_id}
┣━ 📁data
┗━ 📁extensions
现在需要安装两个文件,两个文件的下载地址如下:
x86:
https://vscode.download.prss.microsoft.com/dbazure/download/stable/${commit_id}/vscode-server-linux-x64.tar.gz
https://vscode.download.prss.microsoft.com/dbazure/download/stable/${commit_id}/vscode_cli_alpine_x64_cli.tar.gz
arm:
https://vscode.download.prss.microsoft.com/dbazure/download/stable/${commit_id}/vscode-server-linux-arm64.tar.gz
https://vscode.download.prss.microsoft.com/dbazure/download/stable/${commit_id}/vscode_cli_alpine_arm64_cli.tar.gz
第一个文件 vscode-server-linux-x64.tar.gz 解压解包后名为 vscode-server-linux-x64 文件夹改名为 server 放在 /home/${user}/.vscode-server/cli/servers/Stable-${commit_id}/ 目录下.
第二个文件 vscode_cli_alpine_x64_cli.tar.gz 解压解包后名为 code 的文件改名为 code-${commit_id}放在/home/${user}/.vscode-server/目录下
2.3 无法连接可能问题
- 权限问题
如果仍然连接不上,则可能需要修改.vscode-server文件夹及其子目录的权限,例如权限改为700,再尝试连接:
chmod -R 700 /home/${user}/.vscode-server/
- ssh 设置问题
打开远程主机的 sshd_config 文件,一般在/etc/ssh/sshd_config文件,找到AllowTcpForwarding no这一行,将 no 改为 yes,然后保存退出.
然后重启 ssh 服务:
sudo systemctl restart sshd
- known_hosts 文件问题
如果仍然连接不上,则可能是由于 known_hosts 文件问题导致的,如果你使用了相同的 ip 地址连接过不同主机就会出现此问题,可以尝试删除 known_hosts 文件,然后再尝试连接,本地主机下执行以下命令:
# powershell
rm $env:USERPROFILE.sshknown_hosts
# cmd
del %USERPROFILE%.sshknown_hosts
3. 免密登录
3.1 生成 SSH 密钥
生成 ssh 使用的公钥/密钥对,请从客户端上的 PowerShell 或 cmd 提示符运行以下命令,具体使用方法详细见:微软官方
ssh-keygen -t rsa
输入命令执行完成后会生成C:Users${user}.ssh,里面会有 id_rsa(私钥),
id_rsa.pub(公钥)两个文件,这两个是默认名称,在执行命令时可以添加选项选择不同文件名,如果更改文件名,后面步骤对应文件路径也要更改
3.2 添加公钥到远程服务器
id_rsa.pub(公钥)生成后,打开复制内容,打开远程主机/home/${user}/.ssh/authorized_keys文件,如果文件不存在就创建,然后粘贴复制的公钥内容,然后打开1.2.2 通过更新 ssh 配置文件连接中的C:Users${user}.sshconfig配置文件,在你要连接的Host下配置IdentityFile,后面填写id_rsa(私钥)路径,并保存:
Host xxx
HostName xxx.xxx.xxx.xxx
Port xx
User xxx
IdentityFile "C:Users${user}.sshid_rsa"
如果手动创建 /home/${user}/.ssh/authorized_keys,需要更改其权限:
chmod 700 /home/${user}/.ssh
chmod 600 /home/${user}/.ssh/authorized_keys
3.3 设置允许通过密钥登录
打开远程主机的 sshd_config 文件,一般在/etc/ssh/sshd_config文件,找到PubkeyAuthentication no这一行,将 no 改为 yes,然后保存退出.
然后重启 ssh 服务:
sudo systemctl restart sshd
3.4 验证方式
3.3 完成后点击vscode中远程资源管理器的刷新,此时远程资源管理器会出现刚配置的远程连接,根据需要选择在当前窗口连接或在新窗口中连接,点击后确认左下角进入到连接成功的状态,期间没有提示输入密码的窗口,即代表成功了
