快捷導(dǎo)航

Java實現(xiàn)遠程執(zhí)行Shell指令

更新時間：2025年08月28日 16:12:55 作者：Jeremy_Lee123

文章介紹使用JSch在SpringBoot項目中實現(xiàn)遠程Shell操作,涵蓋環(huán)境配置、依賴引入及工具類編寫,詳解分號和雙與號執(zhí)行多指令的區(qū)別

軟硬件環(huán)境說明

Windows10
IntelliJ IDEA
SpringBoot 2.1.4.RELEASE
CentOS7

在pom.xml中引入JSch依賴

<!-- https://mvnrepository.com/artifact/com.jcraft/jsch -->
<dependency>
    <groupId>com.jcraft</groupId>
    <artifactId>jsch</artifactId>
    <version>0.1.55</version>
</dependency>

編寫執(zhí)行Shell指令的工具類

package com.lxk.aisware.util;

import com.jcraft.jsch.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
import java.util.Properties;

/**
 * 執(zhí)行Shell工具類
 *
 */
public class ExecuteShellUtil {

    private static final Logger LOGGER = LoggerFactory.getLogger(ExecuteShellUtil.class);

    /** 未調(diào)用初始化方法 錯誤提示信息 */
    private static final String DONOT_INIT_ERROR_MSG = "please invoke init(...) first!";

    private Session session;

    private Channel channel;

    private ChannelExec channelExec;

    private ExecuteShellUtil() {
    }

    /**
     * 獲取ExecuteShellUtil類實例對象
     *
     */
    public static ExecuteShellUtil getInstance() {
        return new ExecuteShellUtil();
    }

    /**
     * 初始化
     *
     * @param ip
     *         遠程Linux地址
     * @param port
     *         端口
     * @param username
     *         用戶名
     * @param password
     *         密碼
     * @throws JSchException
     *         JSch異常
     */
    public void init(String ip, Integer port, String username, String password) throws JSchException {
        JSch jsch = new JSch();
        jsch.getSession(username, ip, port);
        session = jsch.getSession(username, ip, port);
        session.setPassword(password);
        Properties sshConfig = new Properties();
        sshConfig.put("StrictHostKeyChecking", "no");
        session.setConfig(sshConfig);
        session.connect(60 * 1000);
        LOGGER.info("Session connected!");
        // 打開執(zhí)行shell指令的通道
        channel = session.openChannel("exec");
        channelExec = (ChannelExec) channel;
    }

    /**
     * 執(zhí)行一條命令
     */
    public String execCmd(String command) throws Exception {
        if (session == null || channel == null || channelExec == null) {
            throw new Exception(DONOT_INIT_ERROR_MSG);
        }
        LOGGER.info("execCmd command - > {}", command);
        channelExec.setCommand(command);
        channel.setInputStream(null);
        channelExec.setErrStream(System.err);
        channel.connect();
        StringBuilder sb = new StringBuilder(16);
        try (InputStream in = channelExec.getInputStream();
             InputStreamReader isr = new InputStreamReader(in, StandardCharsets.UTF_8);
             BufferedReader reader = new BufferedReader(isr)) {
            String buffer;
            while ((buffer = reader.readLine()) != null) {
                sb.append("\n").append(buffer);
            }
        }catch (Exception  e){
            LOGGER.info("execCmd result failed- > {}",e.toString());
        }finally {
            // 釋放資源
            close();
        }

        LOGGER.info("execCmd result succeed- > {}", sb.toString());
        return sb.toString();
    }

    /**
     * 釋放資源
     *
     * @date 2019/3/15 12:47
     */
    private void close() {
        if (channelExec != null && channelExec.isConnected()) {
            channelExec.disconnect();
        }
        if (channel != null && channel.isConnected()) {
            channel.disconnect();
        }
        if (session != null && session.isConnected()) {
            session.disconnect();
        }
    }
}

注：

如果要執(zhí)行多個指令，可以多次調(diào)用工具類，也可以像使用多指令shell一樣，使用【;】或【&&】等符號將多個指令隔開。

追注：

1、【;】隔開的多個shell命令，會按照順序執(zhí)行下來，但是不能保證每條命令都執(zhí)行成功。

2、【&&】隔開的多個shell命令，前面的命令執(zhí)行成功，才會執(zhí)行后面的命令，否則后面的命令不執(zhí)行。

3、將多指令隔開的符號，上面給出的只是最常用的兩種，更多功能的符號可自行查閱相關(guān)資料。