Windows开发环境救星：5分钟为你的本机搭建SSH Server，实现VS Code远程连接调试
Windows开发环境救星：5分钟为你的本机搭建SSH Server，实现VS Code远程连接调试
作为一名经常需要在多台设备间切换的开发者，你是否遇到过这样的困扰：办公室的Windows台式机上有一个复杂的开发环境配置，但回到家想继续工作时，却发现笔记本上的环境完全不同？或者当你在会议室用MacBook做演示时，突然需要调试台式机上的某个项目？这种场景下，远程访问本地开发环境的能力就显得尤为重要。
传统解决方案如远程桌面往往笨重且延迟高，而基于SSH的远程开发则提供了更轻量级的选择。本文将带你快速在Windows上搭建SSH Server，并通过VS Code的Remote-SSH插件实现无缝的远程开发体验。整个过程只需5分钟，却能显著提升你的开发效率。
1. 准备工作与环境检查
在开始安装之前，我们需要确保系统满足基本要求。Windows 10 1809及以上版本或Windows 11都内置了OpenSSH Server组件，这大大简化了我们的安装流程。
首先，让我们检查系统版本：
winver如果系统版本较旧，建议先进行Windows更新。接下来，检查是否已安装OpenSSH组件：
Get-WindowsCapability -Online | Where-Name -like 'OpenSSH*'这个命令会列出OpenSSH客户端和服务器的安装状态。理想情况下，我们应该看到两个组件都处于"NotPresent"状态，表示可以全新安装。
注意：所有PowerShell命令都需要以管理员身份运行。右键点击PowerShell图标，选择"以管理员身份运行"。
2. 安装与基础配置
2.1 安装OpenSSH Server
安装过程非常简单，只需两条命令：
# 安装OpenSSH客户端（通常已预装） Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0 # 安装OpenSSH服务器 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0安装完成后，我们需要启动SSH服务并设置为自动启动：
Start-Service sshd Set-Service -Name sshd -StartupType 'Automatic'2.2 防火墙配置
Windows Defender防火墙可能会阻止SSH连接，我们需要添加一条允许规则：
New-NetFirewallRule -Name sshd -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22验证服务是否正常运行：
Test-NetConnection -ComputerName 127.0.0.1 -Port 22如果看到"TcpTestSucceeded : True"的输出，说明SSH服务器已成功启动。
3. 安全配置与密钥管理
3.1 生成SSH密钥对
密码认证虽然简单，但不够安全且每次连接都需要输入密码。更推荐使用SSH密钥认证方式。首先生成密钥对：
ssh-keygen -t ed25519执行后会询问保存位置（直接回车使用默认位置）和密码（可为空）。生成的密钥对默认保存在：
C:\Users\你的用户名\.ssh\包含两个文件：
- id_ed25519（私钥，相当于密码，必须妥善保管）
- id_ed25519.pub（公钥，将放置到服务器上）
3.2 配置公钥认证
将公钥添加到服务器的授权密钥列表中：
# 确保.ssh目录存在 mkdir C:\Users\你的用户名\.ssh # 将公钥添加到授权列表 cat C:\Users\你的用户名\.ssh\id_ed25519.pub | Out-File -Append -Encoding ascii C:\Users\你的用户名\.ssh\authorized_keys # 设置正确的权限 icacls C:\Users\你的用户名\.ssh\authorized_keys /inheritance:r /grant "你的用户名:F"3.3 使用ssh-agent管理密钥
为了避免每次使用密钥时都需要输入密码（如果你设置了密钥密码），可以使用ssh-agent：
# 设置ssh-agent为手动启动（默认已禁用） Get-Service ssh-agent | Set-Service -StartupType Manual # 启动服务 Start-Service ssh-agent # 将密钥添加到agent ssh-add C:\Users\你的用户名\.ssh\id_ed255194. VS Code远程连接配置
4.1 安装Remote-SSH扩展
在VS Code中，安装"Remote - SSH"扩展。安装完成后，左侧活动栏会出现远程资源管理器图标。
4.2 配置SSH连接
点击左下角的绿色"打开远程窗口"按钮，选择"Connect to Host..." > "Add New SSH Host"，输入连接信息：
ssh 你的用户名@你的windows主机IP -i C:\Users\你的用户名\.ssh\id_ed25519VS Code会自动将此配置保存到C:\Users\你的用户名\.ssh\config文件中。之后可以直接从远程资源管理器中选择已保存的连接。
4.3 连接与调试
首次连接时，VS Code会在远程主机上安装必要的服务器组件。完成后，你就可以像在本地一样使用VS Code的所有功能，包括：
- 完整的IntelliSense代码补全
- 集成终端
- 调试功能
- 扩展支持（部分扩展需要在远程主机上安装）
5. 高级配置与优化
5.1 修改SSH端口
为了安全考虑，可以修改默认的22端口：
# 停止SSH服务 Stop-Service sshd # 修改配置文件 notepad C:\ProgramData\ssh\sshd_config找到#Port 22行，删除注释并修改端口号，然后保存。同时更新防火墙规则：
Set-NetFirewallRule -Name sshd -LocalPort 新端口号 Start-Service sshd5.2 性能优化
对于跨网络连接，可以启用压缩来提升响应速度。在本地SSH配置（~/.ssh/config）中添加：
Host 你的windows主机 HostName 主机IP User 用户名 Compression yes CompressionLevel 65.3 多用户配置
如果需要允许多个用户访问，为每个用户重复3.2节的公钥配置步骤，并确保sshd_config中启用了公钥认证：
PubkeyAuthentication yes AuthorizedKeysFile .ssh/authorized_keys6. 常见问题排查
连接被拒绝
- 检查SSH服务是否运行：
Get-Service sshd - 验证端口是否开放：
Test-NetConnection -ComputerName 127.0.0.1 -Port 22
认证失败
- 确认公钥已正确添加到authorized_keys
- 检查文件权限：
.ssh目录应为700，authorized_keys应为600
VS Code远程连接卡顿
- 尝试启用压缩（见5.2节）
- 检查网络延迟，考虑使用有线连接替代WiFi
防火墙阻止连接
- 确认防火墙规则存在：
Get-NetFirewallRule -Name sshd - 检查规则是否启用：
Get-NetFirewallRule -Name sshd | Select-Object Enabled
这套方案在我的多设备工作流中表现出色，特别是在需要快速切换工作环境时。相比传统的远程桌面方案，SSH+VS Code的组合更加轻量级，对网络带宽要求更低，且保留了完整的开发体验。