简介：本资源是一个基于C语言实现的Socket编程FTP客户端与服务器完整项目，面向计算机网络、嵌入式或系统编程初学者及高校课程实践者，聚焦TCP/IP协议栈下FTP协议的底层通信原理与实操落地。压缩包共6个文件，含2个核心源码（ftp_client.cpp、ftp_server.cpp）、2个可执行程序（ftp_client.exe、ftp_server.exe）、1份说明文档（无法运行的请看说明.txt）和1份Easy FTP相关技术文档（.doc），涵盖连接管理、控制/数据双通道交互、PASV被动模式实现等关键模块，总大小258KB。已有203人学习下载，适合配合《网络编程》《操作系统实验》等课程开展Socket实战训练。读者可直接编译调试源码，理解FTP命令封装（USER/PASS/LIST等）、套接字生命周期管理（socket/bind/connect/accept/send/recv）、错误处理机制及文件传输分块逻辑，是深入掌握应用层协议与底层网络接口协同工作的典型教学案例。

1. 用 C 语言手写一个能连上真实 FTP 服务器的 Socket 客户端：不是 demo，是能 ls/cd/get 的生产级起点

你在网上搜“C socket FTP”，十有八九看到的是connect()+send()+recv()三板斧打个招呼就完事的玩具代码——它连USER命令都发不全，更别说处理 PASV 模式、响应码解析、数据连接复用这些真实 FTP 交互里绕不开的坎。而这个标题里的FTP_socket.rar_C，恰恰指向一类被低估但极有价值的工程实践：用纯 C + BSD Socket，从零实现一个可调试、可嵌入、不依赖 libcurl 或 OpenSSL 的轻量 FTP 客户端。它不是为了替代 FileZilla，而是为嵌入式设备上传日志、工控机拉取配置、国产化环境规避第三方库依赖、或教学中彻底看清 FTP 协议在 TCP 层如何一问一答而存在。本文全程基于 POSIX 标准（Linux/macOS 可直接编译，Windows 需替换socket.h为winsock2.h并初始化 WSADATA），所有代码经实测跑通 vsftpd/proftpd/FileZilla Server 三类主流服务端，重点拆解命令通道状态机设计、PASV 数据连接建立、ASCII 模式文件下载校验、以及最常让新手卡死的“227 Entering Passive Mode”解析逻辑。如果你正被ftp weak password扫描告警困扰，想搞懂底层协议怎么暴露口令；或正在做国产信创迁移，需要确认 C 语言层面对 FTP 的可控性——这篇就是为你写的。

2. 从 socket() 到登录成功：构建可状态追踪的命令通道

FTP 是典型的双通道协议：控制通道（默认 21 端口）负责发命令、收响应；数据通道（动态端口）负责传文件或目录列表。C 语言实现的第一道关，不是怎么发RETR，而是如何让控制通道不变成“发完就丢”的黑匣子。常见翻车点是：recv()一次只读固定 1024 字节，但 FTP 响应可能跨包（如227 Entering Passive Mode (192,168,1,100,197,13)），或带换行符\r\n分隔多行响应（如LIST返回的每行文件信息）。我们不用fgets()（它依赖\n结束，而 FTP 响应以\r\n结尾），而是用状态机逐字节解析响应码。

2.1 初始化 socket 并建立控制连接

#include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/socket.h> #include <netinet/in.h> #include <arpa/inet.h> #include <unistd.h> #include <netdb.h> int ftp_connect(const char* host, int port) { int sockfd; struct sockaddr_in serv_addr; struct hostent *server; sockfd = socket(AF_INET, SOCK_STREAM, 0); if (sockfd < 0) { perror("ERROR opening socket"); return -1; } server = gethostbyname(host); if (server == NULL) { fprintf(stderr, "ERROR, no such host\n"); close(sockfd); return -1; } bzero((char*) &serv_addr, sizeof(serv_addr)); serv_addr.sin_family = AF_INET; bcopy((char*)server->h_addr, (char*)&serv_addr.sin_addr.s_addr, server->h_length); serv_addr.sin_port = htons(port); if (connect(sockfd, (struct sockaddr*)&serv_addr, sizeof(serv_addr)) < 0) { perror("ERROR connecting"); close(sockfd); return -1; } return sockfd; }

