2026.11.12 찜질중 개발일기) GitHub Pages에서 나만의 도메인으로

01. 이름은 찜질중인데, 주소는 아직 개발 중

찜질중을 GitHub Pages에 올리고 처음 주소를 열었을 때는 신기했다.

내가 만든 화면을 파일로 실행하는 게 아니라, 진짜 웹주소를 통해 접속할 수 있다는 게 생각보다 뿌듯했다.

eye215.github.io/jjimjiljung/

 

주소 자체가 길거나 불편한 건 아니었다. 오히려 무료로 웹사이트를 배포하고 바로 확인할 수 있다는 점에서 GitHub Pages는 꽤 만족스러웠다.

다만 조금 아쉬운 부분이 있었다.

분명 '찜질중'이라는 이름도 정하고, 캐릭터도 만들고, 나름대로 하나의 서비스를 기획하고 있었는데 주소만 보면 어딘가 개발 연습용 프로젝트 같은 느낌이었다.

혼자 테스트할 때는 아무런 문제가 없지만, 나중에 다른 사람들에게 소개할 때는 조금 더 찜질중만의 주소가 있었으면 좋겠다고 생각했다.

 

그래서 선택한 것이 jjimjiljung.yullul.com이라는 서브도메인이다.

기존에 사용하던 도메인 아래에 찜질중만의 공간을 만드는 방식이다.

새로운 도메인을 별도로 구매하지 않아도 되고, 앞으로 다른 개인 프로젝트가 늘어나더라도 각각 독립적인 주소를 가질 수 있다.

무엇보다 주소만 봐도 어떤 서비스인지 알 수 있다는 게 마음에 들었다.

 

GitHub Pages가 내가 만든 것을 처음 세상에 꺼내 놓는 과정이었다면, 전용 도메인은 그 공간에 제대로 된 간판을 달아 주는 느낌이었다.

02. 도메인 연결도 결국 경로 설정이었다

도메인 연결 방법을 알아보면서 처음에는 조금 낯선 단어들이 보였다.

DNS, CNAME, GitHub Pages, HTTPS.

평소 서비스를 기획할 때도 서버와 도메인 이야기를 듣기는 했지만, 직접 설정하는 건 또 다른 느낌이었다.

내가 이해한 방식은 이렇다.

 

사용자가 jjimjiljung.yullul.com을 입력하면, DNS 설정을 통해 찜질중이 올라가 있는 GitHub Pages로 연결되는 것이다.

즉, 새로운 웹사이트를 만드는 게 아니라 기존 사이트에 들어오는 주소를 하나 더 만드는 셈이다.

연결을 위해서는 가비아에서 DNS 레코드를 설정하고, GitHub Pages에도 사용할 도메인을 등록해야 한다.

그리고 주소가 정상적으로 연결되는지 확인해야 한다.

 

여기서 중요한 건 단순히 화면이 뜨는지만 보는 게 아니라는 점이다.

모바일에서도 정상 접속되는지, HTTPS가 적용되는지, 기존 주소에서 사용하던 기능들이 그대로 동작하는지도 확인해야 한다.

서브도메인을 설정했다고 모든 것이 즉시 바뀌는 것도 아니다. DNS 변경이 반영되는 데 시간이 걸릴 수 있기 때문이다.

아직 연결 작업이 끝났다고 말할 단계는 아니지만, 필요한 설정을 하나씩 정리하고 있다.

 

03. 주소가 바뀌면 함께 확인해야 할 것들

도메인 연결을 고민하면서 예상하지 못했던 부분은 다른 기능들과의 관계였다.

당장 찜질중에 로그인 기능을 붙일 계획이 있다.

카카오 로그인처럼 외부 서비스를 이용하는 경우에는 로그인 후 돌아올 주소를 미리 등록해야 한다.

그런데 개발할 때 사용하던 GitHub Pages 주소와 실제 운영할 주소가 다르면 어떻게 될까?

 

로그인 후 엉뚱한 곳으로 돌아가거나, 등록하지 않은 주소라 오류가 발생할 수도 있다.

그래서 도메인을 단순한 화면 주소로만 보면 안 된다는 걸 알게 됐다.

로그인, 외부 API, 공유 링크처럼 다른 기능들과 연결되는 기준점이기도 했다.

 

처음에는 찜질중만의 주소를 만들고 싶어서 시작했는데, 생각보다 여러 설정을 함께 확인해야 했다.

이럴 때면 평소 업무에서 연계 서비스의 URL 하나가 바뀌어도 여러 곳을 함께 점검해야 했던 일이 떠오른다.

찜질중 도메인 연결 체크리스트

• 가비아 CNAME 레코드 설정 확인

• GitHub Pages 사용자 지정 도메인 등록

• DNS 연결 상태 확인

• HTTPS 적용 및 보안 접속 확인

• PC·모바일에서 새 주소 접속 확인

• 기존 GitHub Pages 주소의 연결 상태 확인

• 캐릭터 이동 및 주요 기능 정상 작동 확인

• 이미지·스크립트 등 리소스 로딩 확인

• Supabase 인증 및 카카오 로그인 관련 주소 설정 점검

• 블로그와 외부 공유 링크 변경 여부 확인

아직 모든 설정을 완료한 건 아니지만, 이렇게 정리해 두니 무엇을 먼저 확인하고 어떤 부분을 나중에 점검해야 할지 조금 명확해졌다.

사용자에게는 주소 한 줄이지만, 만드는 사람에게는 여러 기능이 연결되는 서비스의 입구였다.

오늘의 고찰

처음 찜질중을 기획할 때만 해도 도메인 설정까지 직접 고민하게 될 줄은 몰랐다.

GitHub Pages에 배포하고 접속되는 것만으로도 충분히 뿌듯했는데, 막상 하나의 서비스로 만들어 가다 보니 주소 하나에도 욕심이 생겼다.

 

단순히 웹사이트가 열리는 것과, 누군가에게 자신 있게 소개할 수 있는 서비스를 만드는 건 조금 다른 일이었다.

물론 주소를 바꾼다고 갑자기 완성도 높은 서비스가 되는 건 아니다. 아직 개발해야 할 기능도 많고 고쳐야 할 부분도 한참 남았다.

그래도 작은 간판 하나를 달아 주는 마음으로 찜질중만의 주소를 준비하고 있다.

 

아직은 개발 중인 작은 공간이지만, 언젠가 누군가에게 "찜질중 놀러 와"라고 자연스럽게 소개할 수 있었으면 좋겠다.

다음 글에서는 로그인 기능을 준비하면서 마주한 또 다른 낯선 세계, 카카오 개발자 설정 이야기를 정리해 보려 한다.

 

▶ 찜질중 현재 접속 주소: https://eye215.github.io/jjimjiljung/

※ 전용 도메인은 연결 및 정상 작동 확인 후 안내할 예정.