备案 立即注册

行业资讯

帮助中心 >  产品文档 >  云计算 >  curl命令使用场景总结

在网络请求与数据交互领域，curl 凭借其轻量、灵活的特性成为开发者与运维人员的必备工具。无论是日常接口调试、文件传输，还是复杂的性能分析，curl 都能通过丰富的参数组合实现高效操作。本文以 2025 年 3 月 10 日为时间背景，系统梳理 curl 的 10 类高频使用场景，结合实例与输出示例，帮助大家快速掌握其核心用法。

1. GET请求

格式：curl -i [request-url]

  • -i 结果中输出响应头信息

curl -i "http://www.landui.com/uacserver/user/personalsettings?userId=20722351"

输出结果示例：

HTTP/1.1 200
Server: nginx/1.13.7
Date: Tue, 10 Oct 2023 02:45:37 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Encoding
processId: dc5a8a60-d37b-4e87-b111-dd6eab484b17
upstream_http_reqid: dc5a8a60-d37b-4e87-b111-dd6eab484b17
processTime: 4
upstream_http_time: 4

…… 数据内容

2. POST请求

  • -X 指定method

  • -d 指定发送Http Post data，content-type不限

curl -i -X POST -d 'data={"timenewsID":"1447","shareScope":{"type":"0","scope_id":[0]}}' 'http://www.landui.com/microblog/timenews/modifysharescope?user_id=62051317&session_id=2dc60ccf24a6088a1e6a638205ed5f66f11dac97'

3. 发送Form表单

  • -F 指定form-data形式来发送请求，参数为&分隔开的多个参数

curl -i -X POST -F "user_id=1453280&session_id=61f730d921eed96d88f34cb18d0e592d6f21202b" 'http://www.landui.com/uccserver/uccapi/user/check'

4. 请求体urlencode编码

  • –data-urlencode，通过该选项提供的参数会自动转义特殊字符

curl --data-urlencode "value& 1" http://www.landui.com

5. 发送JSON

  • -H 指定Header，需要用双引号，可以多次使用指定多个Header

curl -i -X POST -H "Content-Type: application/json" -d "{"newid":"1447"}'" 'http://www.landui.com/microblog/timenews/timenewpraise/1447'

6. 下载文件

使用-O或-o选项来指明将输出内容以文件形式下载。

  • -O：使用URL中默认的文件名保存内容到本地，此选项会自动输出进度信息

curl -O http://www.landui.com/software/gettext/manual/gettext.html
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 1556k  100 1556k    0     0   121k      0  0:00:12  0:00:12 --:--:--  135k

  • -o：将内容保存到命令行指定的文件中，此选项会自动输出进度信息


curl -o mygettext.html http://www.landui.com/software/gettext/manual/gettext.html
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 1556k  100 1556k    0     0   164k      0  0:00:09  0:00:09 --:--:--  182k

7. 上传文件

格式：curl -F “file=@/path/to/file” URL

  • -F 选项也可以用于上传文件

  • file=@/path/to/file表示要上传的文件路径

  • 当上传文件的同时也需要提交form表单，则可以指定两次-F选项

curl -F "userId=88407056" -F "file=@mygettext.html" "http://www.landui.com/eamsgateway/eams-support/setting/uploadFile"

8. 输出调试信息

-v 输出详细的调试信息，包括请求头、响应头以及http请求的整个过程

curl -v -F "file=@mygettext.html" "https://www.landui.com/eamsgateway/eams-support/setting/uploadFile"

调试信息示例：

