복잡한 설정은 NO! Termux Code-Server 초간단 설치부터 활용까지

 

Termux에서 Code-Server 설치와 설정, 당신의 스마트폰을 강력한 개발 환경으로! 이동 중에도 코딩하고 싶으신가요? Termux와 Code-Server 조합이면 충분합니다! 이 글을 통해 언제 어디서든 나만의 VS Code 환경을 구축하는 방법을 알려드릴게요.

스마트폰으로 개발 환경을 구축한다는 거, 예전에는 상상하기 어려웠죠? 저도 처음엔 반신반의했어요. 그런데 Termux라는 앱을 만나고, 그 위에서 Code-Server를 돌려보니 정말 신세계더라고요! 데스크탑에서 쓰던 VS Code 환경을 그대로 폰에서 만날 수 있다니, 뭐랄까... 솔직히 좀 충격이었어요. 이동 중이나 잠깐 쉬는 시간에도 아이디어가 떠오르면 바로 코드를 끄적일 수 있어서 생산성이 확 올라가는 느낌이랄까요? 이 글에서 여러분도 그 놀라움을 경험하실 수 있도록 Termux에서 Code-Server를 쉽고 빠르게 설치하고 설정하는 모든 과정을 알려드릴게요.

 

Termux란 무엇일까요?

Termux는 안드로이드 기기에서 리눅스 명령줄 환경을 에뮬레이트해주는 앱이에요. 별도의 루팅 없이도 다양한 리눅스 패키지를 설치하고 실행할 수 있어서 스마트폰을 마치 작은 리눅스 서버처럼 활용할 수 있게 해줍니다. 텍스트 편집, 스크립트 실행, 서버 구축 등 정말 다양한 작업을 할 수 있답니다. 제가 처음 Termux를 접했을 때는 '폰에서 이런 게 된다고?'라며 놀랐던 기억이 나네요.

Termux를 이용하면 파이썬, Node.js, Ruby 등 다양한 프로그래밍 언어 환경을 구축할 수 있고, Git을 사용해 버전 관리도 할 수 있어요. 개발자들에게는 정말 필수 앱이라고 할 수 있죠!

 

Code-Server, 모바일 VS Code의 꿈

Code-Server는 말 그대로 VS Code를 서버 환경에서 실행시켜 웹 브라우저를 통해 접속할 수 있게 해주는 도구예요. 즉, 여러분의 스마트폰에 VS Code 서버를 띄우고, 폰에 설치된 웹 브라우저로 접속해서 실제 VS Code처럼 사용하는 방식이죠. 폰뿐만 아니라 다른 컴퓨터나 태블릿에서도 동일한 개발 환경에 접속할 수 있다는 점이 진짜 매력적이에요!

데스크탑 VS Code의 거의 모든 기능을 모바일에서 그대로 사용할 수 있어서, 확장 기능 설치나 터미널 사용 등 개발에 필요한 모든 작업을 할 수 있습니다. 저는 개인적으로 작은 화면에서도 코드를 작성하고 테스트할 수 있다는 점이 너무 좋았어요. 지하철에서도, 카페에서도, 심지어 침대에서도 코딩을 할 수 있게 됐으니까요!

알아두세요!
Termux는 F-Droid 스토어에서 다운로드하는 것이 좋아요. Google Play 스토어 버전은 업데이트가 늦을 수 있거든요! 최신 버전을 사용해야 안정적으로 code-server를 이용할 수 있습니다.

 

Termux에서 Code-Server 설치하기

설치 과정은 생각보다 간단해요! Termux 앱을 열고 몇 가지 명령어만 입력하면 끝이랍니다.

1. **Termux 설치**: 먼저 F-Droid에서 Termux 앱을 다운로드하고 설치해주세요.
2. **Termux 저장소 업데이트**: Termux를 실행한 후, 다음 명령어를 입력하여 패키지 목록을 최신 상태로 업데이트하고 필요한 저장소를 추가합니다.

   pkg update && pkg upgrade -y
   pkg install tur-repo -y

   tur-repo는 Termux User Repository의 약자로, code-server와 같은 추가 패키지를 설치할 수 있게 해주는 저장소예요.
