curl 命令详解

显示行号 | 选择喜欢的代码风格

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

curl 命令使用 HTTP、HTTPS、FTP、FTPS、SCP、SFTP、TFTP、DICT、TELNET、LDAP或FILE支持的协议之一，将数据传输到网络服务器或从网络服务器传输数据。它旨在无需用户交互即可工作，因此非常适合在 Shell 脚本中使用。

curl 命令安装：

-bash: curl: command not found  

#Debian
apt-get install curl

#Ubuntu
apt-get install curl

#Alpine
apk add curl

#Arch Linux
pacman -S curl

#Kali Linux
apt-get install curl

#CentOS
yum install curl

#Fedora
dnf install curl

#OS X
brew install curl

#Raspbian
apt-get install curl

#Docker
docker run cmd.cat/curl curl

curl 命令补充说明：

curl 命令提供代理支持，用户身份验证，FTP 上传，HTTP 发布，SSL 连接，cookie，文件传输恢复，metalink 和其他功能。

curl 命令语法：

curl [options] [URL...]

-a/--append (FTP/SFTP)上传文件时，附加到目标文件
-A/--user-agent <agent string>设置用户代理发送给服务器
--anyauth  (HTTP)可以使用“任何”身份验证方法
#请注意，如果您从stdin上传，则不建议使用--anyauth，因为它可能需要发送两次数据，然后客户端必须能够回放。 
#果从stdin上传时需要，则上传操作将失败。

-b/--cookie <name=data> cookie字符串或文件读取位置
--basic (HTTP)使用HTTP基本验证
-B/--use-ascii  (FTP/LDAP) 使用ASCII /文本传输
-c/--cookie-jar (HTTP)操作结束后把cookie写入到这个文件中
-C/--continue-at  断点续传
-d/--data (HTTP) HTTP POST方式传送数据
--data-ascii  以ascii的方式post数据
--data-binary 以二进制的方式post数据
--data-urlencode <data> （HTTP）这会发布数据，类似于其他--data选项，但执行URL编码除外。 （在7.18.0中添加）
--negotiate 使用HTTP身份验证
--digest  (HTTP) 使用数字身份验证，有关相关选项，另请参阅--ntlm， -  negotiate和--anyauth。
--disable-eprt  (FTP)禁止使用EPRT或LPRT
--disable-epsv  (FTP)禁止使用EPSV
-D/--dump-header  把header信息写入到该文件中
--egd-file  (SSL)为随机数据(SSL)设置EGD socket路径
--tcp-nodelay 使用TCP_NODELAY选项
-e/--referer  (HTTP) 来源网址
-E/--cert 客户端证书文件和密码 (SSL)
--environment （仅限RISC OS）使用-w选项支持的名称设置一系列环境变量，以便在运行curl后更轻松地提取有用信息。
--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 &lgt;list of ciphers> SSL密码
--compressed  (HTTP)要求返回是压缩的形势 (using deflate or gzip)
--connect-timeout <seconds> 设置最大请求时间
#从7.32.0开始，此选项接受十进制值，但实际超时的精度会降低，因为指定的超时会以十进制精度增加。 另请参见-m /  -  max-time选项。
#如果多次使用此选项，将使用最后一个选项。

--create-dirs 建立本地目录的目录层次结构
--crlf  (FTP) 上传是把LF转变成CRLF,对MVS（OS / 390）有用。
--crlfile <file> （HTTPS / FTPS）使用带有证书吊销列表的PEM格式提供文件，该列表可以指定要被视为已撤销的对等证书。
#crlfile 在7.19.7中添加，如果多次使用此选项，将使用最后一个选项。

