通用语法：

curl [option] [URL...]

在处理URL时其支持类型于SHELL的名称扩展功能，如http://www.jbxue.com/archive[1996-1999]/vol[1-4]/part{a,b,c}.html可以生成多个期望的URL

curl的选项功能：

• 不带任何参数时 curl 将返回指定url中的数据并打印在屏幕上

• -u 使用用户名和密码登陆。如curl -uname:passwd URL

• -b/--cookie  <name=data>   向服务器提交cookie，若无=则name视为文件名，例如：curl -b cookie.txt www.jbxue.com

• -o out  将指定curl返回保存为out文件，内容从html/jpg到各种MIME类型文件。如curl -o page.html URL

• -d <key=value>  向服务器POST表单数据 例如：curl -d "order=111&count=2" http://www.jbxue.com/buy

• -A/--user-agent  <ua>  指定发送请求的用户代理，例如：curl -A My-Agent/1.0.0 www.jbxue.com 

• -x  ip:port 指定使用的http代理，例如：curl -x 192.168.1.1:8080 www.jbxue.com

• -D head.txt  将服务器的返回的header保存为文件，头部的cookie也可被保存，例如：curl -D header.txt www.jbxue.com  

  • 如果希望从本地文件中获取表单数据，则在文件名前加@ ，例如：curl -d @data.xml http://www.jbxue.com

  • 若希望从标准输入获取则用 curl -d "name=username&passwd=pwd" http://www.jbxue.com

• -L 当页面有跳转的时候，输出跳转到的页面

• -I  header信息  当有跳转时，可以通过 curl -L -I URL|grep Location 来确定跳转到的新url地址

• -c <file> 保存服务器的cookie文件

• -e url  设置引用头的值

• -T localfile  向服务器PUT文件 例如：curl -T 1.mp3  www.jbxue.com/upload.php

• -F <key=value> 向服务器POST表单，例如：curl -F "web=@index.html;type=text/html" url.com

• -E cert.pem  指定本地证书

• -H <header:value>  为HTTP请求设置任意header及值。如curl -H "Connection:keep-alive" http://www.jbxue.com

• -X/--request method 用户定义的HTTP请求方法名如 curl -X GET www.baidu.com

• --compressed 采用压缩方式接收返回数据

• --connect-timeout <s> 设置超时时间

• -v 详细输出，包含请求和响应的首部

• --retry num

• --retry timeo 指定重试的次数和间隔

• --tcp-nodelay 打开TCP_NODELAY选项  不进行捎带确认

• -O  按服务器上的名称保存下载的文件

• -r/--range  from-to 下载指定range内的数据

• -C 在保存文件时进行续传

