curl命令详解

目录

• curl命令详解
• 基本使用示例
  • 1、基本用法
  • 2、保存访问的网页
    • 2.1:使用linux的重定向功能保存
    • 2.2:可以使用curl的内置选项 -o (小写) 保存网页
    • 2.3:可以使用curl的内置选项 -O (大写) 保存网页中的文件
  • 3、测试网页返回值(响应码)
  • 4、指定 proxy 服务器以及其端口
  • 5、cookie
    • 5.1:保存http的response里面的 cookie 信息。内置选项 -c（小写）
    • 5.2:保存http的response里面的 header 信息。内置option: -D
    • 5.3:使用cookie
  • 6、模仿浏览器
  • 7、伪造referer（盗链）
  • 8、curl下载文件
    • 8.1：利用curl下载文件
    • 8.2：循环下载
    • 8.3：下载重命名
    • 8.4：分块下载
    • 8.5：通过ftp下载文件
    • 8.6：显示下载进度条
    • 8.7：不会显示下载进度信息
  • 9、断点续传
  • 10、上传文件
• 常用选项示例
  • -A 指定客户端的用户代理标头
  • -b 向服务器发送 Cookie
  • -c 保存cookie
  • -d 发送 POST 请求的数据体
  • --data-urlencode 自动将发送的数据进行 URL 编码
  • -e 设置 HTTP 标头的请求的来源
  • -F上传二进制文件
  • -G 构造 URL 的查询字符串
  • -H 指定HTTP 请求的标头
  • -i 显示Response头信息，并打印源码
  • -I 显示Response头信息，不打印源码
  • -k 跳过 SSL 检测
  • -L 指定HTTP 请求跟随服务器的重定向
  • --limit-rate 限制 HTTP 请求和回应的带宽
  • -o 服务器的响应保存成文件
  • -O 将URL的最后部分当作文件名保存
  • -s 不输出错误和进度信息
  • -S 指定只输出错误信息
  • -u 设置服务器认证的用户名和密码
  • -v 输出通信的整个过程
  • -x 指定 HTTP 请求的代理
  • -X 指定 HTTP 请求的方法
• GET/POST请求使用示例
  • curl GET 请求
  • curl POST 请求
    • 基础应用
    • 多个请求头 option: -H
    • 转化成一个GET
    • multipart/form-data
    • application/x-www-form-urlencoded
  • curl POST 上传二进制文件
    • POST一个二进制数据

curl命令详解

大佬地址：请优先查看！请优先查看！

Curl Cookbook

阮一峰curl 的用法指南

curl详解

curl常用参数

curl -h

Curl命令详解

佛心看世界

简介：

curl 是常用的命令行工具，用来请求 Web 服务器。它的名字就是客户端（client）的 URL 工具的意思。

它的功能非常强大，命令行参数多达几十种。如果熟练的话，完全可以取代 Postman 这一类的图形界面工具。

如果在一个curl命令中不指定具体的方法，那么默认的就是使用GET方法。对于其它的方法，可以在curl命令中指定：

method	option
POST	-d或-F
HEAD	-I
PUT	-T

语法：

curl [option] [url]

常见选项：

-A/--user-agent <string>             设置用户代理发送给服务器
-b/--cookie <name=string/file>    	 cookie字符串或文件读取位置
-c/--cookie-jar <file>               操作结束后把cookie写入到这个文件中
-C/--continue-at <offset>            断点续转
-D/--dump-header <file>              把header信息写入到该文件中
-e/--referer                         来源网址
-f/--fail                            连接失败时不显示http错误
-o/--output                          把输出写到该文件中
-O/--remote-name                     把输出写到该文件中，保留远程文件的文件名
-r/--range <range>                   检索来自HTTP/1.1或FTP服务器字节范围
-s/--silent                          静音模式。不输出任何东西
-T/--upload-file <file>              上传文件
-u/--user <user[:password]>          设置服务器的用户和密码
-w/--write-out [format]              什么输出完成后
-x/--proxy <host[:port]>             在给定的端口上使用HTTP代理
-#/--progress-bar                    进度条显示当前的传送状态

Curl支持协议:

cURL支持的通信协议有：
FTP、FTPS、HTTP、HTTPS、TFTP、SFTP、Gopher、SCP、Telnet、DICT、FILE、LDAP、LDAPS、IMAP、POP3、SMTP和RTSP。

