快捷導(dǎo)航

Java利用JSch實(shí)現(xiàn)SSH遠(yuǎn)程操作的技術(shù)指南

更新時(shí)間：2025年03月13日 08:27:04 作者：拾荒的小海螺

在日常開發(fā)中,許多應(yīng)用需要通過 SSH 協(xié)議遠(yuǎn)程連接服務(wù)器來執(zhí)行命令、上傳或下載文件,JSch是一個(gè)功能強(qiáng)大的 Java 庫,它提供了便捷的接口來實(shí)現(xiàn) SSH 連接和其他遠(yuǎn)程管理功能,本文將介紹 JSch 的基本功能,并通過實(shí)際代碼示例幫助您快速上手,需要的朋友可以參考下

1、簡(jiǎn)述

在日常開發(fā)中，許多應(yīng)用需要通過 SSH 協(xié)議遠(yuǎn)程連接服務(wù)器來執(zhí)行命令、上傳或下載文件。JSch (Java Secure Channel) 是一個(gè)功能強(qiáng)大的 Java 庫，它提供了便捷的接口來實(shí)現(xiàn) SSH 連接、SFTP 文件傳輸和其他遠(yuǎn)程管理功能。

2、核心功能

SSH 遠(yuǎn)程命令執(zhí)行：通過 SSH 協(xié)議在遠(yuǎn)程服務(wù)器上運(yùn)行命令。
SFTP 文件傳輸：支持上傳和下載文件。
端口轉(zhuǎn)發(fā)：支持本地端口和遠(yuǎn)程端口轉(zhuǎn)發(fā)。
密鑰登錄：支持通過密碼和私鑰進(jìn)行認(rèn)證。

在使用 JSch 之前，需要添加其依賴。以下是 JSch 的 Maven 依賴：

<dependency>
    <groupId>com.jcraft</groupId>
    <artifactId>jsch</artifactId>
    <version>0.1.55</version>
</dependency>

3、使用實(shí)例

3.1 遠(yuǎn)程執(zhí)行命令

以下代碼展示如何通過 SSH 連接到遠(yuǎn)程服務(wù)器并執(zhí)行命令：

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);

            // 忽略主機(jī)密鑰檢查
            session.setConfig("StrictHostKeyChecking", "no");
            session.connect();

            // 打開執(zhí)行命令的通道
            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 上傳文件到遠(yuǎn)程服務(wù)器 (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);

            // 忽略主機(jī)密鑰檢查
            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);

            // 忽略主機(jī)密鑰檢查
            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 使用私鑰進(jìn)行認(rèn)證

如果需要使用私鑰而不是密碼進(jìn)行認(rèn)證，可以如下設(shè)置：

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 本地端口轉(zhuǎn)發(fā)

通過 JSch 實(shí)現(xiàn)本地端口轉(zhuǎn)發(fā)，可以讓本地端口訪問遠(yuǎn)程服務(wù)：

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();

            // 設(shè)置本地端口轉(zhuǎn)發(fā)
            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、總結(jié)

以上JSch常見的使用樣例，JSch常見的使用場(chǎng)景是自動(dòng)化遠(yuǎn)程管理、文件傳輸、構(gòu)建SSH隧道等。以下是JSch 的優(yōu)勢(shì)：

輕量級(jí)：?jiǎn)蝹€(gè) JAR 包即可使用。
功能豐富：支持 SSH、SFTP、端口轉(zhuǎn)發(fā)等多種功能。
開源免費(fèi)：無額外成本。

到此這篇關(guān)于Java利用JSch實(shí)現(xiàn)SSH遠(yuǎn)程操作的技術(shù)指南的文章就介紹到這了,更多相關(guān)Java JSch SSH遠(yuǎn)程操作內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: