[Network] macOS에서 실행 중인 서버/ngrok 포트 확인 및 종료 방법 정리

🔌 macOS에서 실행 중인 서버/ngrok 포트 확인 및 종료 방법 정리

---

📌 개요

로컬에서 실행한 서버(Node.js, Flask, Spring, ngrok 등)가 특정 포트를 점유하고 실행 중일 때:

• 어떤 프로세스가 어떤 포트를 점유하고 있는지 확인
• 서버를 종료하고 해당 포트를 해제
• 포트 충돌이 발생하지 않도록 관리

이 작업은 개발 중 포트 충돌, 중복 실행, 리소스 낭비를 방지하기 위해 필수입니다.

---

✅ 1. 실행 중인 포트 확인

🔍 lsof란?

**lsof (List Open Files)**는 현재 열려 있는 파일과 이를 사용하는 프로세스를 확인하는 명령어입니다.
리눅스/유닉스 시스템에서 포트 사용 중인 프로세스 확인에도 자주 사용됩니다.

📍 특정 포트(예: 3000, 5000, 8080)가 사용 중인지 확인

# 3000번 포트를 사용 중인 프로세스 확인
lsof -i :3000

예시 결과:

COMMAND   PID   USER   FD   TYPE  DEVICE SIZE/OFF NODE NAME
node      1234  you    22u  IPv6  0x...  0t0      TCP *:3000 (LISTEN)

📍 전체 LISTEN 중인 포트 확인 (포트+PID 목록)

sudo lsof -iTCP -sTCP:LISTEN -n -P

 

---

✅ 2. ngrok 확인 및 종료

📍 ngrok 프로세스 찾기

# ngrok PID만 확인
pgrep ngrok

또는

# ngrok 관련 상세 정보 보기
ps aux | grep ngrok

📍 ngrok 종료

kill -9 $(pgrep ngrok)

 

🧽 참고: ngrok이 종료되는 5가지 상황

상황	종료 여부
Ctrl + C 수동 종료	✅ 종료됨
실행 터미널 창 닫음	✅ 종료됨
세션 만료 (Free 플랜 - 약 2시간)	✅ 종료됨
kill / pkill / kill -9 등 수동 종료	✅ 종료됨
백그라운드 실행 후 시스템 재부팅	✅ 종료됨

 

---

✅ 3. 로컬 서버(Node.js, Flask 등) 종료

📍 포트로 실행 중인 서버 찾고 프로세스 종료

lsof -i :3000        # 예: Node.js 서버
kill -9 <PID>        # PID는 위 결과에서 확인

예시:

kill -9 1234

---

✅ 4. 포트를 명시적으로 바꿔 실행하는 방법

포트 충돌을 피하기 위해 다음처럼 포트를 변경해서 실행할 수 있습니다.

Node.js 예:

PORT=5050 npm start

Flask 예:

flask run --port=5050

---

📘 정리 표

명령어	설명
lsof -i :포트번호	해당 포트를 점유 중인 프로세스 확인
sudo lsof -iTCP -sTCP:LISTEN	현재 열려 있는 모든 TCP 포트 확인
kill -9 <PID>	특정 프로세스 강제 종료
pgrep ngrok	ngrok 프로세스 PID 확인
kill -9 $(pgrep ngrok)	실행 중인 ngrok 종료

---

❗ 주의: 시스템 포트는 종료하지 말 것

• rapportd, ControlCenter 등은 macOS 시스템 프로세스
• 포트 5000, 7000 등 시스템에서도 사용할 수 있으므로 프로세스 명 확인 후 종료

ps -p <PID> -o comm,args

---

✅ 마무리 요약

작업	명령어 요약
포트 점유 확인	lsof -i :3000
ngrok 종료	kill -9 $(pgrep ngrok)
서버 프로세스 종료	kill -9 <PID>
포트 충돌 방지	다른 포트 사용 (예: 5050)

---