curl还支持SSL认证、HTTP POST、HTTP PUT、FTP上传, 

HTTP form based upload、proxies、HTTP/2、cookies、用户名+密码认证(Basic, Plain, Digest, CRAM-MD5, NTLM, 

Negotiate and Kerberos)、file transfer resume、proxy tunneling。

基本使用示例

1、基本用法

命令：

curl URL

🌰：

curl http://www.baidu.com

执行后，http://www.baidu.com 的html就会显示在屏幕上了
📃：由于安装linux的时候很多时候是没有安装桌面的，也意味着没有浏览器，因此这个方法也经常用于测试一台服务器是否可以到达一个网站

2、保存访问的网页

2.1:使用linux的重定向功能保存

命令：

curl URL >> filename.html

🌰：

curl http://www.baidu.com >> baidu.html

2.2:可以使用curl的内置选项 -o (小写) 保存网页

命令：

curl -o filename.html  URL

🌰：

curl -o baidu.html http://www.baidu.com

执行完成后会显示如下界面，显示100%则表示保存成功

2.3:可以使用curl的内置选项 -O (大写) 保存网页中的文件

命令：

# 后面的url要具体到某个文件，不然抓不下来
curl -O filename.html  URL/文件名.后缀名

🌰：

curl -O http://www.baidu.com/hello.sh

3、测试网页返回值(响应码)

命令：

curl -o /dev/null -s -w %{http_code} URL

🌰：

curl -o /dev/null -s -w %{http_code} www.baidu.com

📃：在脚本中，这是很常见的测试网站是否正常的用法

4、指定 proxy 服务器以及其端口

很多时候上网需要用到代理服务器（比如是使用代理服务器上网或者因为使用 curl 别人网站而被别人屏蔽IP地址的时候），幸运的是curl通过使用内置option：-x 来支持设置代理

curl -x 192.168.100.100:1080 http://www.baidu.com

5、cookie

有些网站是使用cookie来记录session信息。对于chrome这样的浏览器，可以轻易处理cookie信息，但在curl中只要增加相关参数也是可以很容易的处理cookie。

5.1:保存http的response里面的 cookie 信息。内置选项 -c（小写）

curl -c cookiec.txt  http://www.linux.com

执行后cookie信息就被存到了cookiec.txt里面了

5.2:保存http的response里面的 header 信息。内置option: -D

curl -D cookied.txt http://www.baidu.com

执行后cookie信息就被存到了cookied.txt里面了

注意❗：-c(小写) 产生的 cookie 和 -D 里面的cookie是不一样的。

5.3:使用cookie

很多网站都是通过监视你的cookie信息来判断你是否按规矩访问他们的网站的，因此我们需要使用保存的cookie信息。内置option: -b

curl -b cookiec.txt http://www.linux.com

6、模仿浏览器

有些网站需要使用特定的浏览器去访问他们，有些还需要使用某些特定的版本。curl内置option: -A 可以让我们指定浏览器去访问网站

curl -A "Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 5.0)" http://www.linux.com

这样服务器端就会认为是使用IE8.0去访问的

7、伪造referer（盗链）

很多服务器会检查http访问的referer从而来控制访问。比如：你是先访问首页，然后再访问首页中的邮箱页面，这里访问邮箱的referer地址就是访问首页成功后的页面地址，如果服务器发现对邮箱页面访问的referer地址不是首页的地址，就断定那是个盗连了。
curl中内置option：-e 可以让我们设定referer

curl -e "www.linux.com" http://mail.linux.com

这样就会让服务器其以为你是从www.linux.com点击某个链接过来的

8、curl下载文件

8.1：利用curl下载文件

使用内置option：-o (小写)

命令：

curl -o  图片名称.jpg  URL # 图片地址

🌰：

curl -o bmw.jpg https://scpic.chinaz.net/files/pic/pic9/202205/apic40779.jpg

使用内置option：-O（大写)

命令：

curl -O URL

🌰：

curl -O https://scpic.chinaz.net/files/pic/pic9/202205/apic40779.jpg

这样就会以服务器上的名称保存文件到本地

8.2：循环下载

有时候下载图片可以能是前面的部分名称是一样的，就最后的尾椎名不一样

