跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

解决 Cursor 无法通过 SSH 连接 Linux 服务器的问题

Cursor 在 Windows 上通过 Remote-SSH 连接 Linux 失败的原因。排查发现 Windows 自带 OpenSSH 受防火墙拦截或配置文件解析错误，而 MobaXterm 的 SSH 客户端可正常工作。解决方案包括修复 MobaXterm 配置文件，或在 Cursor 设置中指定使用 MobaXterm 的 SSH 客户端路径及配置文件，亦可尝试配置 Windows 防火墙规则或使用 Git for Windows 的 SSH 工具。重点在于正确配置 remote.SSH.path 和 remote.SSH.configFile 以绕过系统限制。

DevOpsTeam发布于 2026/3/28更新于 2026/5/2836 浏览

解决 Cursor 无法通过 SSH 连接 Linux 服务器的问题

问题描述

在使用 Cursor 编辑器通过 Remote-SSH 连接 Linux 服务器时遇到连接失败的问题：

  • MobaXterm 中可以正常连接：ssh [email protected]
  • Cursor 中连接失败：ssh [email protected]
  • 使用 -F /dev/null 可以连接：ssh -F /dev/null [email protected]

问题排查过程

第一步：检查 SSH 配置文件

首先怀疑是 SSH 配置文件的问题。检查用户配置文件：

cat ~/.ssh/config

配置文件内容正常：

Host song123 HostName 10.12.15.111 User song Port 22
第二步：查看详细错误信息

在 Cursor 的 PowerShell 中运行：

ssh -vvv [email protected]

发现关键错误：

debug3: connectex - ERROR ConnectEx() :10013
debug1: connect to address 10.12.15.111 port 22: Permission denied
ssh: connect to host 10.12.15.111 port 22: Permission denied

错误代码 10013 = WSAEACCES（权限被拒绝）

第三步：验证网络连通性
Test-NetConnection 10.12.15.111 -Port 22

结果：TcpTestSucceeded : True

这说明网络层面是通的，问题不在网络。

第四步：定位问题根源

通过对比发现：

  1. MobaXterm 使用自己的 SSH 客户端（Cygwin 环境）
  2. Cursor 使用 Windows 自带的 OpenSSH（C:\Windows\System32\OpenSSH\ssh.exe）

问题很可能是：Windows 防火墙或安全软件拦截了 ssh.exe 的出站连接。

第五步：检查 MobaXterm 的 SSH 配置

在 MobaXterm 中检查系统配置文件：

cat /etc/ssh_config

发现问题：

User "" ForwardAgent no ... UseRoaming no

错误信息显示：

/etc/ssh_config line 1: Missing argument.
/etc/ssh_config line 10: Deprecated option "useroaming"
/etc/ssh_config: terminating, 1 bad configuration options

根本原因：

  • 第 1 行 User "" 语法错误（空字符串导致解析失败）
  • 第 10 行 UseRoaming no 是已弃用的选项

这就是为什么 ssh -F /dev/null 可以连接（跳过了配置文件），而直接 ssh 失败的原因。

解决方案

方案 A：修复 MobaXterm 的系统配置文件（适用于 MobaXterm）

找到 MobaXterm 的配置文件位置（便携版通常在临时目录）：

cygpath -w /etc/ssh_config
# 输出示例：D:\Temp\MxtXXX\mx86_64b\etc\ssh_config

编辑文件，注释掉有问题的行：

# User "" ← 注释掉第 1 行
ForwardAgent no
Compression yes
PreferredAuthentications hostbased,publickey,password,keyboard-interactive
ForwardX11 yes
ForwardX11Trusted yes
NoHostAuthenticationForLocalhost yes
StrictHostKeyChecking no
CheckHostIP no
# UseRoaming no ← 注释掉第 10 行
方案 B：让 Cursor 使用 MobaXterm 的 SSH 客户端（推荐）
1. 复制 MobaXterm 的 SSH 到固定目录

找到 MobaXterm 的 SSH 可执行文件：

cygpath -w "$(which ssh)"
# 输出示例：D:\Temp\MxtXXX\mx86_64b\bin\ssh.exe

重要：不要直接使用临时目录路径（D:\Temp\...），因为临时目录会变化。

将整个 mx86_64b 目录复制到固定位置，例如：

C:\Tools\MobaSSH\mx86_64b\bin\ssh.exe

或使用 _ssh.exe（实际二进制文件）：

C:\Tools\MobaSSH\mx86_64b\bin\_ssh.exe
2. 配置 Cursor 使用新的 SSH 路径

打开 Cursor 的设置（Ctrl + Shift + J → 点击右上角 {} 打开 JSON），添加：

{
  "remote.SSH.path": "C:\\Tools\\MobaSSH\\mx86_64b\\bin\\_ssh.exe",
  "remote.SSH.configFile": "C:\\Users\\你的用户名\\.ssh\\config",
  "remote.SSH.remotePlatform": {"song123": "linux"}
}

关键配置说明：

  • remote.SSH.path：指定 SSH 可执行文件的完整路径
  • remote.SSH.configFile：必须指定，因为 MobaXterm 的 SSH 使用 Cygwin 路径系统，默认不会读取 Windows 路径下的配置文件
  • remote.SSH.remotePlatform：指定远程主机平台类型
