🗂 目录(点击标题可跳转)
| 图标 | 可跳转章节标题 |
|---|---|
| 🚨 | [问题核心原因](#图标 可跳转章节标题 🚨 问题核心原因 💡 方案1:手动安装OpenSSH离线包(推荐) 📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH) 🛠 方案3:备用(Putty+Trae间接连接) ✅ 验证SSH是否可用) |
| 💡 | [方案1:手动安装OpenSSH离线包(推荐)](#图标 可跳转章节标题 🚨 问题核心原因 💡 方案1:手动安装OpenSSH离线包(推荐) 📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH) 🛠 方案3:备用(Putty+Trae间接连接) ✅ 验证SSH是否可用) |
| 📦 | [方案2:直接用Git自带SSH(无需安装系统OpenSSH)](#图标 可跳转章节标题 🚨 问题核心原因 💡 方案1:手动安装OpenSSH离线包(推荐) 📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH) 🛠 方案3:备用(Putty+Trae间接连接) ✅ 验证SSH是否可用) |
| 🛠 | [方案3:备用(Putty+Trae间接连接)](#图标 可跳转章节标题 🚨 问题核心原因 💡 方案1:手动安装OpenSSH离线包(推荐) 📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH) 🛠 方案3:备用(Putty+Trae间接连接) ✅ 验证SSH是否可用) |
| ✅ | [验证SSH是否可用](#图标 可跳转章节标题 🚨 问题核心原因 💡 方案1:手动安装OpenSSH离线包(推荐) 📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH) 🛠 方案3:备用(Putty+Trae间接连接) ✅ 验证SSH是否可用) |
🚨 问题核心原因
你的Windows系统因更新源故障、网络限制(如公司内网/代理)或系统版本适配问题 ,无法从微软官方服务器在线下载OpenSSH安装包,导致Add-WindowsCapability命令执行失败。
💡 方案1:手动安装OpenSSH离线包(推荐)
步骤1:下载对应版本的OpenSSH离线安装包
- 确认系统版本:按下
Win+R输入winver,查看是Windows 10还是11(x64架构); - 下载离线包(选择对应版本):
- Windows 10/11通用(推荐) :访问微软官方离线包地址
OpenSSH for Windows 离线安装包 - 下载最新版的
OpenSSH-Win64.zip(如OpenSSH-Win64-v9.5.0.0p1-Beta.zip); - 备用下载地址(国内源):蓝奏云 OpenSSH-Win64.zip 密码:6666。
- Windows 10/11通用(推荐) :访问微软官方离线包地址
步骤2:解压并安装OpenSSH
-
将下载的
OpenSSH-Win64.zip解压到固定路径(建议C:\OpenSSH-Win64\,避免中文/空格); -
以管理员身份 打开PowerShell:
-
切换到解压目录:
cd C:\OpenSSH-Win64; -
执行安装命令:
powershell.\install-sshd.ps1
-
-
安装完成后,执行
Set-Service ssh-agent -StartupType Automatic(设置SSH服务自启)。
步骤3:配置环境变量(关键)
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」;
- 在「系统变量」的「Path」中点击「编辑」→「新建」;
- 粘贴OpenSSH路径:
C:\OpenSSH-Win64\,点击「确定」保存; - 关闭所有PowerShell/命令提示符窗口(环境变量生效需重启程序)。
📦 方案2:直接用Git自带SSH(无需安装系统OpenSSH)
若你电脑已安装Git(绝大多数开发者都有),可直接复用Git内置的SSH客户端,无需额外安装:
步骤1:找到Git的ssh.exe路径
Git默认安装路径下,ssh.exe位置为:
- 64位系统:
C:\Program Files\Git\usr\bin\ - 32位系统:
C:\Program Files (x86)\Git\usr\bin\
若忘记Git安装路径:打开「此电脑」→ 搜索「git」→ 找到Git安装目录,进入
usr\bin确认有ssh.exe。
步骤2:添加到系统环境变量
- 按方案1的步骤3,将Git的
ssh.exe路径(如C:\Program Files\Git\usr\bin\)添加到系统「Path」; - 重启命令提示符,执行
ssh -V,若返回OpenSSH_xxx (Git)版本信息,说明配置成功。
步骤3:重启Trae IDE
完全关闭Trae(右键任务栏Trae图标→「退出」),重新打开后再次尝试连接Seetacloud服务器:
ssh -p 42611 root@connect.bjb1.seetacloud.com
🛠 方案3:备用(Putty+Trae间接连接)
若上述方案仍失败,可通过Putty建立SSH隧道,让Trae通过本地隧道连接:
步骤1:下载并安装Putty
- 下载Putty:Putty官方下载(或国内源:蓝奏云 Putty.zip 密码:6666);
- 安装后打开Putty,配置连接信息:
- Host Name:
connect.bjb1.seetacloud.com - Port:
42611 - Connection type:
SSH - 左侧「Connection→SSH→Auth」:无需配置密钥,直接点击「Open」;
- Host Name:
- 弹出终端后输入用户名
root,密码xxx,建立Putty SSH连接(保持窗口打开)。
步骤2:Trae连接本地隧道
-
在Trae中添加SSH连接,输入:
ssh root@127.0.0.1 2222 (Putty默认本地隧道端口,若被占用可自定义) -
按提示输入密码,即可通过Putty的本地隧道连接到Seetacloud服务器。
✅ 验证SSH是否可用
-
打开新的命令提示符,执行:
ssh -V;- 若返回类似
OpenSSH_9.5p1, OpenSSL 3.1.4 24 Oct 2023的版本信息 → SSH客户端已就绪;
- 若返回类似
-
尝试直接连接服务器(验证网络):
bashssh -p 42611 root@connect.bjb1.seetacloud.com- 输入密码
xxxx,若能登录到Seetacloud服务器终端 → 连接正常;
- 输入密码
-
重启Trae IDE,重新添加SSH连接,此时不会再提示「ssh installation not found」。
常见问题补充
| 问题场景 | 解决方法 |
|---|---|
| Git路径添加后仍提示「ssh不是命令」 | 确认Git路径正确(如C:\Program Files\Git\usr\bin\),重启电脑后再验证 |
| Putty连接提示「Connection refused」 | 检查Seetacloud服务器是否处于「运行中」,端口号42611是否输入正确 |
| Trae仍找不到ssh.exe | 在Trae中手动指定SSH路径:1. 打开Trae设置(Ctrl+,);2. 搜索「Remote.SSH: Path」;3. 输入C:\Program Files\Git\usr\bin\ssh.exe(或你的OpenSSH路径) |