로컬호스트의 ERR_CONNECTION_REFUSED(XAMPP, Laragon, MAMP)

이 오류의 의미와 확인 방법

• 브라우저에 localhost 또는 로컬 호스트 이름에 대한 ERR_CONNECTION_REFUSED가 즉시 표시됩니다.
• XAMPP, Laragon 또는 MAMP에서 Apache 또는 Nginx가 중지됨, 시작 실패 또는 더 이상 실행되지 않음으로 표시됩니다.
• 서버가 시작된 다음 중지되며, 때로는 포트, 구성 파일 또는 구문 오류에 관한 메시지가 표시됩니다.
• 재시작, 운영 체제 변경, 로컬 서버 설치 또는 구성 편집 후 문제가 발생합니다.
• 컴퓨터에 프로젝트 파일은 있지만 브라우저가 로컬 서버에 연결하지 못합니다.
• 사용자 지정 포트를 사용하는 서버는 한 주소에서는 작동하지만 일반 localhost에서는 실패할 수 있습니다. 브라우저가 기본 HTTP 포트를 사용하기 때문입니다.

가능성이 높은 순서의 주요 원인

1. Apache 또는 Nginx가 실행 중이 아님 — 로컬 서비스가 시작되지 않았거나 시작 중 오류가 발생했을 수 있습니다.
2. 다른 프로세스가 구성된 포트를 사용 중 — IIS, 다른 XAMPP/Laragon/MAMP 설치, 독립 실행형 Apache 또는 Nginx, 가상화 소프트웨어 또는 다른 애플리케이션이 이미 80 또는 443 포트에서 대기 중일 수 있습니다.
3. 서버 구성이 잘못됨 — httpd.conf, Nginx 구성 파일, virtual host 파일 또는 최근에 편집한 다른 서버 파일의 구문 오류로 인해 서비스가 즉시 중지될 수 있습니다.
4. 브라우저가 잘못된 포트를 사용 중 — 8080 또는 다른 사용자 지정 포트로 구성된 스택은 일반적으로 기본 HTTP 포트의 일반 localhost에 응답하지 않습니다.
5. 방화벽 또는 백신 소프트웨어가 간섭함 — 최근 보안 소프트웨어 변경으로 로컬 서버 또는 네트워크 바인딩이 차단될 수 있습니다. 다만 서비스 중지나 포트 충돌보다 흔한 원인은 아닙니다.

해결 방법

1. 로컬 서버와 주소 확인

XAMPP Control Panel, Laragon 또는 MAMP 애플리케이션을 열고 Apache 또는 Nginx가 Running으로 표시되는지 확인하세요. 중지된 상태라면 Start를 선택하고, 시작에 실패하면 표시되는 정확한 메시지를 기록하세요.

스택이 사용하도록 구성된 HTTP 또는 HTTPS 포트를 확인하세요. 사용자 지정 포트를 사용한다면 일반 localhost가 올바르다고 가정하지 말고 localhost:8080과 같이 일치하는 주소를 테스트하세요.

2. 포트 충돌 확인

시작 메시지에 포트가 이미 사용 중이라고 표시되면 해당 포트를 확인하세요. Windows에서는 환경에 따라 관리자 권한이 필요할 수 있으므로, 필요한 경우 관리자 권한으로 명령 프롬프트를 열고 다음 읽기 전용 명령을 실행하세요.

netstat -ano | findstr :80
netstat -ano | findstr :443

표시된 프로세스 ID를 사용해 작업 관리자에서 해당 프로세스의 소유자를 확인하세요. 잘 모르는 프로세스를 종료하지 마세요. IIS가 포트를 사용 중이고 컴퓨터를 변경할 권한이 있다면 IIS가 필요하지 않은 경우에만 관련 IIS 서비스를 비활성화하거나 중지하세요. 그렇지 않으면 로컬 스택이 사용 가능한 포트를 사용하도록 구성하고 브라우저에서도 해당 포트를 사용하세요.

위 명령은 Windows 전용입니다. 다른 운영 체제에서는 해당 운영 체제의 기본 네트워크 또는 프로세스 도구나 스택 제어판에서 제공하는 포트 정보를 사용하세요.

3. 서버 오류 로그 확인

구성된 포트를 사용하는 명확한 프로세스가 없다면 로컬 스택 또는 구성된 로그 디렉터리에서 Apache 또는 Nginx 오류 로그를 여세요. 특히 파일 경로, 구성 지시문 및 줄 번호가 포함된 첫 번째 구체적인 오류를 찾으세요.

구성을 편집한 후 문제가 시작되었다면 해당 변경 사항을 수정하거나 되돌리세요. httpd.conf, Nginx 구성 파일, virtual host 정의 및 포함된 파일을 확인하세요. 원인을 파악할 수 있도록 한 번에 하나의 파일만 변경하세요.

4. 중복 로컬 서버 확인

두 번째 XAMPP, Laragon, MAMP, WAMP, 독립 실행형 Apache 또는 Nginx 설치가 있는지 확인하세요. 일반적으로 두 서비스가 동일한 주소와 포트에서 동시에 대기할 수는 없습니다. 사용하지 않는 서비스가 안전하게 중지 가능한지 알고 있고 권한이 있는 경우에만 중지하세요. 또는 계속 사용해야 하는 스택에 서로 다른 포트를 할당하세요.

5. 보안 소프트웨어 변경 사항 검토

서버 구성이 올바르고 해당 포트를 사용하는 다른 프로세스도 없다면 최근 방화벽 또는 백신 변경 사항을 검토하세요. 보안 제품의 일반 설정을 사용하고, 허용되는 액세스 범위를 이해한 경우에만 예외를 추가하세요. 문제 해결의 첫 단계로 보호 기능을 광범위하게 비활성화하지 마세요.

6. 해결 여부 확인

Apache 또는 Nginx가 Running 상태를 유지할 때까지 기다린 다음 구성된 localhost 주소를 다시 여세요. ERR_CONNECTION_REFUSED 대신 기본 서버 페이지 또는 프로젝트가 로드되어야 합니다.

기본 페이지는 로드되지만 프로젝트가 로드되지 않는다면 연결 문제는 해결된 것입니다. 포트 설정을 다시 변경하기보다는 document root, 라우팅, virtual host 또는 애플리케이션별 문제를 계속 확인하세요.

예방 및 해결 확인 방법

• 각 로컬 스택에서 사용하는 HTTP 및 HTTPS 포트를 기록하세요. 특히 여러 스택이 설치된 경우 중요합니다.
• 여러 로컬 서버를 동일한 주소와 포트에서 실행하지 마세요. 둘 다 필요하다면 서로 다른 포트를 할당하세요.
• Apache, Nginx 및 virtual host 구성 파일의 변경 사항을 기록해 두세요.
• 서버 구성을 편집한 후에는 프로젝트 코드가 손상되었다고 가정하기 전에 서비스를 시작하고 오류 로그를 확인하세요.
• 서비스가 한 번 시작되는 것뿐 아니라 계속 실행 중인지 스택의 제어판에서 확인하세요.
• 프로세스나 서비스를 중지하기 전에 IIS, 다른 개발 도구 또는 관련 없는 애플리케이션에서 필요로 하는 프로세스가 아닌지 확인하세요.

자주 묻는 질문