CURL命令参数

Fri, 24 Oct 2025 21:16:27 +0800

curl 是一个功能非常强大的命令行工具，用于在终端中进行网络请求（HTTP、HTTPS、FTP、SFTP、WebDAV 等）。下面是最常用的参数分类与示例说明

🧩 一、基本用法

curl [选项] [URL]

参数	说明	示例
`-O`	以原文件名保存下载内容	`curl -O https://example.com/file.zip`
`-o <文件名>`	自定义输出文件名	`curl -o local.zip https://example.com/file.zip`
`-T <文件>`	上传文件（WebDAV / FTP）	`curl -T test.txt https://webdav.server.com/dir/`
`--upload-file <文件>`	同上（更直观）	`curl --upload-file test.txt https://example.com/upload/`

参数	说明	示例
`-u <用户名:密码>`	HTTP 基本认证	`curl -u admin:123456 https://example.com`
`--digest`	启用 HTTP Digest 认证	`curl --digest -u user:pass https://example.com`
`-H "Authorization: Bearer <token>"`	传递 Bearer Token	`curl -H "Authorization: Bearer abc123" https://api.example.com`

参数	说明	示例
`-d <数据>`	发送表单数据（默认 `application/x-www-form-urlencoded`）	`curl -d "user=admin&pass=123" https://example.com/login`
`--data-urlencode`	自动 URL 编码数据	`curl --data-urlencode "msg=你好世界" https://example.com`
`-F <字段=@文件>`	上传文件表单（`multipart/form-data`）	`curl -F "file=@test.jpg" https://example.com/upload`
`-H "Content-Type: application/json"` `-d '{"key":"value"}'`	发送 JSON 数据	`curl -H "Content-Type: application/json" -d '{"a":1}' https://example.com/api`

参数	说明	示例
`-H "<Header>: <值>"`	添加 HTTP 请求头	`curl -H "User-Agent: MyApp/1.0" https://example.com`
`-e <URL>`	设置 `Referer`	`curl -e https://google.com https://example.com`
`-A <字符串>`	自定义 User-Agent	`curl -A "Mozilla/5.0" https://example.com`

参数	说明	示例
`-x <代理>` 或 `--proxy`	使用代理	`curl -x socks5://127.0.0.1:1080 https://example.com`
`--proxy-user <用户名:密码>`	代理认证	`curl -x http://proxy:8080 --proxy-user user:pass https://example.com`
`--connect-timeout <秒>`	设置连接超时	`curl --connect-timeout 10 https://example.com`
`--max-time <秒>`	请求总超时	`curl --max-time 30 https://example.com`

参数	说明	示例
`-w "<格式>"`	自定义输出信息（如耗时、状态码）	`curl -w "code:%{http_code}\ntime:%{time_total}\n" -o /dev/null -s https://example.com`
`-D <文件>`	保存响应头到文件	`curl -D headers.txt https://example.com`
`--trace <文件>`	保存完整调试日志	`curl --trace trace.log https://example.com`

功能	示例
上传文件	`curl -T file.txt -u user:pass https://dav.example.com/path/`
下载文件	`curl -O -u user:pass https://dav.example.com/path/file.txt`
删除文件	`curl -X DELETE -u user:pass https://dav.example.com/path/file.txt`
创建目录	`curl -X MKCOL -u user:pass https://dav.example.com/path/newdir/`
移动文件	`curl -X MOVE -u user:pass -H "Destination: https://dav.example.com/path/newfile.txt" https://dav.example.com/path/oldfile.txt`

Wed, 26 Feb 2025 00:58:15 +0800

欢迎使用Z-Blog，这是程序自动生成的文章，您可以删除或是编辑它:)

系统生成了一个留言本和一篇《欢迎使用Z-BlogPHP！》，祝您使用愉快！