🚀 CURL 安装指南

📱 macOS 安装

                                    # 使用 Homebrew (推荐)
brew install curl

# 检查版本
curl --version

# 更新到最新版本
brew upgrade curl
                                

🐧 Linux 安装

                                    # Ubuntu/Debian
sudo apt update && sudo apt install curl

# CentOS/RHEL/Fedora
sudo yum install curl
# 或者 (Fedora 22+)
sudo dnf install curl

# Arch Linux
sudo pacman -S curl
                                

🪟 Windows 安装

                                    # Windows 10+ 自带 CURL
curl --version

# 使用 Chocolatey
choco install curl

# 使用 Scoop
scoop install curl

# 手动下载
# 访问: https://curl.se/windows/
                                

🐳 Docker 使用

                                    # 官方镜像
docker run --rm curlimages/curl:latest --version

# 在容器中使用
docker run --rm curlimages/curl:latest \
  https://api.tools.top/users
                                

🔧 编译安装 (高级用户)

                            # 下载源码
wget https://curl.se/download/curl-8.5.0.tar.gz
tar -xzf curl-8.5.0.tar.gz
cd curl-8.5.0

# 配置编译选项
./configure --with-ssl --with-libssh2 --with-nghttp2

# 编译安装
make && sudo make install

# 验证安装
curl --version
                        

📋 版本信息查看

                            # 查看详细版本信息
curl --version

# 查看支持的协议和功能
curl --version | grep -E "(Protocols|Features)"

# 示例输出:
# curl 8.5.0 (x86_64-apple-darwin23.0) libcurl/8.5.0
# Protocols: dict file ftp ftps gopher gophers http https imap imaps ldap ldaps mqtt pop3 pop3s rtsp scp sftp smb smbs smtp smtps telnet tftp
# Features: alt-svc AsynchDNS brotli GSS-API HSTS HTTP2 HTTPS-proxy IDN IPv6 Kerberos Largefile libz MultiSSL NTLM SPNEGO SSL TLS-SRP UnixSockets zstd
                        

🔤 基础参数详解

-X, --request <method> 指定HTTP方法 (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS)

-H, --header <header> 添加自定义请求头，支持多个-H参数

-d, --data <data> 发送POST数据，自动设置Content-Type为application/x-www-form-urlencoded

--data-raw <data> 发送原始数据，不进行任何处理

--json <data> 发送JSON数据，自动设置Content-Type为application/json (CURL 7.82+)

-F, --form <name=content> 发送multipart/form-data，支持文件上传

-u, --user <user:password> HTTP基本认证，用户名:密码

--oauth2-bearer <token> OAuth 2.0 Bearer Token认证

-A, --user-agent <agent> 设置User-Agent请求头

-e, --referer <URL> 设置Referer请求头

-b, --cookie <data> 发送Cookie数据

-c, --cookie-jar <filename> 保存Cookie到文件

📁 输出控制参数

-o, --output <file> 将响应保存到文件

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

-w, --write-out <format> 输出传输统计信息

-s, --silent 静默模式，不显示进度条和错误信息

-S, --show-error 与-s配合使用，仍显示错误信息

-f, --fail HTTP错误时静默失败(不输出错误页面)

-i, --include 在输出中包含响应头

-v, --verbose 详细输出，显示请求和响应过程

🔗 连接控制参数

--connect-timeout <seconds> 连接超时时间

-m, --max-time <seconds> 整个操作的最大时间

--retry <num> 请求失败时的重试次数

--retry-delay <seconds> 重试之间的延迟时间

--max-redirs <num> 最大重定向次数

-L, --location 跟随重定向

-k, --insecure 跳过SSL证书验证（用于测试环境）

🚀 HTTP/2 和 HTTP/3 支持

--http2 强制使用HTTP/2协议

--http2-prior-knowledge 使用HTTP/2而不进行HTTP/1.1升级

--http3 尝试使用HTTP/3协议 (实验性功能)

--http3-only 仅使用HTTP/3，失败时不降级

🔐 SSL/TLS 高级配置

--tlsv1.2 强制使用TLS 1.2

--tlsv1.3 强制使用TLS 1.3

--cert <certificate> 客户端证书文件

--key <private-key> 客户端私钥文件

--cacert <CA-certificate> CA证书文件

-k, --insecure 跳过SSL证书验证 (不推荐用于生产)

🌐 代理和网络配置

