localhost와 포트 번호란 — :3000, :8080이 대체 뭐야

AI 도구를 로컬에 띄우거나 바이브코딩 결과물을 처음 열 때, 브라우저 주소창에 뜨는 게 localhost:3000 같은 주소입니다.

localhost는 '내 컴퓨터 자신'을 가리키는 주소이고, 포트 번호는 그 안에서 프로그램을 구분하는 방 번호입니다.

이 글은 2026년 7월 기준으로, localhost와 포트가 뭔지 비유로 쉽게 풀어봅니다.

다 읽고 나면 :3000, :8080이 뜬 화면을 봐도 당황하지 않게 됩니다.

localhost는 내 컴퓨터 자신을 가리키는 주소(127.0.0.1)입니다. 포트 번호는 그 컴퓨터 안에서 어떤 프로그램에 접속할지 정하는 통로 번호입니다. localhost:3000은 "내 컴퓨터의 3000번 방에 있는 프로그램"이라는 뜻입니다.

localhost란 무엇인가

localhost는 '내 컴퓨터 자신'을 가리키는 특별한 주소입니다.

집으로 치면 "우리 집"이라고 부르는 것과 같습니다.

남에게 알려주는 주소가 아니라, 나 자신을 부르는 이름이죠.

이 주소의 실제 숫자 버전이 127.0.0.1입니다.

localhost와 127.0.0.1은 사실상 같은 곳을 가리킵니다.

그래서 localhost로 접속하면 인터넷 밖으로 나가지 않고, 내 컴퓨터 안에서만 오갑니다.

내가 켠 프로그램을 나만 보는 상태라, 아직 인터넷에 공개된 게 아닙니다.

포트 번호란 무엇인가

포트 번호는 한 컴퓨터 안에서 프로그램을 구분하는 '호실 번호'입니다.

큰 건물을 떠올리면 쉽습니다.

건물 주소(localhost)는 하나지만, 안에는 여러 호실이 있습니다.

301호, 802호처럼 방마다 번호가 붙어야 정확히 찾아갑니다.

컴퓨터도 똑같습니다.

여러 프로그램이 동시에 켜져 있을 때, 포트 번호로 어느 프로그램에 갈지 정합니다.

포트 번호는 0부터 65535까지 쓸 수 있습니다.

이 중 0부터 1023번은 '잘 알려진 포트(well-known port)'라 부르며, 웹처럼 정해진 용도로 예약돼 있습니다.

개발할 때는 주로 3000, 8080, 5000번을 많이 씁니다.

http://localhost:3000
      └ 내 컴퓨터   └ 3000번 방(프로그램)

자주 보는 포트 번호 정리

화면에서 자주 마주치는 포트를 표로 정리했습니다.

포트	주요 용도
80	일반 웹(http) 기본 포트
443	보안 웹(https) 기본 포트
3000	개발용 웹 앱에서 자주 쓰는 포트
5000	파이썬 서버 등에서 자주 쓰는 포트
8080	웹 서버·개발 서버에서 자주 쓰는 포트

80번과 443번은 브라우저가 알아서 붙이기 때문에 주소에 잘 안 보입니다.

그래서 평소 웹사이트 주소에는 포트 번호가 생략돼 있습니다.

반대로 3000, 8080처럼 기본이 아닌 포트는 주소에 직접 :3000 형태로 써줘야 합니다.

---

AI랑 무슨 상관인가

localhost와 포트는 AI 도구를 직접 다룰 때 바로 등장합니다.

요즘은 AI를 내 컴퓨터에서 직접 돌리는 경우가 많아졌거든요.

예를 들어 Ollama로 AI 모델을 로컬에 띄우면 localhost:11434 같은 주소로 연결됩니다.

n8n 같은 자동화 도구를 로컬에 설치하면 보통 localhost:5678로 접속합니다.

오픈웹UI 같은 채팅 화면도 localhost:포트 형태로 열립니다.

바이브코딩으로 만든 결과물을 처음 확인할 때도 마찬가지입니다.

대부분 localhost:3000 주소를 열어보라는 안내가 나옵니다.

개인적으로는 이 개념 하나만 잡아두면, AI 도구 설치 안내문이 훨씬 덜 무섭게 느껴진다고 봅니다.

결국 localhost:포트는 '내 컴퓨터에서 켠 프로그램을 여는 문'이라고 이해하면 충분합니다.

정리

localhost는 '내 컴퓨터 자신'을 가리키는 주소(127.0.0.1)입니다.

포트 번호는 그 안에서 프로그램을 구분하는 방 번호입니다.

localhost:3000은 "내 컴퓨터의 3000번 방 프로그램"을 여는 주소입니다.

이 두 가지만 알아도 AI 도구를 로컬에서 다룰 때 첫 관문은 넘은 셈입니다.

참고로 localhost가 '이름'이라면, 그 이름을 실제 주소로 바꾸는 이야기는 다음 IP·도메인 편에서 이어집니다.

자주 묻는 질문

localhost:3000이 안 열리면 왜 그런가요?

보통은 그 3000번 방에 켜진 프로그램이 없어서입니다.

AI 도구나 개발 서버를 먼저 실행해야 해당 포트가 열립니다.

프로그램을 끈 상태에서 주소만 열면 접속되지 않습니다.

포트 번호는 아무 숫자나 써도 되나요?

0부터 65535 사이면 쓸 수 있지만, 0~1023번은 정해진 용도로 예약돼 있어 피하는 게 좋습니다.

그래서 개발용으로는 3000, 8080처럼 큰 숫자를 주로 씁니다.

이미 다른 프로그램이 쓰는 번호와 겹치면 충돌이 나므로, 그럴 땐 번호만 바꿔주면 됩니다.