VSCode 远程连接 Linux 配置：离线安装与免密登录

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.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 无法连接可能问题

1. 权限问题

如果仍然连接不上，则可能需要修改 .vscode-server 文件夹及其子目录的权限，例如权限改为 700，再尝试连接:

chmod -R 700 /home/${user}/.vscode-server/

2. ssh 设置问题

打开远程主机的 sshd_config 文件，一般在 /etc/ssh/sshd_config 文件，找到 AllowTcpForwarding no 这一行，将 no 改为 yes，然后保存退出.

然后重启 ssh 服务:

sudo systemctl restart sshd

3. known_hosts 文件问题

如果仍然连接不上，则可能是由于 known_hosts 文件问题导致的，如果你使用了相同的 ip 地址连接过不同主机就会出现此问题，可以尝试删除 known_hosts 文件，然后再尝试连接，本地主机下执行以下命令:

# powershell
rm $env:USERPROFILE\.ssh\known_hosts
# cmd
del %USERPROFILE%\.ssh\known_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}\.ssh\config 配置文件，在你要连接的 Host 下配置 IdentityFile，后面填写 id_rsa(私钥) 路径，并保存:

Host xxx HostName xxx.xxx.xxx.xxx Port xx User xxx IdentityFile "C:\Users\${user}\.ssh\id_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 中 远程资源管理器的 刷新，此时 远程资源管理器 会出现刚配置的远程连接，根据需要选择 在当前窗口连接 或 在新窗口中连接，点击后确认左下角进入到连接成功的状态，期间没有提示输入密码的窗口，即代表成功了