내 컴퓨터에서만 열리는 것을 남도 볼 수 있게: 배포가 뭔지부터

내 컴퓨터에서만 열리는 상태

AI 도구로 뭔가 만들었습니다. 화면에 잘 나옵니다. 친구에게 보여주려고 주소를 물어보니, 내 컴퓨터에만 있고 남에게 보낼 링크가 없다는 걸 알게 됩니다.

여기서 많은 사람이 멈춥니다. "배포"라는 단어가 나오는 순간 갑자기 어려워지기 때문입니다. 그런데 실제로 필요한 개념은 몇 개 안 됩니다.

왜 링크가 없는가

만든 파일이 지금은 내 컴퓨터 안에만 있습니다. 주소창에 보이는 localhost는 "이 컴퓨터"라는 뜻입니다. 남이 그 주소를 입력하면 자기 컴퓨터를 찾아가니 아무것도 안 나옵니다.

링크를 만들려면 파일이 항상 켜져 있는 다른 컴퓨터에 올라가 있어야 합니다. 그 컴퓨터를 서버라고 부르고, 파일을 거기 올리는 일을 배포라고 합니다.

즉 배포는 어려운 기술이라기보다 "내 컴퓨터에 있던 것을 남도 접속할 수 있는 곳으로 옮기는 일"입니다.

두 종류가 있고, 난이도가 다르다

만든 것이 어느 쪽인지에 따라 필요한 게 달라집니다.

정적인 것: 누가 보든 같은 내용이 나오는 것. 소개 페이지, 계산기, 혼자 쓰는 도구, 브라우저에서 도는 게임이 여기 속합니다. 파일만 올리면 끝이라 가장 쉽습니다.

저장이 필요한 것: 사용자가 입력한 내용이 남아야 하는 것. 회원가입, 게시판, 여러 사람이 함께 쓰는 도구입니다. 데이터를 보관할 곳이 따로 필요해서 단계가 늘어납니다.

처음이라면 정적인 것부터 올려보는 걸 권합니다. 저장 기능은 그다음에 붙여도 됩니다. 순서를 반대로 잡으면 시작도 못 하고 지치는 경우가 많습니다.

무료로 올릴 수 있다

개인 프로젝트를 무료로 올릴 수 있는 서비스가 여럿 있습니다. 이름은 달라도 사용 흐름은 비슷합니다.

1. 만든 코드를 코드 저장소에 올린다
2. 배포 서비스에 가입하고 그 저장소를 연결한다
3. 자동으로 주소가 만들어진다

한 번 연결해두면 그다음부터는 코드를 수정해 저장소에 올릴 때마다 알아서 다시 배포됩니다. 매번 수동으로 올릴 필요가 없습니다.

무료 한도는 서비스마다 다르고 정책도 바뀌므로, 지금 쓰려는 서비스의 조건을 직접 확인하세요. 개인 프로젝트 수준이면 대체로 무료 범위 안에서 해결됩니다.

배포하면 거의 항상 겪는 세 가지

내 컴퓨터에서는 멀쩡했는데 올리고 나면 깨지는 일이 흔합니다. 원인이 거의 정해져 있습니다.

이미지가 안 나온다. 파일 이름의 대문자·소문자 때문인 경우가 많습니다. 내 컴퓨터는 Logo.png와 logo.png를 같은 것으로 취급하지만, 서버는 다른 파일로 봅니다. 코드에 쓴 이름과 실제 파일 이름이 정확히 같은지 확인하세요.

흰 화면만 나온다. 대부분 설정값이 빠진 경우입니다. 내 컴퓨터에만 저장해둔 값(외부 서비스 키 같은 것)은 자동으로 따라 올라가지 않습니다. 배포 서비스의 설정 화면에 같은 값을 다시 넣어야 합니다.

고쳤는데 그대로다. 브라우저가 이전 화면을 기억하고 있는 경우가 많습니다. 다른 브라우저나 시크릿 창으로 열어보세요. 거기서 정상이면 코드는 문제없습니다.

이 세 가지는 실력과 무관하게 누구나 겪습니다. 막혔다고 자책할 필요가 없는 종류입니다.

AI에게 물어볼 때 이렇게

배포에서 막히면 AI에게 물어보는 게 가장 빠릅니다. 이때 오류 메시지를 그대로 복사해서 붙여넣으세요. 요약하지 마세요. 빨간 글씨 전체가 단서입니다.

배포하니까 이런 오류가 나와. 어떻게 고쳐?
(오류 메시지 전체 붙여넣기)
참고로 나는 [사용한 도구 이름]으로 만들었고 [배포 서비스 이름]에 올렸어.

마지막 줄이 중요합니다. 어떤 환경인지 모르면 엉뚱한 답이 옵니다.

주소가 이상하게 긴데 바꿀 수 있나요?

무료로 배포하면 대체로 서비스가 만들어준 긴 주소가 나옵니다. 원하는 주소를 쓰려면 도메인을 따로 구입해서 연결해야 하고, 보통 연 단위로 비용이 듭니다. 처음에는 기본 주소로 두고 공개해도 아무 문제가 없습니다. 주소보다 내용이 먼저입니다.

올려둔 걸 나중에 내릴 수 있나요?

언제든 내릴 수 있습니다. 비공개로 바꾸거나 배포를 삭제하면 됩니다. 다만 공개된 동안 누군가 주소를 저장해뒀거나 검색에 잡혔을 수 있으니, 공개하기 전에 개인정보나 테스트용 내용이 들어 있지 않은지 한 번 확인하세요.

만들다 만 것도 올려도 되나요?

올려도 됩니다. 오히려 완성을 기다리다 영영 공개하지 않는 경우가 훨씬 많습니다. 아직 다듬는 중이라고 설명을 붙여두면 보는 사람도 그렇게 이해합니다. 완성도보다 "지금 눌러볼 수 있는가"가 반응을 얻는 데 훨씬 큰 영향을 줍니다.

링크가 생기면 달라진다

주소가 생기는 순간 만든 것의 성격이 바뀝니다. 보여줄 수 있게 되고, 피드백을 받을 수 있게 되고, 계속할 이유가 생깁니다.

배포까지 마쳤다면 Vibeollio에 프로젝트 등록해서 공개해보세요. 설치 없이 링크로 바로 열리는 프로젝트는 방문자가 그 자리에서 눌러볼 수 있어 반응을 얻기 좋습니다. 댓글로 들어오는 한두 줄이 다음에 무엇을 할지 정해주는 경우가 많습니다.