바쁜 분은 이것만
Address already in use/[Errno 48]/EADDRINUSE는 그 포트를 다른 프로세스가 이미 쓰고 있다는 뜻lsof -nP -iTCP:8000 -sTCP:LISTEN으로 주인(PID) 찾기- 내가 띄운 게 맞는지
ps -p PID로 확인한 뒤kill PID.-sTCP:LISTEN없이 PID를 통째로 kill하면 브라우저 같은 접속한 쪽까지 끌 수 있어요
로컬 서버를 띄우려는데 OSError: [Errno 48] Address already in use가 나와서 막힐 때가 있습니다. 보통 아까 띄운 서버를 Ctrl+C로 안 끄고 터미널 창만 닫았거나, 다른 탭에서 같은 포트로 돌리고 있는 경우예요. 맥 터미널의 lsof로 그 포트를 누가 쓰는지 찾고 끄는 방법을 정리했습니다. 예제는 임시 폴더에서 python3 -m http.server를 직접 띄워서 일부러 같은 포트를 겹치게 만든 출력이고, 테스트 포트는 8000만 썼어요.
1. 에러 재현: 같은 포트로 서버 두 번 띄우기
먼저 8000번 포트로 간단한 웹 서버를 하나 띄워 두고(&를 붙여 뒤에서 실행), 같은 명령을 한 번 더 실행했습니다.
$ python3 -m http.server 8000 &
Serving HTTP on :: port 8000 (http://[::]:8000/) ...
$ python3 -m http.server 8000
Traceback (most recent call last):
File "<frozen runpy>", line 198, in _run_module_as_main
...(중간 생략)...
File "/opt/homebrew/Cellar/python@3.14/3.14.3_1/Frameworks/Python.framework/Versions/3.14/lib/python3.14/socketserver.py", line 478, in server_bind
self.socket.bind(self.server_address)
~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^
OSError: [Errno 48] Address already in use
마지막 줄의 socket.bind가 포트를 잡으려다 실패한 자리입니다. 48은 맥(BSD 계열)에서 "주소가 이미 사용 중"을 뜻하는 번호예요. 리눅스에서는 같은 에러가 98번으로 나옵니다.
노드(Node.js)로 같은 포트를 열어도 이름만 다르고 뜻은 같아요.
$ node -e "require('http').createServer().listen(8000)"
Error: listen EADDRINUSE: address already in use :::8000
code: 'EADDRINUSE',
Flask, Django, Vite, 스프링 부트도 문구는 조금씩 달라도 Address already in use나 EADDRINUSE가 들어 있으면 같은 상황입니다.
2. lsof -i :포트로 누가 쓰는지 찾기
lsof는 "list open files"의 줄임말로, 프로세스가 열어 둔 파일과 네트워크 접속을 보여 줍니다. -i :포트를 붙이면 그 포트를 쓰는 것만 나와요.
$ lsof -i :8000
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
Python 44028 me 4u IPv6 0xa343e8ef25d9f622 0t0 TCP *:irdmi (LISTEN)
COMMAND: 프로그램 이름 (여기서는Python)PID: 프로세스 번호. 끌 때 이 번호를 씁니다USER: 실행한 사용자NAME: 주소와 포트, 괄호 안은 상태.LISTEN이면 이 포트로 접속을 기다리는 서버예요
그런데 포트 자리에 8000이 아니라 irdmi라고 나왔죠. lsof는 기본으로 포트 번호를 /etc/services에 적힌 서비스 이름으로 바꿔서 보여 주는데, 8000번에 그런 이름이 붙어 있어서 그래요. 숫자 그대로 보려면 -P, IP 주소를 호스트 이름으로 바꾸느라 느려지지 않게 하려면 -n을 붙입니다. 그리고 서버만 보고 싶으면 -iTCP:8000 -sTCP:LISTEN처럼 TCP의 LISTEN 상태로 좁혀요.
$ lsof -nP -iTCP:8000 -sTCP:LISTEN
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
Python 44028 me 4u IPv6 0xa343e8ef25d9f622 0t0 TCP *:8000 (LISTEN)
*:8000의 *는 "모든 주소에서 받는다"는 뜻입니다. 127.0.0.1:8000으로 나오면 내 맥 안에서만 받는 서버예요.
3. 끄기 전에 ps로 확인하고 kill
PID만 뽑고 싶으면 -t를 붙입니다. 번호만 한 줄씩 나와서 다른 명령에 넘기기 좋아요.
$ lsof -ti :8000
44028
바로 끄기 전에, 이게 정말 내가 띄운 서버인지 ps로 한 번 봅니다. etime은 실행된 지 얼마나 됐는지, command는 실행한 명령 전체예요.
$ ps -p 44028 -o pid,etime,command
PID ELAPSED COMMAND
44028 00:01 /opt/homebrew/Cellar/python@3.14/3.14.3_1/Frameworks/Python.framework/Versions/3.14/Resources/Python.app/Contents/MacOS/Python -u -m http.server 8000
끝에 -m http.server 8000이 보이니 아까 띄운 테스트 서버가 맞습니다. (-u는 테스트 스크립트에서 출력을 바로 찍으려고 붙인 옵션이에요.) 이제 kill로 끄고 다시 확인합니다.
$ kill 44028
$ lsof -i :8000
$ echo $?
1
아무것도 안 나오고 종료 코드가 1이면 그 포트를 쓰는 프로세스가 없다는 뜻이에요. 이제 서버를 다시 띄우면 됩니다.
kill은 기본으로 "정리하고 끝내 달라"는 신호(SIGTERM)를 보내요. 그래도 안 꺼지는 프로그램에만 강제 종료인 kill -9 PID를 씁니다. -9는 프로그램이 저장이나 정리를 할 틈 없이 바로 끊기니 처음부터 쓰지는 마세요.
터미널 창이 아직 열려 있다면 그 창으로 가서 Ctrl+C로 끄는 게 제일 깔끔합니다. 창을 닫았거나 어느 창인지 모를 때 lsof를 쓰면 돼요.
4. kill $(lsof -ti :포트)를 조심해야 하는 이유
인터넷에서 kill $(lsof -ti :8000)처럼 한 줄로 끄는 방법을 많이 봅니다. 그런데 이 포트에 접속해 있는 쪽도 같이 잡힌다는 점을 알아 두세요. 서버를 띄우고, 다른 파이썬 프로세스로 그 서버에 접속을 붙잡아 둔 상태에서 확인했습니다.
$ lsof -nP -i :8000
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
Python 44086 me 4u IPv6 0xa4551d8ddf141b70 0t0 TCP *:8000 (LISTEN)
Python 44086 me 5u IPv6 0xa343e8ef25d9f622 0t0 TCP 127.0.0.1:8000->127.0.0.1:55755 (ESTABLISHED)
Python 44088 me 3u IPv4 0x21fb3563cd093434 0t0 TCP 127.0.0.1:55755->127.0.0.1:8000 (ESTABLISHED)
$ lsof -ti :8000
44086
44088
44086이 서버, 44088이 접속한 쪽이에요. -ti :8000만 쓰면 둘 다 나오니, 접속한 쪽이 브라우저나 편집기였다면 그 앱까지 꺼질 수 있습니다. 서버만 고르려면 -sTCP:LISTEN을 붙여요.
$ lsof -ti :8000 -sTCP:LISTEN
44086
$ kill $(lsof -ti :8000 -sTCP:LISTEN)
$ lsof -nP -i :8000
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
Python 44088 me 3u IPv4 0x21fb3563cd093434 0t0 TCP 127.0.0.1:55755->127.0.0.1:8000 (CLOSE_WAIT)
서버만 꺼졌고, 접속했던 쪽은 상대가 끊었다는 CLOSE_WAIT 상태로 남아 있습니다. 이 줄은 LISTEN이 아니라서 새 서버를 띄우는 데는 걸리지 않아요.
5. 자주 쓰면 함수로 만들어 두기
매번 옵션을 치기 번거로우면 ~/.zshrc에 짧은 함수를 넣어 둡니다. 넣는 방법과 source ~/.zshrc로 반영하는 법은 맥 터미널 alias 설정 방법 (~/.zshrc)에 있어요.
port() { lsof -nP -iTCP:"$1" -sTCP:LISTEN; }
서버가 떠 있을 때와 빈 포트를 물어봤을 때입니다.
$ port 8000
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
Python 44177 me 4u IPv6 0xa7fb10ab23bd6503 0t0 TCP *:8000 (LISTEN)
$ port 8001
$ echo $?
1
6. 그래도 안 보일 때 확인할 것
- 다른 사용자나 시스템이 쓰는 포트:
sudo없이 실행한 lsof는 내 계정 프로세스만 보여 줍니다. 아무것도 안 나오는데 계속 에러가 나면 시스템 프로세스일 수 있어요. 이럴 땐 끄기보다 포트 번호를 바꾸는 쪽이 안전합니다(python3 -m http.server 8001처럼). - 5000번·7000번: 맥은 AirPlay 수신 모드가 이 포트를 쓰는 것으로 알려져 있어서, Flask 기본 포트 5000이 막히는 경우가 많아요. 시스템 설정의 AirDrop 및 Handoff 쪽에서 AirPlay 수신 모드를 끄거나, 앱 포트를 바꾸면 됩니다.
- 도커 컨테이너: 컨테이너가 포트를 잡고 있으면 lsof에는 도커 관련 프로세스로 보여요. 이때는 kill 대신
docker ps로 컨테이너를 찾아 멈추는 게 맞습니다.
정리
| 하고 싶은 것 | 명령 |
|---|---|
| 포트 쓰는 프로세스 보기 | lsof -i :8000 |
| 숫자 그대로, 서버만 | lsof -nP -iTCP:8000 -sTCP:LISTEN |
| PID만 | lsof -ti :8000 -sTCP:LISTEN |
| 무슨 프로그램인지 확인 | ps -p PID -o pid,etime,command |
| 끄기 | kill PID (안 꺼질 때만 kill -9 PID) |
| 한 줄로 서버만 끄기 | kill $(lsof -ti :8000 -sTCP:LISTEN) |
| 비었는지 확인 | lsof -i :8000 출력 없음, echo $? → 1 |
참고: macOS man page — lsof(8)(-i, -n, -P, -t, -s), kill(1), ps(1) / Python 공식 문서 — http.server, socket, errno / Node.js 공식 문서 — net(EADDRINUSE)
