Mac의 “curl: (7) Failed to connect”
curl 종료 코드 7은 한 단계가 실패했음을 알립니다. curl 문서에는 “Failed to connect() to host or proxy.”라고 나와 있습니다.
제 Mac에 이런 문제가 있습니다: Mac의 “curl: (7) Failed to connect”. https://kilobat.app/ko/guides/curl-7-failed-to-connect.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.
증상
- 터미널에
curl: (7) Failed to connect to host port 443이 표시됩니다. - 문구에 “Couldn't connect to server”나 “Connection refused”가 자주 덧붙습니다.
- 스크립트와 설치 프로그램이 종료 코드 7로 멈춥니다.
가능한 원인
- 포트에서 대기하는 것이 없습니다. 서비스가 꺼져 있거나 다른 포트를 사용합니다.
- 방화벽 또는 프록시. 방화벽이 연결을 거부할 수 있습니다. 프록시가 설정되어 있는데 도달할 수 없을 때도 curl이 실패합니다.
- 잘못된 주소. URL의 호스트나 포트가 잘못되었습니다. 스크립트의 변수가 비어 있을 수 있습니다.
- IPv6 또는 VPN 경로. curl이 네트워크가 도달할 수 없는 주소를 시도할 수 있습니다.
확인 방법
정확한 URL을 출력하세요. 호스트와 포트를 확인하세요.
curl을 자세한 정보와 함께 실행하세요. 첫 몇 줄에 실패한 주소가 표시됩니다.
curl -v https://example.com포트를 테스트하세요.
nc -vz example.com 443프록시 변수를 표시합니다.
env | grep -i proxy
해결 방법
본인의 서비스라면 시작하세요. 출력된 포트를 사용하세요.
IPv6 문제를 테스트하려면 IPv4를 강제하세요.
curl -4 -v https://example.com잘못된 프록시 설정을 해제하세요.
unset https_proxy http_proxy짧게 테스트하기 위해 VPN을 끄세요. 끝나면 다시 켜세요.
Kilobat 사용
Kilobat의 연결 진단은 주소를 네트워크, 프록시, DNS, 규칙, IPv4, IPv6, TLS, 서버의 계층별로 테스트합니다. 실패한 계층을 알려줍니다.
kilobat why https://example.com이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해
diagnose_connection및diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.
질문
종료 코드 7은 호스트가 꺼져 있다는 뜻인가요?
항상 그렇지는 않습니다. curl이 호스트 또는 프록시에 연결하지 못했다는 뜻입니다. curl -v로 어느 쪽인지 알아보세요.
(6)과 무엇이 다른가요?
종료 코드 6은 호스트 이름이 확인되지 않았다는 뜻이고, 코드 7은 연결에 실패했다는 뜻입니다. Mac의 “curl: (6) Could not resolve host”를 참고하세요.
출처
2026년 10월 29일 확인했습니다.