什么，自动部署前端包这么简单？

SSH2-SFTP-Client：简化SFTP文件传输的Node.js插件

在现代开发环境中，文件传输是一个不可或缺的环节，特别是在需要在不同服务器之间同步数据或上传下载文件时。SSH（安全外壳协议）和SFTP（SSH文件传输协议）因其安全性和灵活性而广受欢迎。对于Node.js开发者来说，ssh2-sftp-client是一个强大的插件，能够极大地简化SFTP操作。本文将详细介绍ssh2-sftp-client的功能、安装方法以及如何使用它进行文件传输。

一、概述

ssh2-sftp-client是一个基于ssh2库的Node.js模块，它提供了一个高级的API，使得通过SFTP进行文件上传、下载、删除、列出等操作变得简单直观。该插件封装了底层的SFTP细节，开发者无需深入了解SFTP协议的具体实现，即可快速实现文件传输功能。

二、安装

要使用ssh2-sftp-client，首先需要确保你的Node.js（版本>14，本人用的16）环境已经安装。然后，你可以通过npm（Node包管理器）来安装这个插件：

bash
 代码解读
复制代码
npm install ssh2-sftp-client

三、基本用法

1. 导入模块

在你的Node.js文件中，首先导入ssh2-sftp-client模块：

const SftpClient = require('ssh2-sftp-client');

2. 连接到SFTP服务器

使用connect方法连接到SFTP服务器，需要提供主机名、端口号、用户名和密码等信息。连接成功后，你可以使用返回的连接对象进行各种文件操作。

const sftp = new SftpClient();

sftp.connect({
host: ‘your.sftp.server’,
port: ’22’,
username: ‘your-username’,
password: ‘your-password’
}).then(() => {
console.log(‘Connected to SFTP server’);
// 在这里进行文件操作
}).catch(err => {
console.error(‘Error connecting to SFTP server:’, err);
});

3. 文件操作

• 上传文件

sftp.put('/local/path/to/file.txt', '/remote/path/to/file.txt')
  .then(() => {
    console.log('File uploaded successfully');
  })
  .catch(err => {
    console.error('Error uploading file:', err);
  });

• 下载文件

sftp.get('/remote/path/to/file.txt', '/local/path/to/file.txt')
  .then(() => {
    console.log('File downloaded successfully');
  })
  .catch(err => {
    console.error('Error downloading file:', err);
  });

• 列出目录内容

sftp.list('/remote/path')
  .then(data => {
    console.log('Directory contents:', data);
  })
  .catch(err => {
    console.error('Error listing directory:', err);
  });

• 删除文件

sftp.delete('/remote/path/to/file.txt')
  .then(() => {
    console.log('File deleted successfully');
  })
  .catch(err => {
    console.error('Error deleting file:', err);
  });

• 上传文件夹

sftp.uploadDir('本地目录'，'远程目录')
  .then(() => {
    console.log('File downloadDir successfully');
  })
  .catch(err => {
    console.error('Error downloadDir file:', err);
  });

• 下载服务器的文件夹

sftp.downloadDir('远程目录'，'本地目录')
  .then(() => {
    console.log('File downloadDir successfully');
  })
  .catch(err => {
    console.error('Error downloadDir file:', err);
  });

• 重命名服务器文件夹

sftp.rename('远程目录'，'远程新目录')
  .then(() => {
    console.log('File rename successfully');
  })
  .catch(err => {
    console.error('Error rename file:', err);
  });

4. 断开连接

完成所有文件操作后，别忘了断开与SFTP服务器的连接：

sftp.end()
  .then(() => {
    console.log('Disconnected from SFTP server');
  })
  .catch(err => {
    console.error('Error disconnecting from SFTP server:', err);
  });

四、实践

1. 创建js文件

const SftpClient = require('ssh2-sftp-client')
const sftp = new SftpClient()

const config = {
host: ‘ip’,
port: ‘端口号’,
username: ‘服务器账号’,
password: ‘服务器密码’ // 或者使用 privateKey 字段提供私钥路径
}

const remoteDir = ‘/database/nginx/html/TianJin/operation’ // 远程目录路径
const newFolderPath = ‘/database/nginx/html/TianJin/operationBak1’ // 重命名后的文件夹新路径（仅改变名称）
// const localDir = ‘bak’ // 本地保存路径

sftp.connect(config).then(() => {
console.log(‘连接成功！’)
// console.log(‘开始下载目录…’)
// return sftp.downloadDir(remoteDir, localDir) // 这里本意想下载到本地进行备份
console.log(‘开始备份文件夹…’)
// return sftp.rename(remoteDir, newFolderPath) // 重命名文件夹（远程已经有的文件夹名称，会重命名错误）
}).then(() => {
// console.log(‘目录下载成功！’)
console.log(‘文件夹备份成功！’)
console.log(‘开始上传文件…’)
sftp.uploadDir(‘operation’, remoteDir).then(() => { //’operation’打包后的文件夹目录，这里js放在同级目录中所以，这里可以只填写文件夹名
console.log(‘文件上传成功！’) //这里会直接将远程文件目录覆盖掉，所以前面可以加上备份操作
return sftp.end()
}).catch((err) => {
console.error(err.message)
if (sftp.sftp) {
sftp.sftp.end()
}
})
}).catch((err) => {
console.error(err.message)
if (sftp.sftp) {
sftp.sftp.end()
}
})

3. 将js文件放入项目中，位置随意，然后在package.json中加入一行

4. 执行脚本

npm run deploy

五、高级功能

ssh2-sftp-client还支持许多高级功能，如使用SSH密钥进行身份验证、流式文件传输、处理大文件等。你可以查阅官方文档获取更多详细信息和示例代码。

六、总结

ssh2-sftp-client是一个功能强大且易于使用的Node.js插件，它极大地简化了通过SFTP进行文件传输的复杂性。无论你是需要上传、下载、删除文件，还是列出目录内容，这个插件都能提供直观且高效的API。如果你正在开发需要文件传输功能的Node.js应用，不妨尝试一下ssh2-sftp-client。