cURL 치트시트
검색하고 인쇄할 수 있는 curl 참조 자료——HTTP 메서드, 헤더, 데이터와 폼, 인증, 다운로드, cookie, TLS, 프록시, 디버깅. 무료.
기본
12curl https://api.example.com
GET 요청 전송 후 본문 출력
curl -o page.html https://example.com
응답을 지정한 파일로 저장
curl -O https://example.com/file.zip
원격 파일 이름으로 저장
curl -i https://example.com
응답 헤더와 본문 표시
curl -I https://example.com
응답 헤더만 가져오기 (HEAD)
curl -v https://example.com
요청/응답의 상세 출력
curl -s https://example.com
조용한 모드, 진행률 및 오류 숨김
curl -sS https://example.com
조용하지만 오류는 표시
curl -L https://example.com
HTTP 리디렉션 따르기 (3xx)
curl https://a.com https://b.com
한 번에 여러 URL 요청
curl 'https://x.com/p?[1-5]'
숫자 범위로 URL 반복
curl --version
curl 버전 및 기능 출력
HTTP 메서드
9curl -X GET https://api.example.com
명시적으로 GET 요청 전송
curl -X POST https://api.example.com
POST 요청 전송
curl -X PUT https://api.example.com/1
리소스 교체용 PUT 요청 전송
curl -X PATCH https://api.example.com/1
필드 갱신용 PATCH 요청 전송
curl -X DELETE https://api.example.com/1
DELETE 요청 전송
curl -I https://api.example.com
헤더 전용 HEAD 요청 전송
curl -X OPTIONS https://api.example.com
OPTIONS 사전 요청 전송
curl --head https://api.example.com
HEAD 요청용 -I의 긴 형식
curl --request POST https://x.com
메서드 설정용 -X의 긴 형식
헤더
10curl -H 'Accept: application/json' https://x.com
단일 요청 헤더 추가
curl -H 'X-Token: abc' -H 'X-Env: dev' https://x.com
여러 헤더 추가
curl -H 'Content-Type: application/json' https://x.com
요청 본문 콘텐츠 타입 선언
curl -H 'Authorization: Bearer TOKEN' https://x.com
bearer 인증 헤더 전송
curl -H 'Host: example.com' https://1.2.3.4
Host 헤더 재정의
curl -H 'Accept-Encoding: gzip' https://x.com
gzip 압축 응답 요청
curl -A 'MyAgent/1.0' https://x.com
User-Agent 문자열 설정
curl -e 'https://ref.com' https://x.com
Referer 헤더 설정
curl -H 'X-Debug:' https://x.com
비워 두어 기본 헤더 제거
curl --compressed https://x.com
압축 응답 요청 및 자동 해제
데이터 전송
11curl -d 'name=Jane&age=30' https://x.com
URL 인코딩 폼 데이터 POST
curl -d '@payload.json' https://x.com
파일에서 읽은 데이터 POST
curl --data-urlencode 'q=hello world' https://x.com
단일 URL 인코딩 필드 POST
curl --data-binary '@file.bin' https://x.com
가공 없이 원시 바이트 POST
curl -G --data-urlencode 'q=cats' https://x.com
데이터를 GET 쿼리 문자열로 추가
curl -X POST -H 'Content-Type: application/json' -d '{"name":"Jane"}' https://x.com
JSON 본문 POST
curl --json '{"name":"Jane"}' https://x.com
JSON POST 및 JSON 헤더 자동 설정
curl -F 'name=Jane' https://x.com
multipart 폼 필드 전송
curl -F 'file=@photo.png' https://x.com
파일을 multipart form-data로 업로드
curl -F 'file=@a.pdf;type=application/pdf' https://x.com
명시적 MIME 타입으로 파일 업로드
curl -d '' https://x.com
빈 본문으로 POST
인증
9curl -u user:pass https://x.com
HTTP 기본 인증
curl -u user https://x.com
기본 인증, 비밀번호 입력 요청
curl -H 'Authorization: Bearer TOKEN' https://x.com
bearer 토큰 헤더 전송
curl --oauth2-bearer TOKEN https://x.com
OAuth 2.0 bearer 토큰 전송
curl --digest -u user:pass https://x.com
HTTP digest 인증 사용
curl --ntlm -u user:pass https://x.com
NTLM 인증 사용
curl --netrc https://x.com
~/.netrc에서 자격 증명 읽기
curl --netrc-file creds https://x.com
사용자 지정 netrc 파일에서 자격 증명 읽기
curl -H 'X-Api-Key: KEY' https://x.com
API 키 헤더 전송
다운로드 및 업로드
11curl -O https://x.com/file.zip
원격 파일 이름으로 다운로드
curl -o out.zip https://x.com/file.zip
선택한 파일 이름으로 다운로드
curl -OL https://x.com/file.zip
다운로드 및 리디렉션 따르기
curl -C - -O https://x.com/file.zip
부분 다운로드 재개
curl --limit-rate 200k -O https://x.com/f
전송 속도 제한
curl -r 0-1023 -o part https://x.com/f
바이트 범위만 다운로드
curl --retry 3 -O https://x.com/f
실패 시 다운로드 재시도
curl -T file.txt ftp://x.com/
PUT/FTP로 파일 업로드
curl -T file.txt https://x.com/up
HTTP PUT으로 파일 업로드
curl --create-dirs -o a/b/f.txt https://x.com
출력용 누락 디렉터리 생성
curl -# -O https://x.com/file.zip
간단한 진행 표시줄 표시
쿠키
8curl -b 'session=abc123' https://x.com
쿠키를 인라인으로 전송
curl -b cookies.txt https://x.com
파일에서 쿠키 전송
curl -c cookies.txt https://x.com
수신한 쿠키를 jar에 기록
curl -b jar.txt -c jar.txt https://x.com
동일 쿠키 jar 읽기 및 갱신
curl -b 'a=1; b=2' https://x.com
여러 쿠키를 한 번에 전송
curl -c - https://x.com
수신한 쿠키를 stdout에 출력
curl --junk-session-cookies -b jar.txt https://x.com
jar의 세션 쿠키 무시
curl -L -c jar.txt -b jar.txt https://x.com/login
리디렉션 간 세션 유지
TLS / SSL
10curl -k https://x.com
안전하지 않음 허용 (인증서 검증 생략)
curl --cacert ca.pem https://x.com
사용자 지정 CA 번들로 검증
curl --capath /etc/ssl/certs https://x.com
CA 인증서 디렉터리 사용
curl --cert client.pem https://x.com
클라이언트 인증서 전송
curl --cert client.pem --key client.key https://x.com
클라이언트 인증서 및 개인 키 사용
curl --tlsv1.2 https://x.com
최소 TLS 1.2 요구
curl --tlsv1.3 https://x.com
최소 TLS 1.3 요구
curl --tls-max 1.2 https://x.com
최대 TLS 버전 제한
curl --ciphers ECDHE-RSA-AES128-GCM-SHA256 https://x.com
허용 TLS 암호 제한
curl -vI https://x.com
TLS 핸드셰이크 상세 검사
프록시
9curl -x http://proxy:8080 https://x.com
HTTP 프록시를 통해 요청 라우팅
curl --proxy http://proxy:8080 https://x.com
프록시 설정용 -x의 긴 형식
curl -x proxy:8080 -U user:pass https://x.com
프록시에 인증
curl --proxy-user user:pass -x proxy:8080 https://x.com
프록시 자격 증명의 긴 형식
curl --socks5 127.0.0.1:1080 https://x.com
SOCKS5 프록시 사용
curl --socks5-hostname 127.0.0.1:1080 https://x.com
원격 DNS 해석을 사용하는 SOCKS5 프록시
curl --socks4 127.0.0.1:1080 https://x.com
SOCKS4 프록시 사용
curl --noproxy example.com https://x.com
지정 호스트에 대해 프록시 우회
curl -x '' https://x.com
구성된 프록시 비활성화
디버깅 및 출력
11curl -w '%{http_code}\n' -o /dev/null -s https://x.com
HTTP 상태 코드만 출력
curl -w '%{time_total}\n' -o /dev/null -s https://x.com
총 전송 시간 출력
curl -w '@format.txt' https://x.com
파일에서 write-out 형식 읽기
curl -D headers.txt https://x.com
응답 헤더를 파일에 덤프
curl -D - -o body.txt https://x.com
헤더는 stdout, 본문은 파일로
curl --trace trace.txt https://x.com
전송의 전체 16진 추적
curl --trace-ascii - https://x.com
stdout으로 ASCII 추적
curl --trace-time -v https://x.com
상세 출력에 타임스탬프 추가
curl -v https://x.com 2>&1 | less
상세 로그를 페이지 단위로 보기
curl -sS -o /dev/null -w '%{size_download}\n' https://x.com
다운로드된 바이트 수 출력
curl --libcurl out.c https://x.com
동등한 libcurl C 소스 생성
타임아웃 및 재시도
10curl --connect-timeout 5 https://x.com
연결 단계를 초 단위로 제한
curl --max-time 30 https://x.com
전체 작업 시간 제한
curl --retry 3 https://x.com
일시적 오류 시 재시도
curl --retry 3 --retry-delay 2 https://x.com
재시도 사이 대기
curl --retry 5 --retry-max-time 60 https://x.com
재시도 총 시간 제한
curl --retry-connrefused https://x.com
연결 거부 시에도 재시도
curl --retry-all-errors https://x.com
일시적 오류뿐 아니라 모든 오류 시 재시도
curl --speed-limit 100 --speed-time 10 https://x.com
일정 시간 너무 느리면 중단
curl --keepalive-time 60 https://x.com
TCP keep-alive 간격 설정
curl --expect100-timeout 1 https://x.com
100-continue 대기 제한
“:q”와 일치하는 항목이 없습니다.
도움이 필요하신가요?
이 도구에서 문제를 발견하셨나요? 저희 팀에 알려주세요.