3. 验证配置

在 Cursor 的 PowerShell 中测试：

& "C:\Tools\MobaSSH\mx86_64b\bin\_ssh.exe" -V
& "C:\Tools\MobaSSH\mx86_64b\bin\_ssh.exe" -F "C:\Users\你的用户名\.ssh\config" song123

如果测试成功，重启 Cursor，然后通过 Remote-SSH 连接服务器。

最终配置

SSH 配置文件（C:\Users\你的用户名\.ssh\config）
Host song123 HostName 10.12.15.111 User song Port 22
Cursor 设置（settings.json）
{
  "remote.SSH.path": "C:\\Tools\\MobaSSH\\mx86_64b\\bin\\_ssh.exe",
  "remote.SSH.configFile": "C:\\Users\\你的用户名\\.ssh\\config",
  "remote.SSH.remotePlatform": {"song123": "linux"}
}

问题总结

问题根源
  1. Windows 防火墙/安全软件拦截：Windows 自带的 ssh.exe 被拦截，导致连接失败（错误 10013）
  2. 配置文件路径不匹配：MobaXterm 的 SSH 使用 Cygwin 路径系统，默认不读取 Windows 路径下的配置文件
解决思路
  1. 绕过 Windows 防火墙限制：使用 MobaXterm 的 SSH 客户端（不被拦截）
  2. 明确指定配置文件路径：通过 remote.SSH.configFile 让 Cursor 知道配置文件位置
关键要点
  • ✅ 必须同时配置 remote.SSH.path 和 remote.SSH.configFile
  • ✅ 使用固定路径，不要使用临时目录
  • ✅ 如果使用 _ssh.exe，必须指定配置文件路径
  • ✅ 配置完成后需要重启 Cursor

其他可能的解决方案

方案 C：修复 Windows 防火墙规则（如果方案 B 不可用）
  1. 打开'高级安全 Windows Defender 防火墙'（Win + R → wf.msc）
  2. 创建出站规则：
    • 程序：C:\Windows\System32\OpenSSH\ssh.exe
    • 操作：允许连接
    • 配置文件：根据你的网络类型选择（专用/公用/域）
方案 D：使用 Git for Windows 的 SSH

如果安装了 Git for Windows，可以使用它的 SSH：

{
  "remote.SSH.path": "C:\\Program Files\\Git\\usr\\bin\\ssh.exe"
}

目录

  1. 解决 Cursor 无法通过 SSH 连接 Linux 服务器的问题
  2. 问题描述
  3. 问题排查过程
  4. 第一步：检查 SSH 配置文件
  5. 第二步：查看详细错误信息
  6. 第三步：验证网络连通性
  7. 第四步：定位问题根源
  8. 第五步：检查 MobaXterm 的 SSH 配置
  9. 解决方案
  10. 方案 A：修复 MobaXterm 的系统配置文件（适用于 MobaXterm）
  11. 输出示例：D:\Temp\MxtXXX\mx8664b\etc\sshconfig
  12. User "" ← 注释掉第 1 行
  13. UseRoaming no ← 注释掉第 10 行
  14. 方案 B：让 Cursor 使用 MobaXterm 的 SSH 客户端（推荐）
  15. 1. 复制 MobaXterm 的 SSH 到固定目录
  16. 输出示例：D:\Temp\MxtXXX\mx86_64b\bin\ssh.exe
  17. 2. 配置 Cursor 使用新的 SSH 路径
  18. 3. 验证配置
  19. 最终配置
  20. SSH 配置文件（C:\Users\你的用户名\.ssh\config）
  21. Cursor 设置（settings.json）
  22. 问题总结
  23. 问题根源
  24. 解决思路
  25. 关键要点
  26. 其他可能的解决方案
  27. 方案 C：修复 Windows 防火墙规则（如果方案 B 不可用）
  28. 方案 D：使用 Git for Windows 的 SSH
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • Llama 3.1 与 Claude Opus 对话实验：安全词机制下的 AI 交互观察
  • 零基础转行学习Python指南与核心知识点梳理
  • 基于 DeepFace 和 OpenCV 的情绪分析器
  • 使用 SiliconCloud 免费体验 Llama3.1-405B 开源大模型
  • Python 循环语句详解：For 与 While 用法及控制流程
  • 产品经理 AI 学习地图：从入门到精通的完整指南
  • AI 不是机器人：它到底是什么？
  • MySQL 深度性能优化配置实战指南
  • AI 产品经理指南：面试百人后的洞察与职业建议
  • 几种典型的 Python 兼职开发途径与实战思路
  • RAG 系统检索指标详解：信息检索任务准确性评估指南
  • JavaScript 空值判断工具函数
  • 微信 ClawBot 插件接入个人微信及 Windows 安装避坑指南
  • 17 岁高中生开发 AI 应用 4 个月销售额超百万美元
  • ChatGLM3 大模型本地化部署、应用开发与微调实战指南
  • 大模型、RAG、Agent、知识库、向量数据库与知识图谱的区别及联系综述
  • Mapnik 在 Windows 10 下的源码编译指南
  • 基于YOLOv8与Lung-CLIP的肺结节智能检测系统
  • LLaMA-Factory 多 GPU 微调加速指南
  • Python 递归实现任意进制转换

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online