Mac의 “Could not connect to the server”(NSURLErrorDomain -1004)

앱이 서버 주소는 찾았지만 연결이 열리지 않았습니다. 서버가 거부했거나 경로상의 무언가가 차단했습니다.

에이전트로 해결하기Claude Code, Codex 또는 터미널을 쓸 수 있는 에이전트용 프롬프트를 복사합니다.

제 Mac에 이런 문제가 있습니다: Mac의 “Could not connect to the server”(NSURLErrorDomain -1004). https://kilobat.app/ko/guides/nsurl-error-1004-could-not-connect-to-the-server.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.

적용 대상: macOS 13 Ventura 이상. 문구는 macOS 27.2의 CFNetwork에서 확인했습니다.확인일: 2026년 10월 29일

증상

  • 앱에 오류 -1004와 함께 “Could not connect to the server.”가 표시됩니다.
  • 콘솔이나 로그에 NSURLErrorDomain Code=-1004가 표시됩니다.
  • Safari에는 비슷한 메시지인 “can’t connect to the server”가 표시됩니다.

가능한 원인

  • 서버가 꺼져 있거나 대기하지 않습니다. 해당 포트에서 연결을 받는 것이 없습니다.
  • 로컬 서버가 실행 중이 아닙니다. localhost에는 직접 만든 서버가 실행 중이어야 합니다. Mac에서 포트가 이미 사용 중일 때를 참고하세요.
  • 방화벽, 필터, VPN 또는 프록시. 무언가가 포트나 호스트를 차단합니다.
  • 잘못된 주소 또는 포트. 앱이 오래된 URL을 사용합니다.

확인 방법

  1. 제한 시간 5초로 포트를 테스트하세요.

    nc -vz -G 5 example.com 443
  2. 페이지를 요청하고 연결 단계를 모두 표시합니다.

    curl -v -o /dev/null https://example.com
  3. 로컬 주소라면 포트에서 대기 중인 것을 확인하세요.

    lsof -nP -iTCP:3000 -sTCP:LISTEN

해결 방법

  1. 다른 기기에서 같은 주소를 열어 보세요. 거기서도 실패하면 서버나 네트워크가 원인입니다.

  2. 로컬 서버를 시작하고 출력된 포트를 사용하세요.

  3. 테스트를 위해 VPN, 프록시 또는 필터를 끄고 다시 켜세요.

  4. 앱의 URL에 올바른 호스트와 포트가 있는지 확인하세요.

  5. 나중에 다시 시도하세요. 바쁜 서버는 회복될 수 있습니다.

Kilobat 사용

  1. Wi-Fi, 라우터, 인터넷, DNS 및 로그인 페이지를 한 번에 확인합니다.

    kilobat diagnose
  2. 특정 사이트나 서비스가 실패하면 이를 막는 계층을 찾으세요.

    kilobat why example.com
  3. CLI는 무료입니다. 앱에서 이 검사에 따른 조언은 Kilobat Pro에 포함됩니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참고하세요.

질문

-1004는 -1001과 무엇이 다른가요?

-1004는 거부되거나 차단된 연결이고, -1001은 제한 시간 초과입니다. Mac의 “The request timed out.”를 참고하세요.

localhost에서 왜 -1004가 나오나요?

포트에서 대기하는 것이 없거나 서버가 다른 주소에서 대기합니다.

출처

  • macOS 27.2의 CFNetwork.framework 오류 메시지(Localizable.loctable)
  • curl(1) 및 nc(1), macOS 27.2와 함께 설치된 man 페이지

2026년 10월 29일 확인했습니다.