curl -O http://www.linux.com/dodo[1-5].JPG

这样就会把dodo1，dodo2，dodo3，dodo4，dodo5全部保存下来

8.3：下载重命名

旧方式：

curl -O http://www.linux.com/{hello,bb}/dodo[1-5].JPG

由于下载的hello与bb中的文件名都是dodo1，dodo2，dodo3，dodo4，dodo5。因此第二次下载的会把第一次下载的覆盖，这样就需要对文件进行重命名。

新方式：

curl -o #1_#2.JPG http://www.linux.com/{hello,bb}/dodo[1-5].JPG

这样在hello/dodo1.JPG的文件下载下来就会变成hello_dodo1.JPG，其他文件依此类推，从而有效的避免了文件被覆盖

8.4：分块下载

有时候下载的东西会比较大，这个时候我们可以分段下载。使用内置option：-r

curl -r 0-100 -o dodo1_part1.JPG http://www.linux.com/dodo1.JPG

curl -r 100-200 -o dodo1_part2.JPG http://www.linux.com/dodo1.JPG

curl -r 200- -o dodo1_part3.JPG http://www.linux.com/dodo1.JPG

cat dodo1_part* > dodo1.JPG

这样就可以查看dodo1.JPG的内容了

8.5：通过ftp下载文件

curl可以通过ftp下载文件，curl提供两种从ftp中下载的语法

curl -O -u 用户名:密码 ftp://www.linux.com/dodo1.JPG

curl -O ftp://用户名:密码@www.linux.com/dodo1.JPG

8.6：显示下载进度条

curl -# -O https://scpic.chinaz.net/files/pic/pic9/202205/apic40779.jpg

8.7：不会显示下载进度信息

curl -s -O https://scpic.chinaz.net/files/pic/pic9/202205/apic40779.jpg

9、断点续传

在windows中，我们可以使用迅雷这样的软件进行断点续传。curl可以通过内置 option:-C 同样可以达到相同的效果
如果在下载 apic40779.jpg 的过程中突然掉线了，可以使用以下的方式续传

curl -C -O https://scpic.chinaz.net/files/pic/pic9/202205/apic40779.jpg

10、上传文件

curl不仅仅可以下载文件，还可以上传文件。通过内置 option:-T 来实现

curl -T dodo1.JPG -u 用户名:密码 ftp://www.linux.com/img/

这样就向ftp服务器上传了文件dodo1.JPG

常用选项示例

-A 指定客户端的用户代理标头

-A参数指定客户端的用户代理标头，即User-Agent。curl 的默认用户代理字符串是curl/[version]。

$ curl -A 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.100 Safari/537.36' https://google.com

上面命令将User-Agent改成 Chrome 浏览器。

$ curl -A '' https://google.com

上面命令会移除User-Agent标头。

也可以通过-H参数直接指定标头，更改User-Agent。

$ curl -H 'User-Agent: php/1.0' https://google.com

-b 向服务器发送 Cookie

-b参数用来向服务器发送 Cookie。

$ curl -b 'foo=bar' https://google.com

上面命令会生成一个标头Cookie: foo=bar，向服务器发送一个名为foo、值为bar的 Cookie。

$ curl -b 'foo1=bar' -b 'foo2=baz' https://google.com

上面命令发送两个 Cookie。

$ curl -b cookies.txt https://www.google.com

上面命令读取本地文件cookies.txt，里面是服务器设置的 Cookie（参见-c参数），将其发送到服务器。

-c 保存cookie

-c参数将服务器设置的 Cookie 写入一个文件。

$ curl -c cookies.txt https://www.google.com

上面命令将服务器的 HTTP 回应所设置 Cookie 写入文本文件cookies.txt。

-d 发送 POST 请求的数据体

-d参数用于发送 POST 请求的数据体。

$ curl -d 'login=emma＆password=123' -X POST https://google.com/login
# 或者
$ curl -d 'login=emma' -d 'password=123' -X POST  https://google.com/login

使用-d参数以后，HTTP 请求会自动加上标头Content-Type : application/x-www-form-urlencoded。并且会自动将请求转为 POST 方法，因此可以省略-X POST。

-d参数可以读取本地文本文件的数据，向服务器发送。

$ curl -d '@data.txt' https://google.com/login

