---
title: "Mac에서 Could not connect to the server(NSURLErrorDomain -1004) · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/nsurl-error-1004-could-not-connect-to-the-server"
description: "앱에 Could not connect to the server, NSURLErrorDomain 오류 -1004가 표시됩니다. 서버, 방화벽, 프록시 중 무엇이 거부하는지 알아보세요."
---

# 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에서 포트가 이미 사용 중일 때](https://kilobat.app/ko/guides/port-already-in-use)를 참고하세요.
- **방화벽, 필터, 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에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참고하세요.

## 질문

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

-1004는 거부되거나 차단된 연결이고, -1001은 제한 시간 초과입니다. [Mac의 “The request timed out.”](https://kilobat.app/ko/guides/request-timed-out)를 참고하세요.

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

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

## 출처

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

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

## 관련 가이드

- [Mac에서 “Safari가 서버에 연결할 수 없음”](https://kilobat.app/ko/guides/safari-cant-connect-to-server): Safari가 사이트 주소를 찾았지만 서버 연결을 열지 못했습니다.
- [Mac에서 포트가 이미 사용 중인 경우](https://kilobat.app/ko/guides/port-already-in-use): 한 TCP 포트와 주소에서는 하나의 프로세스만 수신 대기할 수 있습니다.
- [Mac에서 “요청 시간이 초과되었습니다.”](https://kilobat.app/ko/guides/request-timed-out): 오류 -1001에 대한 macOS 메시지입니다.
- [프록시 설정으로 인해 Mac에서 앱이 연결되지 않습니다](https://kilobat.app/ko/guides/proxy-settings-breaking-apps): 프록시 설정은 다른 서버를 통해 트래픽을 전송합니다.
- [Mac의 IPv6 문제](https://kilobat.app/ko/guides/ipv6-problems-mac): 대부분의 네트워크는 Mac에 IPv4와 IPv6 주소를 모두 제공합니다.
