FTP协议命令和响应码

---

当然可以！以下是对 FTP 协议中常用命令 和 响应码（状态码） 的全面讲解，适合开发 FTP 客户端程序时理解通信流程与调试细节。

---

📦 一、什么是 FTP 协议？

FTP（File Transfer Protocol） 是一个基于客户端-服务器架构的应用层协议，主要用于在网络中上传、下载文件。

FTP 通信基于：

• 控制连接：用于传输命令和响应（端口号默认 21）
• 数据连接：用于传输数据，如文件和目录列表

---

🧾 二、FTP 常见命令（客户端发送）

命令	说明	示例
USER	提交用户名	USER test
PASS	提交密码	PASS 123456
PASV	被动模式传输	PASV
PORT	主动模式传输	PORT 192,168,1,10,14,178
LIST	获取文件列表	LIST
RETR	下载文件	RETR filename.txt
STOR	上传文件	STOR filename.txt
CWD	切换目录	CWD /upload
PWD	显示当前路径	PWD
MKD	创建目录	MKD /upload/images
RMD	删除目录	RMD /upload/images
DELE	删除文件	DELE file.txt
QUIT	关闭连接	QUIT
TYPE	设置传输模式	TYPE I（二进制）

---

📡 三、FTP 响应码（服务端返回）

FTP 使用 三位数的状态码 表示操作状态，第一位是类别，后两位是细节。

📌 响应码分类（第一位）

第一位	含义
1xx	初始状态，继续操作（如 150 等待传输）
2xx	成功响应
3xx	需要进一步操作（如提供密码）
4xx	临时失败（可重试）
5xx	永久失败（请求错误）

---

✅ 常见成功响应码（2xx）

响应码	含义
200	命令成功
220	服务准备好，等待用户登录（登录欢迎语）
221	退出成功（QUIT 后）
226	数据连接关闭，传输成功
230	用户登录成功
250	请求的文件操作成功
257	创建目录成功（返回路径）

---

📋 等待/中间状态码（1xx）

响应码	含义
150	文件状态正常，准备打开数据连接
125	数据连接已打开，开始传输
227	进入被动模式，返回数据连接 IP/端口
例：
227 Entering Passive Mode (192,168,1,2,19,200) → 端口 = 19*256 + 200 = 5064

---

❗ 需要继续操作（3xx）

响应码	含义
331	用户名正确，等待密码
332	登录需要账号

---

❌ 常见错误响应码（4xx/5xx）

响应码	含义
421	服务不可用，连接被关闭
425	无法打开数据连接
426	连接关闭，传输失败
450	请求的文件操作未完成
500	命令语法错误
530	未登录（用户名/密码错误）
550	请求的操作失败，例如文件不存在或没有权限
553	文件名非法（STOR、RETR 错误）

---

🧪 四、完整登录示例流程（主动模式）

Client → Server: USER test
Server → Client: 331 Password required
Client → Server: PASS 123456
Server → Client: 230 User logged in

Client → Server: TYPE I
Server → Client: 200 Type set to I

Client → Server: PORT 192,168,1,100,14,178
Server → Client: 200 PORT command successful

Client → Server: STOR file.txt
Server → Client: 150 Opening data connection
Server → Client: 226 Transfer complete

---

🌐 五、主动（PORT）与被动（PASV）模式区别

模式	客户端行为	服务器行为
主动模式	使用 PORT 命令，开放端口等待服务器连接	主动连接客户端的数据端口
被动模式	使用 PASV 命令，请求服务器开放端口	服务器返回 IP 和端口，客户端主动连接

🔹 在 NAT/防火墙 后面建议使用 PASV 模式，因为客户端主动连接数据端口更易通过网络。

---

🧰 六、调试技巧

• 如果连接成功但无法上传/下载，大概率是数据连接（PASV）失败，可抓包分析
• 响应码 530 常见于用户名或密码错误
• 响应码 550 多见于目录或文件不存在，或权限问题
• 使用 telnet 或 nc 模拟 FTP 客户端手动发送命令调试

---

📘 七、总结与建议

要素	建议
命令发送	加上 \r\n 结尾，例如 USER test\r\n
数据读取	使用 recv 后需检查返回码，并处理多行响应
编码	FTP 协议是基于纯文本的，使用 ASCII 传输命令和响应
模式选择	推荐使用 PASV 模式进行数据传输（更稳定）

---