네트워크 및 원격 액세스

명령 curl

HTTP 요청 보내기 및 데이터 다운로드

Linux · Bash 예 · 선택한 서버에서 실행되는 명령

curl를 사용하는 경우

curl를 사용하여 HTTP 응답을 검사하고 리소스를 다운로드하거나 서버에서 API를 호출하세요. 전송 성공과 애플리케이션 성공을 분리하고, 합리적인 시간 초과를 설정하고, 저장된 명령 예제에서 인증 토큰을 제외하세요.

구문

curl [PARAMETERS] URL

대괄호는 선택적 인수를 표시합니다. 줄임표는 반복을 의미합니다. 예제 파일 이름, 사용자 이름 및 서버 주소를 원하는 값으로 바꿉니다.

일반적인 옵션 및 인수

-I
HEAD 메서드를 사용하여 HTTP 헤더만 요청합니다.
-f
HTTP 상태 코드 400 이상에 대해 오류를 반환합니다.
-L
리디렉션을 따르십시오. -o는 결과 파일을 지정합니다.

사용 예

사이트 헤더 확인

curl -I https://example.com

헤더 전용 요청이 이루어집니다. 일부 서비스는 이를 일반 콘텐츠 요청과 다르게 처리합니다.

HTTP 오류 처리가 포함된 파일 다운로드

curl --fail --location --output ./page.html https://example.com

리디렉션이 수행되고 응답 본문이 명명된 로컬 파일을 대체합니다. HTTP 오류 상태로 인해 오류가 발생합니다.

시간 제한이 있는 JSON 요청

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

제한된 전체 기간으로 JSON 응답이 요청됩니다. 엔드포인트는 실제로 해당 API를 제공해야 합니다.

참고 및 제한사항

  • HTTPS를 사용하면 인증서가 기본적으로 확인됩니다. 별도의 이유 없이 -k를 통한 확인을 비활성화하지 마십시오.
  • 명령 기록에 실제 토큰이나 비밀번호를 넣지 말고 다운로드한 스크립트를 확인 없이 실행하지 마세요.

일반적인 질문 및 문제 해결

서버가 오류 페이지를 반환할 때 curl가 성공하는 이유는 무엇입니까?

실패 옵션이 없으면 HTTP 오류 응답을 수신해도 성공적인 전송으로 간주될 수 있습니다. HTTP 상태와 명령 종료 상태를 모두 검사합니다.

HTTPS를 수정하려면 인증서 확인을 비활성화해야 합니까?

일상적인 수정으로 신뢰를 우회하지 마십시오. 대신 호스트 이름, 시스템 시간, 서버 인증서 체인 및 신뢰할 수 있는 CA 구성을 확인하세요.

추가 도움말

옵션은 버전 및 배포판에 따라 다릅니다. 다음 명령으로 설치된 문서를 확인하십시오. man curl.