curl的HTTP参数速查表

Dear 丶 2023-10-01 15:32 15阅读 0赞

#### curl简介 ####

curl是一个开源的命令行工具，它基于网络协议，对指定URL进行网络传输，得到数据后不任何具体处理（如：html的渲染等），直接显示在"标准输出"（stdout）上。

curl支持的网络协议有很多，包括：DICT、FILE、FTP、FTPS、GOPHER、GOPHERS、HTTP、HTTPS、IMAP、IMAPS、LDAP、LDAPS、MQTT、POP3、POP3S、RTMP、RTMPS、RTSP、SCP、SFTP、SMB、SMBS、SMTP、SMTPS、TELNET和TFTP。

curl的参数也有很多，以下主要介绍HTTP和HTTPS相关的参数，建议收藏保存。

#### 参数速查表 ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-A, --user-agent </td> 
   <td>发送指定的User-Agent到服务端</td> 
   <td>curl -A “Agent 007” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–alt-svc </td> 
   <td>使用此缓存文件启用alt-svc</td> 
   <td>curl --alt-svc svc.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>–anyauth</td> 
   <td>选择任意认证方法</td> 
   <td>curl --anyauth --user me:pwd https://one.more</td> 
  </tr> 
  <tr> 
   <td>–compressed</td> 
   <td>请求压缩 (使用 deflate 或 gzip)</td> 
   <td>curl --compressed https://one.more</td> 
  </tr> 
  <tr> 
   <td>-b, --cookie &lt;data</td> 
   <td>filename&gt;</td> 
   <td>发送cookie的字符串，或者读取发送cookie的文件位置</td> 
  </tr> 
  <tr> 
   <td>-c, --cookie-jar </td> 
   <td>操作结束后写入cookie到指定的文件</td> 
   <td>curl -c cookies.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>-d, --data </td> 
   <td>HTTP POST 的数据</td> 
   <td>curl -d “name=onemore” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–data-ascii </td> 
   <td>HTTP POST 的ASCII数据</td> 
   <td>curl --data-ascii @file https://one.more</td> 
  </tr> 
  <tr> 
   <td>–data-binary </td> 
   <td>HTTP POST 的二进制数据</td> 
   <td>curl --data-binary @file https://one.more</td> 
  </tr> 
  <tr> 
   <td>–data-raw </td> 
   <td>HTTP POST 的数据（不对@字符做特殊解析）</td> 
   <td>curl --data-raw “one@more” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–data-urlencode </td> 
   <td>HTTP POST 的url编码的数据</td> 
   <td>curl --data-urlencode name=onemore https://one.more</td> 
  </tr> 
  <tr> 
   <td>–digest</td> 
   <td>使用HTTP摘要访问认证</td> 
   <td>curl -u name:password --digest https://one.more</td> 
  </tr> 
  <tr> 
   <td>–disallow-username-in-url</td> 
   <td>禁止在url中输入用户名</td> 
   <td>curl --disallow-username-in-url https://one.more</td> 
  </tr> 
  <tr> 
   <td>-D, --dump-header </td> 
   <td>把接收到的header写入到指定的文件</td> 
   <td>curl --dump-header header.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>-e, --referer </td> 
   <td>指定Referrer的URL</td> 
   <td>curl --referer “https://more.one” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–etag-compare </td> 
   <td>从文件中读取作为header中的ETag</td> 
   <td>curl --etag-compare etag.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>–etag-save </td> 
   <td>从请求中解析ETag并将其保存到指定的文件中</td> 
   <td>curl --etag-save etag.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>–expect100-timeout </td> 
   <td>允许等待100-continue响应的最大时间(以秒为单位)</td> 
   <td>curl --expect100-timeout 2.5 https://one.more</td> 
  </tr> 
  <tr> 
   <td>-f, --fail</td> 
   <td>在服务器出错时不显示HTTP错误信息</td> 
   <td>curl --fail https://one.more</td> 
  </tr> 
  <tr> 
   <td>-F, --form &lt;name=content&gt;</td> 
   <td>模拟用户按下提交表单</td> 
   <td>curl -F image=@onemore.jpg https://one.more</td> 
  </tr> 
  <tr> 
   <td>–form-string &lt;name=string&gt;</td> 
   <td>模拟用户按下提交表单（值为字符串）</td> 
   <td>curl --form-string “data” https://one.more</td> 
  </tr> 
  <tr> 
   <td>-G, --get</td> 
   <td>将POST数据放在URL中并发起GET请求</td> 
   <td>curl --get -d “name=onemore” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–haproxy-protocol</td> 
   <td>发送HAProxy PROXY v1的header</td> 
   <td>curl --haproxy-protocol https://one.more</td> 
  </tr> 
  <tr> 
   <td>-i, --include</td> 
   <td>在输出中包含HTTP响应头</td> 
   <td>curl -i https://one.more</td> 
  </tr> 
  <tr> 
   <td>-I, --head</td> 
   <td>只显示响应头信息</td> 
   <td>curl -I https://one.more</td> 
  </tr> 
  <tr> 
   <td>-H, --header <a href="mailto:header/@file" rel="nofollow">header/@file</a></td> 
   <td>发送自定义header</td> 
   <td>curl -H “Content-Type: application/json;charset=UTF-8” https://one.more</td> 
  </tr> 
  <tr> 
   <td>–hsts </td> 
   <td>启用HSTS进行传输</td> 
   <td>curl --hsts cache.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>–http0.9</td> 
   <td>使用HTTP 0.9</td> 
   <td>curl --http0.9 https://one.more</td> 
  </tr> 
  <tr> 
   <td>-0, --http1.0</td> 
   <td>使用HTTP 1.0</td> 
   <td>curl --http1.0 https://one.more</td> 
  </tr> 
  <tr> 
   <td>–http1.1</td> 
   <td>使用HTTP 1.1</td> 
   <td>curl --http1.1 https://one.more</td> 
  </tr> 
  <tr> 
   <td>–http2</td> 
   <td>使用HTTP 2</td> 
   <td>curl --http2 https://one.more</td> 
  </tr> 
  <tr> 
   <td>–http2-prior-knowledge</td> 
   <td>使用HTTP 2（不使用HTTP/1.1 Upgrade）</td> 
   <td>curl --http2-prior-knowledge https://one.more</td> 
  </tr> 
  <tr> 
   <td>–http3</td> 
   <td>使用HTTP 3</td> 
   <td>curl --http3 https://one.more</td> 
  </tr> 
  <tr> 
   <td>–ignore-content-length</td> 
   <td>忽略服务端资源的大小</td> 
   <td>curl --ignore-content-length https://one.more</td> 
  </tr> 
  <tr> 
   <td>-j, --junk-session-cookies</td> 
   <td>忽略从文件中读取的会话cookie</td> 
   <td>curl --junk-session-cookies -b cookies.txt https://one.more</td> 
  </tr> 
  <tr> 
   <td>-L, --location</td> 
   <td>启用重定向</td> 
   <td>curl --L https://one.more</td> 
  </tr> 
  <tr> 
   <td>–location-trusted</td> 
   <td>启用重定向并发送验证信息到其它主机</td> 
   <td>curl --location-trusted -u user:pwd https://one.more</td> 
  </tr> 
  <tr> 
   <td>–max-redirs </td> 
   <td>重定向的最大次数</td> 
   <td>curl --max-redirs 3 --location https://one.more</td> 
  </tr> 
  <tr> 
   <td>–negotiate</td> 
   <td>使用HTTP Negotiate (SPNEGO) 认证</td> 
   <td>curl --negotiate -u : https://one.more</td> 
  </tr> 
  <tr> 
   <td>–no-alpn</td> 
   <td>禁用ALPN TLS扩展</td> 
   <td>curl --no-alpn https://one.more</td> 
  </tr> 
  <tr> 
   <td>–no-npn</td> 
   <td>禁用NPN TLS扩展</td> 
   <td>curl --no-npn https://one.more</td> 
  </tr> 
  <tr> 
   <td>–ntlm</td> 
   <td>使用HTTP NTLM认证</td> 
   <td>curl --ntlm -u user:pwd https://one.more</td> 
  </tr> 
  <tr> 
   <td>–ntlm-wb</td> 
   <td>使用HTTP NTLM认证（使用ntlmauth程序做身份验证）</td> 
   <td>curl --ntlm-wb -u user:pwd https://one.more</td> 
  </tr> 
  <tr> 
   <td>–post301</td> 
   <td>在301重定向后不切换为 GET 请求</td> 
   <td>curl --post301 --location https://one.more</td> 
  </tr> 
  <tr> 
   <td>–post302</td> 
   <td>在302重定向后不切换为 GET 请求</td> 
   <td>curl --post302 --location https://one.more</td> 
  </tr> 
  <tr> 
   <td>–post303</td> 
   <td>在303重定向后不切换为 GET 请求</td> 
   <td>curl --post303 --location https://one.more</td> 
  </tr> 
  <tr> 
   <td>-r, --range </td> 
   <td>只接收范围内的字节</td> 
   <td>curl --range 22-44 https://one.more</td> 
  </tr> 
  <tr> 
   <td>–raw</td> 
   <td>禁用所有内部HTTP对内容或传输编码的解码</td> 
   <td>curl --raw https://one.more</td> 
  </tr> 
  <tr> 
   <td>–tr-encoding</td> 
   <td>请求压缩传输编码算法，并解压接收到的数据</td> 
   <td>curl --tr-encoding https://one.more</td> 
  </tr> 
  <tr> 
   <td>-v, --verbose</td> 
   <td>显示通信的整个过程，包括端口连接和头信息。</td> 
   <td>curl -v https://one.more</td> 
  </tr> 
  <tr> 
   <td>-z, --time-cond </td> 
   <td>请求在给定时间之后或之前被修改的文件</td> 
   <td>curl -z “Tue 18 Jan 2021 13:14:15” https://one.more</td> 
  </tr> 
 </tbody> 
</table>

> curl 版本号：7.74.0