跳至正文
移动开发者实验室
返回

如何用手机通过 SSH 连接 Windows 11,并使用 SFTP 浏览文件

核心结论:在 Windows 11 上配置 OpenSSH Server,从 Android 或 iPhone 连接,通过 SFTP 浏览文件,并排查 22 端口连接超时。

通过手机使用 SSH 和 SFTP 访问 Windows 11

用手机访问你的 Windows 开发电脑,不一定需要远程桌面。SSH 和 SFTP 往往就够用了。

最近,我尝试让手机能够正常连接 Windows 11 进行远程开发。想法很简单:不用坐在电脑前,也能浏览文件、编辑代码、运行 PowerShell 命令。

配置过程其实相当直接。真正麻烦的是排查问题:Windows 明明显示已允许访问 22 端口,可每次连接依然超时。

下面介绍完整的配置方法,以及我遇到的问题。

我们要搭建什么

整体结构如下:

Android / iPhone
       |
       | SSH (TCP 22)
       |
       v
Windows 11 电脑
       |
       +-- OpenSSH Server
       +-- SFTP 文件访问
       +-- PowerShell 终端
       +-- 本地项目

SSH 提供远程 Shell。SFTP 通过同一条 SSH 连接运行,让我们能够浏览和传输文件。

我们需要:

  • 一台 Windows 11 电脑
  • 一部连接到同一局域网的手机
  • Windows OpenSSH Server
  • 手机上的 SSH/SFTP 客户端

手机端我会使用 NimoteCode 2.3.0 及以上版本。这是我一直在开发的一款面向 Android 和 iOS 的移动 IDE。其他 SSH/SFTP 客户端也可以使用相同的 Windows 配置。

完成基本配置不需要 Windows 远程桌面、WSL,也不需要在 Windows 主机上额外安装配套应用。

1. 在 Windows 11 上启用 OpenSSH Server

首先,以管理员身份打开 PowerShell。

检查是否已安装 OpenSSH Server:

Get-WindowsCapability -Online |
    Where-Object Name -like 'OpenSSH*'

查找以下内容:

OpenSSH.Server~~~~0.0.1.0
State : Installed

如果尚未安装服务端,运行:

