로컬 Windows 11/10 PC에서 웹 서버를 실행할 때 'Localhost에서 연결을 거부했습니다(Localhost refused to connect)' 오류 메시지가 나타난다면, 이 글은 웹사이트 운영자와 관리자가 가장 적절한 해결 방법으로 문제를 해결할 수 있도록 돕기 위해 작성되었습니다.

'Localhost에서 연결을 거부했습니다' 오류의 의미
이 오류 메시지가 표시된다는 것은 단순히 localhost를 통해 웹 서버에 접근할 수 없다는 의미입니다. 방화벽이 연결을 차단하고 있을 가능성이 있으며, 이 경우 방화벽 설정을 수정하여 MAMP 등이 사용하려는 포트의 인바운드 연결을 허용하면 대부분 해결할 수 있습니다.
이 오류의 주요 원인은 다음과 같습니다.
- localhost가 127.0.0.1과 올바르게 매핑되지 않은 경우
- Windows에서 WSL을 사용해 웹 서버를 실행하는 경우
- 포트 80을 다른 애플리케이션이 이미 사용 중인 경우
- 잘못된 포트로 웹 서버에 접근하는 경우
- 권한이 부족한 경우
'Localhost에서 연결을 거부했습니다' 오류 해결 방법
Windows 11/10 PC의 크롬 브라우저에서 이 오류가 나타난다면, 아래의 해결 방법을 순서와 관계없이 하나씩 시도해 보세요.
- 127.0.0.1을 통해 localhost 접근하기
- 포트 번호를 지정하여 localhost 접근하기
- XAMPP에서 Apache 포트 변경하기
- WAMP에서 Apache 포트 변경하기
- application.config 파일 삭제하기 (해당되는 경우)
- LxssManager 서비스 재시작하기 (WSL에서 실행되는 웹 서버에 적용)
각 해결 방법의 자세한 절차를 살펴보겠습니다.
1] 127.0.0.1을 통해 localhost 접근하기
XAMPP 또는 WAMP를 실행하여 웹 서버를 시작한 뒤, 브라우저 주소창에 127.0.0.1을 입력하고 Enter 키를 누릅니다. 이 방법으로 오류가 해결된다면 localhost가 이 IP 주소를 제대로 가리키지 못하고 있다는 뜻입니다. 이 경우 웹 서버의 프로젝트나 파일에 접근할 때 localhost/filename 대신 127.0.0.1/filename 형식으로 입력해야 합니다.
2] 포트 번호를 지정하여 localhost 접근하기
웹 서버가 기본 포트인 80에서 실행되고 있지 않다면 이 오류가 발생할 수 있습니다. 이 경우 포트 번호를 명시하여 로컬 웹 서버에 접근하면 됩니다. 브라우저에 localhost:8080과 같이 입력해 보세요.
3] XAMPP에서 Apache 포트 변경하기
XAMPP에서 Apache 실행 포트를 변경하려면 다음 단계를 따르세요.
- 시작 메뉴에서 XAMPP를 실행합니다.
- 작업 표시줄의 시스템 트레이에서 XAMPP 아이콘을 더블클릭하여 XAMPP 제어판을 엽니다.
- XAMPP 제어판 창에서 현재 실행 중인 서비스 목록(Apache, MySQL 등)을 확인할 수 있습니다.
- 서비스 이름 옆에 Stop 버튼이 있습니다.
- Apache 서비스 앞의 Stop 버튼을 클릭합니다.
- Windows 키 + E를 눌러 파일 탐색기를 엽니다.
- 다음 디렉터리로 이동합니다.
C:\xampp\apache\conf
- 해당 위치에서 httpd.conf라는 이름의 파일을 찾습니다.
- 텍스트 편집기로 파일을 엽니다.
- 파일 안에서 다음 두 줄을 검색합니다.
Listen 80 ServerName localhost:80
이를 다음과 같이 변경합니다.
Listen 8080 ServerName localhost:8080
- CTRL + S를 눌러 파일을 저장합니다.
- XAMPP 제어판을 다시 열고 Apache 웹 서버를 시작합니다.
포트 충돌이 원인이었다면 이제 오류가 해결되었을 것입니다. 그렇지 않다면 다음 해결 방법을 시도해 보세요.
4] WAMP에서 Apache 포트 변경하기
WAMP에서 Apache 실행 포트를 변경하려면 다음 단계를 따르세요.
- 작업 관리자에서 실행 중인 모든 WAMP 프로세스를 종료합니다.
- 파일 탐색기를 엽니다.
- 다음 디렉터리로 이동합니다.
C:\wamp\apache2\conf
- 해당 위치에서 httpd.conf라는 이름의 파일을 찾습니다.
- 텍스트 편집기로 파일을 엽니다.
- 파일 안에서 다음 두 줄을 검색합니다.
Listen 80 ServerName localhost:80
이를 다음과 같이 변경합니다.
Listen 8080 ServerName localhost:8080
- 파일을 저장합니다.
이제 WAMP를 다시 실행하고 문제가 해결되었는지 확인합니다. 여전히 문제가 있다면 다음 해결 방법을 시도해 보세요.
5] application.config 파일 삭제하기 (해당되는 경우)
애플리케이션 구성 파일을 삭제하려면 다음 단계를 따르세요.
- 파일 탐색기에서 프로젝트 폴더를 엽니다.
- .vs 폴더를 엽니다. 숨김 파일/폴더 표시 옵션을 켜야 할 수 있습니다.
- .vs 폴더 안에서 config 폴더로 이동합니다.
- config 폴더 안에서 application.config 파일을 삭제합니다.
- 파일 탐색기를 닫습니다.
문제가 여전히 해결되지 않는다면 다음 해결 방법을 시도해 보세요.
6] LxssManager 서비스 재시작하기 (WSL에서 실행되는 웹 서버에 적용)

다음 단계를 따르세요.
- Windows 키 + R을 눌러 실행 대화 상자를 엽니다.
- 실행 대화 상자에 services.msc를 입력하고 Enter 키를 눌러 서비스 창을 엽니다.
- 서비스 창에서 LxssManager 서비스를 찾습니다.
- 해당 서비스를 마우스 오른쪽 버튼으로 클릭하고 '다시 시작' 또는 '시작'을 선택합니다.
- 서비스 콘솔을 닫습니다.
이제 웹 서버를 확인하면 문제가 해결되었을 것입니다.
이 해결 방법 중 하나가 여러분의 문제를 해결하는 데 도움이 되기를 바랍니다!
127.0.0.1에서 연결이 거부되는 이유는?
이 예외 메시지는 서버가 다른 호스트에서 실행 중이라고 명시한 상태에서 동일한 호스트(127.0.0.1)에 연결하려고 할 때 나타납니다. 127.0.0.1은 '루프백(loopback)' 주소를 의미합니다. 이 오류를 해결하려면 주소에 포트 번호를 추가해 보세요. 예를 들어 https://127.0.0.1:8080 (JIRA의 기본 포트)과 같이 입력하면 됩니다.
관련 글: Firefox 또는 Chrome에서 '프록시 서버가 연결을 거부합니다' 오류 해결 방법
