hudada-cli/data/linux/Curl常用命令.md

专为程序员准备的本地文档搜索,快捷开发工具

# curl常用命令

## curl简介

curl 即 client URL 的简写，使用 shell 命令来发送URL请求。



## curl默认请求命令

**最基础的 curl 默认请求命令：**

```
curl www.puxiao.com
```

**默认请求注意事项：**

1. 默认以 GET 方式请求 目标网址(URL)
2. 若目标网址(URL)存在跳转，默认并不会返回跳转后的网址内容

例如 上面代码中 `curl www.puxiao.com` 中 `www.puxiao.com`，事实上会返回304状态，默认跳转到 `https://www.puxiao.com`。但是默认 curl 并不会请求跳转后的网址，而仅仅返回 `www.puxiao.com` 本身的内容。



## curl设置Headers(请求标头)

-H 参数用来直接设置 Request Headers 中的字段。

**添加Content-Type字段：**

```
curl -H 'Content-Type: application/json' https://puxiao.com
```

**同时添加多个字段：**

```
culr -H 'Content-Type: application/json' -H 'Accept-Language: zh-CN' https://puxiao.com
```



## curl设置Headers中的User-Agent(用户代理标头)

-A 参数指定客户端的用户代理标头，即 Request Headers 中的 User-Agent，默认 curl 请求用户代理标头值为 curl/[version] 。

**将 User-Agent 设置成 Chrome 浏览器：**

```
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://puxiao.com
```

**移除 User-Agent ：**

```
curl -A '' https://puxiao.com
```

-A为设置 User-Agent 标头，也可以通过 -H 直接设置 Request Headers：

**直接使用 -H 来添加，达到同样效果：**

```
curl -H 'User-Agent: xxxx' https://puxiao.com
```



## curl设置headers中的Referer(来源)

-e 设置 headers 中的 Referer(请求的来源)。

**设置 Referer：**

```
curl -e 'https://www.baidu.com/' https://puxiao.com
```

**直接使用 -H 来添加，达到同样效果：**

```
curl -H 'Referer:https://www.baidu.com' https://puxiao.com
```



## curl设置请求随服务器重定向

-L 参数会让请求跟随服务器的重定向。例如之前举得例子：`curl www.puxiao.com`，由于服务器上会进行 http跳转至 https，首先返回 304，然后将网址跳转至 `https://www.puxiao.com`，若添加 -L 参数则可让请求返回重定向后的网页内容。

**设置请求跟随重定向：**

```
curl -L www.puxiao.com
```

> 此时会返回重新定向后的 `https://www.puxiao.com` 的内容



## curl发送和保存cookie

-b 参数用来向请求中携带 cookie。

**携带1个cookie参数：**

```
curl -b 'uname=puxiao' https://puxiao.com
```

**携带多个cookie参数：**

```
curl -b 'uname=puxiao;id=px1986' https://puxiao.com
```

> 2个参数之间使用 分号(;) 连接

**读取并携带本地 cookie.txt 文件内容：**

```
curl -b cookie.txt https://puxiao.com
```

**接收并写入本地 cookie.txt 文件内容：**

```
curl -c cookie.txt https://puxiao.com
```



## curl设置请求方式

-X 参数用来设置请求方式。默认不设置，请求方式为 GET 。

**设置为POST请求方式：**

```
curl -X POST https://puxiao.com
```



## curl使用POST请求

-d 参数用来设置发送 POST 请求的数据体。注意：若使用了 -d 参数，则自动会在请求 headers 中添加：Content-Type: application/x-www-form-urlencoded，并且自动将请求方式转为 POST，因此无需额外设置 -X POST 。

> 注意：-d 参数默认是不会对数据体进行 URL 编码的
> 例如：`curl -d 'msg=hello world' https://puxiao.com` 中 `hello world`中的空格可能会造成数据错误。

**设置请求数据体：**

```
curl -d 'uid=puxiao&pwd=123456' https://puxiao.com/login
```

或者将多个数据体中的字段单独定义

```
curl -d 'uid=puxiao' -d 'pwd=123456' https://puxiao.com/login
```

**读取本地文件内容作为数据体：**

```
curl -d '@data.txt' https://puxiao.com/login
```

> 注意要在 data.txt 文件前面加上 @ 符号以表示这个为文件路径

**设置数据体并自动URL转码：**

--data-urlencode 参数等同于 -d，并且会自动将数据进行 URL 转码。

```
curl --data-urlencode 'msg=hello world' https://puxiao.com/write
```

**POST发送JSON数据：**

除了设置数据体，重点还要设置 headers 中 Content-Type 的值。

```
curl -d '{"uid":"puxiao","pwd":"123456"}' -H 'Content-Type : application/json' https://puxiao.com/login
```



## curl构造GET请求参数

curl 默认即 GET 请求方式，例如：`curl https://puxiao.com/search?a=2&b=3` ，但是也可以通过 -G -d 结合形式来构造 GET 请求参数。

**构造GET请求参数：**

```
curl -G -d 'a=2;b=3' https://puxiao.com/search
```

或