Add-WindowsCapability -Online `
    -Name OpenSSH.Server~~~~0.0.1.0

也可以在 Windows 设置的“可选功能”中安装。

接着启动 SSH 服务:

Start-Service sshd

将其设为重启后自动启动:

Set-Service -Name sshd -StartupType Automatic

检查服务状态:

Get-Service sshd

你应该看到:

Status   Name
------   ----
Running  sshd

第一部分就完成了。

2. 检查 Windows 是否正在监听 22 端口

如果 SSH 服务实际上没有监听端口,装好 OpenSSH 也无济于事。

运行:

Get-NetTCPConnection -LocalPort 22 -State Listen

典型结果如下:

LocalAddress LocalPort State
------------ --------- -----
0.0.0.0      22        Listen

0.0.0.0 表示服务正在监听所有 IPv4 网络接口。

如果没有输出,再次检查 SSH 服务。同时查看:

C:\ProgramData\ssh\sshd_config

检查是否存在自定义的 Port 或 ListenAddress 设置,导致预期的连接无法建立。

修改 SSH 配置后,使用 sshd -t 验证配置,再重启服务。

用手机测试之前,先检查本机回环地址:

Test-NetConnection 127.0.0.1 -Port 22

关键是这一行:

TcpTestSucceeded : True

如果这一步失败,先修复本机 SSH 服务,再排查手机或路由器。

3. 检查 Windows 防火墙

这一部分花的时间比我预想的多。

我的电脑上有好几条允许 TCP 22 端口的规则,其中包括之前试用 SSH 和 WSL 时创建的规则。

乍看之下,一切都没问题。但有多条防火墙规则,并不能证明远程连接一定能成功。

检查 OpenSSH 规则:

Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" |
    Select-Object DisplayName, Enabled, Action, Profile

你可能会看到:

DisplayName               Enabled Action Profile
-----------               ------- ------ -------
OpenSSH SSH Server (sshd) True    Allow  Private

注意这里的 Private。

这条规则适用于“专用”网络配置文件。如果当前连接被归类为“公用”网络,这条规则就可能不适用。

检查你的网络:

Get-NetConnectionProfile |
    Select-Object InterfaceAlias, NetworkCategory

如果这是你信任的家庭或办公局域网,可以通过 Windows 设置将网络设为“专用”。

为了临时诊断,也可以将 SSH 规则改为适用于所有网络配置文件:

Set-NetFirewallRule `
    -Name "OpenSSH-Server-In-TCP" `
    -Profile Any

不要在不可信网络上让 SSH 处于不必要的暴露状态。找到问题后,将规则限制为预期的网络配置文件,并在条件允许时,将允许访问的远程 IP 地址范围限制为可信地址。

另外,不要仅仅因为连接超时就不断添加重复的防火墙规则。先检查现有规则。

4. 找到 Windows 电脑的 IP 地址

运行:

ipconfig

找到你实际正在使用的网络适配器的 IPv4 地址。

例如:

Wireless LAN adapter Wi-Fi:

IPv4 Address . . . . . : 192.168.1.100

手机应该连接这个局域网地址,而不是 127.0.0.1。

如果电脑上有 WSL2、Docker、Hyper-V 或 VPN 适配器,要格外注意。它们可能会带来额外的 IP 地址,而这些地址并不是手机应该连接的目标。

你可以从另一台 Windows 电脑上测试:

Test-NetConnection 192.168.1.100 -Port 22

将地址替换为你电脑实际的 IP 地址。

如果本机回环地址测试成功,但这个测试失败,就检查防火墙规则是否匹配当前网络配置文件、是否存在网络隔离、安全软件是否拦截,以及连接的是否为正确的网络适配器地址。

5. 从 Android 或 iPhone 连接

现在轮到手机端了。

我使用的是 NimoteCode,它从 2.3.0 版本开始支持 Windows 远程工作区。

NimoteCode 2.4.1 SSH

NimoteCode 2.4.1 连接表单、目录选择与远程文件。新版界面截图使用临时 macOS SSH 项目;上面的 Windows 配置步骤仍针对 Windows。

创建一个 SSH 工作区或连接,填写以下信息:

设置示例
连接名称Windows 11 开发电脑
主机地址192.168.1.100
端口22
用户名你的 Windows 账户用户名
身份验证密码或 SSH 密钥

使用 Windows 账户密码,而不是 Windows Hello PIN。如果你使用的是 Microsoft 账户,请确认 OpenSSH 识别的用户名。

首次建立连接时,先与 Windows 电脑上的信息核对 SSH 主机密钥指纹,确认无误后再信任该主机。

连接成功后,你可以在远程工作区中通过 SFTP 浏览 Windows 文件,打开和编辑受支持的项目文件,并通过 SSH 终端运行 PowerShell 命令。

例如,可以在远程终端中运行:

Get-Location
Get-ChildItem
git status

运行 Git 命令需要 Windows 主机已安装 Git,并且能在命令行中调用它。

关于路径还需要说明一点:Windows 使用的是 C:\Users\YourName\Projects 这样的路径。SFTP 通过服务端的远程文件系统接口呈现路径,因此显示方式可能与 Windows 本地文件选择器不同。

6. SSH 能用,但 SFTP 不行?

SSH 和 SFTP 相互关联,但并不是同一种操作。

即使 SFTP 子系统配置有误,SSH 终端也可能正常工作。

检查 SSH 服务端配置:

C:\ProgramData\ssh\sshd_config

找到 SFTP 子系统的声明。

典型的 Windows OpenSSH 配置使用:

Subsystem sftp sftp-server.exe

如果你的配置使用的是另一个有效的 SFTP 子系统,不要盲目替换。

做出任何修改后,验证配置并重启 SSH:

sshd -t
Restart-Service sshd

你也可以从另一台机器上单独测试 SFTP:

sftp [email protected]

如果普通 SSH 可以连接,但这个测试失败,就检查 SFTP 子系统、身份验证、目录权限和服务端日志。

7. 如果 22 端口仍然连接超时怎么办?

我建议按下面的顺序排查。

现象检查内容
本机回环地址的 22 端口测试失败sshd 服务和端口监听状态
本机回环地址测试成功,但手机连接超时防火墙、局域网 IP、客户端隔离
连接被拒绝端口监听状态、端口号、防火墙或网络是否拒绝连接
权限被拒绝Windows 用户名和身份验证
SSH 正常,SFTP 失败SFTP 子系统和权限
Wi-Fi 下能连接,移动数据下不能缺少公网可达的网络通路或远程访问隧道

最有用的诊断命令如下:

Get-Service sshd

Get-NetTCPConnection -LocalPort 22 -State Listen

Test-NetConnection 127.0.0.1 -Port 22

Get-NetConnectionProfile

Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" |
    Select-Object DisplayName, Enabled, Action, Profile

还有一点:ping 不能测试 TCP 22 端口。请使用真正的 TCP 连通性测试。

如果你想从家庭网络之外连接,仅配置 Windows 防火墙规则还不够。你还需要一条能够安全访问这台电脑的网络通路。

我建议使用 VPN 或可信的私有组网方案,而不是将 SSH 服务直接暴露在公网。

8. WSL2 怎么办?

如果你已经在使用 WSL2,可以将 Windows 和 Linux 的 SSH 访问分开配置。

例如:

Windows OpenSSH: TCP 22
WSL2 SSH:        TCP 2222

这样,手机就可以使用不同的 SSH 连接配置。

但不要以为修改了 WSL 的 SSH 端口,就能自动通过 Windows 主机的 2222 端口访问它。根据 WSL 的网络模式,你可能还需要额外配置端口转发或防火墙。

如果只是通过 SFTP 访问 Windows 文件、使用 PowerShell,完全不需要 WSL2。

我为什么想把这件事做好

手机不会取代我完整的桌面开发环境。

但很多小任务实在没必要专门打开笔记本电脑:

  • 查看项目文件或配置文件
  • 编辑脚本
  • 快速运行一条 PowerShell 命令
  • 查看 Git 变更
  • 离开电脑时检查日志

这些就是我希望通过 NimoteCode 改善的工作场景。

目标不是把完整桌面塞进一块六英寸的屏幕,而是让你离开键盘时,仍然能用上开发环境中那些有用的部分。

如果你的主力开发电脑是 Windows 11,SSH 和 SFTP 是一个不错的起点。

如果你明明开放了 22 端口,却仍在排查连接超时,请先检查 SSH 实际的端口监听状态和网络配置文件,再考虑添加另一条防火墙规则。


实用链接

我正在开发 NimoteCode,希望让通过手机和平板进行远程开发的体验更顺手。如果你尝试过用手机连接 SSH/SFTP,我很想知道还有哪些问题在妨碍你。