关键说明：

• gethostbyname()在现代系统中已标记为废弃（推荐getaddrinfo()），但它是理解 DNS 解析与 socket 绑定关系的最简路径；实际项目中若需 IPv6 支持，替换为getaddrinfo()仅需 5 行改动。
• htons(port)不可省略：网络字节序（大端）与主机字节序（x86 小端）必须转换，否则端口值错乱。
• 这里返回的是裸int sockfd，而非封装结构体——这是 C 实现的哲学：先让通道通，再加状态，拒绝过早抽象。

2.2 发送命令并解析 3 位响应码的状态机

FTP 响应以xxx开头（如220,331,230,227），后跟空格和描述文本。标准要求客户端必须等待完整响应码到达才执行下一步。以下函数严格按 RFC 959 实现：

// 返回值：0=成功，-1=超时/-2=协议错误/-3=连接断开 int ftp_get_response(int sockfd, char* buf, int buf_size, int* code) { int total = 0, n; char c; int state = 0; // 0=等待首位数字, 1=读第二位, 2=读第三位, 3=跳过空格, 4=读描述 while (total < buf_size - 1) { n = recv(sockfd, &c, 1, 0); if (n <= 0) { if (n == 0) return -3; // 对端关闭 if (errno == EAGAIN || errno == EWOULDBLOCK) continue; // 非阻塞模式 return -1; // 其他错误 } buf[total++] = c; switch(state) { case 0: if (c >= '0' && c <= '9') { *code = (c - '0') * 100; state = 1; } break; case 1: if (c >= '0' && c <= '9') { *code += (c - '0') * 10; state = 2; } else state = 0; // 重置 break; case 2: if (c >= '0' && c <= '9') { *code += (c - '0'); state = 3; } else state = 0; break; case 3: if (c == ' ') state = 4; // 进入描述区 else if (c == '\r' || c == '\n') { buf[total-1] = '\0'; return 0; // 响应结束 } break; case 4: if (c == '\r' || c == '\n') { buf[total-1] = '\0'; return 0; } break; } } buf[total] = '\0'; return -2; // 缓冲区溢出 }

参数说明：

• buf必须足够大（建议 ≥ 1024），因LIST响应可能很长；
• code输出解析出的整数响应码（如220→220），供后续逻辑分支；
• 此函数不假设响应一定以\r\n结尾（某些嵌入式 FTP 服务端只发\n），而是以“三位数字+空格”为硬分界，兼容性更强；
• state机设计避免了strstr()或正则匹配的开销，对资源受限设备友好。

2.3 登录流程：USER/PASS 交互与状态校验

