libssh 是一个支持 SSH 协议，并且同时提供 SFTP 客户端与服务器端功能的 C 语言库。

这意味着你既可以使用 libssh 编写程序来连接远程 SFTP 服务器（客户端），也可以用它来构建一个提供 SFTP 服务的程序（服务器端）。

1、核心功能与特点

• 双向支持：libssh 库允许你在应用程序中实现 SFTP 的客户端功能（如连接服务器、上传下载文件）和服务器端功能（如接收连接、处理文件请求

  
  

• 安全保障：由于 SFTP 基于 SSH 协议，libssh 能够确保数据在传输过程中的加密，有效防止窃听和篡改，保障了传输的安全性和可靠性。

  
  

• 功能集成：除了基础的 SFTP 文件传输，libssh 通常还支持安全的远程命令执行、端口转发等 SSH 协议的其他功能。

2、使用场景与常见问题

• 典型应用场景：libssh 适用于需要安全远程操作的场景，例如自动化运维、云服务实例的远程配置管理、安全文件传输以及通过 SSH 隧道进行的应用程序安全访问等。

  
  

• SFTP 会话挂起问题：在使用 libssh 创建 SFTP 会话时，如果遇到会话挂起的情况，可能的原因包括网络连接不稳定、认证信息错误（如用户名、密码或 SSH 密钥不匹配）、

  服务器端 SSH 服务配置有误或服务器资源不足等，排查时可从这些方面着手。

3、简单代码示例

下面的 C 代码片段展示了使用 libssh 建立 SSH 连接并初始化一个 SFTP 会话的基本流程。

客户端用例：

#include <libssh/libssh.h>
#include <libssh/sftp.h>
 
int main() {
    ssh_session my_ssh_session;
    sftp_session sftp;
    int rc;
 
    // 创建 SSH 会话
    my_ssh_session = ssh_new();
    if (my_ssh_session == NULL) {
        return -1;
    }
 
    // 设置连接选项，如主机和用户名
    ssh_options_set(my_ssh_session, SSH_OPTIONS_HOST, "example.com");
    ssh_options_set(my_ssh_session, SSH_OPTIONS_USER, "your_username");
 
    // 连接到 SSH 服务器
    rc = ssh_connect(my_ssh_session);
    if (rc != SSH_OK) {
        ssh_free(my_ssh_session);
        return -1;
    }
 
    // 进行用户认证（此处示例为公钥认证）
    rc = ssh_userauth_publickey_auto(my_ssh_session, NULL, NULL);
    if (rc != SSH_AUTH_SUCCESS) {
        ssh_disconnect(my_ssh_session);
        ssh_free(my_ssh_session);
        return -1;
    }
 
    // 创建 SFTP 会话
    sftp = sftp_new(my_ssh_session);
    if (sftp == NULL) {
        ssh_disconnect(my_ssh_session);
        ssh_free(my_ssh_session);
        return -1;
    }
 
    // 初始化 SFTP 会话
    rc = sftp_init(sftp);
    if (rc != SSH_OK) {
        sftp_free(sftp);
        ssh_disconnect(my_ssh_session);
        ssh_free(my_ssh_session);
        return -1;
    }
 
    // ... 此处可以进行具体的 SFTP 操作，如文件传输 ...
 file = sftp_open(sftp, REMOTE_FILE, O_RDONLY, 0);
    if (file == NULL) {
        sftp_free(sftp);
        ssh_disconnect(my_ssh_session);
        ssh_free(my_ssh_session);
        return -1;
    }
 
// 创建本地文件
local_file = fopen(LOCAL_FILE, "wb");
    if (local_file == NULL) {
         sftp_free(sftp);
        ssh_disconnect(my_ssh_session);
        ssh_free(my_ssh_session);
        return -1;
    }
 
//SFTP传输文件
while ((nbytes = sftp_read(file, buffer, sizeof(buffer))) > 0) {
        nwritten = fwrite(buffer, 1, nbytes, local_file);
        if (nwritten != nbytes) {
            fprintf(stderr, "Write error: %s\n", strerror(errno));
            fclose(local_file);
            sftp_close(file);
 
             sftp_free(sftp);
             ssh_disconnect(my_ssh_session);
             ssh_free(my_ssh_session);
            return -1;
        }
        LOGM("write: %d bytes", nwritten);
        fflush(stdout);
    }
 
// SFTP关闭文件
   fclose(local_file);
    sftp_close(file);
 
    // 清理资源
    sftp_free(sftp);
    ssh_disconnect(my_ssh_session);
    ssh_free(my_ssh_session);
 
    return 0;
}

参考文章：原文链接​