上面命令读取data.txt文件的内容，作为数据体向服务器发送。

--data-urlencode 自动将发送的数据进行 URL 编码

--data-urlencode参数等同于-d，发送 POST 请求的数据体，区别在于会自动将发送的数据进行 URL 编码。

$ curl --data-urlencode 'comment=hello world' https://google.com/login

上面代码中，发送的数据hello world之间有一个空格，需要进行 URL 编码。

-e 设置 HTTP 标头的请求的来源

-e参数用来设置 HTTP 的标头Referer，表示请求的来源。

curl -e 'https://google.com?q=example' https://www.example.com

上面命令将Referer标头设为https://google.com?q=example。

-H参数可以通过直接添加标头Referer，达到同样效果。

curl -H 'Referer: https://google.com?q=example' https://www.example.com

-F上传二进制文件

-F参数用来向服务器上传二进制文件。

$ curl -F 'file=@photo.png' https://google.com/profile

上面命令会给 HTTP 请求加上标头Content-Type: multipart/form-data，然后将文件photo.png作为file字段上传。

-F参数可以指定 MIME 类型。

$ curl -F 'file=@photo.png;type=image/png' https://google.com/profile

上面命令指定 MIME 类型为image/png，否则 curl 会把 MIME 类型设为application/octet-stream。

-F参数也可以指定文件名。

$ curl -F 'file=@photo.png;filename=me.png' https://google.com/profile

上面命令中，原始文件名为photo.png，但是服务器接收到的文件名为me.png。

-G 构造 URL 的查询字符串

-G参数用来构造 URL 的查询字符串。

$ curl -G -d 'q=kitties' -d 'count=20' https://google.com/search

上面命令会发出一个 GET 请求，实际请求的 URL 为https://google.com/search?q=kitties&count=20。如果省略--G，会发出一个 POST 请求。

如果数据需要 URL 编码，可以结合--data--urlencode参数。

$ curl -G --data-urlencode 'comment=hello world' https://www.example.com

-H 指定HTTP 请求的标头

-H参数添加 HTTP 请求的标头。

下面命令添加 HTTP 标头Accept-Language: en-US。

$ curl -H 'Accept-Language: en-US' https://google.com

下面命令添加两个 HTTP 标头。

$ curl -H 'Accept-Language: en-US' -H 'Secret-Message: xyzzy' https://google.com

下面命令添加 HTTP 请求的标头是Content-Type: application/json，然后用-d参数发送 JSON 数据。

$ curl -d '{"login": "emma", "pass": "123"}' -H 'Content-Type: application/json' https://google.com/login

设置User-Agent绕过服务器访问代理检测，可用于爬虫欺骗

curl -H'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:69.0) Gecko/20100101 Firefox/69.0'

设置Host绕过主机头检测，替代更改host文件的繁琐操作

curl -H'Host: xxxx' IP

-i 显示Response头信息，并打印源码

-i参数打印出服务器回应的 HTTP 标头。

$ curl -i https://www.example.com

上面命令收到服务器回应后，先输出服务器回应的标头，然后空一行，再输出网页的源码。

-I 显示Response头信息，不打印源码

-I参数向服务器发出 HEAD 请求，然会将服务器返回的 HTTP 标头打印出来。

$ curl -I https://www.example.com

上面命令输出服务器对 HEAD 请求的回应。

--head参数等同于-I。

$ curl --head https://www.example.com

-k 跳过 SSL 检测

-k参数指定跳过 SSL 检测。

$ curl -k https://www.example.com

上面命令不会检查服务器的 SSL 证书是否正确。

-L 指定HTTP 请求跟随服务器的重定向

-L参数会让 HTTP 请求跟随服务器的重定向。curl 默认不跟随重定向。

$ curl -L -d 'tweet=hi' https://api.twitter.com/tweet

--limit-rate 限制 HTTP 请求和回应的带宽

--limit-rate用来限制 HTTP 请求和回应的带宽，模拟慢网速的环境。

$ curl --limit-rate 200k https://google.com

上面命令将带宽限制在每秒 200K 字节。

-o 服务器的响应保存成文件

-o参数将服务器的回应保存成文件，等同于wget命令。

$ curl -o example.html https://www.example.com

上面命令将www.example.com保存成example.html。

-O 将URL的最后部分当作文件名保存

