# curl 命令 ## curl 命令 `curl` 命令是一个利用URL规则在命令行下工作的文件传输工具。它支持文件的上传和下载，所以是综合传输工具，但按传统，习惯称 `curl` 为下载工具。作为一款强力工具，`curl` 支持包括HTTP、HTTPS、ftp 等众多协议，还支持 POST、cookies、认证、从指定偏移处下载部分文件、用户代理字符串、限速、文件大小、进度条等特征。 ## 命令用法 ``` $ curl [options]... ``` 注意 `url` 请求地址最好用 `""` 括起来。 `curl` 是将下载文件输出到 stdout，将进度信息输出到 stderr，不显示进度信息使用 `--silent` 选项。 ### 常用可选参数 | 参数 | 说明 | | --------------------------------- | ----------------------------------------- | | -A, --user-agent STRING | 设置用户代理报头信息 `STRING` 发送给服务器 | | -b, --cookie DATA | 设置 cookie 的数据 `DATA`，可以是字符串或文件的读取位置 | | -c, --cookie-jar FILE | 操作结束后把 cookie 写入这个文件 `FILE` 中 | | -d, --data DATA/@FILE | HTTP POST 方式传送数据 `DATA` 或者 `FILE` 文件的内容 | | --data-ascii DATA | 以 ascii 的方式 post 数据 `DATA` | | --data-binary DATA | 以二进制的方式 post 数据 `DATA` | | -D, --dump-header FILE | 将响应报头信息写到 `FILE` 文件中 | | -F, --form NAME=CONTENT | 提交 multipart MIME 数据，以 `NAME=CONTENT` 的形式 | | --form-string NAME=STRING | 提交 multipart MIME 数据，以 `NAME=STRING` 的形式 | | -e, --referer URL | 指定来源网址 `URL` | | -H, --header LINE/@FILE | 自定义报头信息 `LINE` 或 `FILE` 文件的内容作为报头信息传递给服务器 | | --ignore-content-length | 忽略 HTTP 头信息的长度 | | -Q, --quote COMMAND | 文件传输前，发送命令 `COMMAND` 到服务器 | | -o, --output FILE | 把输出写到该文件 `FILE` 中 | | -O, --remote-name | 把输出写到文件中，并保留远程文件名 | | --limit-rate RATE | 限制下载速度为 `RATE` | | -u, --user USER\[:PASSWORD] | 设置服务器的用户和密码 | | -U, --proxy-user USER\[:PASSWORD] | 设置代理用户名和密码 | | -x, --proxy HOST\[:PORT] | 设置代理 `HOST` 地址 | | -X, --request COMMAND | 指定使用什么命令 `COMMAND` | ### 使用实例 1. 下载文件： * 下载单个文件，默认将输出打印到 stdout 中： ``` $ curl http://www.centos.org/ ``` * 下载到指定文件中： ``` curl -o mygettext.html http://www.gnu.org/software/gettext/manual/gettext.html curl -O http://www.gnu.org/software/gettext/manual/gettext.html ``` * 对 `curl` 的最大网络使用进行限制： ``` $ curl --limit-rate 1000B -O http://gnu.org/software/gettext/manual/gettext.html ``` * 从 FTP 服务器上下载所有文件： ``` $ curl -u ftpuser:ftppass -O ftp://ftp_server/public_html/ ``` 2. 保存于使用网站 cookie 信息 * 将 cookies 保存到 sugercookies 文件中 ``` $ curl -D sugercookies http://localhost/sugercrm/index ``` * 使用 sugercookies 保存的 cookies ``` $ curl -b sugercookies http://localhost/sugercrm/login ``` 3. 传递请求数据 * 使用 GET 方法请求数据 ``` $ curl -u username https://api.github.com/user?access_token=XXXXX ``` * 使用 POST 方法请求数据 ``` $ curl --data "param1=value1¶m2=value" http://api.github.com/ $ curl --data @data.json http://api.github.com/authorizations ``` * 自动转义参数中的特殊字符 ``` $ curl --data-urlencode "value 1" http://hostname.com ``` * 使用其他方法请求 ``` $ curl -X DELETE https://api.github.com ``` * 设置 http 请求头： ``` $ curl -A "Mozilla/5.0 Firefox/21.0" http://www.baidu.com #设置 http 请求头 User-Agent $ curl -H "Content-Type: application/json \n Connection: keep-alive" http://www.aiezu.com ``` * 设置 http 响应头 ``` $ curl -I http://www.aiezu.com # 仅返回 header $ curl -D /tmp/header http://www.aiezu.com # 将 http header 保存到 /tmp/header 文件 ``` 4. 上传文件 * 同时上传多个文件到 FTP 服务器 ``` $ curl -u ftpuser:ftppass -T "{file1, file2}" ftp：//ftp.testserver.com ``` * 从标准输入获取内容保存到 FTP 服务器指定的文件中 ``` $ curl -u ftpuser:ftppass -T ftp://ftp.testserver.com/myfile.txt ``` * 以表单数据的形式上传文件 ``` $ curl --form "fileupload=@filename.txt" http://hostname/resource ``` 5. 其他设置 * 为 `curl` 设置代理 ``` $ curl -x proxyserver.test.com:3128 http://google.com ``` * 显示一次 HTTP 请求的通信过程 ``` $ curl -v http://www.baidu.com ``` * 跟随重定向的链接 ``` $ curl -L http://codebelief.com ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://linux-in-action.gitbook.io/project/wang-luo-jian-kong/curl.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.