localhost 뜻: localhost:3000의 포트와 안 열릴 때 확인할 것
localhost는 지금 쓰는 컴퓨터 자신을 가리키는 이름이고, 뒤에 붙는 3000은 개발 서버가 열어둔 포트 번호입니다. localhost:3000이 안 열릴 때 확인할 것, 같은 주소를 남에게 보내도 그 사람 화면에서는 열리지 않는 이유, 배포로 공개 주소를 만드는 과정을 정리했습니다.
핵심 요약
- localhost:3000은 내 컴퓨터(localhost)의 3000번 포트에서 돌고 있는 개발 서버를 가리킵니다.
- 친구가 같은 localhost 주소를 열면 친구 자신의 컴퓨터를 찾기 때문에 내 화면이 보이지 않습니다.
- 배포된 주소는 내 컴퓨터를 꺼도 열리며 localhost는 새 기능을 만드는 작업실로 계속 사용합니다.
바이브코딩으로 뭔가 만들다 보면 이 주소를 매일 봐요. AI가 "http://localhost:3000 에서 확인해보세요"라고 하고, 열어보면 방금 만든 화면이 떠 있어요. 그런데 이 주소를 친구에게 보내면 이상한 일이 생겨요. 친구 화면에서는 안 열려요. 왜 그런지, 그리고 어떻게 해야 남들도 들어올 수 있게 되는지 정리해드릴게요.
localhost는 '지금 이 컴퓨터'라는 뜻이에요
localhost는 특별한 사이트 주소가 아니라, "지금 이 컴퓨터"를 가리키는 이름이에요. 뒤에 붙는 :3000은 컴퓨터 안에 열려 있는 문 번호(포트) 정도로 이해하면 돼요.
주소창에 localhost 대신 127.0.0.1을 넣어도 같은 곳이 열려요. 둘 다 "지금 이 컴퓨터"를 가리키는 같은 이름이고, localhost가 사람이 읽기 쉬운 쪽입니다.
npm run dev 같은 명령으로 개발 서버를 켜면, 내 컴퓨터 안에서 작은 서버가 돌기 시작해요. 브라우저로 localhost:3000을 여는 건 그 서버에 "지금 만들고 있는 화면 보여줘"라고 말을 거는 거예요. 만들면서 바로바로 확인하라고 있는, 일종의 작업실이에요. 왜 파일을 그냥 열지 않고 서버를 실행해야 하는지는 HTML 파일과 웹앱이 왜 다르게 열리는지 설명한 글에서 더 자세히 다뤄요.
localhost:3000의 3000은 포트 번호예요
주소에서 헷갈리는 건 보통 뒤쪽 숫자입니다. :3000은 사이트 이름의 일부가 아니라, 내 컴퓨터에 열려 있는 문 번호(포트)예요. 한 컴퓨터에서 여러 프로그램이 동시에 돌 수 있으니, 어느 문으로 들어가야 할지 번호로 구분합니다.
http://localhost:3000
└──────┘ └──┘
이 컴퓨터 3000번 문
번호가 3000인 건 규칙이 아니라 도구의 기본값입니다. Next.js 개발 서버는 3000번을 먼저 쓰고, 이미 다른 프로그램이 3000번을 쓰고 있으면 3001번으로 넘어가요. Vite로 만든 프로젝트는 5173번을 기본으로 씁니다. 그래서 npm run dev를 실행한 터미널에 찍힌 주소를 그대로 열어야 해요. 어제 3000번이었다고 오늘도 3000번인 건 아닙니다.
localhost:3000이 안 열릴 때 확인할 것
localhost:3000을 열었는데 "연결할 수 없음"이나 빈 화면이 뜬다면 순서대로 확인해보세요. 거의 전부 문을 열어둔 개발 서버가 꺼져 있거나 다른 번호에 있다는 뜻입니다.
npm run dev를 실행한 터미널이 아직 켜져 있나요? 창을 닫거나Ctrl+C로 멈추면 그 문도 같이 닫힙니다.- 터미널에 찍힌 포트 번호가 3000번인가요? 3001번으로 넘어갔다면 주소도 바꿔야 해요.
- 프로젝트 폴더에서 실행했나요? 다른 폴더에서 켜면 다른 프로젝트가 열립니다.
- 터미널에
EADDRINUSE나 "port 3000 is in use"가 보이나요? 아까 켜둔 개발 서버가 아직 3000번을 잡고 있는 경우예요. 그 터미널에서Ctrl+C로 멈추고 다시 켜면 됩니다. http://로 열었나요?https://localhost:3000은 개발 서버가 받지 못해 오류가 납니다.
주소를 손으로 고쳐 치는 대신, npm run dev를 실행한 터미널에 찍힌 주소를 그대로 복사해 여는 편이 빠릅니다.
그래서 남들은 못 열어요
localhost가 "지금 이 컴퓨터"라는 뜻이라는 게 함정이에요. 친구가 자기 브라우저에 localhost:3000을 치면, 친구는 자기 컴퓨터를 열어보는 거예요. 거기엔 내 사이트가 없으니 아무것도 안 떠요.
작업실에서 구운 빵은 작업실에 와야만 먹을 수 있는 것과 같아요. 지금 내 사이트는 내 컴퓨터라는 작업실 안에서만 돌아가고 있어요. 내 컴퓨터를 끄면 같이 꺼져요.
배포가 그 벽을 넘는 일이에요
배포는 내 코드를 인터넷 위의 컴퓨터에 올려서, 누구나 들어올 수 있는 진짜 주소를 받는 일이에요.
인터넷에 항상 켜져 있는 컴퓨터(서버)에 내 코드를 실어두면, 누가 언제 접속해도 그 서버가 내 사이트를 보여줘요. 예전엔 이 서버를 직접 구하고 관리하는 일이 만만치 않았는데, 지금은 Vercel 같은 배포 서비스가 그 인프라를 대신 맡아줘요. 코드를 올리면 몇 분 안에 내프로젝트.vercel.app 같은 주소가 생기고, 원하면 따로 산 도메인(mybakery.kr 같은)을 연결할 수도 있어요. 기본 배포 주소와 자체 도메인 중 무엇을 써야 할지는 홈페이지 도메인이 꼭 필요한지 설명한 글에서 이어서 확인할 수 있습니다.
배포하면 달라지는 것들
- 링크를 보내면 누구든 열 수 있어요. 폰에서도, 친구 컴퓨터에서도.
- 내 컴퓨터를 꺼도 사이트는 계속 살아 있어요.
- 진짜 손님을 받을 수 있어요. 예약이든 주문이든, 여기서부터 서비스예요.
localhost가 필요 없어지는 게 아니에요. 역할이 나뉘는 거예요. localhost는 작업실, 배포된 주소는 매장. 새 기능은 작업실에서 만들어 확인하고, 다 됐으면 매장에 내보내요. 지난 글에서 말한 것처럼 GitHub에 푸시할 때마다 매장이 자동으로 새 버전이 되게 해두면, 이 리듬이 아주 편해져요.
다만 배포했다고 구글 검색에 바로 나타나는 것은 아니에요. 매장 문을 여는 일과 사람들이 검색으로 매장을 발견하는 일이 왜 다른지는 SEO와 검색 노출의 과정을 설명한 글에서 살펴볼 수 있어요.
배포할 준비가 됐는데 Vercel, Netlify, Railway 중 어디를 골라야 할지 고민된다면 프로젝트 실행 방식에 따른 배포 플랫폼 비교를 참고하세요.
바이브코딩에서는 어렵지 않아요
배포라고 하면 거창하게 들리지만, 실제로는 AI에게 시키면 돼요. "이거 배포해줘"라고 하면 클로드코드(Claude Code)가 Vercel 연결부터 올리는 것까지 순서대로 안내해줘요. 처음 한 번 계정을 만들고 연결하는 과정만 거치면, 그다음부터는 몇 마디로 끝나요.
배포할 땐 주의할 점이 있어요. 배포하는 순간부터 남들이 진짜로 들어올 수 있는 곳이 돼요. 시험 삼아 넣어둔 데이터나 아직 공개하면 안 되는 내용이 없는지 한 번 둘러보고 내보내세요.
정리
- localhost는 "지금 이 컴퓨터"라는 뜻이에요. 내 컴퓨터 안 작업실이라 남들은 못 열어요.
- 배포는 코드를 인터넷 위 서버에 올려서 누구나 들어올 수 있는 주소를 받는 일이에요.
- Vercel 같은 서비스 덕분에 계정 연결 한 번이면, 그다음은 AI에게 시켜서 끝나요.
- localhost는 작업실, 배포 주소는 매장. 만들 땐 작업실에서, 보여줄 땐 매장으로.
처음 배포한 날의 기분이 꽤 오래 가요. 내가 만든 화면이 진짜 주소를 달고, 폰으로도 열리고, 링크를 받은 친구가 "오 이거 뭐야"라고 답하는 순간이요. localhost에서 충분히 만들었다면, 한 번 내보내 보세요.
Vercel에 올리고 배포 후 설정까지 확인하려면 바이브코딩 가이드 13장의 배포 실습을 따라 해보세요.
인스타그램 @ddukddak.build · 페이스북 뚝딱








