目录
- 一、curl 简介
- 二、基本语法
- 三、常用选项说明
- 四、核心使用示例
- 1. GET 请求
- 2. POST 请求
- （1）提交表单数据（
application/x-www-form-urlencoded） - （2）提交 JSON 数据
- （1）提交表单数据（
- 3. 文件上传（
multipart/form-data） - 4. Cookie 相关操作
- 5. 自定义请求头
- 6. 设置请求来源（Referer）
参考资料地址1: 官网
参考资料地址2: 官方文档
参考资料地址3: curl命令详解
一、curl 简介
curl 是一款功能强大的命令行工具，用于在网络上进行数据传输。它支持多种协议，如 HTTP、HTTPS、FTP、SFTP 等，常被用于测试 API、下载文件、模拟用户请求等场景。
二、基本语法
curl [选项] [URL]
三、常用选项说明
| 选项 | 完整写法 | 功能说明 |
|---|---|---|
| -a | --append | 上传文件时，将本地文件内容附加到目标文件末尾，而不是覆盖。 |
| -A | --user-agent | 设置发送给服务器的 User-Agent 请求头，用于模拟不同的浏览器或客户端。 |
| -b | --cookie | 向服务器发送 Cookie。参数可以是字符串（"name=value; name2=value2"）或包含 Cookie 的文件名。 |
| -c | --cookie-jar | 将服务器返回的 Set-Cookie 头信息保存到指定的文件中。 |
| -d | --data | 以 POST 方式发送数据，适用于 application/x-www-form-urlencoded 类型的表单提交。 |
| -e | --referer | 设置请求头 Referer，告诉服务器该请求是从哪个页面链接过来的。 |
| -F | --form | 模拟 multipart/form-data 类型的表单提交，常用于上传文件。 |
| --form-string | 与 -F 类似，但值始终被视为纯文本字符串，不会进行文件上传。 | |
| -g | --globoff | 禁用 URL 中 {和} 以及 [ 和 ] 的特殊含义，防止它们被解析为序列或范围。 |
| -G | --get | 将 -d 或 --data-urlencode 指定的数据附加到 URL 后面，并以 GET 方式请求。 |
| -H | --header | 自定义 HTTP 请求头。可以多次使用该选项来添加多个头信息。 |
| -i | --include | 在输出中包含 HTTP 响应头信息。 |
| -I | --head | 只请求页面的 HTTP 响应头信息，不获取页面内容（即 HEAD 请求）。 |
| --ignore-content-length | 忽略响应头中的 Content-Length 字段，这在某些情况下可以避免下载中断。 | |
| -l | --list-only | 对于 FTP 等协议，仅列出目录内容而不下载文件。在 HTTP 请求中，效果不明显，通常与其他选项结合使用。 |
| -o | --output | 将下载的内容保存到指定的文件中，而不是输出到终端。 |
| -O | --remote-name | 将下载的内容保存到文件中，文件名从 URL 中推断（即使用远程文件的原始名称）。 |
| -x | --proxy | 使用指定的代理服务器（如 http://user:pass@host:port）进行连接。 |
| -X | --request | 指定 HTTP 请求方法（如 GET, POST, PUT, DELETE, PATCH 等）。 |
| -v | --verbose | 显示详细的请求和响应过程，包括 DNS 解析、TCP 连接、SSL 握手、请求头和响应头的详细信息，便于调试。 |
| -w | --write-out | 请求完成后，按照指定的格式输出额外的信息，如响应时间、HTTP 状态码等。 |
四、核心使用示例
1. GET 请求
# 1. 基础 GET 请求，将响应体输出到终端
curl "http://www.example.com"# 2. 显示响应头（-i）和响应体
curl -i "http://www.example.com"# 3. 仅显示响应头（-I）
curl -I "http://www.example.com"# 4. 显示请求全过程的详细调试信息（-v）
curl -v "http://www.example.com"# 5. 将响应内容保存到文件（-o）
curl -o "example.html" "http://www.example.com"# 6. 以 GET 方式发送数据（-G 配合 -d）
curl -G -d "q=keyword" -d "page=1" "https://example.com/search"
2. POST 请求
（1）提交表单数据（application/x-www-form-urlencoded）
# 1. 使用 -d 发送 POST 数据
curl -d "param1=value1¶m2=value2" -X POST "http://www.example.com/login"# 2. 多次使用 -d 添加多个参数
curl -d 'login=emma' -d 'password=123' -X POST "https://example.com/login"# 3. 使用 --data-urlencode 自动编码特殊字符
curl --data-urlencode 'comment=hello world & other things' "https://example.com/submit"
（2）提交 JSON 数据
curl -X POST \-H "Content-Type: application/json" \-d '{"phone": "13888888888","password": "test"}' \"http://example.com/apis/users.json"
3. 文件上传（multipart/form-data）
# 1. 基础文件上传
curl -F 'file=@/path/to/photo.png' "https://example.com/profile"# 2. 上传文件并指定 MIME 类型
curl -F 'file=@/path/to/photo.png;type=image/png' "https://example.com/profile"# 3. 上传文件并指定服务器接收的文件名
curl -F 'file=@/path/to/photo.png;filename=avatar.png' "https://example.com/profile"
4. Cookie 相关操作
# 1. 发送 Cookie 到服务器（-b）
curl -b "user=root;pass=123456" "http://example.com/dashboard"# 2. 从文件读取 Cookie 并发送（-b）
curl -b "cookies.txt" "http://example.com/dashboard"# 3. 将服务器返回的 Cookie 保存到文件（-c）
curl -c "cookies.txt" "http://example.com/login"
5. 自定义请求头
# 1. 添加单个请求头
curl -H "Accept-Language: en-US" "https://example.com"# 2. 添加多个请求头
curl -H "Accept-Language: en-US" -H "Secret-Token: abc123" "https://example.com"# 3. 模拟浏览器 User-Agent (-A)
curl -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36" "https://example.com"
6. 设置请求来源（Referer）
# 使用 -e 或 -H "Referer: ..."
curl -e "https://google.com" "https://example.com/target-page"
# 等效于
# curl -H "Referer: https://google.com" "https://example.com/target-page"