当前位置:首页 > 系统教程 > 正文

Windows 11/10 WSL2 SSH 连接配置全攻略(手把手教你远程访问 WSL2 Linux 环境)

本文核心关键词:WSL2 SSH 连接、Windows 远程访问 WSL2、Ubuntu SSH 配置、SSH 连接 Linux 环境

在开发过程中,WSL2(Windows Subsystem for Linux 2)为我们提供了强大的 Linux 环境。但有时我们需要通过专业的 SSH 客户端(如 PuTTY, Xshell 或 VS Code)从外部或本地连接到 WSL2 内部。本文将详细讲解如何完成这一配置。

第一步:安装 OpenSSH Server

默认情况下,WSL2 中的 Ubuntu 可能没有安装或未完全配置 SSH 服务。首先,我们需要进入 WSL2 终端执行以下命令:

    sudo apt updatesudo apt install openssh-server  

第二步:修改 SSH 配置文件

为了确保可以通过密码登录并修改默认端口(避免与 Windows 自带的 SSH 服务冲突),我们需要编辑配置文件:

    sudo vim /etc/ssh/sshd_config  

在文件中找到并修改以下几项:

  • Port 2222 (将端口改为 2222,因为 22 端口常被占用)
  • PasswordAuthentication yes (确保允许密码登录)
  • ListenAddress 0.0.0.0 (允许任何 IP 访问)
Windows 11/10 WSL2 SSH 连接配置全攻略(手把手教你远程访问 Linux 环境) 连接  远程访问 Ubuntu 配置 环境 第1张

第三步:重启 SSH 服务

配置完成后,重启服务使设置生效,并建议将其设置为启动:

    sudo service ssh restart  

第四步:设置端口转发(关键步骤)

由于 WSL2 是运行在 Hyper-V 虚拟化层之后的,它拥有独立的内部 IP。要从 Windows 本地宿主机访问,最简单的方法是使用 127.0.0.1 配合端口转发。在 Windows 中以管理员身份打开 PowerShell,执行以下命令:

    netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=2222 connectaddress=[WSL_IP] connectport=2222  

注:[WSL_IP] 请通过在 WSL2 中输入 `hostname -I` 获取。

第五步:连接测试

现在,你可以打开你的 SSH 客户端。主机名填入 127.0.0.1,端口号填入 2222,点击连接。输入你 WSL2 的用户名和密码,即可成功进入 Linux 环境!

温馨提示: 如果连接失败,请检查 Windows 防火墙是否允许 2222 端口入站,并确保 WSL2 中的 ssh 服务正在运行。