*   Trying 10.255.0.71...
* TCP_NODELAY set
* Connected to testweb.quanshi.com (10.255.0.71) port 80 (#0)
> POST /eamsgateway/eams-support/setting/uploadFile HTTP/1.1
> Host: testweb.quanshi.com
> User-Agent: curl/7.64.1
> Accept: */*
> Content-Length: 1594364
> Content-Type: multipart/form-data; boundary=------------------------3fa4d90f3c8f29f3
> Expect: 100-continue
>
< HTTP/1.1 100 Continue
* We are completely uploaded and fine
< HTTP/1.1 200 OK
< Server: nginx
< Date: Tue, 10 Oct 2023 04:57:30 GMT
< Content-Type: application/json;charset=UTF-8
< Transfer-Encoding: chunked
< Connection: keep-alive
< Vary: Accept-Encoding
< Vary: Accept-Encoding
< Access-Control-Allow-Methods: POST,GET,OPTIONS,DELETE
< Access-Control-Max-Age: 3600
< Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Access-Control-Allow-Origin,Accept,cache-control,if-modified-since
< Set-Cookie: JSESSIONID=F6921C9D1FADEA898E2BD5B9C935E4A8; Path=/; HttpOnly
<
* Connection #0 to host testweb.quanshi.com left intact
…… 响应body
* Closing connection 0

9. 走代理发请求

  • -x 可以为CURL添加代理功能，请求会通过代理服务器发送出去

curl -x proxy.com:3128 http://www.landui.com

10. 分析请求耗时

  • -w 自定义输出内容和格式

  • -o /dev/null 用于屏蔽响应内容，只关心统计信息

  • -s 用于屏蔽进度条和错误信息的显示

curl -o /dev/null -s -w "\\nhttp_code: %{http_code}\\ntime_namelookup: %{time_namelookup}s\\ntime_connect: %{time_connect}s\\ntime_starttransfer: %{time_starttransfer}s\\ntime_total: %{time_total}s\\n" "http://www.landui.com/umsapi/rs/users/64042216/organizations"

自定义输出格式时可以使用的内置变量有：

  • %{time_total}: 请求花费的总时间（秒）

  • %{time_namelookup}: DNS解析时间（秒），就是将域名转换成IP地址的耗时

  • %{time_connect}: 建立连接时间（秒），可以理解成TCP协议三次握手的时间

  • %{time_appconnect}: SSL/TLS握手时间（秒）

  • %{time_pretransfer}: 从请求开始到请求数据开始传输的时间（秒）

  • %{time_redirect}: 重定向时间（秒）

  • %{time_starttransfer}: 从请求开始到第一个字节接收的时间（秒）

  • %{speed_download}: 下载速度（字节/秒）

  • %{speed_upload}: 上传速度（字节/秒）

  • %{size_download}: 下载文件的大小（字节）

  • %{size_upload}: 上传文件的大小（字节）

  • %{http_code}: HTTP状态码

  • %{url_effective}: 请求的最终URL

  • %{redirect_url}: 重定向URL（如果有的话）

复杂的输出格式可以用文件来定义，方式如下：

  • 先编辑一个文件来描述格式信息：vi curl-format.txt

    time_namelookup:  %{time_namelookup}s\\n
       time_connect:  %{time_connect}s\\n
    time_appconnect:  %{time_appconnect}s\\n
      time_redirect:  %{time_redirect}s\\n
   time_pretransfer:  %{time_pretransfer}s\\n
 time_starttransfer:  %{time_starttransfer}s\\n
                    ----------\\n
         time_total:  %{time_total}s\\n

  • 发送请求时指定要采用的格式文件

 curl -s -o /dev/null -w "@curl-format.txt" "http://www.landui.com/umsapi/rs/users/64042216/organizations"

  • 输出示例：

    time_namelookup:  0.002610s
       time_connect:  0.022759s
    time_appconnect:  0.000000s
      time_redirect:  0.000000s
   time_pretransfer:  0.022797s
 time_starttransfer:  0.050744s
                    ----------
         time_total:  0.050963s

耗时信息的简单理解：

  • TCP 连接时间 = pretransfter - namelookup

  • 服务器处理时间 = starttransfter - pretransfer

  • 内容传输时间 = total - starttransfer

掌握 curl 的多样化指令，不仅能提升开发效率，更能深入理解 HTTP 协议细节。从基础的请求构造到高级的耗时分析，本文通过典型案例展现了 curl 的强大功能。在实际应用中，建议结合具体场景灵活组合参数，同时关注输出中的响应头、状态码及性能指标，以实现精准的问题定位与优化。期待这些实用技巧能成为工具箱中的利刃。


蓝队云官网上拥有完善的技术支持库可供参考，大家可自行查阅，更多技术问题，也可以直接咨询。同时，蓝队云整理了运维必备的工具包免费分享给大家使用，需要的朋友可以直接咨询。更多技术知识，蓝队云期待与你一起探索，助力你在 Linux 运维之路上稳步前行。





提交成功！非常感谢您的反馈，我们会继续努力做到更好！

这条文档是否有帮助解决问题？

非常抱歉未能帮助到您。为了给您提供更好的服务，我们很需要您进一步的反馈信息：

在文档使用中是否遇到以下问题：

服务热线：
4006-75-4006(7*24小时在线)

总机直拨：
0871-63886388（工作日9:00-18:00）

Copyright © 2012 - 2025 LanDui.com. All RightsReserved.　蓝队云 版权所有

  • 蓝队微信

  • 蓝队微博

全国域名注册 航帆网 IDC公司大全 九机网