curl文件传输专家：FTP、SFTP、SCP协议的深度应用

原创 于 2025-08-28 18:41:33 发布 · 1k 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

curl文件传输专家：FTP、SFTP、SCP协议的深度应用

【免费下载链接】curl "libcurl 是一个命令行工具和库，它使用URL语法进行数据传输，并支持多种协议，包括DICT、FILE、FTP、FTPS、GOPHER、GOPHERS、HTTP、HTTPS、IMAP、IMAPS、LDAP、LDAPS、MQTT、POP3、POP3S、RTMP、RTMPS、RTSP、SCP、SFTP、SMB、SMBS、SMTP、SMTPS、TELNET、TFTP、WS和WSS。libcurl提供了众多强大的功能。 【免费下载链接】curl 项目地址: https://gitcode.com/GitHub_Trending/cu/curl

引言：为什么选择curl进行文件传输？

在日常开发和系统管理中，文件传输是必不可少的需求。无论是自动化部署、数据备份还是远程文件管理，都需要可靠的文件传输工具。curl作为一款强大的命令行工具和库，支持超过25种协议，其中FTP、SFTP和SCP是文件传输领域的三大利器。

读完本文，你将掌握：

  • curl支持的文件传输协议详解
  • 三种协议的安全性和适用场景对比
  • 完整的代码示例和最佳实践
  • 高级功能如断点续传、大文件处理
  • 常见问题排查和性能优化技巧

协议对比：选择合适的传输方案

协议安全性端口认证方式适用场景
FTP明文传输21用户名/密码内网环境、测试环境
FTPSSSL/TLS加密990用户名/密码+证书企业级文件传输
SFTPSSH加密22密钥/密码安全要求高的场景
SCPSSH加密22密钥/密码简单快速的文件复制

FTP协议深度应用

基础文件下载

#include <stdio.h>
#include <curl/curl.h>

struct FtpFile {
  const char *filename;
  FILE *stream;
};

static size_t write_callback(void *buffer, size_t size, size_t nmemb, void *stream)
{
  struct FtpFile *out = (struct FtpFile *)stream;
  if(!out->stream) {
    out->stream = fopen(out->filename, "wb");
    if(!out->stream) return 0;
  }
  return fwrite(buffer, size, nmemb, out->stream);
}

int main(void)
{
  CURL *curl;
  CURLcode res;
  struct FtpFile ftpfile = {"download.tar.gz", NULL};

  curl_global_init(CURL_GLOBAL_DEFAULT);
  curl = curl_easy_init();
  
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/file.tar.gz");
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &ftpfile);
    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

    res = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }

  if(ftpfile.stream) fclose(ftpfile.stream);
  curl_global_cleanup();
  return 0;
}

高级文件上传与重命名

#include <stdio.h>
#include <curl/curl.h>

#define LOCAL_FILE "/data/upload.txt"
#define REMOTE_URL "ftp://user:pass@ftp.example.com/temp.txt"
#define RENAME_TO "final.txt"

int main(void)
{
  CURL *curl;
  FILE *hd_src;
  struct curl_slist *headerlist = NULL;
  
  // FTP重命名命令
  headerlist = curl_slist_append(headerlist, "RNFR temp.txt");
  headerlist = curl_slist_append(headerlist, "RNTO final.txt");

  hd_src = fopen(LOCAL_FILE, "rb");
  curl_global_init(CURL_GLOBAL_ALL);
  
  curl = curl_easy_init();
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
    curl_easy_setopt(curl, CURLOPT_URL, REMOTE_URL);
    curl_easy_setopt(curl, CURLOPT_READDATA, hd_src);
    curl_easy_setopt(curl, CURLOPT_POSTQUOTE, headerlist);
    
    // 设置文件大小
    fseek(hd_src, 0, SEEK_END);
    long fsize = ftell(hd_src);
    fseek(hd_src, 0, SEEK_SET);
    curl_easy_setopt(curl, CURLOPT_INFILESIZE, fsize);

    curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
  
  fclose(hd_src);
  curl_slist_free_all(headerlist);
  curl_global_cleanup();
  return 0;
}

SFTP协议安全传输

基础SFTP下载

#include <stdio.h>
#include <curl/curl.h>

struct FtpFile {
  const char *filename;
  FILE *stream;
};

static size_t write_callback(void *buffer, size_t size, size_t nmemb, void *stream)
{
  struct FtpFile *out = (struct FtpFile *)stream;
  if(!out->stream) {
    out->stream = fopen(out->filename, "wb");
    if(!out->stream) return 0;
  }
  return fwrite(buffer, size, nmemb, out->stream);
}

int main(void)
{
  CURL *curl;
  CURLcode res;
  struct FtpFile ftpfile = {"backup.tar", NULL};

  curl_global_init(CURL_GLOBAL_DEFAULT);
  curl = curl_easy_init();
  
  if(curl) {
    // SFTP URL格式: sftp://user@hostname/path/file
    curl_easy_setopt(curl, CURLOPT_URL, "sftp://user@example.com/backups/data.tar");
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &ftpfile);
    
    // 使用SSH代理认证
    curl_easy_setopt(curl, CURLOPT_SSH_AUTH_TYPES, CURLSSH_AUTH_AGENT);
    curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

    res = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }

  if(ftpfile.stream) fclose(ftpfile.stream);
  curl_global_cleanup();
  return 0;
}

带密钥认证的SFTP

// 设置SSH私钥认证
curl_easy_setopt(curl, CURLOPT_SSH_PRIVATE_KEYFILE, "/home/user/.ssh/id_rsa");
curl_easy_setopt(curl, CURLOPT_SSH_PUBLIC_KEYFILE, "/home/user/.ssh/id_rsa.pub");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "your_key_passphrase");

