何时使用 curl
使用 curl 检查 HTTP 响应、下载资源或从服务器调用 API。将传输成功与应用程序成功分开,设置合理的超时并将身份验证令牌排除在保存的命令示例之外。
语法
curl [PARAMETERS] URL方括号标记可选参数;省略号意味着重复。将示例文件名、用户名和服务器地址替换为您自己的值。
常见选项和参数
使用示例
检查网站标题
curl -I https://example.com发出仅标头请求;某些服务对此的处理方式与普通内容请求不同。
下载包含 HTTP 错误处理的文件
curl --fail --location --output ./page.html https://example.com遵循重定向,响应正文替换指定的本地文件; HTTP 错误状态导致失败。
请求 JSON 有时间限制
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status请求 JSON 响应的总持续时间有限;端点实际上必须提供 API。
注意事项和限制
- 对于 HTTPS,默认情况下会验证证书;如果没有单独的原因,请勿禁用通过 -k 的检查。
- 不要将真实的令牌或密码放入命令历史记录中,并且不要在未经验证的情况下运行下载的脚本。
常见问题和故障排除
为什么服务器返回错误页面时curl会成功?
如果没有失败选项,收到 HTTP 错误响应仍然可以算作成功传输。检查 HTTP 状态和命令退出状态。
我应该禁用证书验证来修复 HTTPS 吗?
不要将信任作为例行修复来绕过。检查主机名、系统时间、服务器证书链和受信任的 CA 配置。
进一步的帮助
选项因版本和发行版而异。使用以下命令检查已安装的文档: man curl.