curl

利用URL規(guī)則在命令行下工作的文件傳輸工具

補(bǔ)充說(shuō)明

curl命令 是一個(gè)利用URL規(guī)則在命令行下工作的文件傳輸工具。它支持文件的上傳和下載，所以是綜合傳輸工具，但按傳統(tǒng)，習(xí)慣稱curl為下載工具。作為一款強(qiáng)力工具，curl支持包括HTTP、HTTPS、ftp等眾多協(xié)議，還支持POST、cookies、認(rèn)證、從指定偏移處下載部分文件、用戶代理字符串、限速、文件大小、進(jìn)度條等特征。做網(wǎng)頁(yè)處理流程和數(shù)據(jù)檢索自動(dòng)化，curl可以祝一臂之力。

語(yǔ)法

curl(選項(xiàng))(參數(shù))

選項(xiàng)

-a/--append	上傳文件時(shí)，附加到目標(biāo)文件
-A/--user-agent	設(shè)置用戶代理發(fā)送給服務(wù)器
-anyauth	可以使用“任何”身份驗(yàn)證方法
-b/--cookie	cookie字符串或文件讀取位置
? ? ?--basic	使用HTTP基本驗(yàn)證
-B/--use-ascii	使用ASCII /文本傳輸
-c/--cookie-jar	操作結(jié)束后把cookie寫入到這個(gè)文件中
-C/--continue-at	斷點(diǎn)續(xù)傳
-d/--data	HTTP POST方式傳送數(shù)據(jù)
? ? ?--data-ascii	以ascii的方式post數(shù)據(jù)
? ? ?--data-binary	以二進(jìn)制的方式post數(shù)據(jù)
? ? ?--negotiate	使用HTTP身份驗(yàn)證
? ? ?--digest	使用數(shù)字身份驗(yàn)證
? ? ?--disable-eprt	禁止使用EPRT或LPRT
? ? ?--disable-epsv	禁止使用EPSV
-D/--dump-header	把header信息寫入到該文件中
? ? ?--egd-file	為隨機(jī)數(shù)據(jù)(SSL)設(shè)置EGD socket路徑
? ? ?--tcp-nodelay	使用TCP_NODELAY選項(xiàng)
-e/--referer	來(lái)源網(wǎng)址
-E/--cert	客戶端證書文件和密碼 (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	要求返回是壓縮的形勢(shì) (using deflate or gzip)
? ? ?--connect-timeout	設(shè)置最大請(qǐng)求時(shí)間
? ? ?--create-dirs	建立本地目錄的目錄層次結(jié)構(gòu)
? ? ?--crlf	上傳是把LF轉(zhuǎn)變成CRLF
-f/--fail	連接失敗時(shí)不顯示http錯(cuò)誤
? ? ?--ftp-create-dirs	如果遠(yuǎn)程目錄不存在，創(chuàng)建遠(yuǎn)程目錄
? ? ?--ftp-method [multicwd/nocwd/singlecwd]	控制CWD的使用
? ? ?--ftp-pasv	使用 PASV/EPSV 代替端口
? ? ?--ftp-skip-pasv-ip	使用PASV的時(shí)候,忽略該IP地址
? ? ?--ftp-ssl	嘗試用 SSL/TLS 來(lái)進(jìn)行ftp數(shù)據(jù)傳輸
? ? ?--ftp-ssl-reqd	要求用 SSL/TLS 來(lái)進(jìn)行ftp數(shù)據(jù)傳輸
-F/--form	模擬http表單提交數(shù)據(jù)
? ? ?--form-string	模擬http表單提交數(shù)據(jù)
-g/--globoff	禁用網(wǎng)址序列和范圍使用{}和[]
-G/--get	以get的方式來(lái)發(fā)送數(shù)據(jù)
-H/--header	自定義頭信息傳遞給服務(wù)器
? ? ?--ignore-content-length	忽略的HTTP頭信息的長(zhǎng)度
-i/--include	輸出時(shí)包括protocol頭信息
-I/--head	只顯示請(qǐng)求頭信息
-j/--junk-session-cookies	讀取文件進(jìn)忽略session cookie
? ? ?--interface	使用指定網(wǎng)絡(luò)接口/地址
? ? ?--krb4	使用指定安全級(jí)別的krb4
-k/--insecure	允許不使用證書到SSL站點(diǎn)
-K/--config	指定的配置文件讀取
-l/--list-only	列出ftp目錄下的文件名稱
? ? ?--limit-rate	設(shè)置傳輸速度
? ? ?--local-port	強(qiáng)制使用本地端口號(hào)
-m/--max-time	設(shè)置最大傳輸時(shí)間
? ? ?--max-redirs	設(shè)置最大讀取的目錄數(shù)
? ? ?--max-filesize	設(shè)置最大下載的文件總量
-M/--manual	顯示全手動(dòng)
-n/--netrc	從netrc文件中讀取用戶名和密碼
? ? ?--netrc-optional	使用 .netrc 或者 URL來(lái)覆蓋-n
? ? ?--ntlm	使用 HTTP NTLM 身份驗(yàn)證
-N/--no-buffer	禁用緩沖輸出
-o/--output	把輸出寫到該文件中
-O/--remote-name	把輸出寫到該文件中，保留遠(yuǎn)程文件的文件名
-p/--proxytunnel	使用HTTP代理
? ? ?--proxy-anyauth	選擇任一代理身份驗(yàn)證方法
? ? ?--proxy-basic	在代理上使用基本身份驗(yàn)證
? ? ?--proxy-digest	在代理上使用數(shù)字身份驗(yàn)證
? ? ?--proxy-ntlm	在代理上使用ntlm身份驗(yàn)證
-P/--ftp-port	使用端口地址，而不是使用PASV
-q	作為第一個(gè)參數(shù)，關(guān)閉 .curlrc
-Q/--quote	文件傳輸前，發(fā)送命令到服務(wù)器
-r/--range	檢索來(lái)自HTTP/1.1或FTP服務(wù)器字節(jié)范圍
--range-file	讀取（SSL）的隨機(jī)文件
-R/--remote-time	在本地生成文件時(shí)，保留遠(yuǎn)程文件時(shí)間
? ? ?--retry	傳輸出現(xiàn)問(wèn)題時(shí)，重試的次數(shù)
? ? ?--retry-delay	傳輸出現(xiàn)問(wèn)題時(shí)，設(shè)置重試間隔時(shí)間
? ? ?--retry-max-time	傳輸出現(xiàn)問(wèn)題時(shí)，設(shè)置最大重試時(shí)間
-s/--silent	靜默模式。不輸出任何東西
-S/--show-error	顯示錯(cuò)誤
? ? ?--socks4	用socks4代理給定主機(jī)和端口
? ? ?--socks5	用socks5代理給定主機(jī)和端口
? ? ?--stderr	?
-t/--telnet-option	Telnet選項(xiàng)設(shè)置
? ? ?--trace	對(duì)指定文件進(jìn)行debug
? ? ?--trace-ascii	Like --跟蹤但沒(méi)有hex輸出
? ? ?--trace-time	跟蹤/詳細(xì)輸出時(shí)，添加時(shí)間戳
-T/--upload-file	上傳文件
? ? ?--url	Spet URL to work with
-u/--user	設(shè)置服務(wù)器的用戶和密碼
-U/--proxy-user	設(shè)置代理用戶名和密碼
-w/--write-out [format]	什么輸出完成后
-x/--proxy	在給定的端口上使用HTTP代理
-X/--request	指定什么命令
-y/--speed-time	放棄限速所要的時(shí)間，默認(rèn)為30
-Y/--speed-limit	停止傳輸速度的限制，速度時(shí)間

實(shí)例

文件下載

curl命令可以用來(lái)執(zhí)行下載、發(fā)送各種HTTP請(qǐng)求，指定HTTP頭部等操作。如果系統(tǒng)沒(méi)有curl可以使用yum install curl安裝，也可以下載安裝。curl是將下載文件輸出到stdout，將進(jìn)度信息輸出到stderr，不顯示進(jìn)度信息使用--silent選項(xiàng)。

curl URL --silent

這條命令是將下載文件輸出到終端，所有下載的數(shù)據(jù)都被寫入到stdout。

使用選項(xiàng)-O將下載的數(shù)據(jù)寫入到文件，必須使用文件的絕對(duì)地址：

curl http://example.com/text.iso --silent -O

選項(xiàng)-o將下載數(shù)據(jù)寫入到指定名稱的文件中，并使用--progress顯示進(jìn)度條：

curl http://example.com/test.iso -o filename.iso --progress
######################################### 100.0%

不輸出錯(cuò)誤和進(jìn)度信息

-s 參數(shù)將不輸出錯(cuò)誤和進(jìn)度信息。

curl -s https://www.example.com
# 上面命令一旦發(fā)生錯(cuò)誤，不會(huì)顯示錯(cuò)誤信息。不發(fā)生錯(cuò)誤的話，會(huì)正常顯示運(yùn)行結(jié)果。

如果想讓 curl 不產(chǎn)生任何輸出，可以使用下面的命令。

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

斷點(diǎn)續(xù)傳

curl能夠從特定的文件偏移處繼續(xù)下載，它可以通過(guò)指定一個(gè)便宜量來(lái)下載部分文件：

curl URL/File -C 偏移量

#偏移量是以字節(jié)為單位的整數(shù)，如果讓curl自動(dòng)推斷出正確的續(xù)傳位置使用-C -：
curl -C -URL

使用curl設(shè)置參照頁(yè)字符串

參照頁(yè)是位于HTTP頭部中的一個(gè)字符串，用來(lái)表示用戶是從哪個(gè)頁(yè)面到達(dá)當(dāng)前頁(yè)面的，如果用戶點(diǎn)擊網(wǎng)頁(yè)A中的某個(gè)連接，那么用戶就會(huì)跳轉(zhuǎn)到B網(wǎng)頁(yè)，網(wǎng)頁(yè)B頭部的參照頁(yè)字符串就包含網(wǎng)頁(yè)A的URL。

使用--referer選項(xiàng)指定參照頁(yè)字符串：

curl --referer http://www.google.com http://wangchujiang.com

用curl設(shè)置用戶代理字符串

有些網(wǎng)站訪問(wèn)會(huì)提示只能使用IE瀏覽器來(lái)訪問(wèn)，這是因?yàn)檫@些網(wǎng)站設(shè)置了檢查用戶代理，可以使用curl把用戶代理設(shè)置為IE，這樣就可以訪問(wèn)了。使用--user-agent或者-A選項(xiàng)：