-O参数将服务器回应保存成文件，并将 URL 的最后部分当作文件名。

$ curl -O https://www.example.com/foo/bar.html

上面命令将服务器回应保存成文件，文件名为bar.html。

-s 不输出错误和进度信息

-s参数将不输出错误和进度信息。

$ curl -s https://www.example.com

上面命令一旦发生错误，不会显示错误信息。不发生错误的话，会正常显示运行结果。

如果想让 curl 不产生任何输出，可以使用下面的命令。

$ curl -s -o /dev/null https://google.com

-S 指定只输出错误信息

-S参数指定只输出错误信息，通常与-s一起使用。

$ curl -s -o /dev/null https://google.com

上面命令没有任何输出，除非发生错误。

-u 设置服务器认证的用户名和密码

-u参数用来设置服务器认证的用户名和密码。

$ curl -u 'bob:12345' https://google.com/login

上面命令设置用户名为bob，密码为12345，然后将其转为 HTTP 标头Authorization: Basic Ym9iOjEyMzQ1。

curl 能够识别 URL 里面的用户名和密码。

$ curl https://bob:12345@google.com/login

上面命令能够识别 URL 里面的用户名和密码，将其转为上个例子里面的 HTTP 标头。

$ curl -u 'bob' https://google.com/login

上面命令只设置了用户名，执行后，curl 会提示用户输入密码。

-v 输出通信的整个过程

-v参数输出通信的整个过程，用于调试。

$ curl -v https://www.example.com

--trace参数也可以用于调试，还会输出原始的二进制数据。

$ curl --trace - https://www.example.com

-x 指定 HTTP 请求的代理

-x参数指定 HTTP 请求的代理。

下面命令指定 HTTP 请求通过myproxy.com:8080的 socks5 代理发出。

$ curl -x socks5://james:cats@myproxy.com:8080 https://www.example.com

如果没有指定代理协议，默认为 HTTP。下面命令中，请求的代理使用 HTTP 协议。

$ curl -x james:cats@myproxy.com:8080 https://www.example.com

-x指定代理，可用于IP被拉黑时绕过IP检测

curl -x 127.0.0.1:8080 http://www.baidu.com

-X 指定 HTTP 请求的方法

-X参数指定 HTTP 请求的方法。

$ curl -X POST https://www.example.com

上面命令对https://www.example.com发出 POST 请求。

