9. 기본부터 다시 하기: 마음을 비우고 FastAPI 서버와 Cloudflare 터널을 뚫다

👤 관리자

조회 수 109

들어가며: 완벽주의를 버리고 기본으로 돌아가다

지난 8편에서 저는 AI의 '바이브 코딩'에 의존하다 코드가 산으로 가는 뼈아픈 경험을 했습니다. 이 문제를 해결하기 위해 수많은 개발자 선배들이 조언하는 '코드 관리 시스템(Git, GitHub)'을 도입하려고 인터넷 창을 켰었죠.

하지만 현실적인 벽에 부딪혔습니다. 코딩 자체도 벅찬 마당에 브랜치(Branch)가 어쩌고, 커밋(Commit)이 어쩌고 하는 새로운 시스템의 개념을 백지부터 다시 공부하고 세팅하려니 머리에 쥐가 날 것 같았습니다. 솔직히 말씀드리면, 지금 당장 저에게는 그 거대한 시스템을 소화할 만한 마음적, 시간적 여유가 턱없이 부족했습니다.

"이러다간 지쳐서 웹사이트 개발 자체를 포기하겠다." 저는 과감한 결단을 내렸습니다. 꼬여버린 코드를 미련 없이 휴지통에 던져버리고, 복잡한 관리 시스템 도입은 잠시 미뤄둔 채 **'가장 확실한 기본 뼈대'**부터 다시 세우기로 마음먹었습니다.

1. 리눅스 서버에 FastAPI 기본 뼈대 구축하기

우분투(Ubuntu) 노트북 서버의 텅 빈 폴더를 다시 열었습니다. 이번에는 욕심을 부리지 않고, 파이썬 기반의 웹 프레임워크인 FastAPI가 제공하는 가장 기초적인 코드 단 몇 줄만 작성했습니다.

화면에 "Hello World"라는 텍스트 하나만 띄워주는, 정말 볼품없을 정도로 단순한 뼈대였습니다. 하지만 언젠가 이곳에 인스타그램 미디어를 다운로드하고 다시 업로드하는 기능이나, 유저들의 점수를 매기는 화려한 랭킹 보드 같은 복잡한 커뮤니티 기능들을 얹으려면 이 첫 번째 주춧돌이 무엇보다 단단해야 했습니다.

복잡한 부가 기능 없이 순수하게 <code>main.py</code> 파일 하나로 돌아가는 깔끔한 FastAPI 서버를 보고 있으니, 그동안 AI와 씨름하며 받았던 스트레스가 싹 씻겨 내려가는 기분이었습니다.

2. Cloudflare 터널링으로 로컬 서버 외부로 개방하기

무료라서 좋은 Cloudflare의 대시보드, 이제 웹사이트에 주소를 치면 나의 웹사이트 연결된다.

<무료라서 좋은 Cloudflare의 대시보드, 이제 웹사이트에 주소를 치면 나의 웹사이트 연결된다.>

뼈대를 세웠으니 이제 이 웹사이트를 전 세계 사람들이 접속할 수 있도록 인터넷에 공개할 차례였습니다.

원래대로라면 우리 집 공유기 설정 창에 들어가서 복잡한 '포트포워딩(Port Forwarding)'을 설정하고, 방화벽을 뚫고, IP 주소를 연결하는 험난한 과정을 거쳐야 합니다. 보안상 위험하기도 하고, 초보자가 하다가 공유기를 먹통으로 만들기 딱 좋은 작업이죠.

이때 저를 구원해 준 것이 바로 **'클라우드플레어 터널(Cloudflare Tunnels)'**입니다.