curl URL --user-agent "Mozilla/5.0"
curl URL -A "Mozilla/5.0"

其他HTTP頭部信息也可以使用curl來(lái)發(fā)送，使用-H"頭部信息" 傳遞多個(gè)頭部信息，例如：

curl -H "Host:wangchujiang.com" -H "accept-language:zh-cn" URL

curl的帶寬控制和下載配額

使用--limit-rate限制curl的下載速度：

curl URL --limit-rate 50k

命令中用k（千字節(jié)）和m（兆字節(jié)）指定下載速度限制。

使用--max-filesize指定可下載的最大文件大小：

curl URL --max-filesize bytes

如果文件大小超出限制，命令則返回一個(gè)非0退出碼，如果命令正常則返回0。

curl --limit-rate 200k https://example.com
# 上面命令將帶寬限制在每秒 200K 字節(jié)。

用curl進(jìn)行認(rèn)證

使用curl選項(xiàng)?-u?可以完成HTTP或者FTP的認(rèn)證，可以指定密碼，也可以不指定密碼在后續(xù)操作中輸入密碼：

curl -u user:pwd http://wangchujiang.com
curl -u user http://wangchujiang.com

只打印響應(yīng)頭部信息

通過(guò)-I或者-head可以只打印出HTTP頭部信息：

