VSCode Remote-SSH 1.90 免密登录：Windows/Linux 双平台 3 步配置与 2 大权限错误修复

远程开发已经成为现代工程师的标配技能，而VSCode的Remote-SSH插件无疑是这一领域的佼佼者。最新发布的1.90版本在稳定性和功能上都有了显著提升，但跨平台配置中的权限问题依然是困扰开发者的常见痛点。本文将带你从零开始，用最简单的方式实现Windows与Linux间的无缝连接，并彻底解决那些令人头疼的权限错误。

1. 环境准备与基础配置

在开始之前，确保你已经具备以下条件：

• 本地Windows机器（Win10及以上版本）
• 远程Linux服务器（Ubuntu/CentOS等主流发行版）
• VSCode 1.90+版本

安装Remote-SSH插件 ：

1. 打开VSCode扩展市场（Ctrl+Shift+X）
2. 搜索"Remote - SSH"
3. 点击安装微软官方发布的插件

提示：建议同时安装"Remote - SSH: Editing Configuration Files"插件，它能提供SSH配置文件的语法高亮和自动补全功能。

验证SSH基础连接：

ssh username@your_server_ip

如果提示密码登录，说明基础SSH服务正常。此时可以按Ctrl+C退出，我们将进入免密配置阶段。

2. 三步骤实现跨平台免密登录

2.1 密钥生成与Windows端配置

在Windows端生成密钥对：

ssh-keygen -t rsa -b 4096 -C "vscode_remote"

执行后会询问保存路径，直接回车使用默认位置（ C:\Users\你的用户名\.ssh\id_rsa ）。连续三次回车跳过密码设置。

检查生成的文件：

├── id_rsa      # 私钥（必须严格保护）
└── id_rsa.pub  # 公钥（将上传到服务器）

2.2 Linux服务器端配置

将公钥部署到Linux服务器有两种推荐方式：

方法一：使用ssh-copy-id（最简单）

ssh-copy-id -i ~/.ssh/id_rsa.pub username@your_server_ip

方法二：手动配置（适合无ssh-copy-id环境）

1. 登录服务器创建.ssh目录（如果不存在）：

   mkdir -p ~/.ssh && chmod 700 ~/.ssh
   

2. 将公钥内容追加到authorized_keys：

   cat >> ~/.ssh/authorized_keys < ~/.ssh/id_rsa.pub
   

3. 设置严格的文件权限：

   chmod 600 ~/.ssh/authorized_keys
   

2.3 VSCode最终配置

编辑SSH配置文件（ C:\Users\你的用户名\.ssh\config ）：

Host my_remote_server
  HostName your_server_ip
  User your_username
  IdentityFile "C:\Users\你的用户名\.ssh\id_rsa"
  IdentitiesOnly yes

关键参数说明：

• Host ：自定义连接名称（显示在VSCode中）
• IdentityFile ：必须用双引号包裹Windows路径
• IdentitiesOnly ：强制使用指定密钥

3. 两大权限错误深度修复

3.1 Windows端私钥权限问题

错误表现：

Permissions for 'id_rsa' are too open.
It is required that your private key files are NOT accessible by others.

解决方案（管理员权限运行）：

icacls "$env:USERPROFILE\.ssh\id_rsa" /reset
icacls "$env:USERPROFILE\.ssh\id_rsa" /inheritance:r
icacls "$env:USERPROFILE\.ssh\id_rsa" /grant:r "%USERNAME%:(R)"

权限验证命令：

icacls "$env:USERPROFILE\.ssh\id_rsa"

正确输出应只显示你的用户名有 (R) 权限。

3.2 Linux端文件权限问题

错误表现：

Permissions 0777 for '/home/user/.ssh/authorized_keys' are too open.

修复命令：

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R $USER:$USER ~/.ssh

权限检查清单：

drwx------  .ssh
-rw-------  authorized_keys

4. 高级配置与优化技巧

4.1 多服务器管理方案

对于需要连接多个服务器的开发者，推荐以下config文件结构：

# 开发环境
Host dev-server
  HostName 192.168.1.100
  User dev
  IdentityFile "~/.ssh/dev_key"

# 生产环境  
Host prod-server
  HostName 10.0.0.100
  User deploy
  IdentityFile "~/.ssh/prod_key"
  Port 2222

4.2 连接稳定性优化

在config中添加以下参数可提升连接质量：

ServerAliveInterval 60
TCPKeepAlive yes
Compression yes

4.3 安全增强措施

1. 禁用密码登录（服务器端）：

   sudo sed -i 's/#PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config
   sudo systemctl restart sshd
   

2. 使用ed25519算法生成更安全的密钥：

   ssh-keygen -t ed25519 -a 100
   

5. 常见问题速查表

问题现象	可能原因	解决方案
连接超时	防火墙阻挡	检查服务器安全组规则
提示"Too many authentication failures"	密钥尝试次数过多	在config添加 IdentitiesOnly yes
文件同步失败	用户权限不一致	检查服务器文件所有者与登录用户是否匹配
中文乱码	终端编码问题	在VSCode设置中配置 "terminal.integrated.defaultProfile.linux": "bash"

对于持续存在的问题，可以启用SSH调试模式：

ssh -vvv user@host

最后分享一个实用技巧：在VSCode远程窗口中按下Ctrl+Shift+P，输入"Remote-SSH: Show Log"可以查看详细的连接日志，这对排查复杂问题非常有帮助。