3. **Code-Server 설치**: 이제 Code-Server를 설치할 차례입니다!

   pkg install code-server -y

   이 명령어를 실행하면 필요한 모든 종속성(dependency)과 함께 code-server가 설치됩니다. 시간이 조금 걸릴 수 있으니 인내심을 가지고 기다려주세요!
4. **Code-Server 실행**: 설치가 완료되면 간단하게 code-server 명령어로 실행할 수 있습니다.

   code-server

   처음 실행하면 기본 설정 파일이 생성되고, 웹으로 접속할 수 있는 주소와 비밀번호가 터미널에 표시될 거예요. 이 주소를 웹 브라우저에 입력하면 됩니다.

주의하세요!
Termux에서 code-server를 실행할 때, 터미널에 표시되는 URL(보통 localhost:8080 또는 127.0.0.1:8080)과 비밀번호를 꼭 기억해두세요! 이 정보로 웹 브라우저에서 접속해야 합니다.

 

Code-Server 설정 파일 다루기 (`config.yaml`)

Code-Server는 ~/.config/code-server/config.yaml 파일을 통해 다양한 설정을 할 수 있어요. 이 파일을 편집해서 서버 주소, 포트, 인증 방식 등을 변경할 수 있습니다.

파일 찾기 및 편집

Termux에서 다음 명령어로 config.yaml 파일을 열 수 있어요. 저는 nano 편집기를 주로 사용하는데, vim을 선호하신다면 pkg install vim으로 설치 후 사용하시면 됩니다.

nano ~/.config/code-server/config.yaml

주요 설정 항목 살펴보기

설정 항목	설명	예시
bind-addr	서버가 실행될 주소와 포트를 설정합니다. 외부에서 접속하려면 0.0.0.0으로 설정하는 것이 좋아요.	0.0.0.0:8080
auth	인증 방식을 설정합니다. password: 비밀번호로 접속합니다. none: 비밀번호 없이 바로 접속합니다. (보안에 취약)	password 또는 none
password	auth가 password일 경우, 접속 시 필요한 비밀번호를 설정합니다.	your_secure_password
cert	HTTPS(보안 연결) 사용 여부를 설정합니다. true로 설정하면 자체 서명된 인증서가 생성됩니다.	true 또는 false

예시: config.yaml 내용

보통 처음 code-server를 실행하면 기본 config.yaml 파일이 생성되지만, 만약 직접 편집하고 싶다면 아래와 같이 수정할 수 있어요.

bind-addr: 0.0.0.0:8080
auth: password
password: mysecretpassword123
cert: false # 처음엔 false로 시작하고, 필요하면 나중에 true로 변경해보세요!

파일을 수정한 후에는 Termux에서 Ctrl + X, Y, Enter를 눌러 저장하고 종료하세요. 이후 code-server를 다시 실행해야 변경된 설정이 적용됩니다.

 

Code-Server 실행 및 접속하기

설정까지 마쳤으니 이제 실제로 접속해 볼 차례예요!

1. **Code-Server 실행**: Termux 터미널에서 다음 명령어를 다시 입력하여 Code-Server를 실행합니다.

   code-server

   이제 터미널에 "Server is listening on [http://0.0.0.0:8080](http://0.0.0.0:8080)" 또는 유사한 메시지가 보일 거예요. 0.0.0.0은 현재 기기의 모든 네트워크 인터페이스를 의미합니다.
