cURL 命令用法详解

cURL（Client URL）是一个功能强大的命令行工具，用于在终端中传输数据。它支持多种协议，包括 HTTP、HTTPS、FTP、FTPS、SCP、SFTP、SMTP 等。以下是 cURL 的详细用法指南。

基础语法

curl [options] [URL]

基本用法

1. 获取网页内容

最简单的用法是直接获取一个 URL 的内容：

curl https://example.com

2. 保存输出到文件

# 使用 -o 参数指定输出文件名

curl -o filename.html https://example.com

# 使用 > 重定向符

curl https://example.com > filename.html

# 使用 -O 参数保留远程文件名

curl -O https://example.com/filename.txt

3. 下载多个文件

curl -O https://example.com/file1.txt -O https://example.com/file2.txt

HTTP 请求相关

1. 指定 HTTP 方法

# GET 请求（默认）

curl https://api.example.com/data

# POST 请求

curl -X POST https://api.example.com/data

# PUT 请求

curl -X PUT https://api.example.com/data

# DELETE 请求

curl -X DELETE https://api.example.com/data

2. 发送表单数据

# 发送 URL 编码的表单数据

curl -d "name=John&age=25" https://api.example.com/form

# 发送文件中的表单数据

curl -d @data.txt https://api.example.com/form

3. 发送 JSON 数据

curl -X POST -H "Content-Type: application/json" -d '{"name":"John","age":25}' https://api.example.com/json

# 从文件发送 JSON 数据

curl -X POST -H "Content-Type: application/json" -d @data.json https://api.example.com/json

4. 设置请求头

curl -H "Authorization: Bearer token123" https://api.example.com

curl -H "Content-Type: application/json" -H "Accept: application/json" https://api.example.com

5. 处理重定向

# 允许重定向

curl -L https://example.com

# 显示重定向过程

curl -L -v https://example.com

认证相关

1. 基本认证

curl -u username:password https://api.example.com

# 或者

curl --user username:password https://api.example.com

2. Bearer Token 认证

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.example.com

3. 客户端证书认证

curl --cert client.pem --key key.pem https://api.example.com

Cookie 和 Session 相关

1. 发送 Cookie

curl -b "name=value" https://example.com

curl --cookie "name=value" https://example.com

2. 保存和使用 Cookie

# 保存 Cookie 到文件

curl -c cookies.txt https://example.com

# 使用已保存的 Cookie

curl -b cookies.txt https://example.com

调试和输出控制

1. 详细输出

curl -v https://example.com

curl --verbose https://example.com

2. 只显示响应头

curl -I https://example.com

curl --head https://example.com

3. 隐藏进度信息

curl -s https://example.com

curl --silent https://example.com

4. 显示响应时间

curl -w "Total time: %{time_total}s\n" https://example.com

高级选项

1. 限制传输速率

# 限制下载速率为 1000 字节/秒

curl --limit-rate 1000B https://example.com/largefile.zip

2. 设置超时

# 设置连接超时为 10 秒

curl --connect-timeout 10 https://example.com

# 设置总传输超时为 30 秒

curl --max-time 30 https://example.com

3. 使用代理

curl -x proxy.example.com:8080 https://example.com

curl --proxy proxy.example.com:8080 https://example.com

# 使用 SOCKS5 代理

curl --socks5 proxy.example.com:1080 https://example.com

4. 恢复下载

curl -C - -O https://example.com/largefile.zip

5. 发送 HTTP/2 请求

curl --http2 https://example.com

实际 API 调用示例

调用 DeepSeek FIM 补全 API 的例子

curl -X POST https://api.deepseek.com/beta/completions \

-H "Content-Type: application/json" \

-H "Accept: application/json" \

-H "Authorization: Bearer YOUR_API_KEY" \

-d '{

"model": "deepseek-chat",

"prompt": "def fibonacci(n):",

"suffix": " return result",

"max_tokens": 128,

"temperature": 0.7

}'

常见选项参考表

选项长选项描述

-A--user-agent设置用户代理

-b--cookie发送 Cookie

-c--cookie-jar保存 Cookie 到文件

-d--data发送 POST 数据

-F--form发送多部分表单数据

-H--header设置请求头

-I--head只获取响应头

-k--insecure允许不安全的 SSL 连接

-L--location跟随重定向

-o--output将输出保存到文件

-O--remote-name使用远程文件名保存

-s--silent静默模式

-T--upload-file上传文件

-u--user用户名和密码

-v--verbose详细输出

-X--request指定请求方法

-x--proxy使用代理

cURL 是一个非常强大的工具，掌握它可以极大地提高在命令行环境下与 API 交互和数据传输的效率。