使用com.jcraft.jsch进行SSH连接

一、引言

在开发网络应用程序时，我们经常需要使用到SSH连接来与远程服务器进行交互。而JSCH是一个Java Secure Channel的缩写，它提供了直接连接SSH的能力，使得我们可以在Java应用程序中进行SSH连接，而不需要额外的工具或软件。

二、JSCH的安装和配置

在开始使用JSCH之前，我们需要进行JSCH的安装和配置。JSCH的安装非常简单，只需要将它的JAR包添加到我们的项目中即可。我们可以从以下地址下载到JSCH的JAR包：

• http://www.jcraft.com/jsch/

下载完成后，我们可以将JAR包添加到我们的项目中。在Eclipse中，我们可以右键单击项目名，选择Build Path -> Configure Build Path，然后在弹出窗口的Libraries选项卡中选择Add External JARs来将JSCH的JAR包添加进来。

三、连接SSH服务器

在JSCH中，我们需要使用Session来建立SSH连接，并使用Channel来执行相关的操作。下面就让我们来看看如何使用JSCH连接SSH服务器。

import com.jcraft.jsch.*;

public class SSHConnection {
   public static void main(String[] args) {
      String user = "username";
      String password = "password";
      String host = "example.com";
      int port = 22;

      JSch jsch = new JSch();
      Session session = null;
      try {
         session = jsch.getSession(user, host, port);
         session.setConfig("StrictHostKeyChecking", "no");
         session.setPassword(password);
         session.connect();

         Channel channel = session.openChannel("shell");

         channel.setInputStream(System.in);
         channel.setOutputStream(System.out);

         channel.connect();
      } catch (JSchException e) {
         e.printStackTrace();
      }
   }
}

在上面的代码中，我们使用JSch的getSession方法来创建一个Session对象，其中user、host和port分别代表我们要连接的SSH服务器的用户名、主机名和端口号，而password则代表服务器的密码。我们还需要设置StrictHostKeyChecking配置，这样我们才能够连接到未知主机。最后，我们调用session的connect方法来建立SSH连接。

接下来，我们使用session的openChannel方法来打开一个Channel对象，在本例中，我们选择了shell类型的Channel。我们还需要设置Channel的输入输出流，以便我们可以像在命令行中一样与服务器进行交互。最后，我们调用Channel的connect方法来完成SSH连接。

四、SSH连接进阶应用

除了连接SSH服务器之外，JSCH还提供了许多进阶应用。以下是一些常见的应用场景：

1. 使用SFTP进行文件传输

除了SSH连接之外，JSCH还提供了SFTP的支持，用来进行文件传输。以下是一个SFTP传输文件的例子：

import com.jcraft.jsch.*;

public class SFTP {
   public static void main(String[] args) {
      String user = "username";
      String password = "password";
      String host = "example.com";
      int port = 22;

      JSch jsch = new JSch();
      Session session = null;
      try {
         session = jsch.getSession(user, host, port);
         session.setConfig("StrictHostKeyChecking", "no");
         session.setPassword(password);
         session.connect();

         ChannelSftp sftpChannel = (ChannelSftp) session.openChannel("sftp");
         sftpChannel.connect();

         sftpChannel.put("C:\\localfile.txt", "/remotefile.txt");

         sftpChannel.disconnect();
      } catch (JSchException | SftpException e) {
         System.err.println(e);
      }
   }
}

在上面的代码中，我们首先建立了一个SSH连接，然后调用session的openChannel方法来打开一个SFTP类型的Channel，并且连接到服务器。接下来，我们调用ChannelSftp对象的put方法来将本地的文件localfile.txt上传到服务器上的remotefile.txt。最后，我们关闭Channel并且退出SSH连接。

2. 使用SCP进行文件传输

除了SFTP之外，JSCH还提供了SCP的支持，用来进行文件传输。以下是一个SCP传输文件的例子：

import com.jcraft.jsch.*;

public class SCP {
   public static void main(String[] args) {
      String user = "username";
      String password = "password";
      String host = "example.com";
      int port = 22;

      JSch jsch = new JSch();
      Session session = null;
      try {
         session = jsch.getSession(user, host, port);
         session.setConfig("StrictHostKeyChecking", "no");
         session.setPassword(password);
         session.connect();

         Channel channel = session.openChannel("exec");
         String command = "scp -t /remote/folder/";
         ((ChannelExec) channel).setCommand(command);

         OutputStream out = channel.getOutputStream();
         InputStream in = channel.getInputStream();

         channel.connect();

         String localFile = "/local/folder/file.txt";
         File file = new File(localFile);

         if (file.exists()) {
            // send "C0644 filesize filename", where filename should not include '/'
            long filesize = file.length();
            command = "C0644 " + filesize + " ";
            if (localFile.lastIndexOf('/') > 0) {
               command += localFile.substring(localFile.lastIndexOf('/') + 1);
            } else {
               command += localFile;
            }
            command += "\n";
            out.write(command.getBytes());
            out.flush();

            // send a content of lfile
            FileInputStream fis = new FileInputStream(localFile);
            byte[] buf = new byte[1024];
            while (true) {
               int len = fis.read(buf, 0, buf.length);
               if (len <= 0) {
                  break;
               }

               out.write(buf, 0, len);
            }
            fis.close();

            // send '\0'
            buf[0] = 0;
            out.write(buf, 0, 1);
            out.flush();

            if (checkAck(in) != 0) {
               System.exit(0);
            }
         }

         channel.disconnect();
      } catch (JSchException | IOException e) {
         e.printStackTrace();
      }
   }

   static int checkAck(InputStream in) throws IOException {
      int b = in.read();
      if (b == 0) return b;
      if (b == -1) return b;

      if (b == 1 || b == 2) {
         StringBuffer sb = new StringBuffer();
         int c;
         do {
            c = in.read();
            sb.append((char) c);
         } while (c != '\n');
         if (b == 1) { // error
            System.out.print(sb.toString());
         }
         if (b == 2) { // fatal error
            System.out.print(sb.toString());
         }
      }
      return b;
   }
}

在上面的代码中，我们首先建立了一个SSH连接，然后打开一个exec类型的Channel。我们将要传输到服务器上的文件名设置为/remote/folder/file.txt，并且使用OutputStream将命令发送给服务器。接着，我们设置InputStream和OutputStream，然后连接Channel。

在连接之后，我们检查本地文件是否存在，如果存在，则将文件发送到服务器上。我们通过一个循环来将文件发送到服务器上，并且检查发送的结果。最后，我们关闭Channel并且退出SSH连接。

五、总结

在本文中，我们学习了如何使用JSCH连接SSH服务器，同时还介绍了SFTP和SCP的使用方法。希望这篇文章能够帮助你学习和使用JSCH。