Java利用JSch实现SSH远程操作的技术指南
更新时间：2025年03月13日 08:27:04 作者：拾荒的小海螺
在日常开发中,许多应用需要通过 SSH 协议远程连接服务器来执行命令、上传或下载文件,JSch是一个功能强大的 Java 库,它提供了便捷的接口来实现 SSH 连接和其他远程管理功能,本文将介绍 JSch 的基本功能,并通过实际代码示例帮助您快速上手,需要的朋友可以参考下
1、简述
在日常开发中，许多应用需要通过 SSH 协议远程连接服务器来执行命令、上传或下载文件。JSch (Java Secure Channel) 是一个功能强大的 Java 库，它提供了便捷的接口来实现 SSH 连接、SFTP 文件传输和其他远程管理功能。
2、核心功能
- SSH 远程命令执行：通过 SSH 协议在远程服务器上运行命令。
- SFTP 文件传输：支持上传和下载文件。
- 端口转发：支持本地端口和远程端口转发。
- 密钥登录：支持通过密码和私钥进行认证。
在使用 JSch 之前，需要添加其依赖。以下是 JSch 的 Maven 依赖：
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch</artifactId>
<version>0.1.55</version>
</dependency>
3、使用实例
3.1 远程执行命令
以下代码展示如何通过 SSH 连接到远程服务器并执行命令：
import com.jcraft.jsch.ChannelExec;
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
import java.io.InputStream;
public class JSchExecExample {
public static void main(String[] args) {
String host = "your-server-ip";
String user = "your-username";
String password = "your-password";
try {
JSch jsch = new JSch();
Session session = jsch.getSession(user, host, 22);
session.setPassword(password);
// 忽略主机密钥检查
session.setConfig("StrictHostKeyChecking", "no");
session.connect();
// 打开执行命令的通道
ChannelExec channel = (ChannelExec) session.openChannel("exec");
channel.setCommand("ls -l");
// 获取命令输出
InputStream inputStream = channel.getInputStream();
channel.connect();
byte[] tmp = new byte[1024];
while (inputStream.read(tmp) != -1) {
System.out.print(new String(tmp));
}
channel.disconnect();
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
3.2 上传文件到远程服务器 (SFTP)
以下代码展示如何通过 SFTP 上传文件：
import com.jcraft.jsch.ChannelSftp;
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
public class JSchSFTPUploadExample {
public static void main(String[] args) {
String host = "your-server-ip";
String user = "your-username";
String password = "your-password";
String localFile = "/path/to/local/file.txt";
String remoteDir = "/path/to/remote/dir/";
try {
JSch jsch = new JSch();
Session session = jsch.getSession(user, host, 22);
session.setPassword(password);
// 忽略主机密钥检查
session.setConfig("StrictHostKeyChecking", "no");
session.connect();
// 打开 SFTP 通道
ChannelSftp channel = (ChannelSftp) session.openChannel("sftp");
channel.connect();
// 上传文件
channel.put(localFile, remoteDir);
System.out.println("File uploaded successfully!");
channel.disconnect();
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
3.3 下载文件到本地 (SFTP)
import com.jcraft.jsch.ChannelSftp;
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
public class JSchSFTPDownloadExample {
public static void main(String[] args) {
String host = "your-server-ip";
String user = "your-username";
String password = "your-password";
String remoteFile = "/path/to/remote/file.txt";
String localDir = "/path/to/local/dir/";
try {
JSch jsch = new JSch();
Session session = jsch.getSession(user, host, 22);
session.setPassword(password);
// 忽略主机密钥检查
session.setConfig("StrictHostKeyChecking", "no");
session.connect();
// 打开 SFTP 通道
ChannelSftp channel = (ChannelSftp) session.openChannel("sftp");
channel.connect();
// 下载文件
channel.get(remoteFile, localDir);
System.out.println("File downloaded successfully!");
channel.disconnect();
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
3.4 使用私钥进行认证
如果需要使用私钥而不是密码进行认证，可以如下设置：
import com.jcraft.jsch.ChannelExec;
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
import java.io.InputStream;
public class JSchPrivateKeyExample {
public static void main(String[] args) {
String host = "your-server-ip";
String user = "your-username";
String privateKey = "/path/to/private/key";
try {
JSch jsch = new JSch();
jsch.addIdentity(privateKey);
Session session = jsch.getSession(user, host, 22);
session.setConfig("StrictHostKeyChecking", "no");
session.connect();
ChannelExec channel = (ChannelExec) session.openChannel("exec");
channel.setCommand("ls -l");
InputStream inputStream = channel.getInputStream();
channel.connect();
byte[] tmp = new byte[1024];
while (inputStream.read(tmp) != -1) {
System.out.print(new String(tmp));
}
channel.disconnect();
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
3.5 本地端口转发
通过 JSch 实现本地端口转发，可以让本地端口访问远程服务：
import com.jcraft.jsch.JSch;
import com.jcraft.jsch.Session;
public class JSchPortForwarding {
public static void main(String[] args) {
String host = "your-server-ip";
String user = "your-username";
String password = "your-password";
try {
JSch jsch = new JSch();
Session session = jsch.getSession(user, host, 22);
session.setPassword(password);
session.setConfig("StrictHostKeyChecking", "no");
session.connect();
// 设置本地端口转发
int assignedPort = session.setPortForwardingL(8888, "localhost", 8080);
System.out.println("Local port forwarding: localhost:" + assignedPort + " -> localhost:8080");
// 保持连接
Thread.sleep(60000);
session.disconnect();
} catch (Exception e) {
e.printStackTrace();
}
}
}
4、总结
以上JSch常见的使用样例，JSch常见的使用场景是自动化远程管理、文件传输、构建SSH隧道等。以下是JSch 的优势：
- 轻量级：单个 JAR 包即可使用。
- 功能丰富：支持 SSH、SFTP、端口转发等多种功能。
- 开源免费：无额外成本。
到此这篇关于Java利用JSch实现SSH远程操作的技术指南的文章就介绍到这了,更多相关Java JSch SSH远程操作内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了IDEA关联数据库的相关知识，本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2021-03-03
SpringBoot结合Thymeleaf模板引擎,可以快速搭建Web应用,介绍了使用SpringBoot处理JSON数据的基本过程,包括创建实体类、视图页面和控制器,通过这些步骤,即可完成基于SpringBoot和Thymeleaf的简单Web开发,感兴趣的朋友跟随小编一起看看吧2024-09-09
这篇文章主要为大家详细介绍了Java日期时间，以及日期相互转换的方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-10-10
用于restful的app应用无状态无sesion登录示例,需要的朋友可以参考下2014-02-02
这篇文章主要介绍了基于Spring AOP实现日志自动打印功能,文中通过代码示例讲解的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下2025-01-01
本篇文章是关于ava构造方法Vector源码分析系列文章，本文主要介绍了Vector查找元素的源码分析，有需要的朋友可以借鉴参考下，希望可以有所帮助2021-09-09
这篇文章主要介绍了关于Java继承中父类和子类构造函数的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-10-10
使用Java和SpringBoot实现服务器发送事件(Server-Sent Events)
使用Java开发web应用,大多数时候我们提供的接口返回数据都是一次性完整返回,有些时候,我们也需要提供流式接口持续写出数据,以下提供一种简单的方式,本文给大家介绍了如何在Java web中实现服务器发送事件,需要的朋友可以参考下2024-02-02
这篇文章主要为大家详细介绍了Spring boot多线程配置方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-10-10
web开发阶段我们主要是浏览器和服务器之间来进行交互。浏览器和服务器之间的交互就像人和人之间进行交流一样，但是对于机器来说，在一次请求之间只是会携带着本次请求的数据的，但是可能多次请求之间是会有联系的，所以提供了会话机制2022-11-11
最新评论