在企业自动化运维、远程部署、文件管理等场景下，Java 程序往往需要与 Linux 服务器进行 

，演示如何用 Java 完整实现 SSH 登录、文件上传及命令执行，并带超时保护与异步输出处理。

在传统的 Java 项目中，我们可能会通过 

 调用远程命令，但这种方式有以下问题：

（Java Secure Channel）库，可以轻松解决以上问题：

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

为了支持异步执行和超时控制，我们使用线程池：

private static final ExecutorService EXECUTOR = Executors.newFixedThreadPool(4);

public static Session createSession(String host, int port, String username, String privateKeyPath) throws Exception {
    JSch jsch = new JSch();
​
    // 加载私钥
    jsch.addIdentity(privateKeyPath);
​
    // 创建 Session
    Session session = jsch.getSession(username, host, port);
    Properties config = new Properties();
    config.put("StrictHostKeyChecking", "no"); // 避免首次连接提示 yes/no
    session.setConfig(config);
​
    // 连接，超时 5 秒
    session.connect(5000);
​
    return session;
}

public static void uploadFileToRemote(Session session, String content, String remotePath) throws Exception {
    Future<Void> future = EXECUTOR.submit(() -> {
        ChannelSftp sftp = null;
        try {
            sftp = (ChannelSftp) session.openChannel("sftp");
            sftp.connect();
            try (InputStream is = new ByteArrayInputStream(content.getBytes(StandardCharsets.UTF_8))) {
                sftp.put(is, remotePath);
            }
        } finally {
            if (sftp != null && sftp.isConnected()) {
                sftp.disconnect();
            }
        }
        return null;
    });
​
    // 等待上传完成，带超时 5 秒
    future.get(5000, TimeUnit.MILLISECONDS);
}

3.4 异步执行远程命令并返回输出

public static String runRemoteCommandAsync(Session session, List<String> command, long timeout, TimeUnit unit, String logPrefix) throws Exception {
    String cmd = command.stream()
            .map(s -> s.replace("\"", "\\\""))
            .map(s -> s.contains(" ") ? "\"" + s + "\"" : s)
            .collect(Collectors.joining(" "));
​
    ChannelExec channel = null;
    try {
        channel = (ChannelExec) session.openChannel("exec");
        channel.setCommand(cmd);
        channel.setInputStream(null);
        InputStream in = channel.getInputStream();
        InputStream err = channel.getErrStream();
        channel.connect();
​
        StringBuilder outputBuilder = new StringBuilder();
​
        Future<?> stdoutFuture = EXECUTOR.submit(() -> {
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(in, StandardCharsets.UTF_8))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    System.out.println(logPrefix + " " + line);
                    outputBuilder.append(line).append(System.lineSeparator());
                }
            } catch (IOException e) {
                System.err.println(logPrefix + " stdout读取异常: " + e.getMessage());
            }
        });
​
        Future<?> stderrFuture = EXECUTOR.submit(() -> {
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(err, StandardCharsets.UTF_8))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    System.err.println(logPrefix + " " + line);
                    outputBuilder.append(line).append(System.lineSeparator());
                }
            } catch (IOException e) {
                System.err.println(logPrefix + " stderr读取异常: " + e.getMessage());
            }
        });
​
        long timeoutMillis = unit.toMillis(timeout);
        long startTime = System.currentTimeMillis();
        while (!channel.isClosed()) {
            if (System.currentTimeMillis() - startTime > timeoutMillis) {
                channel.disconnect();
                throw new TimeoutException(logPrefix + " 命令超时");
            }
            Thread.sleep(50);
        }
​
        stdoutFuture.get(1, TimeUnit.SECONDS);
        stderrFuture.get(1, TimeUnit.SECONDS);
​
        int exitStatus = channel.getExitStatus();
        String output = outputBuilder.toString();
​
        if (exitStatus != 0) {
            throw new IOException(logPrefix + " 执行失败，exitCode=" + exitStatus + "\n输出：" + output);
        }
​
        return output.trim();
    } finally {
        if (channel != null && !channel.isClosed()) {
            channel.disconnect();
        }
    }
}

public static void main(String[] args) throws Exception {
    String host = "172.26.***.***";
    int port = 22;
    String username = "root";
    String privateKey = "/root/.ssh/id_rsa";
​
    Session session = createSession(host, port, username, privateKey);
​
    // 上传文件
    uploadFileToRemote(session, "Hello, SSH!", "/root/hello.txt");
​
    // 执行命令
    String output = runRemoteCommandAsync(session, Arrays.asList("cat", "/root/hello.txt"), 5, TimeUnit.SECONDS, "[REMOTE]");
    System.out.println("命令输出: " + output);
​
    session.disconnect();
}

[REMOTE] Hello, SSH!
命令输出: Hello, SSH!

Java 使用 JSch 实现 SSH 与 SFTP 操作全攻略

在企业自动化运维、远程部署、文件管理等场景下，Java 程序往往需要与 Linux 服务器进行 SSH 连接、执行命令、上传文件 等操作。本文将结合 JSch 库，演示如何用 Java 完整实现 SSH 登录、文件上传及命令执行，并带超时保护与异步输出处理。

Java开发

编程语言

Java实现SSH连接Linux服务器的最佳实践：使用JSch库实现安全登录、文件上传和命令执行，支持SSH密钥认证、异步输出处理与超时控制。包含完整代码示例，解决传统Runtime.exec的局限性，提升自动化运维效率。

自动化运维

服务器

Linux

Java

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Java 使用 JSch 实现 SSH 与 SFTP 操作全攻略

Java 使用 JSch 实现 SSH 与 SFTP 操作全攻略

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