FTP协议命令和响应码

news2025/4/21 11:22:36

文章目录

- 📦 一、什么是 FTP 协议？
- 🧾 二、FTP 常见命令（客户端发送）
- 📡 三、FTP 响应码（服务端返回）
- - 📌 响应码分类（第一位）
  - ✅ 常见成功响应码（2xx）
  - 📋 等待/中间状态码（1xx）
  - ❗ 需要继续操作（3xx）
  - ❌ 常见错误响应码（4xx/5xx）
- 🧪 四、完整登录示例流程（主动模式）
- 🌐 五、主动（PORT）与被动（PASV）模式区别
- 🧰 六、调试技巧
- 📘 七、总结与建议

当然可以！以下是对 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 模式进行数据传输（更稳定）