环境 变量：http_proxy [protocol://]<host>[:port]

CURL 的十种常见用法：

1. 获取页面内容

当我们不加任何选项使用 curl 时，默认会发送 GET 请求来获取链接内容到标准输出。 

curl 

2. 显示 HTTP 头

如果我们只想要显示 HTTP 头，而不显示文件内容，可以使用 -I 选项： 

curl -I  输出为：

HTTP/1.1 200 OKServer: nginx/1.10.3Date: Thu, 11 May 2017 08:24:45 GMTContent-Type: text/html; charset=utf-8Content-Length: 24206Connection: keep-aliveX-Powered-By: ExpressCache-Control: public, max-age=0ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"Vary: Accept-Encoding

也可以同时显示 HTTP 头和文件内容，使用 -i 选项： 

curl -i  输出为：

HTTP/1.1 200 OKServer: nginx/1.10.3Date: Thu, 11 May 2017 08:25:46 GMTContent-Type: text/html; charset=utf-8Content-Length: 24206Connection: keep-aliveX-Powered-By: ExpressCache-Control: public, max-age=0ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"Vary: Accept-Encoding......

3. 将链接保存到文件

我们可以使用 > 符号将输出重定向到本地文件中。 

curl  > index.html 也可以通过 curl 自带的 -o/-O 选项将内容保存到文件中。

-o（小写的 o）：结果会被保存到命令行中提供的文件名 

-O（大写的 O）：URL 中的文件名会被用作保存输出的文件名 curl -o index.html  curl -O  注意：使用 -O 选项时，必须确保链接末尾包含文件名，否则 curl 无法正确保存文件。如果遇到链接中无文件名的情况，应该使用 -o 选项手动指定文件名，或使用重定向符号。

4. 同时下载多个文件

我们可以使用 -o 或 -O 选项来同时指定多个链接，按照以下格式编写命令： 

curl -O  -O 

或者： 

curl -o page1.html  -o page2.html 

5. 使用 -L 跟随链接重定向

如果直接使用 curl 打开某些被重定向后的链接，这种情况下就无法获取我们想要的网页内容。例如： 

curl  会得到如下提示：

     
      
       
301 Moved Permanently
      
      
      
       nginx/1.10.3
      
     

而当我们通过浏览器打开该链接时，会自动跳转到 。此时我们想要 curl 做的，就是像浏览器一样跟随链接的跳转，获取最终的网页内容。我们可以在命令中添加 -L 选项来跟随链接重定向：

curl -L  

这样我们就能获取到经过重定向后的网页内容了。

6. 使用 -A 自定义 User-Agent

我们可以使用 -A 来自定义用户代理，例如下面的命令将伪装成安卓火狐浏览器对网页进行请求： 

curl -A “Mozilla/5.0 (Android; Mobile; rv:35.0) Gecko/35.0 Firefox/35.0”  下面我们会使用 -H 来实现同样的目的。

7. 使用 -H 自定义 header

当我们需要传递特定的 header 的时候，可以仿照以下命令来写： 

curl -H “Referer: www.example.com” -H “User-Agent: Custom-User-Agent”  可以看到，当我们使用 -H 来自定义 User-Agent 时，需要使用 “User-Agent: xxx” 的格式。

我们能够直接在 header 中传递 Cookie，格式与上面的例子一样： 

curl -H “Cookie: JSESSIONID=D0112A5063D938586B659EF8F939BE24”  另一种方式会在下面介绍。

8. 使用 -c 保存 Cookie

当我们使用 cURL 访问页面的时候，默认是不会保存 Cookie 的。有些情况下我们希望保存 Cookie 以便下次访问时使用。例如登陆了某个网站，我们希望再次访问该网站时保持登陆的状态，这时就可以现将登陆时的 Cookie 保存起来，下次访问时再读取。

-c 后面跟上要保存的文件名。 

curl -c “cookie-example” 

9. 使用 -b 读取 Cookie

前面讲到了使用 -H 来发送 Cookie 的方法，这种方式是直接将 Cookie 字符串写在命令中。如果使用 -b 来自定义 Cookie，命令如下： 

curl -b “JSESSIONID=D0112A5063D938586B659EF8F939BE24”  如果要从文件中读取 Cookie，-H 就无能为力了，此时可以使用 -b 来达到这一目的： curl -b “cookie-example”  即 -b 后面既可以是 Cookie 字符串，也可以是保存了 Cookie 的文件名。

10. 使用 -d 发送 POST 请求

我们以登陆网页为例来进行说明使用 cURL 发送 POST 请求的方法。假设有一个登录页面 www.example.com/login，只需要提交用户名和密码便可登录。我们可以使用 cURL 来完成这一 POST 请求，-d 用于指定发送的数据，-X 用于指定发送数据的方式： 

curl -d “userName=tom&passwd=123456” -X POST 

在使用 -d 的情况下，如果省略 -X，则默认为 POST 方式： 

curl -d “userName=tom&passwd=123456” 

强制使用 GET 方式 

发送数据时，不仅可以使用 POST 方式，也可以使用 GET 方式，例如： curl -d “somedata” -X GET 

或者使用 -G 选项： 

curl -d “somedata” -G 

从文件中读取 data 

curl -d “@data.txt” 

带 Cookie 登录 

当然，如果我们再次访问该网站，仍然会变成未登录的状态。我们可以用之前提到的方法保存 Cookie，在每次访问网站时都带上该 Cookie 以保持登录状态。 curl -c “cookie-login” -d “userName=tom&passwd=123456”  再次访问该网站时，使用以下命令： curl -b “cookie-login”  这样，就能保持访问的是登录后的页面了。

常用操作：

需要传递用户名密码校验的请求

curl -u username:pass http://www.xxx.com

需要传递token校验的请求

curl -H "Authorization token:xxxxxx"  http://www.xxx.com

需要指定http method的请求

curl -H "ContentType: text" --request GET\DELETE\PUT http://www.xxxx.com

只获取header信息

curl -I http://www.xxx.com

提交数据json格式

curl -H ""Content-Type: application/json"  -d '{"name":"name"}--request GET\DELETE\PUT http://www.xxxx.comcurl -H ""Content-Type: application/json"  -d 'a=1&b=2' --request GET\DELETE\PUT http://www.xxxx.com

使用 cURL 度量 Web 站点的响应时间

$curl -o /dev/null -s -w %{time_connect}:%{time_starttransfer}:%{time_total} http://www.xxx.com0.081:0.272:0.779

通过 -o 参数发送到 /dev/null。 -s 参数去掉所有状态信息。-w参数让 curl 写出列出的计时器的状态信息：

time_connect     建立到服务器的 TCP 连接所用的时间

time_starttransfer     在发出请求之后，Web 服务器返回数据的第一个字节所用的时间

time_total         完成请求所用的时间！

源文档：