처음으로 에이전트가 "사이트가 localhost:3000에서 실행 중입니다"라고 했을 때, 바로 브라우저를 열어 주소를 쳤어요. 진짜 작동하는 웹사이트가 떡하니 떠 있었죠. 링크를 모두에게 보내고 싶었어요. 그런데 폰으로 접속을 시도했더니 아무것도 없었어요. 그때 깨달았어요. 이건 내 앞에 있는 이 컴퓨터 위에서만 존재하는 거였어요.
빈 극장에서 진행하는 드레스 리허설을 떠올려보세요. 조명도 의상도 완벽하고, 공연이 처음부터 끝까지 돌아가요. 다만 관객이 없을 뿐이에요. 공연을 돌리고, 직접 보고, 문제 있는 부분을 잡아내요. 아무도 표를 사지 않았어요. 그게 localhost예요. 소프트웨어가 완전히 살아 움직이지만, 오직 나만 들어설 수 있는 빈 무대에서요.
실제로 무슨 일이 벌어지는 걸까요. 무언가를 빌드하면, 먼저 내 컴퓨터에서 실행해요. 내 컴퓨터가 자체적으로 작은 서버(페이지를 제공하는 주체)가 되어, 그 페이지를 나에게 돌려줘요. 이때 주어지는 주소는 이런 형태예요:
localhost:3000
두 부분으로 나뉘는데, 둘 다 알아두면 유용해요:
localhost는 컴퓨터가 자기 자신을 가리키는 별명이에요.127.0.0.1로 표기하기도 해요. 같은 뜻이에요. 문자 그대로 "바로 이 기계"를 의미해요. 이 주소를 입력하면 인터넷에 연결하는 게 아니라, 자기 자신의 문을 두드리는 거예요.:3000은 포트예요. 그 집의 특정 문 번호라고 생각하면 돼요. 컴퓨터는 여러 것을 동시에 실행할 수 있으니, 각각 충돌하지 않도록 고유한 문 번호를 받아요.:3000,:5173,:8080처럼 다양해요. 숫자 자체는 중요하지 않아요. 이 공연이 어느 문 뒤에서 열리는지를 나타낼 뿐이에요.
핵심은 비공개라는 점이에요. 팀원도, 고객도, 주소를 추측한 누군가도 볼 수 없어요. 외부에서 접근 가능한 공개 주소가 없어요. 노트북을 닫으면 공연은 끝나요. 다시 열고 서버를 시작하면 리허설이 재개되고요. 이건 제한이 아니라 설계예요. 오직 나만 들어설 수 있는 공간이어야 하거든요.
그 비공개성 덕분에 마음껏 만들고 부수는 공간이 돼요. 뭔가를 바꾸고 새로고침을 누르면 바로 반영돼요. 어색하면 고치면 돼요. 깨지면 더 부수고, 이유를 파악하고, 다시 고치면 돼요. 완성본까지 가는 마흔 번의 실패를 아무도 지켜보지 않아요. localhost가 마치 사고 현장처럼(오류투성이에 페이지 반이 날아간) 보인 적도 있었어요. 하지만 그걸 본 사람은 나뿐이었으니 아무 문제없었어요.
실제로 마주치는 순간:
"내 컴퓨터에서는 되는데"라는 말을 듣게 돼요. 소프트웨어 업계에서 가장 오래된 농담이에요. localhost(개발자 본인 컴퓨터)에서는 잘 돌아가지만, 다른 어디에서도 작동한다는 걸 아직 증명하지 못했다는 뜻이에요. 비공개 환경에서 돌아가는 것과 전 세계에 공개하는 것은 전혀 다른 테스트예요.
에이전트가 "로컬에서 실행 중"이라고 해요. 같은 의미예요. 에이전트가 무언가를 빌드하고, 공개하기 전에 먼저 내 컴퓨터에서 볼 수 있도록 리허설을 시작한 거예요.
링크를 눌렀더니 폰에서 작동하지 않아요. 당연한 결과예요. 폰에서
localhost는 그 폰 자체를 가리켜요. 노트북이 아니에요. 이 주소는 항상 입력한 기기 자신만을 가리켜요.
그러면 자연스럽게 다음 질문이 나오죠. 리허설을 어떻게 온 세상이 표를 살 수 있는 진짜 공연으로 만드는 걸까요? 비공개 컴퓨터에서 꺼내, 누구나 접근할 수 있는 공개 주소로 내보내면 돼요. 그 과정(개막일, 빈 극장에 관객이 들어차는 순간)이 바로 배포예요.
비공개로 만들어요. localhost에서 리허설해요. 공연이 진짜 준비됐을 때 비로소 문을 열어요.