[root@localhost text]# curl -I http://wangchujiang.com
HTTP/1.1 200 OK
Server: nginx/1.2.5
date: Mon, 10 Dec 2012 09:24:34 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
Vary: Accept-Encoding
X-Pingback: http://wangchujiang.com/xmlrpc.php

get請(qǐng)求

curl "http://www.wangchujiang.com"    # 如果這里的URL指向的是一個(gè)文件或者一幅圖都可以直接下載到本地
curl -i "http://www.wangchujiang.com" # 顯示全部信息
curl -l "http://www.wangchujiang.com" # 只顯示頭部信息
curl -v "http://www.wangchujiang.com" # 顯示get請(qǐng)求全過(guò)程解析

post請(qǐng)求

$ curl -d "param1=value1&param2=value2" "http://www.wangchujiang.com/login"

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

--data-urlencode 參數(shù)等同于 -d，發(fā)送 POST 請(qǐng)求的數(shù)據(jù)體，區(qū)別在于會(huì)自動(dòng)將發(fā)送的數(shù)據(jù)進(jìn)行 URL 編碼。

curl --data-urlencode 'comment=hello world' https://wangchujiang.com/login
# 上面代碼中，發(fā)送的數(shù)據(jù)hello world之間有一個(gè)空格，需要進(jìn)行 URL 編碼。