参数	说明
-a/--append	上传文件时，附加到目标文件
--anyauth	可以使用“任何”身份验证方法
--basic	使用HTTP基本验证
-B/--use-ascii	使用ASCII文本传输
-d/--data	HTTP POST方式传送数据
--data-ascii	以ascii的方式post数据
--data-binary	以二进制的方式post数据
--negotiate	使用HTTP身份验证
--digest	使用数字身份验证
--disable-eprt	禁止使用EPRT或LPRT
--disable-epsv	禁止使用EPSV
--egd-file	为随机数据(SSL)设置EGD socket路径
--tcp-nodelay	使用TCP_NODELAY选项
-E/--cert <cert[:passwd]>	客户端证书文件和密码 (SSL)
--cert-type	证书文件类型 (DER/PEM/ENG) (SSL)
--key	私钥文件名 (SSL)
--key-type	私钥文件类型 (DER/PEM/ENG) (SSL)
--pass	私钥密码 (SSL)
--engine	加密引擎使用 (SSL). "--engine list" for list
--cacert	CA证书 (SSL)
--capath	CA目 (made using c_rehash) to verify peer against (SSL)
--ciphers	SSL密码
--compressed	要求返回是压缩的形势 (using deflate or gzip)
--connect-timeout	设置最大请求时间
--create-dirs	建立本地目录的目录层次结构
--crlf	上传是把LF转变成CRLF
--ftp-create-dirs	如果远程目录不存在，创建远程目录
--ftp-method [multicwd/nocwd/singlecwd]	控制CWD的使用
--ftp-pasv	使用 PASV/EPSV 代替端口
--ftp-skip-pasv-ip	使用PASV的时候,忽略该IP地址
--ftp-ssl	尝试用 SSL/TLS 来进行ftp数据传输
--ftp-ssl-reqd	要求用 SSL/TLS 来进行ftp数据传输
-F/--form <name=content>	模拟http表单提交数据
-form-string <name=string>	模拟http表单提交数据
-g/--globoff	禁用网址序列和范围使用{}和[]
-G/--get	以get的方式来发送数据
-h/--help	帮助
-H/--header	自定义头信息传递给服务器
--ignore-content-length	忽略的HTTP头信息的长度
-i/--include	输出时包括protocol头信息
-I/--head	只显示文档信息
-j/--junk-session-cookies	读取文件时忽略session cookie
--interface	使用指定网络接口/地址
--krb4	使用指定安全级别的krb4
-k/--insecure	允许不使用证书到SSL站点
-K/--config	指定的配置文件读取
-l/--list-only	列出ftp目录下的文件名称
--limit-rate	设置传输速度
--local-port	强制使用本地端口号
-m/--max-time	设置最大传输时间
--max-redirs	设置最大读取的目录数
--max-filesize	设置最大下载的文件总量
-M/--manual	显示全手动
-n/--netrc	从netrc文件中读取用户名和密码
--netrc-optional	使用 .netrc 或者 URL来覆盖-n
--ntlm	使用 HTTP NTLM 身份验证
-N/--no-buffer	禁用缓冲输出
-p/--proxytunnel	使用HTTP代理
--proxy-anyauth	选择任一代理身份验证方法
--proxy-basic	在代理上使用基本身份验证
--proxy-digest	在代理上使用数字身份验证
--proxy-ntlm	在代理上使用ntlm身份验证
-P/--ftp-port	使用端口地址，而不是使用PASV
-Q/--quote	文件传输前，发送命令到服务器
--range-file	读取（SSL）的随机文件
-R/--remote-time	在本地生成文件时，保留远程文件时间
--retry	传输出现问题时，重试的次数
--retry-delay	传输出现问题时，设置重试间隔时间
--retry-max-time	传输出现问题时，设置最大重试时间
-S/--show-error	显示错误
--socks4 <host[:port]>	用socks4代理给定主机和端口
--socks5 <host[:port]>	用socks5代理给定主机和端口
-t/--telnet-option <OPT=val>	Telnet选项设置
--trace	对指定文件进行debug
--trace-ascii	Like --跟踪但没有hex输出
--trace-time	跟踪/详细输出时，添加时间戳
--url	Spet URL to work with
-U/--proxy-user <user[:password]>	设置代理用户名和密码
-V/--version	显示版本信息
-X/--request	指定什么命令
-y/--speed-time	放弃限速所要的时间。默认为30
-Y/--speed-limit	停止传输速度的限制，速度时间'秒
-z/--time-cond	传送时间设置
-0/--http1.0	使用HTTP 1.0
-1/--tlsv1	使用TLSv1（SSL）
-2/--sslv2	使用SSLv2的（SSL）
-3/--sslv3	使用的SSLv3（SSL）
--3p-quote	like -Q for the source URL for 3rd party transfer
--3p-url	使用url，进行第三方传送
--3p-user	使用用户名和密码，进行第三方传送
-4/--ipv4	使用IP4
-6/--ipv6	使用IP6

GET/POST请求使用示例

一般情况下，我们调试数据接口，都会使用一个 postman 的工具，但是有的场景是从服务器1请求服务器2，而我们自己主机不能直接访问服务器2，这时可以在服务器1命令行使用curl命令测试接口。

curl GET 请求

不加参数时，默认发出GET请求，查看页面源码

命令：

# protocol:请求协议、address:ip、port:端口、url:地址、args:参数
curl protocol://address:port/url?args

🌰：

curl http://127.0.0.1:8080/demo/curl-test/get

curl http://127.0.0.1:8080/login?username=admin&passwd=12345678  # 带参数请求，参数用&连接

我们就可以请求到我们的数据了

如果想看到详细的请求信息，我们可以加上 -v 参数

curl POST 请求

基础应用

我们可以用 -X POST 来申明我们的请求方法，用 -d 参数，来传送我们的参数。

所以，我们可以用 -X PUT 和 -X DELETE 来指定另外的请求方法。

一般我们的接口都是 json 格式的，我们可以用 -H 参数来申明请求的 header。

curl http://192.168.56.103:7788/demo/curl-test/post -X POST -H "Content-Type:application/json" -d '{"name": "leizi","age": 25,"address": "杭州"}'

