如何用C++通过SSH远程执行Docker Compose命令且避免阻塞与输出

1. 快速改法：基于Shell命令实现无阻塞静默执行 #

如果不想大幅修改现有代码，可以通过调整SSH命令和本地进程创建方式解决问题：

#include <unistd.h>
#include <sys/wait.h>

// ...

std::string ssh_cmd = "ssh user@198.126.0.0 'nohup docker compose -f /home/user/analysis.yml up system > /dev/null 2>&1 &'";

// 用fork+exec替代std::system，避免主进程阻塞
pid_t pid = fork();
if (pid == 0) {
    // 子进程中关闭标准输出/错误，避免干扰主进程终端
    close(STDOUT_FILENO);
    close(STDERR_FILENO);
    // 执行shell命令
    execl("/bin/bash", "bash", "-c", ssh_cmd.c_str(), nullptr);
    // 只有execl失败才会走到这里
    _exit(EXIT_FAILURE);
} else if (pid < 0) {
    std::cerr << "创建子进程失败" << std::endl;
}
// 主进程无需等待子进程，直接继续执行后续逻辑

关键细节：

• 远程命令用nohup ... &让Docker Compose在B后台运行，即使SSH连接断开也不会终止任务
• > /dev/null 2>&1把远程命令的标准输出和错误输出全部丢弃，不会传到A的终端
• 本地用fork+exec替代std::system，主进程不需要等待SSH命令完成，实现非阻塞

2. 长期优雅方案：使用libssh库直接操作SSH #

如果未来要扩展更多SSH相关任务，推荐用C++的libssh库，它能直接建立SSH连接、执行远程命令，完全摆脱对系统shell的依赖，安全性和可控性更高。

示例代码（异步执行模式）：

#include <libssh/libssh.h>
#include <thread>
#include <iostream>

void run_remote_task(const std::string& host, const std::string& user, const std::string& task_cmd) {
    ssh_session session = ssh_new();
    if (!session) {
        std::cerr << "无法创建SSH会话" << std::endl;
        return;
    }

    // 配置SSH连接参数
    ssh_options_set(session, SSH_OPTIONS_HOST, host.c_str());
    ssh_options_set(session, SSH_OPTIONS_USER, user.c_str());

    // 建立连接
    int rc = ssh_connect(session);
    if (rc != SSH_OK) {
        std::cerr << "SSH连接失败: " << ssh_get_error(session) << std::endl;
        ssh_free(session);
        return;
    }

    // 用公钥免密登录（推荐，避免硬编码密码）
    rc = ssh_userauth_publickey_auto(session, nullptr, nullptr);
    if (rc != SSH_OK) {
        std::cerr << "身份验证失败: " << ssh_get_error(session) << std::endl;
        ssh_disconnect(session);
        ssh_free(session);
        return;
    }

    // 构造静默后台执行的命令
    std::string silent_cmd = "nohup " + task_cmd + " > /dev/null 2>&1 &";
    ssh_channel channel = ssh_channel_new(session);
    if (!channel) {
        std::cerr << "无法创建SSH通道" << std::endl;
        ssh_disconnect(session);
        ssh_free(session);
        return;
    }

    rc = ssh_channel_open_session(channel);
    if (rc != SSH_OK) {
        std::cerr << "无法打开会话: " << ssh_get_error(session) << std::endl;
        ssh_channel_free(channel);
        ssh_disconnect(session);
        ssh_free(session);
        return;
    }

    rc = ssh_channel_request_exec(channel, silent_cmd.c_str());
    if (rc != SSH_OK) {
        std::cerr << "执行远程命令失败: " << ssh_get_error(session) << std::endl;
    }

    // 关闭通道和连接，无需等待任务完成
    ssh_channel_send_eof(channel);
    ssh_channel_close(channel);
    ssh_channel_free(channel);
    ssh_disconnect(session);
    ssh_free(session);
}

int main() {
    std::string docker_cmd = "docker compose -f /home/user/analysis.yml up system";
    // 启动独立线程执行远程任务，主进程不阻塞
    std::thread remote_thread(run_remote_task, "198.126.0.0", "user", docker_cmd);
    remote_thread.detach(); // 分离线程，主进程无需等待其结束

    // 主进程后续业务逻辑
    return 0;
}

该方案优势： #

• 无shell依赖，避免shell注入安全风险
• 可灵活配置SSH连接细节（超时、密钥、代理等）
• 方便扩展其他SSH操作（如文件上传下载、交互式shell）
• 完全掌控输出流向，可根据需求将远程日志写入B的本地文件而非丢弃

3. 额外优化建议 #

• 配置免密登录：务必给A配置到B的SSH公钥免密登录，既提升安全性，又避免代码中处理密码
• 保留日志：如果需要排查问题，可以把远程命令的输出重定向到B的日志文件（如> /var/log/docker_compose_$(date +%Y%m%d).log 2>&1），而非直接丢弃
• 状态校验：如果需要确认任务是否成功启动，可后续通过SSH远程检查容器状态，或者让B的任务完成后主动回调A的接口

内容的提问来源于stack exchange，提问作者Oroshimaru