讀取本地文本文件的數(shù)據(jù)，向服務(wù)器發(fā)送

curl -d '@data.txt' https://wangchujiang.com/upload
# 讀取data.txt文件的內(nèi)容，作為數(shù)據(jù)體向服務(wù)器發(fā)送。

json格式的post請(qǐng)求

curl -l -H "Content-type: application/json" -X POST -d '{"phone":"13521389587","password":"test"}' http://wangchujiang.com/apis/users.json

向服務(wù)器發(fā)送 Cookie

使用--cookie "COKKIES"選項(xiàng)來(lái)指定cookie，多個(gè)cookie使用分號(hào)分隔：

curl http://wangchujiang.com --cookie "user=root;pass=123456"

將cookie另存為一個(gè)文件，使用--cookie-jar選項(xiàng)：

curl URL --cookie-jar cookie_file

-b 參數(shù)用來(lái)向服務(wù)器發(fā)送 Cookie。

curl -b 'foo=bar' https://taobao.com
# 上面命令會(huì)生成一個(gè)標(biāo)頭Cookie: foo=bar，向服務(wù)器發(fā)送一個(gè)名為foo、值為bar的 Cookie。

curl -b 'foo1=bar' -b 'foo2=baz' https://taobao.com
# 上面命令發(fā)送兩個(gè) Cookie。

