网络和远程访问

命令 curl

发送HTTP请求并下载数据

Linux · Bash 示例 · 在所选服务器上运行的命令

何时使用 curl

使用 curl 检查 HTTP 响应、下载资源或从服务器调用 API。将传输成功与应用程序成功分开,设置合理的超时并将身份验证令牌排除在保存的命令示例之外。

语法

curl [PARAMETERS] URL

方括号标记可选参数;省略号意味着重复。将示例文件名、用户名和服务器地址替换为您自己的值。

常见选项和参数

-I
使用 HEAD 方法仅请求 HTTP 标头。
-f
对于 HTTP 状态代码 400 及以上,返回错误。
-L
遵循重定向; -o 指定结果文件。

使用示例

检查网站标题

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.