1. 项目概述为什么要在Win11上折腾OpenSSH Server最近在几个项目现场经常遇到需要从一台Windows 11的机器上安全地访问另一台Windows 11设备的情况。传统的远程桌面RDP虽然直观但在某些场景下显得笨重且不够“极客”——比如只想快速执行一条命令、传输几个文件或者是在网络条件不佳时建立一个稳定的隧道。这时候SSHSecure Shell协议的优势就凸显出来了加密、轻量、跨平台几乎是运维和开发人员的标配工具。过去在Windows上搭建SSH服务大家可能会想到第三方软件比如Putty的配套服务端、Bitvise SSH Server或者更重型的Cygwin环境。但很多人不知道的是微软从Windows 10 1809版本开始就已经将OpenSSH客户端和服务器端作为了可选的系统功能集成进来。到了Windows 11这个功能更加成熟和稳定。这意味着我们完全可以不依赖任何第三方软件仅凭系统自带功能就搭建一个原生、轻量且与Windows系统深度集成的SSH服务器。我之所以选择原生的OpenSSH for Windows主要是看中它的几个核心优势。首先是“零依赖”无需安装额外软件减少系统复杂度与潜在冲突。其次是“官方维护”由微软和OpenSSH官方团队共同维护安全更新有保障兼容性也最好。再者是“与Windows生态无缝集成”它使用Windows自带的用户账户和权限体系进行认证管理起来非常方便。对于需要频繁在Windows与Linux混合环境中穿梭或者希望统一运维工具链的朋友来说这绝对是一个值得投入时间配置的功能。2. 核心需求与方案选型解析2.1 明确你的使用场景在动手之前先想清楚你为什么要装这个SSH Server。不同的场景配置的侧重点完全不同。我总结了几种典型需求远程命令行管理这是最基础的需求。你可以在任何支持SSH的终端如macOS/Linux的终端、Windows Terminal、PuTTY、MobaXterm上连接到你的Win11机器执行PowerShell或CMD命令。这对于管理没有图形界面的服务器版Windows或者在后台静默运行脚本特别有用。安全的文件传输通过SCP或SFTP协议传输文件。相比于开放的SMB共享SFTP提供了加密通道在公网或不可信网络环境中更安全。很多现代IDE如VS Code和文件管理器如WinSCP都直接支持SFTP。端口转发与隧道这是SSH的高级用法但非常强大。你可以通过SSH建立加密隧道实现“内网穿透”、安全访问内部Web服务如本地开发的localhost:3000或者加密其他不安全的协议流量。远程开发环境结合VS Code的Remote - SSH插件你可以将Win11机器作为远程开发主机在本地用VS Code的界面直接编辑、运行、调试远程机器上的代码获得近乎本地的开发体验。对于绝大多数个人用户和小型团队原生OpenSSH Server已经足够满足上述所有需求。除非你有极其特殊的认证方式如LDAP深度集成、双因素硬件令牌或性能要求否则没有必要引入第三方SSH服务器增加复杂度。2.2 原生方案 vs. 第三方方案为什么强烈推荐Windows自带的OpenSSH而不是像Bitvise SSH Server这样的第三方软件我们来做个简单对比特性Windows 原生 OpenSSH ServerBitvise SSH Server (举例)安装与部署系统功能一键启用无额外安装包。需要下载、安装独立的EXE/MSI包。维护与更新通过Windows Update推送安全更新与系统同步。需手动关注官网下载新版本覆盖安装。系统集成度深度集成使用Windows用户账户管理日志写入Windows事件查看器。通常自带一套用户管理界面与系统账户可能分离日志体系独立。资源占用轻量作为Windows服务运行按需启动会话。通常也是轻量的但作为独立应用服务运行。功能与协议支持标准SSH2协议SFTP子系统基于官方OpenSSH代码。功能可能更丰富如图形化配置界面、更细粒度的访问控制、Tunnelier集成等。成本完全免费。个人/教育免费商业用途可能需要授权。学习成本配置主要靠PowerShell和配置文件对习惯命令行的用户友好。提供图形化配置界面对新手更友好。核心结论如果你追求的是最小化部署、系统原生集成、由微软负责安全更新并且习惯使用命令行和文本编辑器进行配置那么Windows自带的OpenSSH Server是你的不二之选。它的“傻瓜式”安装背后是足够专业和可靠的内核。3. 详细安装与启用步骤好了理论说完我们开始动手。整个过程可以分为“安装功能”、“初始配置”和“连接测试”三大步。3.1 通过设置界面安装推荐给所有用户这是最直观、最不容易出错的方法尤其适合对PowerShell不熟悉的用户。打开设置按下Win I快捷键快速打开Windows设置。进入应用管理点击左侧的“应用”然后在右侧找到并点击“可选功能”。添加功能在“可选功能”页面顶部点击“查看功能”按钮旁边的“添加功能”按钮。搜索并选择在弹出的功能列表窗口中在搜索框输入“ssh”。你会看到两个相关结果OpenSSH 客户端用于从本机连接到其他SSH服务器。通常默认已安装。OpenSSH 服务器这就是我们要安装的服务端。安装勾选“OpenSSH 服务器”然后点击右下角的“安装”按钮。系统会自动下载并安装所需文件你只需要等待进度条完成即可。注意安装过程可能需要几分钟并且不会有显著的系统提示或弹窗。安装完成后你可以在“可选功能”列表中找到“OpenSSH 服务器”状态显示为“已安装”。3.2 通过PowerShell安装给喜欢效率的极客如果你像我一样更喜欢用命令行搞定一切那么PowerShell是更高效的选择。以管理员身份打开Windows Terminal或PowerShell。检查是否已安装Get-WindowsCapability -Online | Where-Object Name -like OpenSSH.Server*如果返回结果中State显示为Installed则表示已安装。如果显示为NotPresent则需要安装。执行安装命令# 这行命令会从Windows更新源获取并安装OpenSSH服务器组件 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0执行后等待命令行返回成功的提示。这个过程同样是在后台静默完成的。为什么推荐PowerShell方式除了快更重要的是可脚本化。如果你需要为多台机器批量部署SSH服务把这条命令写进脚本里效率提升不是一点半点。3.3 安装后的关键操作启动服务并设置自启安装完成只是把“软件包”放到了系统里要让SSH服务真正运行起来还需要启动它并设置为开机自动启动。启动SSH服务在刚才的管理员PowerShell中运行Start-Service sshd这条命令会立即启动名为sshd的Windows服务。设置开机自动启动我们不希望每次重启电脑后都手动来启动服务。Set-Service -Name sshd -StartupType Automatic这条命令将服务的启动类型设置为“自动”。验证服务状态可选但建议Get-Service sshd查看输出确保Status是RunningStartType是Automatic。实操心得很多教程到这一步就结束了但这里有一个巨坑。Windows防火墙默认会阻止外部对SSH端口22的访问。如果你安装后直接从外网连接很可能会遇到“Connection refused”或超时。所以我们紧接着必须配置防火墙。4. 防火墙配置与基础安全加固安全无小事尤其是在开放一个远程访问端口的时候。4.1 配置Windows防火墙入站规则我们需要在防火墙中为SSH服务打开一个“洞”允许TCP 22端口的入站连接。使用PowerShell一键配置最推荐New-NetFirewallRule -Name OpenSSH-Server-In-TCP -DisplayName OpenSSH Server (sshd) -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22这条命令做了以下几件事-Name: 给规则起个内部名字。-DisplayName: 在防火墙高级设置界面里显示的名字。-Enabled True: 规则立即生效。-Direction Inbound: 这是一条入站规则。-Protocol TCP -Action Allow -LocalPort 22: 允许TCP协议访问本地的22端口。通过图形界面配置备用 如果你对命令不放心可以手动操作打开“控制面板” - “系统和安全” - “Windows Defender 防火墙” - “高级设置”。在左侧选择“入站规则”右侧点击“新建规则...”。规则类型选择“端口”下一步。选择“TCP”特定本地端口输入“22”下一步。选择“允许连接”下一步。配置文件全选域、专用、公用下一步。给规则起个名字比如“OpenSSH Server Port 22”完成。4.2 基础安全加固建议在公网或公司内网开放SSH仅打开端口是不够的必须做一些基础加固。修改默认端口强烈建议22端口是全世界黑客扫描的“重灾区”。修改为一个高位端口如 2222, 3522等能立刻过滤掉99%的自动化扫描攻击。方法修改配置文件C:\ProgramData\ssh\sshd_config。找到#Port 22这一行去掉开头的#注释符并将22改为你想要的端口例如Port 2222。保存后务必重启SSH服务(Restart-Service sshd) 并在防火墙规则中同步修改端口号。禁用密码登录启用密钥登录至关重要密码可能被暴力破解或嗅探而密钥认证公钥加密私钥解密在数学上几乎不可破解。这是提升SSH安全性的单点最有效措施。方法同样在sshd_config文件中找到以下两行并进行修改#PubkeyAuthentication yes # 确保这行没有被注释且值为yes PasswordAuthentication no # 将这行的值改为 no禁用密码登录 #PermitRootLogin prohibit-password # 对于Windowsroot对应的是管理员账户建议保持注释或设为no禁用密码前你必须先将你的公钥部署到服务器的对应用户目录下C:\Users\你的用户名\.ssh\authorized_keys文件内。限制可登录的用户在sshd_config末尾可以添加AllowUsers your_username来指定只允许某个用户通过SSH登录。多个用户用空格隔开。重要提醒每次修改sshd_config后必须执行Restart-Service sshd使配置生效。修改前最好备份原文件。5. 密钥认证配置全流程上面提到了密钥登录这里详细展开。这是实现“免密”、“高安全”登录的关键。5.1 在客户端生成密钥对以Windows 11为例你的个人电脑就是“客户端”。我们使用Windows 11自带的OpenSSH客户端来生成密钥。在客户端电脑上打开Windows Terminal或PowerShell无需管理员权限。运行以下命令生成ED25519密钥目前更安全、更快的算法ssh-keygen -t ed25519 -C your_emailexample.com-t ed25519: 指定密钥类型。-C: 添加一个注释通常用你的邮箱方便标识密钥所有者。命令执行后会询问你密钥的保存路径直接按回车使用默认路径C:\Users\客户端用户名\.ssh\id_ed25519。接着会询问你是否为密钥设置一个“通行短语”passphrase。强烈建议设置一个这相当于为你的私钥再加一把锁即使私钥文件被盗没有通行短语也无法使用。输入一个你能记住的强密码即可。生成成功后你会在~\.ssh\目录下看到两个文件id_ed25519:私钥相当于你的家门钥匙必须绝对保密绝不能发给任何人或服务器。id_ed25519.pub:公钥相当于一把公开的锁可以放心地放到任何你想访问的服务器上。5.2 将公钥部署到SSH服务器Win11现在需要把客户端生成的公钥“锁”安装到服务器的“门”上。方法一使用ssh-copy-id命令最方便但Windows客户端默认不带如果你的客户端是Linux/macOS或者已在Windows上安装了Git Bash等包含此工具的环境可以直接运行ssh-copy-id -p 22 -i ~/.ssh/id_ed25519.pub usernameyour_win11_ip它会自动帮你完成后续所有步骤。但纯Windows环境通常没有这个命令。方法二手动部署通用方法这是你需要掌握的标准流程将公钥内容复制到剪贴板。在客户端的PowerShell中运行cat ~\.ssh\id_ed25519.pub | Set-Clipboard或者直接用记事本打开.pub文件复制全部内容。在SSH服务器Win11上创建.ssh目录和authorized_keys文件。首先用你打算用来SSH登录的账户比如adminuser登录到那台Win11机器。打开PowerShell依次执行# 确保用户目录下的.ssh文件夹存在 mkdir -Force $env:USERPROFILE\.ssh # 将剪贴板中的公钥内容追加到authorized_keys文件末尾 Get-Clipboard $env:USERPROFILE\.ssh\authorized_keys设置正确的文件权限关键SSH对权限非常敏感过松的权限会导致密钥认证失败。# 设置.ssh目录权限仅当前用户完全控制 icacls $env:USERPROFILE\.ssh /inheritance:r /grant:r $env:USERNAME:(OI)(CI)F # 设置authorized_keys文件权限仅当前用户完全控制 icacls $env:USERPROFILE\.ssh\authorized_keys /inheritance:r /grant:r $env:USERNAME:F这两条icacls命令至关重要它们移除了所有继承权限并只授予文件所有者完全控制权。很多连接失败的问题都出在这里。5.3 测试密钥登录并禁用密码部署完成后回到客户端电脑尝试连接ssh -p 22 usernameyour_win11_ip如果配置正确它会提示你输入私钥的通行短语passphrase而不是用户密码。输入通行短语后即可登录。成功登录后务必返回第4.2节将服务器sshd_config中的PasswordAuthentication设置为no并重启服务。从此你的服务器只认密钥不认密码安全性大幅提升。6. 高级配置与实用场景拓展基础服务搭好了我们来点更实用的“骚操作”。6.1 自定义SSH服务器配置详解配置文件C:\ProgramData\ssh\sshd_config是SSH服务的大脑。除了修改端口和禁用密码还有一些实用参数ListenAddress 0.0.0.0默认监听所有IPv4地址。如果你的机器有多块网卡可以指定只监听内网IP如ListenAddress 192.168.1.100增加一层隔离。LoginGraceTime 30登录宽限期秒。如果用户在这个时间内没有成功登录服务器将断开连接。防止资源被长时间挂起的连接占用。MaxAuthTries 3最大认证尝试次数。配合PasswordAuthentication no这个设置主要针对密钥认证的尝试次数。AllowTcpForwarding yes是否允许TCP端口转发。如果你需要用到SSH隧道功能必须保持为yes。Subsystem sftp sftp-server.exe定义SFTP子系统。默认已启用这就是你能用SFTP客户端连接的原因。一般无需改动。修改任何配置后记得用Restart-Service sshd重启服务。6.2 将SFTP访问限制到特定目录Chroot默认情况下用户通过SFTP登录可以访问其有权限的整个驱动器。出于安全考虑我们可能希望将其“禁锢”在特定目录如D:\SFTPRoot内。Windows OpenSSH实现Chroot相对Linux复杂但可以通过配置sshd_config和NTFS权限实现类似效果。一个更简单实用的方法是使用Match块和ForceCommand内部指令来限制特定用户。例如只想让用户sftpuser使用SFTP且将其根目录限制在D:\DataSubsystem sftp sftp-server.exe -d %d Match User sftpuser ForceCommand internal-sftp -d D:\Data ChrootDirectory D:\Data PermitTunnel no AllowTcpForwarding no X11Forwarding no同时你需要确保D:\Data目录的NTFS权限设置正确SYSTEM和sftpuser用户需要有完全控制权并移除其他所有用户的权限。此配置需要反复测试建议在虚拟机中先演练。6.3 与VS Code Remote-SSH无缝集成这是对开发者而言的“杀手级”应用。在本地VS Code中安装“Remote - SSH”扩展。按F1打开命令面板输入“Remote-SSH: Connect to Host...”选择“Add New SSH Host”。输入连接命令例如ssh -p 2222 adminuser192.168.1.100。根据提示选择SSH配置文件保存位置通常选第一个用户配置文件。在VS Code左侧活动栏会出现一个新的“远程资源管理器”图标点击它在你刚添加的主机旁边点击“连接”。首次连接会提示选择平台选择“Linux”因为OpenSSH行为类似Linux或“Windows”均可扩展会自动处理。接下来会提示你输入私钥通行短语如果设置了的话。输入后即可连接。连接成功后新开的VS Code窗口标题会显示[SSH: your_hostname]。你可以像操作本地文件一样操作远程Win11机器上的文件使用安装在远程机器上的环境运行和调试代码体验极其流畅。7. 故障排查与常见问题实录即使按照步骤操作也难免会遇到问题。这里记录了我踩过的坑和解决方案。7.1 连接失败问题速查表问题现象可能原因排查步骤与解决方案Connection refused1. SSH服务未运行。2. 防火墙阻止。3. 修改端口后未重启服务或更新防火墙规则。1.Get-Service sshd检查状态未运行则Start-Service sshd。2. 检查防火墙入站规则是否启用且端口正确。3. 重启服务Restart-Service sshd。Connection timed out1. IP地址或端口错误。2. 中间网络设备路由器、公司防火墙阻断。3. 服务器监听地址配置错误。1. 用ipconfig确认服务器IP用 netstat -anPermission denied (publickey)1. 公钥未正确部署到authorized_keys。2.authorized_keys文件权限过宽。3.sshd_config中PubkeyAuthentication被禁用。4. 服务器用户目录权限问题。1. 逐字核对authorized_keys文件内容是否与公钥一致确保没有多余空格或换行。2. 使用第5.2节中的icacls命令重置权限。3. 检查配置文件确保PubkeyAuthentication yes。4. 确保用户主目录C:\Users\xxx权限不被过度限制。Password authentication failed但密码正确1. 用户账户被禁用或锁定了。2. 服务器是Windows家庭版或组策略限制了网络登录。1. 在“计算机管理”-“本地用户和组”中检查账户状态。2. 家庭版可能限制可尝试启用内置管理员账户测试。组策略需检查“拒绝从网络访问此计算机”等条目。SFTP可以连接但SSH Shell无法使用用户Shell如PowerShell执行策略限制或路径错误。检查sshd_config中是否有Subsystem配置错误或为用户指定了无效的shell。默认使用Windows自带的powershell.exe或cmd.exe通常没问题。7.2 诊断利器服务器端日志当连接出现问题时查看服务器端的日志是定位问题的关键。Windows OpenSSH的日志位于两个地方Windows事件查看器打开“事件查看器”导航到“应用程序和服务日志” - “OpenSSH” - “Operational”。这里记录了SSH服务的启动、停止、认证成功/失败等详细事件。任何连接尝试都会在这里留下记录是首要排查点。SSH服务调试日志在sshd_config中可以开启更详细的调试日志。找到#LogLevel INFO这一行可以改为LogLevel DEBUG3最详细然后重启服务。日志会输出到C:\ProgramData\ssh\logs目录下需要手动创建logs目录并给SYSTEM和sshd运行账户写权限。注意调试日志非常详细仅在排查复杂问题时临时开启。7.3 关于Windows家庭版的特别说明一些教程会提到Windows家庭版缺少某些组策略功能可能导致SSH登录失败。实测在最新的Windows 11家庭版中原生OpenSSH Server可以正常工作。如果遇到“密码认证失败”但密码确定正确的问题可以尝试使用内置的Administrator账户进行测试需先启用该账户。确保用于SSH登录的账户具有密码而非PIN码登录。在“设置”-“账户”-“登录选项”中确保“要求Windows Hello登录”等选项未被强制开启这可能会干扰传统的密码认证。最后一个我反复强调的经验每次修改sshd_config后务必使用Restart-Service sshd重启服务。直接重启服务器当然也行但这个命令更快更精准。配置SSH就是一个“修改-重启-测试”的循环耐心一点根据错误信息对照排查问题总能解决。当你成功通过密钥在终端里连上自己的Win11或者用VS Code打开远程项目时这一切的折腾都是值得的。
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