如上，这就是一个普通的 post 请求。

注意点❗：

1、传递json格式的入参

-d可以指定入参为json格式，此时需要 -H 指定 Content-type=application/json 的请求头
json格式入参：使用单引号''括起json格式的入参，单引号中的内容是可以json解析的内容

2、Content-Type

当使用POST方法提交数据时，对于提交的数据主要有如下四种形式：

• application/x-www-form-urlencoded：默认的形式，即key1=value1&key2=value2的形式；
• multipart/form-data：使用表单上传文件时使用这个形式；
• application/json：提交JSON格式的数据；
• text/xml：提交XML格式的数据。

Content-Type是一个Header，如果不指定的话，那么默认就是使用application/x-www-form-urlencoded形式传输数据，当需要使用别的形式进行数据传输的话，那么就需要指定这个Header

多个请求头 option: -H

我们可以用 -H 来设置更多的 header 比如，用户的 token 之类的。

curl http://localhost:7788/demo/test/post -X POST -H "Content-Type:application/json" -H "token:6666" -d '{"name": "leizi","age": 25,"address": "杭州"}'

同样，我们可以用 -v 来查看详情。

转化成一个GET

使用-G或-get选项，可以把一个POST请求转化成一个GET请求。如果有-d选项指定的参数，那么curl就会把-d后面的数据添加到URL的后面，用?连接。比如：

curl -d "key1=value1" -G http://example.com

得到的请求URL就是：

http://example.com/?key1=value1

multipart/form-data

如果一个HTTP POST具有如下形式的表单：

<form action="submit.cgi" method="post" enctype="multipart/form-data">
    Name: <input type="text" name="person"><br>
    File: <input type="file" name="secret"><br>
    <input type="submit" value="Submit">
</form>

用户可以在Name中填写名字，在File中选择一个文件，然后单击Submit按钮提交数据。

为了可以在curl中模拟这个请求，我们可以使用-F或–form选项来指定数据：

curl -F person=annonymous -F secret=@filename http://example.com/submit.cgi

在上面的表单中，action指定了这个请求发送到哪里；method指定这是一个POST请求；而enctype指定了这是一个multipart formpost。

当执行上面的curl命令后，curl会产生如下的请求头：

POST /submit.cgi HTTP/1.1
Host: example.com
User-Agent: curl/7.46.0
Accept: */*
Content-Length: 313
Content-Type: multipart/form-data; boundary=------------------------d74496d66958873e

其中Content-Type是和enctype一致的。

当使用-F选项时，默认的Content-Type就是multipart/form-data，不过，我们也可以使用-H进行指定：

curl -F 'name=Dan' -H 'Content-Type: multipart/magic' https://example.com

application/x-www-form-urlencoded

当请求接口类型是x-www-form-urlencoded，请求的参数可以使用如下方式配置。

curl -d 'userName=zhangsan&age=18&' -H "Content-Type: application/x-www-form-urlencoded" -X POST http://localhost:8080/user/test

curl POST 上传二进制文件

上面的两种请求，都是只传输字符串，我们在测试上传接口的时候，会要求传输文件。

我们用 -F "file=@filePath" 的选项，传输文件即可。命令如下：

curl http://192.168.56.103:7788/demo/curl-test/file -F "file=@/home/image.jpg" -v

执行结果如下图所示：

上面命令会给 HTTP 请求加上标头Content-Type: multipart/form-data，然后将文件image.jpg作为file字段上传。

POST一个二进制数据

在curl中，我们也可以提交一个文件，可以使用–data-binary选项来指定一个文件：

curl --data-binary @filename http://example.com

命令行是可以保存历史记录的，我们使用 ctrl+r 快捷键可以进行历史命令搜索，这样，我们可以非常方便的重复进行命令调试。在命令行中使用 ctrl + r 激活搜索，然后输入关键词。如果搜索出来的结果有多条，当前的这条不是你想要的，继续按 ctrl + r 快捷键，可以切换搜索结果。确定了某条历史执行命令之后，可以按 回车键 立即执行该命令，也可以按一下 ➡️ 右方向键，然后退出搜索模式，进而修改这条命令，然后继续执行。

更多 curl 的使用方法，以及参数说明，可以在系统中输入 man curl 来进行查看。或者，点击 curl man 查看网页版的介绍。