2. **웹 브라우저로 접속**: 스마트폰의 웹 브라우저(크롬, 파이어폭스 등)를 열고 주소창에 http://localhost:8080 또는 [http://127.0.0.1:8080](http://127.0.0.1:8080) (config.yaml에서 bind-addr을 0.0.0.0으로 설정했다면 http://localhost:8080이 될 거예요)를 입력하세요.만약 비밀번호를 설정했다면, 비밀번호 입력창이 나타날 거예요. config.yaml에 설정한 비밀번호를 입력하고 접속하면 됩니다.
3. **나만의 VS Code 환경 즐기기**: 짜잔! 이제 여러분의 스마트폰에서 VS Code 환경을 만끽할 수 있습니다. 파일을 생성하고, 코드를 작성하고, 터미널을 사용하고, 확장 기능을 설치하는 등 데스크탑에서 하던 모든 작업을 할 수 있어요. 정말 멋지지 않나요?

 

 

글의 핵심 요약

지금까지 Termux에서 Code-Server를 설치하고 설정하는 방법을 자세히 알아봤어요. 핵심 내용을 다시 한번 정리해볼까요?

1. Termux 앱 설치: F-Droid에서 최신 버전의 Termux를 설치합니다.
2. 저장소 및 Code-Server 설치: pkg update && pkg upgrade -y, pkg install tur-repo -y, pkg install code-server -y 명령어로 설치를 진행합니다.
3. 설정 파일 (`config.yaml`) 편집: nano ~/.config/code-server/config.yaml을 통해 bind-addr, auth, password, cert 등을 설정합니다.
4. Code-Server 실행 및 접속: code-server 실행 후 웹 브라우저로 http://localhost:8080에 접속하여 나만의 모바일 개발 환경을 시작합니다.

이제 스마트폰만 있으면 언제 어디서든 코딩할 준비가 완료된 거예요! 정말 편리하겠죠?

모바일 개발 환경, Code-Server로 끝!

간편한 설치: Termux에서 몇 가지 명령어 입력으로 바로 설치!

VS Code 환경: 익숙한 VS Code 인터페이스와 기능을 모바일에서 그대로!

설정의 자유:

config.yaml 파일로 서버 주소, 인증, 보안 설정 변경 가능

언제 어디서나 코딩: 스마트폰만 있으면 나만의 개발 공간 완성!

더 많은 정보와 팁은 블로그 댓글로 문의해주세요!

 

자주 묻는 질문

Q: Termux에서 Code-Server를 실행했는데, 웹 브라우저에서 접속이 안 돼요. 어떻게 해야 하나요?

A: 비밀번호가 제대로 입력되었는지, 그리고 config.yaml 파일의 bind-addr 설정이 0.0.0.0:8080으로 되어있는지 확인해보세요. 또한, Termux가 백그라운드에서 강제로 종료되지 않도록 설정하거나 Termux 세션을 유지하는 앱을 사용하는 것도 도움이 됩니다.

Q: config.yaml 파일이 어디에 있나요?

A: Code-Server를 처음 실행하면 사용자 홈 디렉토리의 .config/code-server/ 경로에 자동으로 생성됩니다. nano ~/.config/code-server/config.yaml 명령어로 바로 편집할 수 있어요.

Q: Code-Server 사용 중에 배터리 소모가 심한가요?

A: 네, 아무래도 서버를 스마트폰에서 직접 돌리는 것이기 때문에 배터리 소모가 일반 앱보다는 많을 수 있습니다. 장시간 사용 시에는 충전기를 연결하는 것을 권장해요.

Q: 데스크탑 VS Code처럼 확장 기능을 설치할 수 있나요?

A: 네! Code-Server는 VS Code와 동일한 확장 기능 마켓플레이스를 지원하기 때문에 대부분의 확장 기능을 설치하여 사용할 수 있습니다.

Termux와 Code-Server를 통해 스마트폰에서도 강력한 개발 환경을 구축하는 방법을 알아봤어요! 처음엔 조금 낯설 수 있지만, 한번 설정해두면 정말 유용하게 활용할 수 있을 거예요. 궁금한 점이나 막히는 부분이 있다면 언제든지 댓글로 물어봐주세요! 제가 아는 선에서 최대한 도와드릴게요~