ganymed-ssh2简介

Ganymed SSH-2 for Java是用纯Java实现SSH-2协议的一个包。在使用它的过程中非常容易，只需要指定合法的用户名口令，或者授权认证文件，就可以创建到远程Linux主机的连接，在建立起来的会话中调用该Linux主机上的脚本文件，执行相关操作。使用方法：将 ganymed-ssh2-build210.jar 加入到项目的lib中。简单示例：

假定我在192.168.0.114的Linux系统的/home/lldu目录下放了一个文件夹test，test文件夹对应测试Java类的包名test，我们在该机器上运用javac ./test/Main.java编译后，再通过调用下面的代码完成远程调用：

import ch.ethz.ssh2.Connection;
import ch.ethz.ssh2.ConnectionInfo;
import ch.ethz.ssh2.Session;
/**
*
* @author lldu
*/
public class Main {
    public static void main(String[] args) {
        try {
            Connection con = new Connection("192.168.0.114");
            ConnectionInfo info = con.connect();
            boolean result = con.authenticateWithPassword("lldu", "123456");
            Session session = con.openSession();
            session.execCommand("java test.Main");
        } catch (Exception ex) {
            System.out.println(ex.getLocalizedMessage());
        }
    }
}

总结使用步骤：


1.首先构造一个连接器，传入一个需要登陆的ip地址 

Connection conn = new Connection(ipAddr);
conn.connect(); // 连接

2.模拟登陆目的服务器 传入用户名和密码 

boolean isAuthenticated = conn.authenticateWithPassword(username, password);

它会返回一个布尔值，true 代表成功登陆目的服务器，否则登陆失败

3.打开一个session，有点象Hibernate的session ，执行你需要的linux 脚本命令 。

Session sess = conn.openSession();
sess.execCommand("last");

4.接收目标服务器上的控制台返回结果，读取br中的内容

InputStream stdout = new StreamGobbler(sess.getStdout());
BufferedReader br = new BufferedReader(new InputStreamReader(stdout));

5.得到脚本运行成功与否的标志 ：0－成功 非0－失败

System.out.println("ExitCode: " + sess.getExitStatus());

6.关闭session和connection 

sess.close();
conn.close();

需要说明的是：
1.通过第2步认证成功后，当前目录就位于/home/username/目录之下，你可以指定脚本文件所在的绝对路径，或者通过cd导航到脚本文件所在的目录，然后传递执行脚本所需要的参数，完成脚本调用执行。


2.执行脚本以后，可以获取脚本执行的结果文本，需要对这些文本进行正确编码后返回给客户端，避免乱码产生。

3.如果你需要执行多个linux控制台脚本，比如第一个脚本的返回结果是第二个脚本的入参，你必须打开多个Session,也就是多次调用

Session sess = conn.openSession();,使用完毕记得关闭就可以了

=================================================================================================

摘录部分源码如下：

import java.io.BufferedReader; 
import java.io.IOException; 
import java.io.InputStream; 
import java.io.InputStreamReader; 
import org.apache.log4j.Logger; 
import ch.ethz.ssh2.Connection; 
import ch.ethz.ssh2.SCPClient; 
import ch.ethz.ssh2.Session; 
import ch.ethz.ssh2.StreamGobbler; 
public class CommandRunner { 
private static final Logger logger = Logger.getLogger(CommandRunner.class); 
//从其他网络计算机中拿去文件 
public static void scpGet(String host, String username, String password, 
   String remoteFile, String localDir) throws IOException { 
if (logger.isDebugEnabled()) { 
   logger.debug("spc [" + remoteFile + "] from " + host + " to " 
     + localDir); 
} 
Connection conn = getOpenedConnection(host, username, password); 
SCPClient client = new SCPClient(conn); 
client.get(remoteFile, localDir); 
conn.close(); 
} 
//将文件拷贝到其他计算机上 
public static void scpPut(String host, String username, String password, 
   String localFile, String remoteDir) throws IOException { 
if (logger.isDebugEnabled()) { 
   logger.debug("spc [" + localFile + "] to " + host + remoteDir); 
} 
Connection conn = getOpenedConnection(host, username, password); 
SCPClient client = new SCPClient(conn); 
client.put(localFile, remoteDir); 
conn.close(); 
}
//执行SSH命令.
public static int runSSH(String host, String username, String password, 
   String cmd) throws IOException { 
if (logger.isDebugEnabled()) { 
   logger.debug("running SSH cmd [" + cmd + "]"); 
} 
Connection conn = getOpenedConnection(host, username, password); 
Session sess = conn.openSession(); 
sess.execCommand(cmd); 
InputStream stdout = new StreamGobbler(sess.getStdout()); 
BufferedReader br = new BufferedReader(new InputStreamReader(stdout)); 
while (true) { 
   String line = br.readLine(); 
   if (line == null) 
    break; 
   if (logger.isDebugEnabled()) { 
    logger.debug(line); 
   } 
} 
sess.close(); 
conn.close(); 
return sess.getExitStatus().intValue(); 
} 
//获得连接
private static Connection getOpenedConnection(String host, String username, 
   String password) throws IOException { 
if (logger.isDebugEnabled()) { 
   logger.debug("connecting to " + host + " with user " + username 
     + " and pwd " + password); 
} 
Connection conn = new Connection(host); 
conn.connect(); // make sure the connection is opened 
boolean isAuthenticated = conn.authenticateWithPassword(username, 
    password); 
if (isAuthenticated == false) 
   throw new IOException("Authentication failed."); 
return conn; 
} 
//执行本地的cmd命令.(DOS命令)
public static int runLocal(String cmd) throws IOException { 
if (logger.isDebugEnabled()) { 
   logger.debug("running local cmd [" + cmd + "]"); 
} 
Runtime rt = Runtime.getRuntime(); 
Process p = rt.exec(cmd); 
InputStream stdout = new StreamGobbler(p.getInputStream()); 
BufferedReader br = new BufferedReader(new InputStreamReader(stdout)); 
while (true) { 
   String line = br.readLine(); 
   if (line == null) 
    break; 
   if (logger.isDebugEnabled()) { 
    logger.debug(line); 
   } 
} 
return p.exitValue(); 
} 
}