7. 우분투(Ubuntu) 노트북 서버 구축과 완벽한 원격 개발 환경 만들기

👤 관리자

조회 수 108

들어가며: 시뻘건 에러 화면의 정체

지난 6편, 야심 차게 구운 부팅 USB를 꽂고 마주한 것은 환영 인사가 아니라 화면을 가득 채운 기괴한 에러 메시지였습니다. 한 달 동안 고생해서 쌓아 올린 워드프레스를 포기하고 내린 결정이었는데, 시작부터 이렇게 꽉 막혀버리니 솔직히 '다시 호스팅을 결제해야 하나?' 하는 엄청난 후회와 허탈감이 밀려왔습니다.

하지만 이대로 포기할 수는 없었죠. 에러 화면을 스마트폰으로 찍어 저의 든든한 조력자인 제미나이(Gemini)와 클로드(Claude)에게 분석을 요청했습니다.

1. 그래픽 드라이버의 반란, 그리고 '안전 모드(Safe Graphics)'

AI의 진단 결과, 원인은 허무하게도 **'그래픽 드라이버 충돌'**이었습니다. 제 구형 노트북에 달려있는 오래된 외장 그래픽 카드를 최신 우분투 리눅스 커널이 제대로 인식하지 못해 부팅 단계에서 화면 출력을 포기해 버린 것입니다.해결책은 의외로 간단했습니다. USB를 꽂고 처음 뜨는 부팅 선택 화면에서 제일 위에 있는 기본 설치(Try or Install Ubuntu)를 누르는 것이 아니었습니다. 그 바로 밑에 있는 두 번째 옵션, **'Ubuntu (safe graphics)'**를 선택해야 했습니다.

Safe Graphics(안전 그래픽) 모드란?: 화려한 그래픽 효과를 모두 끄고, 가장 기본적인 해상도와 호환성 모드로만 화면을 출력하여 일단 운영체제 설치를 최우선으로 진행할 수 있게 해주는 기능입니다.

</li></ul>

안전 모드로 진입하자 언제 에러를 뿜었냐는 듯 깔끔하게 우분투 설치 마법사 화면이 나타났습니다! 설치를 무사히 마친 후, 저는 가장 먼저 설정의 '추가 드라이버' 메뉴로 들어가 제 노트북에 맞는 최신 그래픽 드라이버부터 업데이트해 주었습니다. 드디어 낡은 노트북이 어엿한 '리눅스 서버'로 다시 태어나는 순간이었습니다.

2. 뜻밖의 난관: "여기서 코딩하라고?"

작은 화면으로 보다보니 구부정해지면서 허리가 아프다.

<작은 화면으로 보다보니 구부정해지면서 허리가 아프다.>

노트북에 우분투를 설치하고 나니 이제 본격적으로 코딩을 할 차례였습니다. 제가 애용하는 VS Code 에디터를 노트북에 깔고 화면을 켰는데... 아, 이건 도저히 사람이 할 짓이 아니었습니다.

낡고 작은 노트북 모니터, 뻑뻑한 키보드, 그리고 평생 윈도우만 쓰다가 마주한 낯선 우분투의 조작감까지. 제 방에는 이미 크고 시원한 듀얼 모니터와 타건감 좋은 기계식 키보드가 세팅된 빵빵한 '개발용 메인 데스크톱'이 있는데, 굳이 이 불편한 노트북 앞에 거북목을 하고 앉아 코딩을 해야 한다는 사실이 너무 고통스러웠습니다.

3. 구세주 등장: VS Code 원격(Remote) 접속 기능

수많은 천재들이 이미 다 만들어주었다.

<수많은 천재들이 이미 다 만들어주었다.>

"메인 컴퓨터에서 코딩을 하고, 저장만 노트북 서버에 할 수는 없을까?" 이 간절한 물음에 AI 선생님들은 **'VS Code Remote - SSH'**라는 기가 막힌 해결책을 제시해 주었습니다.

이 기능은 제 윈도우 메인 데스크톱의 VS Code 화면에서 코드를 타이핑하지만, 실제 파일은 네트워크를 타고 방구석에 있는 우분투 노트북 서버에 실시간으로 작성되고 실행되게 해주는 마법 같은 확장 프로그램이었습니다. 현업 개발자들이 AWS 같은 클라우드 서버에 접속해서 개발할 때 쓰는 바로 그 방식이었죠.

내친김에 AI의 친절한 가이드를 받아, 나중에 개발한 웹사이트를 쉽게 배포하고 관리하기 위해 필수라는 도커(Docker) 프로그램까지 노트북 서버에 무사히 설치해 두었습니다. 이제 메인 컴퓨터와 연결만 하면 끝이었습니다.

4. 마지막 퍼즐: IP 주소의 미로를 탈출하다

기쁜 마음으로 메인 데스크톱의 VS Code에서 노트북으로 원격 접속을 시도했습니다. 그런데 화면에 무심하게 <code>Connection timed out(연결 시간 초과)</code>이라는 에러만 뜰 뿐 접속이 되지 않았습니다.

도대체 뭐가 문제일까 AI와 함께 한참을 씨름한 끝에 원인을 찾았습니다. 바로 **'IP 주소'**가 맞지 않았던 것입니다. 메인 컴퓨터가 방구석의 노트북을 찾아가려면 우리 집 공유기가 노트북에 부여한 고유한 이름표, 즉 **'내부 IP 주소(Local IP)'**를 정확히 알아야 합니다. 저는 바보같이 노트북의 외부 IP를 입력하거나 엉뚱한 주소를 치고 있었던 것이죠.

리눅스 터미널에 <code>ip a</code>라는 명령어를 입력해 노트북의 진짜 내부 IP를 찾아내었고, 이를 VS Code 접속 창에 정확히 입력했습니다.