```
curl -G -d 'a=2' -d 'b=3' https://puxiao.com/search
```

> 上述代码最终执行效果，等同于：`curl https://puxiao.com/search?a=2&b=3`

原本 -d 参数会让请求自动变为 POST，但是加上 -G 之后会让请求方式变为 GET，并且 数据体 自动构建成 GET 请求的参数。

**再次提醒：**-d 并不会进行参数 URL 转码，因此如果使用 -G ，更多时候应该使用 --data-urlencode 。



## curl上传文件

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

**上传二进制文件：**

```
curl -F 'file=@aa.jpg' https://puxiao.com/upload
```

> 默认会自动给 headers 中添加：Content-Type: multipart/form-data，然后将文件 aa.jpg 作为 file 字段上传。

**指定 MIME 类型：**

```
curl -F 'file=@aa.jpg;type=image/jpg' https://puxiao.com/upload
```

**指定文件名：**

```
curl -F 'file=@aa.jpg;filename=bb.jpg' https://puxiao.com/upload
```

> 上述命令中，原始文件名为 aa.jpg，但是服务器接收到的文件名为 bb.jpg



## curl打印返回信息头(Respone Headers)

-i 参数打印出服务器返回信息头(respone headers)。

**先打印出返回信息头，再打印出网页内容：**

```
curl -i https://puxiao.com
```

> 会先打印出返回信息头，然后空一行，再打印出网页内容

**仅引出返回信息头，不打印网页内容：**

```
curl -I https://puxiao.com
```

--head 等同于 -I，因此上述命令也可以写成：

```
curl --head https://puxiao.com
```



## curl跳过SSL检测

-k 参数可以指定跳过 SSL 检测，不会去检查服务器 SSL 证书是否正确。

**跳过SSL检测：**

```
curl -k https://puxiao.com
```



## curl模拟网速带宽

--limit-rate 用来限制 请求和回应 的网速(网络带宽)，可以模拟出网速不好的情况。

**模拟限制网速带宽：**

```
curl --limit-rate 200k https://puxiao.com
```

> 模拟每秒 200k 的带宽情况下的请求和回应



## curl保存文件

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

**以xxx.xx名字保存文件：**

```
curl -o index.html https://puxiao.com
```

> 上述命令会将网页返回内容保存为 index.html 文件。



**直接保存文件：**

-O 参数将服务器回应的内容保存成文件，并且将 URL 的后面部分直接当做文件名。

```
curl -O https://puxiao.com/me.jpg
```

> 会直接将文件以 me.jpg 的名字保存到本地

**文件保存位置：**论使用哪种保存参数，文件保存目录均为 终端 shell 命令中 当前所在的目录。



## curl控制输出信息

默认情况下，curl 若不发生错误 则输出返回的网页内容，若发生错误，则输出错误信息。

**仅输出正确的返回信息，不输出错误和进度信息：**

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

```
curl -s https://puxiao.com
```

> 因为添加有 -s ，即使请求发生错误也不输出任何错误信息。

**仅输出错误信息，不输出正确的返回信息：**

-S 参数将设置仅输出错误信息

```
curl -S https://puxiao.com
```

**设置不输出任何信息(错误信息和正常的返回信息)：**

-o /dev/null 参数将设置不输出任何信息

```
curl -s -o /dev/null https://puxiao.com
```

> 上述命令，无论 curl 是否遇到错误，均不输出任何信息



## curl设置服务器认证信息(用户名和密码)

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

**设置服务器认证信息：**

```
curl -u 'puxiao:123456' https://puxiao.com/login
```

补充说明：

1. 用户名和密码之间，使用冒号(:)分割连接。
2. 自动会在请求 headers 中添加：Authorization: Basic Ym9iOjEyMzQ1

**识别URL中的用户名和密码：**

curl会自动识别 URL 中的用户名和密码，格式为：用户名:密码@URL，例如：

```
curl https://puxiao:123456@puxiao.com/login
```

**后期补齐密码：**

```
curl -u 'puxiao' https://puxiao.com/login
```

> 上述命令只设置了用户名，执行后，curl 会提示需要输入密码，注意此时输入密码时，为了密码安全，是不会有任何输入光标变动提示的(无法看到已输入密码长度)。



## curl通信过程中的调试

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

**调试更新整个过程：**

```
curl -v https://puxiao.com
```

> 会打印出请求过程中的一些细节，例如 请求对应的IP地址、request headers、respone headers等

**显示接收到的二进制数据：**

--trace - 参数可以打印出接收数据过程中的原始二进制数据

```
curl --trace - https://puxiao.com
```



## curl设置请求代理

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

**设置请求代理：**

```
curl -x socks5://puxiao:123456@xxxx.com:8080 https://puxiao.com
```

通过请求 xxxx.com:8080的 socks5 代理发出请求。

如果没有指定代理协议，默认为 http 协议，例如：

```
curl -x puxiao:123456@xxxx.com:8080 https://puxiao.com
```

> 上面的请求中，会使用默认的 http 协议作为代理协议，等同于：`curl -x http://puxiao:123456@xxxx.com:8080 https://puxiao.com`