linux系统中的curl是一款功能强大的命令行数据传输工具,支持HTTP、HTTPS、FTP等多种网络协议,常被用于接口调试、文件下载、数据上传等场景,掌握它的参数和使用方法能大幅提升操作效率。

curl常用参数分类
请求方法相关参数
这类参数用于指定发送的网络请求类型,适配不同的接口调用需求。
- -X:指定请求方法,比如GET、POST、PUT、DELETE等,默认是GET请求。
- -G:强制使用GET方法发送请求,即使同时指定了-d参数也会转为GET请求的参数拼接。
请求头相关参数
用于自定义请求头信息,满足接口对请求头的要求。
- -H:添加自定义请求头,格式为
-H "Key: Value",可以多次使用添加多个请求头。 - -A:设置User-Agent请求头,用于模拟不同的客户端访问。
- -e:设置Referer请求头,标识请求的来源页面。
数据传输相关参数
用于携带请求数据或者处理响应数据中的文件内容。
- -d:发送POST请求的数据,数据会放在请求体中,默认使用application/x-www-form-urlencoded格式。
- -F:以multipart/form-data格式发送POST数据,常用于文件上传场景。
- -o:将响应内容保存到指定文件中,后面跟文件名。
- -O:使用远程文件的文件名保存响应内容到本地。
输出控制相关参数
用于控制curl执行过程中的输出信息,方便调试和查看结果。
- -v:开启详细输出模式,会打印请求和响应的完整头信息,方便调试接口。
- -s:静默模式,不输出进度条和错误信息,只返回响应内容。
- -i:在输出响应内容的同时,也打印响应头信息。
- -w:自定义输出格式,比如可以输出HTTP状态码、请求耗时等信息。
curl常见使用场景示例
发送GET请求
最简单的GET请求,直接跟上目标URL即可:
# 发送GET请求获取页面内容 curl https://ipipp.com/api/test
如果需要携带查询参数,可以直接拼接在URL后面:
# 带查询参数的GET请求 curl "https://ipipp.com/api/test?id=1&name=test"
发送POST请求
发送表单格式的POST数据:
# 发送application/x-www-form-urlencoded格式的POST请求 curl -X POST -d "username=admin&password=123456" https://ipipp.com/api/login
发送JSON格式的POST请求,需要自定义Content-Type请求头:
# 发送JSON格式的POST请求
curl -X POST -H "Content-Type: application/json" -d '{"username":"admin","password":"123456"}' https://ipipp.com/api/login
文件上传
使用-F参数上传本地文件到服务器:
# 上传本地test.txt文件到服务器 curl -X POST -F "file=@/home/user/test.txt" https://ipipp.com/api/upload
文件下载
使用-o参数指定保存的文件名:
# 下载文件并保存为local.zip curl -o local.zip https://ipipp.com/files/test.zip
使用-O参数使用远程文件名保存:
# 下载文件,保存为远程原文件名test.zip curl -O https://ipipp.com/files/test.zip
接口调试查看详细信息
使用-v参数查看完整的请求和响应过程,方便排查接口问题:
# 详细输出请求和响应信息 curl -v https://ipipp.com/api/test
获取HTTP状态码
使用-w参数自定义输出,只获取HTTP状态码:
# 只输出HTTP状态码,不输出响应内容
curl -s -o /dev/null -w "%{http_code}" https://ipipp.com/api/test
注意事项
如果请求的URL中包含特殊字符比如&,需要用英文单引号或者双引号把URL包裹起来,避免被shell解析。发送JSON数据的时候,如果数据中包含双引号,建议使用单引号包裹整个数据字符串,避免转义问题。使用curl访问本地服务比如127.0.0.1或者192.168.0.1的时候,不需要做额外的地址替换,正常访问即可。