-f/--fail 连接失败时不显示http错误
--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 模拟http表单提交数据
--form-string 模拟http表单提交数据
-g/--globoff  禁用网址序列和范围使用{}和[]
-G/--get  以get的方式来发送数据
-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  禁用缓冲输出
-o/--output 把输出写到该文件中
-O/--remote-name  把输出写到该文件中，保留远程文件的文件名
-p/--proxytunnel  使用HTTP代理
--proxy-anyauth 选择任一代理身份验证方法
--proxy-basic 在代理上使用基本身份验证
--proxy-digest  在代理上使用数字身份验证
--proxy-ntlm  在代理上使用ntlm身份验证
-P/--ftp-port
#使用端口地址，而不是使用PASV
-q  作为第一个参数，关闭 .curlrc
-Q/--quote  文件传输前，发送命令到服务器
-r/--range  检索来自HTTP/1.1或FTP服务器字节范围
--range-file  读取（SSL）的随机文件
-R/--remote-time  在本地生成文件时，保留远程文件时间
--retry 传输出现问题时，重试的次数
--retry-delay 传输出现问题时，设置重试间隔时间
--retry-max-time  传输出现问题时，设置最大重试时间
-s/--silent 静默模式。不输出任何东西
-S/--show-error 显示错误
--socks4  用socks4代理给定主机和端口
--socks5  用socks5代理给定主机和端口
--stderr  
-t/--telnet-option  Telnet选项设置
--trace 对指定文件进行debug
--trace-ascii Like --跟踪但没有hex输出
--trace-time  跟踪/详细输出时，添加时间戳
-T/--upload-file  上传文件
--url Spet URL to work with
-u/--user 设置服务器的用户和密码
-U/--proxy-user 设置代理用户名和密码
-w/--write-out [format] 什么输出完成后
-x/--proxy  在给定的端口上使用HTTP代理
-X/--request  指定什么命令
-y/--speed-time 放弃限速所要的时间，默认为30
-Y/--speed-limit  停止传输速度的限制，速度时间

curl 命令参数：

[URL...]

curl 命令实例：

查看 curl 的版本:

[root@TestMaster ~]
$ curl --version
curl 7.29.0 (x86_64-redhat-linux-gnu) libcurl/7.29.0 NSS/3.36 zlib/1.2.7 libidn/1.28 libssh2/1.4.3
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtsp scp sftp smtp smtps telnet tftp 
Features: AsynchDNS GSS-Negotiate IDN IPv6 Largefile NTLM NTLM_WB SSL libz unix-sockets

下载文件:

$ curl -O http://yourdomain.com/yourfile.tar.gz # Save as yourfile.tar.gz
$ curl -o newfile.tar.gz http://yourdomain.com/yourfile.tar.gz # Save as newfile.tar.gz

curl URL --silent
#curl是将下载文件输出到stdout，将进度信息输出到stderr
#不显示进度信息使用--silent选项
#使用--progress显示进度条

curl URL/File -C 偏移量
#断点续传, curl能够从特定的文件偏移处继续下载，它可以通过指定一个便宜量来下载部分文件
$ curl -C - -O http://yourdomain.com/yourfile.tar.gz

#下载多个文件
curl -O http://yoursite.com/info.html -O http://mysite.com/about.html 

#从文件下载
$ xargs -n 1 curl -O < listurls.txt

curl --referer http://www.google.com http://commandnotfound.cn
#使用--referer选项指定来源

GET请求和POST请求

#GET
curl "https://commandnotfound.cn"    # 如果这里的URL指向的是一个文件或者一幅图都可以直接下载到本地
curl -i "https://commandnotfound.cn" # 显示全部信息
curl -l "https://commandnotfound.cn" # 只显示头部信息
curl -v "https://commandnotfound.cn" # 显示get请求全过程解析

#POST
curl -d "key1=value1&key2=value2" "https://commandnotfound.cn"

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

用 curl 获取本机外网 IP 地址

curl ipecho.net/plain

#用 curl 保存网站 Cookies
$ curl --cookie-jar cnncookies.txt https://www.cnn.com/index.html -O

#发送 cookie
$ curl --cookie cnncookies.txt https://www.cnn.com

#限制下载速度
$ curl --limit-rate 100K http://yourdomain.com/yourfile.tar.gz -O

#curl命令指定ip访问url
#curl url -x ip:port
curl http://baidu.com -x 11.1.1.91:80
curl -H 'Host:baidu.com' http://11.1.1.91

curl 命令遇到的坑：

curl: (3) URL rejected: Malformed input to a URL function

这种情况，一般是这个输入的文件，是一个 DOS 文本文件。它在每行末尾包含一个额外的回车符，这些字符将成为 word 变量值的一部分，从而引发 curl 的特定错误。解决方式要么保证文件是 LF 而非 CRLF，或者用 dos2unix 命令自动将文件从 DOS 格式转化为 Linux 格式。