--proxy <[protocol://]host[:port]> 使用代理服务器

--proxy-user <user:password> 代理服务器认证

--socks5 <host[:port]> 使用SOCKS5代理

--resolve <host:port:address> 强制域名解析到指定IP

--interface <name> 指定网络接口

--dns-servers <addresses> 指定DNS服务器

📊 性能和限制

--limit-rate <speed> 限制传输速度 (如: 100K, 1M)

--max-filesize <bytes> 最大下载文件大小

--parallel 并行传输多个URL

--parallel-max <num> 最大并行连接数

--keepalive-time <seconds> TCP keepalive探测间隔

--compressed 请求压缩响应 (gzip, deflate, br)

🔄 高级数据处理

--data-binary @<file> 发送二进制文件内容

--data-urlencode <data> URL编码数据后发送

--upload-file <file> 上传文件 (PUT方法)

--range <range> 请求部分内容 (如: 0-1023)

--continue-at <offset> 断点续传

--remote-time 保持远程文件的时间戳

🔍 详细调试参数

-v, --verbose 显示详细的请求和响应过程，包括握手信息

--trace <file> 将完整的网络跟踪保存到文件

--trace-ascii <file> 将ASCII格式的网络跟踪保存到文件

--dump-header <file> 将响应头保存到文件

-w, --write-out <format> 输出传输统计信息

--stderr <file> 将错误输出重定向到文件

-k, --insecure 跳过SSL/TLS证书验证，允许不安全连接

📊 curl -v 输出详解

示例命令:

curl -v https://api.tools.top/users

输出解析:

* Trying 104.21.45.123:443... 尝试连接到服务器IP和端口

* Connected to api.tools.top (104.21.45.123) port 443 (#0) 成功建立TCP连接

* ALPN, offering h2 协商HTTP/2协议

* SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384 建立TLS 1.3加密连接

* Server certificate: 服务器SSL证书信息

> GET /users HTTP/2 发送的HTTP请求行

> Host: api.tools.top 发送的请求头

< HTTP/2 200 服务器响应状态

< content-type: application/json 响应头信息

🎯 输出符号含义

* 连接信息和协议协商过程

> 发送给服务器的数据 (请求行、请求头、请求体)

< 从服务器接收的数据 (响应行、响应头)

[data] 数据传输信息 (上传/下载字节数)

📈 性能分析参数

                            # 详细的时间统计
curl -w "@curl-format.txt" https://api.tools.top/users

# curl-format.txt 内容:
     time_namelookup:  %{time_namelookup}s\n
        time_connect:  %{time_connect}s\n
     time_appconnect:  %{time_appconnect}s\n
    time_pretransfer:  %{time_pretransfer}s\n
       time_redirect:  %{time_redirect}s\n
  time_starttransfer:  %{time_starttransfer}s\n
                     ----------\n
          time_total:  %{time_total}s\n
           size_download: %{size_download} bytes\n
           speed_download: %{speed_download} bytes/s\n
                        

🔧 常用调试技巧

🌐 测试连接性

curl -I -v https://api.tools.top

只获取响应头，测试服务器连通性

🔍 跟踪重定向

curl -L -v https://tools.top

跟随重定向并显示每一步的详细过程

⏱️ 超时测试

curl -v --connect-timeout 5 --max-time 10 https://api.tools.top

测试网络延迟和超时情况

🔐 SSL调试

curl -v --tlsv1.3 https://api.tools.top

调试SSL/TLS连接问题

使用技巧

📝 保存响应到文件

curl -o output.json https://api.tools.top/data

使用 -o 参数将响应保存到指定文件

🔄 跟随重定向

curl -L https://tools.top

使用 -L 参数自动跟随HTTP重定向

🔒 忽略SSL证书错误

curl -k https://api.tools.top

使用 -k 参数忽略SSL证书验证错误

📊 显示请求统计

curl -w "@curl-format.txt" https://api.tools.top

使用 -w 参数显示详细的请求统计信息

📁 文件上传路径

curl -F "file=@./local-file.txt" https://api.tools.top/upload

使用相对路径 (./) 或绝对路径 (/full/path/to/file) 指定文件位置

常用示例

GET 请求

curl -X GET "https://api.tools.top/users?page=1&limit=10"

POST JSON 数据

curl -X POST "https://api.tools.top/users" \
  -H "Content-Type: application/json" \
  -d '{"name": "John", "email": "john@tools.top"}'

Bearer Token 认证

curl -X GET "https://api.tools.top/profile" \
  -H "Authorization: Bearer your-token-here"

文件上传

curl -X POST "https://api.tools.top/upload" \
  -F "file=@/Users/username/document.pdf" \
  -F "description=Important document"

注意：文件路径必须是完整的绝对路径或相对路径

HTTP 请求构建器

基本请求

请求头 (Headers)

认证设置 (Authentication)

请求体 (Request Body)

不携带请求体

生成的 CURL 命令

生成错误

CURL 使用指南