개발 환경 설정 기초집LESSON 14

포트와 로컬 서버: 실행 주소·포트 충돌 해결하기

난이도입문

예상 시간45분

선수지식8강 Python 또는 10강 Node.js

14강. 포트와 로컬 서버: 실행 주소·포트 충돌 해결하기

1. 이번 강의에서 해결할 문제

개발 서버가 “address already in use” 오류로 시작되지 않거나, 브라우저에서 잘못된 포트를 엽니다. 주소, 포트와 프로세스의 관계를 확인합니다.

2. 학습 목표

3. 핵심 개념

http://localhost:8000에서 localhost는 내 컴퓨터, 8000은 한 네트워크 서비스의 접점입니다. 같은 IP·프로토콜·포트 조합은 동시에 한 Listener만 사용할 수 있습니다. 포트를 쓰는 프로세스를 확인한 뒤 기존 서버를 정상 종료하거나 새 포트를 선택합니다.

4. 단계별 실습

PowerShell A · 실행 위치: D:\Dev\environment-lab

python -m http.server 8000 --bind 127.0.0.1

예상 결과: Serving HTTP와 8000 포트가 표시되고 명령은 서버가 동작하는 동안 대기합니다. 관리자 권한은 필요하지 않습니다. 종료는 Ctrl+C입니다.

PowerShell B · 실행 위치: 아무 일반 PowerShell

$listener = Get-NetTCPConnection -LocalPort 8000 -State Listen -ErrorAction SilentlyContinue
$listener | Select-Object LocalAddress, LocalPort, OwningProcess
if ($listener) { Get-Process -Id $listener.OwningProcess }
Test-NetConnection 127.0.0.1 -Port 8000

예상 결과: Listener의 PID와 Python 프로세스, TCP 테스트 성공 여부가 표시됩니다.

충돌을 재현하려면 PowerShell C에서 같은 서버 명령을 실행합니다. 오류를 확인한 뒤 프로세스를 강제 종료하지 말고 8001로 바꿔 실행합니다.

5. 명령어와 설정이 동작하는 이유

첫 Python 프로세스가 127.0.0.1:8000을 Listen 상태로 점유합니다. 두 번째 프로세스는 같은 접점을 사용할 수 없어 실패하며 포트 8001은 별도 접점이라 동시에 실행됩니다.

6. 자주 하는 실수와 해결법

7. 직접 실습

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