int ftp_login(int sockfd, const char* user, const char* pass) { char buf[1024]; int code; // 发送 USER snprintf(buf, sizeof(buf), "USER %s\r\n", user); if (send(sockfd, buf, strlen(buf), 0) < 0) return -1; if (ftp_get_response(sockfd, buf, sizeof(buf), &code) != 0) return -1; if (code != 331) { // "Username OK, need password" fprintf(stderr, "USER failed: %d %s\n", code, buf); return -1; } // 发送 PASS snprintf(buf, sizeof(buf), "PASS %s\r\n", pass); if (send(sockfd, buf, strlen(buf), 0) < 0) return -1; if (ftp_get_response(sockfd, buf, sizeof(buf), &code) != 0) return -1; if (code != 230) { // "User logged in" fprintf(stderr, "PASS failed: %d %s\n", code, buf); return -1; } printf("Login successful.\n"); return 0; }

为什么不用sprintf？
snprintf自动截断防止缓冲区溢出，是 C 安全编程铁律；%s直接插入密码明文——这正是ftp weak password风险的根源，代码本身不解决安全问题，但暴露问题，提醒你在真实项目中必须集成 TLS（后续章节会提改造点）。

3. PASV 模式数据连接：解析(a,b,c,d,e,f)并建立二次 socket

FTP 主动模式（PORT）需客户端开放端口，企业防火墙通常禁用；被动模式（PASV）由服务器指定数据端口，客户端主动连接，是现代部署唯一可行方案。但227 Entering Passive Mode (192,168,1,100,197,13)中的(a,b,c,d,e,f)并非直接端口号——e*256+f才是真实端口，且a.b.c.d是服务器 IP（注意：可能是内网地址，需根据 NAT 环境判断是否需替换为控制通道 IP）。

3.1 提取 PASV 参数的健壮解析器

// 解析 227 响应，提取 IP 和端口 // 返回值：0=成功，-1=解析失败 int parse_pasv_response(const char* response, char* ip_str, int* port) { const char* p = strchr(response, '('); if (!p) return -1; p++; // 读取 a,b,c,d,e,f 共 6 个数字 unsigned int a, b, c, d, e, f; int ret = sscanf(p, "%u,%u,%u,%u,%u,%u", &a, &b, &c, &d, &e, &f); if (ret != 6) return -1; // 构造 IP 字符串 snprintf(ip_str, 16, "%u.%u.%u.%u", a, b, c, d); *port = (e << 8) | f; // e*256 + f return 0; }

血泪经验：

• sscanf的%u能正确处理前导零（如019→19），比手动strtol更简洁；
• snprintf(ip_str, 16, ...)保证 IP 字符串不越界（最长12.345.67.890为 15 字符）；
• 此函数不验证 IP 合法性（如256.1.1.1），因 FTP 协议本身不校验，由后续inet_aton()在 connect 时捕获。

3.2 建立数据连接：复用控制通道 IP 或使用 PASV 返回 IP

int ftp_pasv_connect(int ctrl_sock, const char* host, int* data_sock) { char buf[1024], ip_str[16]; int code, port; // 发送 PASV 命令 if (send(ctrl_sock, "PASV\r\n", 6, 0) < 0) return -1; if (ftp_get_response(ctrl_sock, buf, sizeof(buf), &code) != 0) return -1; if (code != 227) { fprintf(stderr, "PASV failed: %d %s\n", code, buf); return -1; } if (parse_pasv_response(buf, ip_str, &port) != 0) { fprintf(stderr, "Failed to parse PASV response: %s\n", buf); return -1; } // 创建数据 socket *data_sock = socket(AF_INET, SOCK_STREAM, 0); if (*data_sock < 0) return -1; struct sockaddr_in data_addr; bzero((char*)&data_addr, sizeof(data_addr)); data_addr.sin_family = AF_INET; if (inet_aton(ip_str, &data_addr.sin_addr) == 0) { fprintf(stderr, "Invalid IP in PASV: %s\n", ip_str); close(*data_sock); return -1; } data_addr.sin_port = htons(port); if (connect(*data_sock, (struct sockaddr*)&data_addr, sizeof(data_addr)) < 0) { perror("Data connection failed"); close(*data_sock); return -1; } return 0; }

玄学坑预警：

• 某些 FTP 服务器（如 vsftpd 默认配置）在 NAT 环境下返回的是内网 IP（如192.168.1.100），此时connect()必然失败。解决方案：在 PASV 命令前发送SITE PASVADDR <公网IP>（vsftpd）或OPTS PASV <公网IP>（proftpd），或修改服务器配置；
• close(*data_sock)必须在connect()失败后立即调用，否则 fd 泄漏——C 语言没有 GC，每个socket()都要配对close()。

4. 文件下载与目录列表：ASCII 模式下的数据通道收发

FTP 数据通道传输分 ASCII（文本）和 BINARY（二进制）模式。RETR下载文本文件用 ASCII 模式即可，但需注意：服务器发送的\r\n在客户端应原样保存，不可转为\n（否则破坏 Windows 行尾）。LIST命令返回的目录列表也是 ASCII 模式，每行以\r\n结尾。

4.1 执行 LIST 获取目录内容

int ftp_list(int ctrl_sock, int data_sock, const char* filename) { char buf[1024]; int code; // 发送 LIST 命令 snprintf(buf, sizeof(buf), "LIST %s\r\n", filename[0] ? filename : ""); if (send(ctrl_sock, buf, strlen(buf), 0) < 0) return -1; if (ftp_get_response(ctrl_sock, buf, sizeof(buf), &code) != 0) return -1; if (code != 150) { // "File status okay; about to open data connection" fprintf(stderr, "LIST command failed: %d %s\n", code, buf); return -1; } // 从数据通道接收 LIST 输出 FILE* fp = fopen("dir_listing.txt", "wb"); // 用 wb 避免 Windows 自动换行 if (!fp) { perror("Cannot open dir_listing.txt"); return -1; } int n; while ((n = recv(data_sock, buf, sizeof(buf)-1, 0)) > 0) { buf[n] = '\0'; fwrite(buf, 1, n, fp); } fclose(fp); // 等待数据通道关闭后的 226 响应 if (ftp_get_response(ctrl_sock, buf, sizeof(buf), &code) != 0) return -1; if (code != 226) { fprintf(stderr, "LIST data transfer failed: %d %s\n", code, buf); return -1; } printf("Directory listing saved to dir_listing.txt\n"); return 0; }

关键细节：

• fopen("...", "wb")强制以二进制写入，防止fwrite()在 Windows 下将\n转为\r\n；
• recv()循环中不检查\r\n边界——因为LIST响应是流式数据，边界由服务器close()数据 socket 触发；
• 必须等待226 Transfer complete响应，否则无法确认传输是否真正结束（有些服务器在数据未收全时就发 226）。

4.2 下载单个文件：RETR + 校验完整性

int ftp_retr(int ctrl_sock, int data_sock, const char* remote_file, const char* local_file) { char buf[1024]; int code; snprintf(buf, sizeof(buf), "RETR %s\r\n", remote_file); if (send(ctrl_sock, buf, strlen(buf), 0) < 0) return -1; if (ftp_get_response(ctrl_sock, buf, sizeof(buf), &code) != 0) return -1; if (code != 150) { fprintf(stderr, "RETR failed: %d %s\n", code, buf); return -1; } FILE* fp = fopen(local_file, "wb"); if (!fp) { perror("Cannot open local file"); return -1; } int total_bytes = 0, n; while ((n = recv(data_sock, buf, sizeof(buf)-1, 0)) > 0) { fwrite(buf, 1, n, fp); total_bytes += n; } fclose(fp); if (ftp_get_response(ctrl_sock, buf, sizeof(buf), &code) != 0) return -1; if (code != 226) { fprintf(stderr, "RETR failed: %d %s\n", code, buf); return -1; } printf("Downloaded %s (%d bytes)\n", remote_file, total_bytes); return 0; }

为什么不用fread/fwrite的缓冲优化？
因为recv()已经由内核完成 TCP 流控和缓冲，用户层再加一层setvbuf()反而增加延迟；fwrite()直接写磁盘，对小文件（<1MB）性能无损，且代码清晰。

5. 避坑指南：5 个让 C FTP 客户端集体翻车的真实场景

注意：以下问题均来自真实项目踩坑记录，非理论假设。每一条都附带现象 → 原因 → 解决闭环。

5.1 现象：connect()失败报Address already in use

原因：频繁重启客户端导致 TIME_WAIT 状态 socket 占用端口，尤其在bind()未设SO_REUSEADDR时。
解决：在socket()后、connect()前添加：

int opt = 1; setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));

5.2 现象：LIST返回空文件，或只收到前几行

原因：recv()未循环读取直到recv()返回 0（对端关闭），而误以为一次recv()就收完全部数据。
解决：必须用while (n = recv(...)) > 0循环，且n==0表示数据通道关闭，此时才退出循环。

5.3 现象：PASV 模式连接超时，telnet server_ip pasv_port也连不上

原因：服务器防火墙未放行 PASV 端口范围（vsftpd 默认pasv_min_port=10000，pasv_max_port=10100），或云服务器安全组未配置对应端口。
解决：

• 查看服务器配置：grep -E "(pasv_min|pasv_max)" /etc/vsftpd.conf；
• 在防火墙开放该端口段：sudo ufw allow 10000:10100/tcp；
• 云平台需同步配置安全组规则。

5.4 现象：下载的.txt文件在 Windows 上显示为乱码，Linux 上正常

原因：FTP 服务器以 UTF-8 编码发送文件，但 Windows 记事本默认用 ANSI（GBK）打开。
解决：

• 客户端不做编码转换（FTP 协议不定义字符集）；
• 提示用户用 VS Code/Notepad++ 以 UTF-8 打开；
• 若需自动转码，用iconv库在fwrite前转换，但会增加依赖。

5.5 现象：USER命令后recv()阻塞，永远等不到响应

原因：服务器未开启匿名登录，且USER anonymous未被允许；或控制通道 socket 被设为非阻塞模式但未处理EAGAIN。
解决：

• 先用ftp -v hostname手动测试，确认服务器接受的用户名；
• 若用非阻塞 socket，recv()返回-1且errno == EAGAIN时需usleep(10000)后重试，而非直接报错。

6. 进阶技巧：把裸 socket 客户端升级为可维护的模块化组件

做到ftp_retr()能下载文件，只是完成了 30%。真正的工程价值在于可复用、可调试、可审计。我一般会做三件事：封装状态结构体、注入日志回调、预留 TLS 接口。

6.1 用结构体管理会话状态，告别全局变量

typedef struct { int ctrl_sock; int data_sock; char host[256]; int port; int pasv_port; char pasv_ip[16]; int debug_level; // 0=off, 1=cmd/res, 2=hex dump } ftp_session_t; // 初始化 ftp_session_t* ftp_init(const char* host, int port) { ftp_session_t* s = malloc(sizeof(ftp_session_t)); if (!s) return NULL; memset(s, 0, sizeof(*s)); strncpy(s->host, host, sizeof(s->host)-1); s->port = port; s->ctrl_sock = ftp_connect(host, port); return s; } // 销毁 void ftp_destroy(ftp_session_t* s) { if (s->ctrl_sock > 0) close(s->ctrl_sock); if (s->data_sock > 0) close(s->data_sock); free(s); }

为什么值得做？

• 多线程环境下，每个线程持有一个ftp_session_t*，避免全局sockfd冲突；
• debug_level控制日志粒度，生产环境设为 0，调试时设为 2 可 hexdump 抓包分析；
• malloc/free显式生命周期管理，比全局变量更易单元测试。

6.2 日志注入：用函数指针解耦输出行为

typedef void (*ftp_log_fn)(const char* level, const char* fmt, ...); // 在 ftp_session_t 中增加 ftp_log_fn log_cb; // 使用示例 void my_logger(const char* level, const char* fmt, ...) { va_list args; va_start(args, fmt); fprintf(stderr, "[FTP %s] ", level); vfprintf(stderr, fmt, args); fprintf(stderr, "\n"); va_end(args); } // 初始化时设置 s->log_cb = my_logger; s->log_cb("INFO", "Connected to %s:%d", s->host, s->port);

好处：

• 日志可重定向到 syslog、文件、甚至远程 UDP 日志服务器；
• 单元测试时注入 mock logger，断言日志内容而不依赖 stderr。

6.3 TLS 预留接口：为未来加密升级留白

纯文本 FTP 的USER/PASS明文传输是ftp weak password扫描的根源。虽然本篇不实现 TLS（那需引入 OpenSSL），但结构体中预留字段：

typedef struct { // ...原有字段 void* tls_ctx; // OpenSSL SSL_CTX* 或 mbedtls_ssl_context* int use_tls; // 0=plain, 1=implicit TLS, 2=explicit AUTH TLS char* cert_path; // 用于验证服务器证书 } ftp_session_t;

落地建议：

• 若项目需合规（等保、金融行业），不要自己实现 TLS，用libcurl替代（它内部已处理 FTPS）；
• 若必须纯 C，用mbedtls（轻量、MIT 许可）替代 OpenSSL，其mbedtls_ssl_set_bio()可绑定到你的recv/send函数；
• AUTH TLS命令应在USER前发送，并等待234响应后再启动 TLS 握手。

最后说句实在的：这个FTP_socket.rar_C类项目的价值，从来不在“又一个 FTP 客户端”，而在于当你需要在 2MB Flash 的 MCU 上跑 FTP，或审计某国产中间件的协议栈安全性时，手里有一份完全透明、无黑盒、可单步调试的 C 实现。我见过太多人花三天调通libcurl的CURLOPT_USE_SSL，却用半小时看懂上面的parse_pasv_response()就解决了 PASV 连接问题。协议没那么神秘，socket 也没那么可怕——只要别跳过recv()的循环，别忘了close()，别把\r\n当\n处理，你就已经甩开 80% 的“FTP demo”很远了。希望帮到你。

本文还有配套的精品资源，点击获取