使用 curl

curl 与 wget 的比较

工具	类型	擅长
curl	通用的网络请求客户端	HTTP API、上传/下载、调试请求、认证、代理、多协议
wget	专门的下载器	下载文件、递归下载网站、断点续传、镜像站点

curl 的通用性主要体现在它不只是“下载文件”。例如：

# GET
curl https://example.com

# POST JSON
curl -X POST https://example.com/api \
  -H 'Content-Type: application/json' \
  -d '{"name":"test"}'

# 上传文件
curl -F 'file=@a.png' https://example.com/upload

# 带认证
curl -u user:password https://example.com

# SOCKS5 代理
curl --proxy socks5h://127.0.0.1:1080 https://example.com

日常使用上的差别：

wget https://example.com/a.zip

默认就会保存为 a.zip。

但是 curl 默认把文件内容输出到终端：

curl https://example.com/a.zip

需要：

# 按远程文件名保存
curl -O https://example.com/a.zip

# 手动指定保存位置
curl -o a.zip https://example.com/a.zip

⭐ curl 常用参数列表 ⭐

参数	作用	示例
-O	按远程文件名保存	curl -O https://example.com/a.zip
-o FILE	保存为指定文件名	curl -o app.zip URL
-L	跟随重定向	curl -L URL
-C -	断点续传	curl -C - -O URL
-s	静默，不显示进度	curl -s URL
-S	配合 -s，出错时仍显示错误	curl -sS URL
-f	HTTP 4xx/5xx 时返回失败	curl -f URL
-I	只获取响应头	curl -I URL
-i	输出响应头 + 响应体	curl -i URL
-v	显示详细请求过程	curl -v URL
-X	指定 HTTP 方法	curl -X POST URL
-H	添加请求头	curl -H 'Authorization: Bearer xxx' URL
-d	发送请求数据	curl -d 'a=1&b=2' URL
--data-raw	原样发送数据	curl --data-raw '{"a":1}' URL
-F	multipart/form-data，常用于上传文件	curl -F 'file=@a.png' URL
-u	Basic Auth	curl -u user:pass URL
-b	发送 Cookie	curl -b 'token=abc' URL
-c	保存 Cookie	curl -c cookies.txt URL
-A	指定 User-Agent	curl -A 'Mozilla/5.0' URL
-e	指定 Referer	curl -e 'https://google.com' URL
-x / --proxy	使用代理	curl -x http://127.0.0.1:7890 URL
--socks5	SOCKS5 代理	curl --socks5 127.0.0.1:1080 URL
--socks5-hostname	SOCKS5，DNS 也通过代理	curl --socks5-hostname 127.0.0.1:1080 URL
-k	忽略 HTTPS 证书错误	curl -k https://example.com
--connect-timeout	连接超时	curl --connect-timeout 5 URL
-m	整个请求最大时间	curl -m 30 URL
--retry	请求失败自动重试	curl --retry 5 URL
-w	输出请求统计信息	`curl -w ’%{http_code}\n’ URL`

下载功能说明

下载功能主要与 -L 参数有关，同时支持与一些其他参数组合使用。

通常使用：

curl -fsSL URL

因为如果服务器返回 403、404、500，-f 会让 curl 返回非 0 exit code。

• -f HTTP 错误时失败
• -s 静默
• -S 静默模式下仍显示错误
• -L 跟随重定向

例如很多安装脚本都是：

curl -fsSL https://example.com/install.sh | sh

不过对于不熟悉的脚本，建议先查看：

curl -fsSL https://example.com/install.sh | less

确认内容后再执行。

[!TIP]

还支持断续传，添加 -C 参数以支持。

网络请求功能

主要与参数 -X、-H、-d 有关。

一下是个示例：

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

测试网络代理

通常完成环境变量设置后，使用：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

curl https://www.google.com

如果正常获得输出，这说明网络代理配置工作正常。