news 2026/3/20 6:47:21

C++：FTP文件上传下载（附带源码）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
C++：FTP文件上传下载（附带源码）

项目背景详细介绍

在传统企业系统、工业控制、内网工具以及大量遗留系统中，FTP（File Transfer Protocol）依然被广泛用于文件传输任务，例如：

  • 自动化日志上传

  • 程序更新文件分发

  • 服务器配置同步

  • 内网设备文件交换

  • 嵌入式系统文件传输

尽管如今 HTTP / HTTPS 已成为主流，但在以下场景中 FTP 仍不可替代：

  • 内网环境，部署简单

  • 老系统兼容性要求高

  • 无需复杂证书配置

  • 与大量历史系统对接

对于C++ 开发者而言，掌握 FTP 文件传输能力，依然是系统工具开发、运维工具、工业软件中的重要技能。

在 Windows 平台上，微软提供了成熟稳定的WinINet API，用于：

  • HTTP / HTTPS

  • FTP

  • 代理网络访问

无需引入第三方库，即可完成 FTP 登录、上传、下载等操作，非常适合教学与工程实践。

因此，本项目将通过一个完整、可运行、工程级的 C++ 示例，系统演示：

如何使用 C++ + WinINet 实现 FTP 文件上传与下载

该项目非常适合作为 Windows 网络编程、系统工具开发、C++ 实战课程的教学案例。

项目需求详细介绍

1. 功能需求

  1. 使用 C++ 连接 FTP 服务器

  2. 支持用户名 / 密码登录

  3. 支持文件上传（PUT）

  4. 支持文件下载（GET）

  5. 支持二进制模式传输

  6. 输出关键执行步骤日志

2. 技术要求

  1. 基于 Windows 原生 WinINet API

  2. 使用 FTP 被动模式

  3. 支持 Unicode（宽字符）

  4. 不依赖任何第三方库

3. 教学与工程要求

  1. 明确区分 FTP 会话与连接

  2. 展示完整 FTP 操作流程

  3. 代码结构清晰、可复用

  4. 适合课堂逐步讲解

相关技术详细介绍

1. FTP 协议简介

FTP 是一种基于 TCP 的明文文件传输协议，主要包含：

  • 控制连接（端口 21）

  • 数据连接（主动 / 被动模式）

基本操作包括：

  • 登录（USER / PASS）

  • 上传（STOR）

  • 下载（RETR）

  • 列表（LIST）

2. WinINet API 简介

WinINet 是 Windows 提供的高层网络 API，封装了：

  • Socket 细节

  • 协议交互流程

  • 错误处理机制

常用 FTP 相关函数包括：

  • InternetOpen

  • InternetConnect

  • FtpPutFile

  • FtpGetFile

  • InternetCloseHandle

3. FTP 传输模式

本项目采用：

  • 二进制模式（FTP_TRANSFER_TYPE_BINARY）

  • 被动模式（PASV）

这是最常用、兼容性最好的配置。

实现思路详细介绍

整体实现流程如下：

  1. 初始化 WinINet 环境

  2. 创建 Internet 会话

  3. 连接 FTP 服务器

  4. 执行文件上传 / 下载

  5. 错误处理与资源释放

项目采用函数封装方式，便于后续扩展为：

  • FTP 工具类

  • 批量上传程序

  • 自动更新模块

完整实现代码