클라우드플레어 터널은 제 방구석에 있는 낡은 노트북(로컬 서버)과 클라우드플레어의 전 세계 서버를 아주 안전한 '비밀 통로(터널)'로 연결해 주는 마법 같은 서비스입니다. 복잡한 포트포워딩을 할 필요 없이, 터미널에 명령어 몇 줄만 입력하니 제 도메인(<code>inspeep.com</code>)을 치고 들어오는 모든 접속자가 안전하게 제 노트북 서버로 연결되었습니다. 세상에 이렇게 쉽고 안전하게 내 방구석 서버를 개방할 수 있다니, 신세계를 맛본 기분이었습니다.

3. 치명적인 문제 발생: "터미널을 끄면 서버도 죽는다?"

터널도 뚫었겠다, 기쁜 마음으로 메인 데스크톱의 VS Code 원격 접속(SSH) 창을 닫고 침대에 누웠습니다. 그런데 스마트폰으로 제 웹사이트에 접속해 보니 또다시 '접속 불가' 에러가 뜨는 것이 아니겠습니까?

이유를 알아보니 리눅스의 특성 때문이었습니다. 제가 데스크톱에서 원격 접속을 통해 실행시킨 FastAPI 서버는, 제가 원격 접속(터미널) 창을 닫는 순간 실행 중이던 프로그램도 함께 종료되어 버리는 구조였습니다. 24시간 내내 돌아가야 할 서버가 제가 컴퓨터를 끌 때마다 같이 잠들어 버린다면 그건 서버로서의 가치가 없는 것이었죠.

4. tmux를 활용해 24시간 무중단 서버 셋팅하기

실제 나의 서버가 실행되고 유지하고 있는 tmux창이다. 개발용 모니터에 VS code를 꺼도 서버는 유지된다.

<실제 나의 서버가 실행되고 유지하고 있는 tmux창이다. 개발용 모니터에 VS code를 꺼도 서버는 유지된다.>

이 문제를 해결하기 위해 드디어 **<code>tmux</code> (Terminal Multiplexer)**라는 강력한 리눅스 도구를 도입했습니다.

tmux의 역할: 쉽게 말해 리눅스 서버 안에 '절대 꺼지지 않는 가상의 모니터 화면'을 하나 띄워두는 기능입니다.

</li></ul>

저는 <code>tmux</code> 명령어를 통해 가상의 창을 하나 만들고, 그 안에서 FastAPI 서버를 실행시켰습니다. 그리고 살며시 가상 창에서 빠져나와(Detach) 원격 접속을 종료해 보았습니다. 결과는 대성공이었습니다! 제 데스크톱을 끄고 VS Code 창을 닫아도, 노트북 서버 안의 <code>tmux</code> 가상 화면에서는 웹 서버가 24시간 쉬지 않고 팽팽 돌아가고 있었습니다.

마치며: 진정한 의미의 '나만의 서버' 완성

복잡한 코드 관리 시스템을 억지로 욱여넣으려던 욕심을 버리고 기본으로 돌아온 것은 정말 신의 한 수였습니다.

깔끔한 FastAPI 뼈대, 외부와 안전하게 연결된 클라우드플레어 터널, 그리고 <code>tmux</code>를 통한 24시간 무중단 구동까지. 이제 제 구형 노트북은 그 어떤 호스팅 부럽지 않은 완벽하고 독립적인 '웹 서버'의 형태를 갖추게 되었습니다. 비로소 코드를 마음껏 짰다 지웠다 할 수 있는 진짜 튼튼한 놀이터가 완성된 것입니다.

다음 포스팅에서는 이 튼튼한 뼈대 위에, 제가 구상했던 커뮤니티의 첫 번째 기능들을 조심스럽게 하나씩 올려보는 진짜 코딩 작업기를 공유해 보겠습니다. 초보 개발자의 맨땅 헤딩은 계속됩니다!

지난편 보러가기: 8. 새로운 시작, 압도적인 개발의 자유로움 (부제: AI 바이브 코딩의 함정에 빠지다)

다음편 보러가기: 10. 방구석 서버의 한계를 넘다: Render 백업부터 웹진형 게시판 개발까지