curl案例讲解

uzong2025-07-06 21:42

前段时间有同学反馈，不能正常访问开放平台的测试环境，使用 curl 命令，发现了端倪，于是整理一下 curl 的一些基础用法。

案例入门

shell 复制代码 
uzong@MacBook-Air ~ % curl -v -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Ca-Timestamp: 1743126273976" \
-H "X-Ca-Nonce: 2c6ad4ec-c255-4098-9411-09d442e7ef8c" \
-H "X-Site-Tenant: US_AMZ" \
-H "Content-MD5: 0y4yBh50w0H73OZQih7cAQ==" \
-H "X-Ca-Key: 204840648" \
-H "X-Ca-Signature: cvtVD6BnadR3xtZNVpCZSZP/GN6QvlHOoxxADA0uT9k=" \
-H "X-Ca-Signature-Method: HmacSHA256" \
-d '{"current_page":1,"page_size":1,"ssku_list":["01259-3020-0020","01259-3110-0010"]}' \
https://xxx-open-tst.xxxio.com/api/v1/page_product
Note: Unnecessary use of -X or --request, POST is already inferred.
*   Trying 121.40.69.55:443...
* Connected to xxx-open-tst.xxxio.com (121.40.69.55) port 443 (#0)
* ALPN: offers h2,http/1.1
* (304) (OUT), TLS handshake, Client hello (1):
*  CAfile: /etc/ssl/cert.pem
*  CApath: none
* (304) (IN), TLS handshake, Server hello (2):
* TLSv1.2 (IN), TLS handshake, Certificate (11):
* TLSv1.2 (IN), TLS handshake, Server key exchange (12):
* TLSv1.2 (IN), TLS handshake, Server finished (14):
* TLSv1.2 (OUT), TLS handshake, Client key exchange (16):
* TLSv1.2 (OUT), TLS change cipher, Change cipher spec (1):
* TLSv1.2 (OUT), TLS handshake, Finished (20):
* TLSv1.2 (IN), TLS change cipher, Change cipher spec (1):
* TLSv1.2 (IN), TLS handshake, Finished (20):
* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
* ALPN: server accepted h2
* Server certificate:
*  subject: C=CN; ST=ZheJiang; L=HangZhou; O=Alibaba (China) Technology Co., Ltd.; CN=*.market.alicloudapi.com
*  start date: Mar 11 08:27:01 2025 GMT
*  expire date: Sep  4 00:00:00 2025 GMT
*  subjectAltName does not match xxx-open-tst.xxxio.com
* SSL: no alternative certificate subject name matches target host name 'xxx-open-tst.xxxio.com'
* Closing connection 0
* TLSv1.2 (OUT), TLS alert, close notify (256):
curl: (60) SSL: no alternative certificate subject name matches target host name 'xxx-open-tst.xxxio.com'
More details here: https://curl.se/docs/sslcerts.html

curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it. To learn more about this situation and
how to fix it, please visit the web page mentioned above.

错误原因

  • 错误信息显示：SSL: no alternative certificate subject name matches target host name 'xxx-open-tst.xxxio.com'
  • 服务器的证书是为 *.market.alicloudapi.com 签发的，而你尝试访问的主机名是 xxx-open-tst.xxxio.com，两者不匹配。
  • 这是 HTTPS 的安全机制，用于防止中间人攻击
  • curl 默认会验证服务器的 SSL 证书，包括检查证书是否由受信任的机构颁发、是否过期以及主机名是否匹配。
  • 由于主机名不匹配，curl 拒绝了连接。
  • TLS 握手本身是成功的（使用了 TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384），但证书验证失败导致连接关闭。

curl 它的功能非常强大，命令行参数多达几十种。可以掌握了解一下。

Curl 介绍

curl（Client for URLs）是一个支持多种协议（如 HTTP、HTTPS、FTP、SFTP、SCP、LDAP 等）的命令行工具，用于在终端中传输数据。它的最大特点是无需图形界面即可与远程服务器交互，非常适合脚本自动化、API 调试、网络测试等场景

curl weread.qq.com/

选项 功能 案例
-X 指定请求方法（GET、POST、PUT、DELETE 等） $ curl -X POST www.example.com
-H 添加请求头（Header）
-d 发送数据（通常用于 POST/PUT）
-o 将输出保存到文件
-O 以远程文件名保存下载内容
-I 只获取响应头信息
-L 自动跟随重定向
-u 指定用户名和密码（基本认证）
-F 发送 multipart/form-data 数据（上传文件）
-V 参数输出通信的整个过程，用于调试。 $ curl -v www.example.com
--trace 用于调试，还会输出原始的二进制数据 $ curl --trace - www.example.com

使用案例详情

查看请求详细信息（调试模式） -V

你想查看完整的请求和响应过程，包括 Headers 和 Body：

  • 解析的IP地址
  • 建立的TCP连接
  • TLS握手过程
  • 发送的精确请求头
  • 接收到的响应头
  • 响应体
arduino 复制代码 
curl -v https://example.com

发送 JSON 数据调用 RESTful API

json 复制代码 
curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -d '{"name":"Alice", "email":"alice@example.com"}' \
     https://api.example.com/v1/users

说明 ：-H 设置请求头，-d 发送 JSON 数据体。

强制使用 IPv4 或 IPv6

bash 复制代码 
# 强制使用 IPv4
curl -4 https://example.com

# 强制使用 IPv6
curl -6 https://example.com

自动重试失败请求

当网络不可靠时，可以配置 curl 自动重试。（适用脚本中）

ruby 复制代码 
curl --retry 3 --retry-delay 5 https://flaky-api.example.com/data

载大文件并断点续传

但网络不稳定，希望支持断点续传

bash 复制代码 
# 第一次下载
curl -C - -O http://mirror.example.com/ubuntu.iso

# 如果中断，再次运行相同命令可继续下载

说明 ：-C - 启用断点续传，-O 使用远程文件名保存

模拟浏览器行为（User-Agent + Referer）

有些网站会检查请求来源是否为真实浏览器，你可以通过设置 User-Agent 和 Referer 来伪装：

arduino 复制代码 
curl -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
     -e "https://www.google.com/" \
     https://example.com

-A 设置 User-Agent
-e 设置 Referer 头

适用场景：爬虫伪装、绕过简单反爬机制

OAuth2 Bearer Token 调用 API

很多现代 API 使用 OAuth2 认证方式，你可以在 curl 中轻松携带 token

bash 复制代码 
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     https://api.example.com/v2/data

用 curl 来测量请求耗时，用于性能监控或优化分析

perl 复制代码 
curl -w "Time Connect: %{time_connect}\nTime AppConnect: %{time_appconnect}\nTime Redirect: %{time_redirect}\nTime Total: %{time_total}\n" -o /dev/null -s https://example.com

更多场景

场景 用法
网络不稳定的情况下，设置超时可以防止命令长时间挂起 连接超时 5 秒，响应超时 10 秒curl --connect-timeout 5 -m 10 slow-api.example.com
在生产环境中下载大文件，但不想占用全部带宽 # 限制下载速度为100KB/scurl --limit-rate 100K -O example.com/largefile.i...# 设置超时和最大连接时间curl --connect-timeout 30 --max-time 300 -O example.com/largefile.i...
测试一个使用自签名证书的开发服务器 # 忽略证书验证（仅用于测试环境）curl -k dev.example.com# 指定自定义CA证书curl --cacert /path/to/custom-ca.pem dev.example.com# 检查证书详细信息curl --verbose --cert-status example.com

当然还有很多其他用法，可以通过AI进行探索，不再赘述。

参考资源

官网地址：curl.se/docs/

curl 的用法指南： www.ruanyifeng.com/blog/2019/0...

相关推荐
martinzh26 分钟前
Spring AI 项目介绍
后端
前端付豪35 分钟前
20、用 Python + API 打造终端天气预报工具（支持城市查询、天气图标、美化输出🧊
后端·python
爱学习的小学渣37 分钟前
关系型数据库
后端
武子康40 分钟前
大数据-33 HBase 整体架构 HMaster HRegion
大数据·后端·hbase
前端付豪41 分钟前
19、用 Python + OpenAI 构建一个命令行 AI 问答助手
后端·python
凌览41 分钟前
斩获 27k Star，一款开源的网站统计工具
前端·javascript·后端
全栈凯哥44 分钟前
02.SpringBoot常用Utils工具类详解
java·spring boot·后端
狂师1 小时前
啥是AI Agent！2025年值得推荐入坑AI Agent的五大工具框架！（新手科普篇）
人工智能·后端·程序员
星辰大海的精灵1 小时前
使用Docker和Kubernetes部署机器学习模型
人工智能·后端·架构
MikeWe1 小时前
C++宏的解析：从基础语法到实战场景
后端
热门推荐
01集群聊天服务器---MySQL数据库的建立02GPU 进阶笔记（二）：华为昇腾 910B GPU03Coze扣子平台完整体验和实践（附国内和国际版对比）04使用Ruby接入实时行情API教程05Word粘贴时出现“运行时错误53,文件未找到：MathPage.WLL“的解决方案06扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解07基于odoo17的设计模式详解---装饰模式08扣子空间的使用教程与大模型技术思考09DeepSeek各版本说明与优缺点分析10Java学习第十五部分——MyBatis