/**************************************************** * File: FtpClient.h ****************************************************/ #pragma once #include <Windows.h> #include <WinInet.h> #include <string> #pragma comment(lib, "Wininet.lib") class FtpClient { public: FtpClient(); ~FtpClient(); bool connect(const std::wstring& server, const std::wstring& user, const std::wstring& password, INTERNET_PORT port = INTERNET_DEFAULT_FTP_PORT); bool uploadFile(const std::wstring& localFile, const std::wstring& remoteFile); bool downloadFile(const std::wstring& remoteFile, const std::wstring& localFile); private: HINTERNET hInternet; HINTERNET hFtp; }; /**************************************************** * File: FtpClient.cpp ****************************************************/ #include "FtpClient.h" #include <iostream> FtpClient::FtpClient() : hInternet(nullptr), hFtp(nullptr) { // 初始化 WinINet hInternet = InternetOpenW( L"CppFtpClient", INTERNET_OPEN_TYPE_DIRECT, nullptr, nullptr, 0 ); } FtpClient::~FtpClient() { if (hFtp) InternetCloseHandle(hFtp); if (hInternet) InternetCloseHandle(hInternet); } bool FtpClient::connect(const std::wstring& server, const std::wstring& user, const std::wstring& password, INTERNET_PORT port) { hFtp = InternetConnectW( hInternet, server.c_str(), port, user.c_str(), password.c_str(), INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0 ); return hFtp != nullptr; } bool FtpClient::uploadFile(const std::wstring& localFile, const std::wstring& remoteFile) { return FtpPutFileW( hFtp, localFile.c_str(), remoteFile.c_str(), FTP_TRANSFER_TYPE_BINARY, 0 ); } bool FtpClient::downloadFile(const std::wstring& remoteFile, const std::wstring& localFile) { return FtpGetFileW( hFtp, remoteFile.c_str(), localFile.c_str(), FALSE, FILE_ATTRIBUTE_NORMAL, FTP_TRANSFER_TYPE_BINARY, 0 ); } /**************************************************** * File: main.cpp ****************************************************/ #include "FtpClient.h" #include <iostream> int main() { FtpClient ftp; if (!ftp.connect(L"127.0.0.1", L"testuser", L"testpass")) { std::wcout << L"FTP 连接失败\n"; return 1; } if (ftp.uploadFile(L"C:\\Test\\upload.txt", L"upload.txt")) std::wcout << L"文件上传成功\n"; else std::wcout << L"文件上传失败\n"; if (ftp.downloadFile(L"download.txt", L"C:\\Test\\download.txt")) std::wcout << L"文件下载成功\n"; else std::wcout << L"文件下载失败\n"; return 0; }
/**************************************************** * File: FtpClient.h ****************************************************/ #pragma once #include <Windows.h> #include <WinInet.h> #include <string> #pragma comment(lib, "Wininet.lib") class FtpClient { public: FtpClient(); ~FtpClient(); bool connect(const std::wstring& server, const std::wstring& user, const std::wstring& password, INTERNET_PORT port = INTERNET_DEFAULT_FTP_PORT); bool uploadFile(const std::wstring& localFile, const std::wstring& remoteFile); bool downloadFile(const std::wstring& remoteFile, const std::wstring& localFile); private: HINTERNET hInternet; HINTERNET hFtp; }; /**************************************************** * File: FtpClient.cpp ****************************************************/ #include "FtpClient.h" #include <iostream> FtpClient::FtpClient() : hInternet(nullptr), hFtp(nullptr) { // 初始化 WinINet hInternet = InternetOpenW( L"CppFtpClient", INTERNET_OPEN_TYPE_DIRECT, nullptr, nullptr, 0 ); } FtpClient::~FtpClient() { if (hFtp) InternetCloseHandle(hFtp); if (hInternet) InternetCloseHandle(hInternet); } bool FtpClient::connect(const std::wstring& server, const std::wstring& user, const std::wstring& password, INTERNET_PORT port) { hFtp = InternetConnectW( hInternet, server.c_str(), port, user.c_str(), password.c_str(), INTERNET_SERVICE_FTP, INTERNET_FLAG_PASSIVE, 0 ); return hFtp != nullptr; } bool FtpClient::uploadFile(const std::wstring& localFile, const std::wstring& remoteFile) { return FtpPutFileW( hFtp, localFile.c_str(), remoteFile.c_str(), FTP_TRANSFER_TYPE_BINARY, 0 ); } bool FtpClient::downloadFile(const std::wstring& remoteFile, const std::wstring& localFile) { return FtpGetFileW( hFtp, remoteFile.c_str(), localFile.c_str(), FALSE, FILE_ATTRIBUTE_NORMAL, FTP_TRANSFER_TYPE_BINARY, 0 ); } /**************************************************** * File: main.cpp ****************************************************/ #include "FtpClient.h" #include <iostream> int main() { FtpClient ftp; if (!ftp.connect(L"127.0.0.1", L"testuser", L"testpass")) { std::wcout << L"FTP 连接失败\n"; return 1; } if (ftp.uploadFile(L"C:\\Test\\upload.txt", L"upload.txt")) std::wcout << L"文件上传成功\n"; else std::wcout << L"文件上传失败\n"; if (ftp.downloadFile(L"download.txt", L"C:\\Test\\download.txt")) std::wcout << L"文件下载成功\n"; else std::wcout << L"文件下载失败\n"; return 0; }
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/3/15 21:01:09

Zotero Style插件终极指南：5步打造个性化文献管理系统

Zotero Style插件终极指南&#xff1a;5步打造个性化文献管理系统 【免费下载链接】zotero-style zotero-style - 一个 Zotero 插件&#xff0c;提供了一系列功能来增强 Zotero 的用户体验&#xff0c;如阅读进度可视化和标签管理&#xff0c;适合研究人员和学者。 项目地址:…

作者头像 李华
网站建设 2026/3/15 21:01:15

PCL2-CE社区版启动器：新手也能轻松掌握的Minecraft游戏配置全攻略

PCL2-CE社区版启动器&#xff1a;新手也能轻松掌握的Minecraft游戏配置全攻略 【免费下载链接】PCL2-CE PCL2 社区版&#xff0c;可体验上游暂未合并的功能 项目地址: https://gitcode.com/gh_mirrors/pc/PCL2-CE 还在为Minecraft启动器复杂难用而烦恼吗&#xff1f;PCL…

作者头像 李华
网站建设 2026/3/15 21:01:14

yfinance实战宝典：从零开始构建专业级金融数据分析平台

yfinance实战宝典&#xff1a;从零开始构建专业级金融数据分析平台 【免费下载链接】yfinance Download market data from Yahoo! Finances API 项目地址: https://gitcode.com/GitHub_Trending/yf/yfinance yfinance作为Python生态中备受推崇的金融数据获取工具&#x…

作者头像 李华
网站建设 2026/3/15 21:01:12

3分钟快速上手：AI图片标注工具的完整使用指南与实战技巧

3分钟快速上手&#xff1a;AI图片标注工具的完整使用指南与实战技巧 【免费下载链接】BooruDatasetTagManager 项目地址: https://gitcode.com/gh_mirrors/bo/BooruDatasetTagManager 还在为数千张图片的手工标注而烦恼吗&#xff1f;BooruDatasetTagManager作为一款专…

作者头像 李华
网站建设 2026/3/15 21:01:15

NS-USBLoader终极指南：告别Switch文件传输困扰的完整解决方案

NS-USBLoader终极指南&#xff1a;告别Switch文件传输困扰的完整解决方案 【免费下载链接】ns-usbloader Awoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files. 项目地址: https://gitcode.com/g…

作者头像 李华
网站建设 2026/3/15 11:10:14

5分钟学会用mermaid绘制专业实体关系图

5分钟学会用mermaid绘制专业实体关系图 【免费下载链接】mermaid 项目地址: https://gitcode.com/gh_mirrors/mer/mermaid mermaid ER图功能让数据建模变得简单直观&#xff0c;只需掌握几个基础语法规则&#xff0c;就能快速创建专业的实体关系图。无论是数据库设计还…

作者头像 李华