reference/docs/curl.md

Curl 备忘清单

此 Curl 备忘清单包含命令和一些常见的 Curl 技巧示例。

入门

介绍

Curl 是一种在服务器之间传输数据的工具，支持协议，包括 HTTP/FTP/IMAP/LDAP/POP3/SCP/SFTP/SMB/SMTP 等

• Curl GitHub 源码仓库 (github.com)
• Curl 官方网站 (curl.se)

Options

-o <file>    # --output: 写入文件
-u user:pass # --user: 验证

---

-v           # --verbose: 在操作期间使 curl 冗长
-vv          # 更冗长
-s           # --silent: 不显示进度表或错误
-S           # --show-error: 与 --silent (-sS) 一起使用时，显示错误但没有进度表

---

-i           # --include: 在输出中包含 HTTP 标头
-I           # --head: 仅标头

请求

-X POST # --request
-L  # 如果页面重定向，请点击链接
-F  # --form: multipart/form-data 的 HTTP POST 数据

数据

# --data: HTTP post 数据
# URL 编码(例如，status="Hello")
-d 'data'

# --data 通过文件
-d @file

# --get: 通过 get 发送 -d 数据
-G

头信息 Headers

-A <str>         # --user-agent

-b name=val      # --cookie

-b FILE          # --cookie

-H "X-Foo: y"    # --header

--compressed     # 使用 deflate/gzip

SSL

    --cacert <file>
    --capath <dir>

-E, --cert <cert>     # --cert: 客户端证书文件
    --cert-type       # der/pem/eng
-k, --insecure        # 对于自签名证书

安装

apk add --update curl  # alpine linux 中安装

示例

CURL GET/HEAD

命令	说明
curl -I https://www.baidu.com	curl 发请求
curl -v -I https://www.baidu.com	带有详细信息的 curl 发请求
curl -X GET https://www.baidu.com	使用显式 http 方法进行 curl
curl --noproxy 127.0.0.1 http://www.stackoverflow.com	没有 http 代理的 curl
curl --connect-timeout 10 -I -k https://www.baidu.com	curl 默认没有超时
curl --verbose --header "Host: www.mytest.com:8182" www.baidu.com	curl 得到额外的标题
curl -k -v https://www.google.com	curl 获取带有标题的响应

多文件上传

$ curl -v -include \
    --form key1=value1 \
    --form upload=@localfilename URL

为 curl 响应美化 json 输出

$ curl -XGET http://${elasticsearch_ip}:9200/_cluster/nodes | python -m json.tool

CURL POST

命令	说明
curl -d "name=username&password=123456" <URL>	curl 发请求
curl <URL> -H "content-type: application/json" -d "{ \"woof\": \"bark\"}"	curl 发送 json

CURL 脚本安装 rvm

curl -sSL https://get.rvm.io | bash

CURL 高级

命令	说明
curl -L -s http://ipecho.net/plain, curl -L -s http://whatismijnip.nl	获取我的公共 IP
curl -u $username:$password http://repo.dennyzhang.com/README.txt	带凭证的 curl
curl -v -F key1=value1 -F upload=@localfilename <URL>	curl 上传
curl -k -v --http2 https://www.google.com/	使用 http2 curl
curl -T cryptopp552.zip -u test:test ftp://10.32.99.187/	curl ftp 上传
curl -u test:test ftp://10.32.99.187/cryptopp552.zip -o cryptopp552.zip	curl ftp 下载
curl -v -u admin:admin123 --upload-file package1.zip http://mysever:8081/dir/package1.zip	使用凭证 curl 上传

检查网站响应时间

curl -s -w \
     '\nLookup time:\t%{time_namelookup}\nConnect time:\t%{time_connect}\nAppCon time:\t%{time_appconnect}\nRedirect time:\t%{time_redirect}\nPreXfer time:\t%{time_pretransfer}\nStartXfer time:\t%{time_starttransfer}\n\nTotal time:\t%{time_total}\n' \
     -o /dev/null https://www.google.com

使用 Curl 检查远程资源是否可用

curl -o /dev/null --silent -Iw "%{http_code}" https://example.com/my.remote.tarball.gz

正在下载文件

curl https://example.com | \
grep --only-matching 'src="[^"]*.[png]"' | \
cut -d\" -f2 | \
while read i; do curl https://example.com/"${i}" \
-o "${i##*/}"; done

从站点下载所有 PNG 文件（使用GNU grep）

下载文件，保存文件而不更改其名称

curl --remote-name "https://example.com/linux-distro.iso"

重命名文件

curl --remote-name "http://example.com/index.html" --output foo.html

继续部分下载

curl --remote-name --continue-at - "https://example.com/linux-distro.iso"

从多个域下载文件

curl "https://www.{example,w3,iana}.org/index.html" --output "file_#1.html"

下载一系列文件

curl "https://{foo,bar}.com/file_[1-4].webp" --output "#1_#2.webp"

下载一系列文件（输出foo_file1.webp、foo_file2.webp…bar_file1_webp等）

将输出重定向到文件

$ curl http://url/file > file

基本认证

$ curl --user username:password http://example.com/
$ curl -u username:password http://example.com/

写入文件而不是标准输出

$ curl -o file http://url/file
$ curl --output file http://url/file

下载头信息

$ curl -I url
# 显示头信息

将输出写入名为远程文件的文件

$ curl -o file http://url/file
$ curl --output file http://url/file

执行远程脚本

$ curl -s http://url/myscript.sh

配置文件

curl -K file
# 从文件中读取配置
curl --config file
$HOME/.curlrc # 类 UNIX 系统中的默认配置文件