解决Windows环境下SublimeText编辑器的SFTP使用秘钥上传下载失败的问题

博主：黄炜
发布时间：2023 年 12 月 28 日
655 次浏览
3083字数
分类：技术工具推荐

### 引言

今天突发奇想，想在`SublimeText`当中用秘钥上传下载代码的时候，用秘钥来鉴权，往常都是用密码的。

结果发现配置之后不能用，上传下载都不行。

遂去网上查找，N久之后确定，不是不能用，是格式不对。

#### 唠叨

自己搞了个公众号，如果有兴趣可以关注一下，会有各种好玩的技术文章可以看，大佬有时间也可以瞅瞅，欢迎各位不吝赐教~

![拓行公众号](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/654410095.png)

### 解决方法

#### 1. 确认你电脑上的秘钥信息

首先打开你的电脑上秘钥和公钥的存放目录：

路径一般来说是：`~/.ssh/`，在`windows`系统下，一般位置是：

`C:\Users\Administrator\.ssh`

当然，如果你的用户名被你自己改过（不是`Administrator`），你就得自行替换一下了。

打开之后能看到有我这边几个文件，那就可以继续往下看了。

![秘钥与公钥文件](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/2499742974.png)

**Tip：如果没有这些个文件，甚至整个目录都不存在的话，建议你先初始化秘钥先**

重点是我画红圈的两个文件，其他的不重要（至少是现在不重要）。

#### 2. 下载`putty`

首先一步是下载这个名叫`Putty`的软件，这个软件类似于我常用的`Finalshell`，是可以进行远程连接的。

可以在网上搜索下载，当然也可以关注我们的公众号，有相关资源提供（关注后发送消息即可）。

![下载下来的软件包](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/3347864790.png)

#### 3. 解压并且放到你的软件目录去

这一步，我感觉就不用怎么介绍了吧……

不会吧，不会还有人不会解压吧？

然后看到里头有N多的可执行文件（`.exe`）

如下图所示

![解压后目录](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/2980122354.png)

请注意，一定要有`puttygen.exe`这个文件，我们后续是需要用到的。

如果没有，反而是一大堆广告之类的，那就应该是弄错包了

欢迎各位关注公众号跟我们联系，共同探讨

**注意：这里的解压路径最好是全英文，指的是盘符以下的文件名最好不要出现中文和特殊标点**

#### 4. 导入当前的秘钥文件

然后打开我们刚刚说的这个`puttygen.exe`可执行文件。

打开看到的画面大体是这样的。

![puttygen.exe程序的导入key](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/405384915.png)

点击左上角的导入，不清楚的可以看我上方的截图。

注意，这里要求导入的是私钥(`private Key`)，别弄错了。

选择你上面第1步看到的那个`id_rsa`文件

**注意：不带后缀`.pub`，带后缀的是公钥，不是私钥**

你在选择的时候，可能看不到私钥文件。

但别着急，选择`*`（查看所有后缀的文件），你就能看到了

![查看所有文件](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/217665960.png)

选中`id_rsa`文件后，点击确定，就会弹出导入成功的提示，如下图：

![导入成功](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/4148947500.png)

代表是导入成功了，点击确定按钮即可

然后需要点击下面的`Save private key`按钮，进行保存

![点击保存](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/2795215936.png)

这里会弹出框显示一些提示，询问我们是否用空密码进行保存，直接确定即可（毕竟不需要这么严重的保密）

![询问空密码](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/2182451128.png)

点击确定之后，会弹出一个保存位置选择框，这个位置没有什么要求，我建议最好放在公钥和私钥同级的目录下（方便查找）

然后需要输入保存的文件名，别跟公钥私钥文件冲突即可，我这里写了个`id_rsa_ppk.ppk`的文件名。

**注意：后缀一定要是`ppk`否则前功尽弃**

![确定保存目录](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/4269595400.png)

然后点击保存即可。

#### 5. 检测秘钥同级文件夹下是否生成

还是第一步的位置，打开看一下，如果像我这样，有了个文件，那就可以了。

![生成ppk私钥文件](https://aliyun-yuesha-public-oss.oss-cn-zhangjiakou.aliyuncs.com/usr/uploads/2023/12/1807813300.png)

#### 6. `SublimeText`编辑器的`SFTP`配置文件中引用这个新私钥

这里有个小坑，`Windows`环境下特殊

如果你按照文档来写，像这样配置`ssh_key_file`配置项的值的话，大概率还是不行的。

```json
{
    "ssh_key_file": "~/.ssh/id_rsa_ppk.ppk"
}
```

只有改一下，改成盘符的绝对路径才行

```json
{
    "ssh_key_file": "C://Users//Administrator//.ssh//id_rsa_ppk.ppk"
}

```

测试通过，可以正常上传下载

瑞思拜

下班！

欢迎关注拓行公众号，分享各种技术博客文章

拓行——奋勇进取，开拓未来，砥砺前行

最后修改：2023 年 12 月 28 日

如果您对各种技术博客文章感兴趣，欢迎关注拓行公众号，分享各种专业技术知识~