// 或者使用已知主机文件
curl_easy_setopt(curl, CURLOPT_SSH_KNOWNHOSTS, "/home/user/.ssh/known_hosts");

SCP协议快速传输

虽然curl主要使用SFTP协议进行SSH文件传输，但SCP模式也可以通过特定配置实现：

// 使用SCP风格的传输（通过SFTP协议模拟）
curl_easy_setopt(curl, CURLOPT_SSH_AUTH_TYPES, CURLSSH_AUTH_PASSWORD);
curl_easy_setopt(curl, CURLOPT_USERPWD, "user:password");

// 对于SCP，需要确保服务器支持SFTP协议

安全传输：FTPS配置

// 显式FTPS（推荐）
curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_ALL);

// 隐式FTPS
curl_easy_setopt(curl, CURLOPT_URL, "ftps://ftp.example.com/file.txt");

// SSL/TLS证书验证
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);
curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/cacert.pem");

高级功能实现

断点续传支持

// 获取远程文件大小
curl_off_t remote_size;
curl_easy_setopt(curl, CURLOPT_NOBODY, 1L);
curl_easy_perform(curl);
curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T, &remote_size);

// 设置断点续传
FILE *fp = fopen("local_file", "ab");
fseek(fp, 0, SEEK_END);
long local_size = ftell(fp);
curl_easy_setopt(curl, CURLOPT_RESUME_FROM_LARGE, (curl_off_t)local_size);

大文件分块传输

mermaid

进度回调函数

static int progress_callback(void *clientp, curl_off_t dltotal, 
                           curl_off_t dlnow, curl_off_t ultotal, curl_off_t ulnow)
{
  if(dltotal > 0) {
    double percent = (double)dlnow / dltotal * 100;
    printf("\r下载进度: %.2f%%", percent);
    fflush(stdout);
  }
  return 0;
}

// 设置进度回调
curl_easy_setopt(curl, CURLOPT_XFERINFOFUNCTION, progress_callback);
curl_easy_setopt(curl, CURLOPT_XFERINFODATA, NULL);
curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);

实战：完整的自动化备份脚本

#include <stdio.h>
#include <curl/curl.h>
#include <time.h>

void backup_to_ftp(const char *local_file, const char *remote_url) 
{
    CURL *curl;
    FILE *src_file;
    char timestamp[50];
    time_t now = time(NULL);
    
    // 添加时间戳到远程文件名
    struct tm *t = localtime(&now);
    strftime(timestamp, sizeof(timestamp), "%Y%m%d_%H%M%S", t);
    
    char final_url[256];
    snprintf(final_url, sizeof(final_url), "%s_%s", remote_url, timestamp);
    
    src_file = fopen(local_file, "rb");
    if(!src_file) {
        perror("无法打开本地文件");
        return;
    }
    
    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();
    
    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, final_url);
        curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
        curl_easy_setopt(curl, CURLOPT_READDATA, src_file);
        
        // 获取文件大小
        fseek(src_file, 0, SEEK_END);
        long fsize = ftell(src_file);
        fseek(src_file, 0, SEEK_SET);
        curl_easy_setopt(curl, CURLOPT_INFILESIZE, fsize);
        
        // 设置超时
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L);
        
        CURLcode res = curl_easy_perform(curl);
        if(res != CURLE_OK) {
            fprintf(stderr, "传输失败: %s\n", curl_easy_strerror(res));
        } else {
            printf("备份成功: %s\n", final_url);
        }
        
        curl_easy_cleanup(curl);
    }
    
    fclose(src_file);
    curl_global_cleanup();
}

int main() {
    backup_to_ftp("/data/important.db", "ftp://backup:password@backup.example.com/db_backup");
    return 0;
}

性能优化与故障排除

连接池优化

// 启用连接复用
curl_easy_setopt(curl, CURLOPT_FRESH_CONNECT, 0L);
curl_easy_setopt(curl, CURLOPT_FORBID_REUSE, 0L);

// 设置最大连接时间
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 30L);

// 启用TCP保活
curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);
curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);
curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);

常见错误处理

CURLcode res = curl_easy_perform(curl);
if(res != CURLE_OK) {
    switch(res) {
        case CURLE_COULDNT_CONNECT:
            printf("无法连接到服务器\n");
            break;
        case CURLE_REMOTE_ACCESS_DENIED:
            printf("认证失败\n");
            break;
        case CURLE_REMOTE_FILE_NOT_FOUND:
            printf("远程文件不存在\n");
            break;
        case CURLE_WRITE_ERROR:
            printf("写入本地文件失败\n");
            break;
        default:
            printf("错误: %s\n", curl_easy_strerror(res));
    }
}

安全最佳实践

  1. 认证安全

    • 避免在URL中直接包含密码
    • 使用密钥认证代替密码认证
    • 定期轮换凭据

  2. 传输安全

    • 优先使用SFTP/FTPS而不是FTP
    • 验证服务器证书
    • 使用强加密算法

  3. 网络安全

【免费下载链接】curl "libcurl 是一个命令行工具和库，它使用URL语法进行数据传输，并支持多种协议，包括DICT、FILE、FTP、FTPS、GOPHER、GOPHERS、HTTP、HTTPS、IMAP、IMAPS、LDAP、LDAPS、MQTT、POP3、POP3S、RTMP、RTMPS、RTSP、SCP、SFTP、SMB、SMBS、SMTP、SMTPS、TELNET、TFTP、WS和WSS。libcurl提供了众多强大的功能。 【免费下载链接】curl 项目地址: https://gitcode.com/GitHub_Trending/cu/curl

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值