```shell
curl -b cookies.txt https://www.taobao.com
# 上面命令讀取本地文件 cookies.txt，里面是服務(wù)器設(shè)置的 Cookie（參見-c參數(shù)），將其發(fā)送到服務(wù)器。

Cookie 寫入一個(gè)文件

curl -c cookies.txt https://www.taobao.com
# 上面命令將服務(wù)器的 HTTP 回應(yīng)所設(shè)置 Cookie 寫入文本文件cookies.txt。

請(qǐng)求的來(lái)源

-e 參數(shù)用來(lái)設(shè)置 HTTP 的標(biāo)頭 Referer，表示請(qǐng)求的來(lái)源。

curl -e 'https://taobao.com?q=example' https://www.example.com
# 上面命令將Referer標(biāo)頭設(shè)為 https://taobao.com?q=example。

-H 參數(shù)可以通過(guò)直接添加標(biāo)頭 Referer，達(dá)到同樣效果。

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

上傳二進(jìn)制文件

-F 參數(shù)用來(lái)向服務(wù)器上傳二進(jìn)制文件。

curl -F 'file=@photo.png' https://taobao.com/profile
# 上面命令會(huì)給 HTTP 請(qǐng)求加上標(biāo)頭 Content-Type: multipart/form-data ，然后將文件photo.png作為file字段上傳。

-F 參數(shù)可以指定 MIME 類型。

curl -F 'file=@photo.png;type=image/png' https://taobao.com/profile
# 上面命令指定 MIME 類型為image/png，否則 curl 會(huì)把 MIME 類型設(shè)為 application/octet-stream。

-F 參數(shù)也可以指定文件名。

curl -F 'file=@photo.png;filename=me.png' https://taobao.com/profile
# 上面命令中，原始文件名為photo.png，但是服務(wù)器接收到的文件名為me.png。

設(shè)置請(qǐng)求頭

-H 參數(shù)添加 HTTP 請(qǐng)求的標(biāo)頭。

curl -H 'Accept-Language: en-US' https://google.com
# 上面命令添加 HTTP 標(biāo)頭 Accept-Language: en-US。

curl -H 'Accept-Language: en-US' -H 'Secret-Message: xyzzy' https://google.com
# 上面命令添加兩個(gè) HTTP 標(biāo)頭。

curl -d '{"login": "emma", "pass": "123"}' -H 'Content-Type: application/json' https://google.com/login
# 上面命令添加 HTTP 請(qǐng)求的標(biāo)頭是 Content-Type: application/json，然后用 -d 參數(shù)發(fā)送 JSON 數(shù)據(jù)。

跳過(guò) SSL 檢測(cè)

curl -k https://www.example.com
# 上面命令不會(huì)檢查服務(wù)器的 SSL 證書是否正確。

請(qǐng)求跟隨服務(wù)器的重定向

-L 參數(shù)會(huì)讓 HTTP 請(qǐng)求跟隨服務(wù)器的重定向。curl 默認(rèn)不跟隨重定向。

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

調(diào)試參數(shù)

-v 參數(shù)輸出通信的整個(gè)過(guò)程，用于調(diào)試。

curl -v https://www.example.com
# --trace參數(shù)也可以用于調(diào)試，還會(huì)輸出原始的二進(jìn)制數(shù)據(jù)。

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

獲取本機(jī)外網(wǎng)ip

curl ipecho.net/plain

使用 curl 測(cè)試網(wǎng)站加載速度

命令有一個(gè)鮮為人知的選項(xiàng)，-w，該選項(xiàng)在請(qǐng)求結(jié)束之后打印本次請(qǐng)求的統(tǒng)計(jì)數(shù)據(jù)到標(biāo)準(zhǔn)輸出。

首先，我們定義控制打印行為的格式化字符串。新建文本文件 fmt.txt，并填入下面的內(nèi)容：

\n
Response Time for: %{url_effective}\n\n
DNS Lookup Time:\t\t%{time_namelookup}s\n
Redirection Time:\t\t%{time_redirect}s\n
Connection Time:\t\t%{time_connect}s\n
App Connection Time:\t\t%{time_appconnect}s\n
Pre-transfer Time:\t\t%{time_pretransfer}s\n
Start-transfer Time:\t\t%{time_starttransfer}s\n\n
Total Time:\t\t\t%{time_total}s\n

curl 提供了很多置換變量，可以在格式化字符串中通過(guò) %{var} 的形式使用。完整的變量列表可以在 curl 的 manpage 中查看。簡(jiǎn)單介紹一下我們使用的這幾個(gè)變量：

url_effective: 執(zhí)行完地址重定向之后的最終 URL；
time_namelookup: 從請(qǐng)求開始至完成名稱解析所花的時(shí)間，單位為秒，下同；
time_redirect: 執(zhí)行所有重定向所花的時(shí)間；
time_connect: 從請(qǐng)求開始至建立 TCP 連接所花的時(shí)間；
time_appconnect: 從請(qǐng)求開始至完成 SSL/SSH 握手所花的時(shí)間；
time_pretransfer: 從請(qǐng)求開始至服務(wù)器準(zhǔn)備傳送文件所花的時(shí)間，包含了傳送協(xié)商時(shí)間；
time_starttransfer: 從請(qǐng)求開始至服務(wù)器準(zhǔn)備傳送第一個(gè)字節(jié)所花的時(shí)間；
time_total: 完整耗時(shí)。

然后執(zhí)行請(qǐng)求，通過(guò) @filename 指定保存了格式化字符串的文件：

$ curl -L -s -w @fmt.txt -o /dev/null http://www.google.com

輸出：

Response Time for: http://www.google.co.jp/?gfe_rd=cr&dcr=0&ei=cjIaWpTkHeiQ8QfnxYzoBA

DNS Lookup Time:        0.000038s
Redirection Time:       0.207271s
Connection Time:        0.000039s
App Connection Time:    0.000039s
Pre-transfer Time:      0.000067s
Start-transfer Time:    0.260115s

Total Time:             0.467691s

要求返回是壓縮的狀態(tài)