[완벽 가이드] 안드로이드 스마트폰에서 PC처럼 Git 사용하기 (Termux 활용)

PC가 없을 때, 이동 중에 갑자기 좋은 코딩 아이디어가 떠오르거나 급하게 수정해야 할 버그를 발견한 경험이 있으신가요? 예전에는 스마트폰에서 코드를 살짝 확인하는 것조차 어려웠지만, 이제는 안드로이드 기기만으로도 꽤 전문적인 개발 작업이 가능해졌습니다.

이전 글에서는 Pydroid 3를 이용해 파이썬을 실행하거나, Spck Editor 같은 앱으로 GitHub 저장소를 클론(clone), 푸시(push), 풀(pull)하는 방법을 소개했습니다.

 

하지만 Spck Editor를 사용해보신 분들은 한 가지 불편함을 느끼셨을 겁니다. 바로 실제 작업하는 폴더와 GitHub에 연동된 폴더가 분리되어 있다는 점입니다. 이 때문에 코드를 수정한 뒤 GitHub에 올리려면, 먼저 작업한 파일을 Spck Editor의 Git 관리 공간으로 '내보내기(export)'하고, GitHub의 변경 사항을 가져오려면 다시 '가져오기(import)'를 해야 하는 번거로운 과정이 필요했습니다.

이 글에서는 이러한 불편함 없이, PC의 터미널(CLI) 환경에서처럼 내가 원하는 폴더에서 직접 Git 명령어를 실행하여 변경 사항을 즉시 커밋하고 푸시하는 방법을 자세히 알아보겠습니다. 이 방법을 사용하면 안드로이드 스마트폰이 강력한 휴대용 개발 머신으로 거듭날 것입니다.

---

목차

1. Termux: 안드로이드 속 작은 리눅스
2. Termux와 스마트폰 저장 공간 연결하기
3. Git 설치 및 기본 설정
4. 실전! GitHub 저장소 클론부터 푸시까지
5. 프로처럼 작업하기: 반복 작업 자동화 팁

---

1. Termux: 안드로이드 속 작은 리눅스

우리의 목표를 달성해 줄 핵심 도구는 바로 Termux입니다.

Termux란?
안드로이드 기기에서 리눅스(Linux) 명령줄 환경을 사용할 수 있게 해주는 터미널 에뮬레이터 및 앱입니다. 패키지 관리자(pkg)를 통해 수많은 리눅스용 개발 도구(Python, Node.js, Git 등)를 설치하고 사용할 수 있어, 스마트폰을 작은 서버나 개발 머신처럼 활용하게 해줍니다.

⚠️ 중요: 설치는 F-Droid에서!

Google Play 스토어에서 Termux를 검색하면 앱이 나타나지만, 절대 Play 스토어에서 설치하면 안 됩니다. Play 스토어 버전은 2020년 이후로 업데이트가 중단되어 심각한 보안 문제나 패키지 호환성 오류를 일으킬 수 있습니다.

항상 최신 버전과 보안 업데이트를 지원받으려면, 오픈 소스 앱 스토어인 F-Droid를 통해 설치해야 합니다.

Termux 설치 단계

1. F-Droid 설치
   • 웹 브라우저에서 F-Droid 공식 웹사이트에 접속합니다.
   • Download F-Droid 버튼을 눌러 .apk 설치 파일을 다운로드합니다.
   • 다운로드한 파일을 실행하면 '출처를 알 수 없는 앱 설치' 권한을 요구할 수 있습니다. 보안 설정에서 해당 권한을 허용해 주고 설치를 완료합니다.
2. F-Droid에서 Termux 검색 및 설치
   • 설치된 F-Droid 앱을 실행합니다. 처음 실행 시, 저장소 정보를 업데이트하느라 약간의 시간이 걸릴 수 있습니다.
   • 하단의 돋보기(검색) 아이콘을 누르고 termux를 검색합니다.
   • 여러 검색 결과 중, 아래 이미지와 같은 Termux 앱을 찾아 설치합니다. (Termux:API 등 다른 부가 기능 앱은 지금 당장 필요하지 않습니다.)

3. Termux 실행 및 초기 업데이트
   • Termux를 실행하면, 아래와 같이 검은 화면에 텍스트가 깜빡이는 터미널 창이 나타납니다. 이제 여러분의 스마트폰에서 리눅스 명령어를 사용할 준비가 되었습니다!
   • 가장 먼저, 패키지 목록을 최신화하고 설치된 기본 패키지들을 업그레이드해야 합니다. 아래 명령어를 그대로 입력하고 실행하세요.

   pkg update && pkg upgrade

명령어 해설

3. • pkg: Termux의 패키지 관리자입니다. (Debian/Ubuntu의 apt와 유사)
   • update: 설치 가능한 패키지들의 최신 목록 정보를 가져옵니다.
   • upgrade: 현재 설치된 모든 패키지를 최신 버전으로 업그레이드합니다.
   • &&: 앞의 명령(update)이 성공적으로 완료되었을 때만 뒤의 명령(upgrade)을 실행하라는 의미의 셸(shell) 연산자입니다.
4. 중간에 Do you want to continue? [Y/n]과 같은 질문이 나오면 y를 입력하고 엔터를 누르면 됩니다.

2. Termux와 스마트폰 저장 공간 연결하기

기본적으로 Termux는 앱 자체의 비공개 데이터 공간에서만 작동합니다. 우리가 코드를 저장하고 관리할 Downloads나 Documents 같은 스마트폰의 공유 저장 공간에 접근하려면 별도의 설정이 필요합니다.

1. 저장 공간 접근 권한 요청
   아래의 Termux 전용 명령어를 입력하세요.
2. termux-setup-storage
3. 권한 허용
   명령어를 실행하면 "Termux가 기기의 사진, 미디어, 파일에 액세스하도록 허용하시겠습니까?"라는 시스템 팝업이 나타납니다. '허용'을 선택하세요.
4. 연결 확인
   이제 홈 디렉터리(~)에 storage라는 폴더가 생성되었을 겁니다. ls 명령어로 확인해 봅시다.명령어 결과로 storage가 보이면 성공입니다. 이 storage 폴더는 실제 스마트폰 공유 저장 공간으로 연결되는 '바로가기(Symbolic Link)'입니다.
5. ls
6. 접근 가능한 폴더 확인
   storage 폴더 안으로 들어가서 어떤 폴더들이 보이는지 확인해 보겠습니다.결과를 보면 dcim, downloads, movies, music, pictures 등 익숙한 폴더들이 나타날 것입니다. 안드로이드의 보안 정책(Scoped Storage) 때문에 모든 폴더에 자유롭게 접근할 수는 없지만, 개발 프로젝트를 관리하기에는 이 폴더들로도 충분합니다. 이 글에서는 비교적 비어있을 확률이 높은 movies 폴더를 작업 공간으로 사용하겠습니다. (물론 downloads나 새로 만든 폴더를 사용하셔도 됩니다.)
7. cd storage ls

3. Git 설치 및 기본 설정

이제 드디어 Git을 설치할 차례입니다. pkg 명령어를 사용해 간단하게 설치할 수 있습니다.

pkg install git

설치가 완료되었다면, PC에서 Git을 처음 설정할 때와 마찬가지로 사용자 정보를 등록해야 합니다. 이 정보는 여러분이 만드는 모든 커밋에 기록됩니다.

git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"

팁: "Your Name"과 "your_email@example.com" 부분은 본인의 GitHub 계정 이름과 이메일로 바꿔주세요.

이제 여러분의 Termux 환경에서 Git을 사용할 모든 준비가 끝났습니다.

4. 실전! GitHub 저장소 클론부터 푸시까지

이제 실제 워크플로우를 따라가며 GitHub 저장소를 관리해 보겠습니다.

1. 작업 폴더로 이동
   앞서 정했던 movies 폴더로 이동합니다.
2. # '~'는 홈 디렉터리를 의미하는 약어입니다. # 'cd ~/storage/movies'와 동일합니다. cd storage/movies
3. GitHub 저장소 클론
   git clone 명령어를 사용하여 원격 저장소를 내 스마트폰으로 복제합니다. [URL] 부분에는 본인의 GitHub 저장소 주소를 복사해서 붙여넣으세요.이제 ls 명령어를 쳐보면 your-repository라는 이름의 폴더가 생성된 것을 확인할 수 있습니다.
4. git clone https://github.com/your-username/your-repository.git
5. 코드 수정
   이제 스마트폰에 설치된 코드 에디터 앱(예: ACode, Spck Editor, QuickEdit 등)을 열어 movies/your-repository 경로에 있는 파일을 수정합니다.
6. 변경 사항 스테이징 및 커밋
   파일 수정이 끝났다면, 다시 Termux로 돌아와 변경 사항을 커밋합니다.
   • 먼저, 프로젝트 폴더로 들어갑니다.

     cd your-repository

   • 변경된 모든 파일을 스테이징(staging) 영역에 추가합니다.

     # '.'은 현재 디렉터리의 모든 변경 사항을 의미합니다.
     git add .

   • 변경 사항에 대한 메시지와 함께 커밋을 생성합니다.

     git commit -m "feat: 모바일에서 새로운 기능 추가"

7. GitHub으로 푸시(Push)하기이제 마지막으로 push 명령어를 실행합니다.명령어를 실행하면 Username과 Password를 요구할 것입니다.
   • Username: GitHub 아이디를 입력하세요.
   • Password: GitHub 비밀번호가 아닌, 방금 발급받은 개인 액세스 토큰(PAT)을 붙여넣으세요. (터미널에서는 비밀번호 입력 시 아무것도 보이지 않는 것이 정상입니다.)
   인증이 성공하면, 여러분의 커밋이 GitHub 저장소에 안전하게 업로드됩니다!
8. git push
9.  

⛔️ 중요: 비밀번호 대신 개인 액세스 토큰(PAT) 사용
2021년 8월부터 GitHub는 보안상의 이유로 Git 작업 시 비밀번호 인증을 지원하지 않습니다. 대신 개인 액세스 토큰(Personal Access Token, PAT)을 사용해야 합니다.

1.  

PAT 생성 방법 (간략 가이드):

1. 1. PC 또는 모바일 브라우저에서 GitHub에 로그인합니다.
   2. [프로필 사진] > Settings > Developer settings > Personal access tokens > Tokens (classic)으로 이동합니다.
   3. Generate new token 버튼을 클릭합니다.
   4. 토큰 이름(Note)을 정하고, 만료 기간(Expiration)을 설정합니다.
   5. Scopes에서 repo 항목에 체크합니다. (저장소 접근에 필요한 모든 권한 부여)
   6. Generate token 버튼을 누르면 ghp_...로 시작하는 토큰이 생성됩니다. 이 토큰은 다시 볼 수 없으니 반드시 안전한 곳에 복사해 두세요!

5. 프로처럼 작업하기: 반복 작업 자동화 팁

매번 Termux를 켤 때마다 cd storage/movies/your-repository로 이동하고, git add ., git commit -m "...", git push를 순서대로 입력하는 것은 꽤 귀찮은 일입니다. 이 과정을 한 줄의 명령어로 만들어 클립보드에 저장해두고 사용하면 매우 편리합니다.

아래는 이 모든 과정을 한 번에 처리하는 명령어 체인입니다.

cd ~/storage/movies/your-repository && git add . && git commit -m "mobile edit" && git push

명령어 분석:

• cd ~/storage/movies/your-repository: 프로젝트 폴더로 이동합니다.
• &&: 앞선 cd 명령이 성공하면, 다음 명령을 실행합니다.
• git add .: 모든 변경 사항을 스테이징합니다.
• &&: add가 성공하면, 다음 명령을 실행합니다.
• git commit -m "mobile edit": "mobile edit"이라는 메시지로 커밋합니다. (급할 땐 유용하지만, 평소에는 의미 있는 커밋 메시지를 작성하는 것이 좋습니다.)
• &&: commit이 성공하면, 다음 명령을 실행합니다.
• git push: GitHub에 푸시합니다.

활용 팁:

• 대부분의 스마트폰 키보드(삼성 키보드, Gboard 등)는 클립보드 고정 기능을 제공합니다. 위 명령어를 복사한 뒤 클립보드에 고정해두면, 필요할 때마다 Termux에 간편하게 붙여넣고 실행할 수 있습니다.

---

마치며

이제 여러분은 안드로이드 스마트폰에서 PC와 거의 동일한 방식으로 Git과 GitHub를 자유자재로 다룰 수 있게 되었습니다. 더 이상 Spck Editor의 import/export 과정에 얽매일 필요 없이, 원하는 어떤 에디터로든 파일을 수정하고 Termux를 통해 즉시 버전 관리를 할 수 있습니다.

이 설정은 간단한 수정뿐만 아니라, 가벼운 웹 프레임워크(Flask, Express.js)를 돌리거나 알고리즘 문제를 풀고 바로 제출하는 등 생각보다 훨씬 다양한 작업을 가능하게 합니다. 여러분의 손안에 있는 작은 컴퓨터, 스마트폰의 잠재력을 최대한 활용해 보세요.

 

---

이 글은 아래 글을 바탕으로 GEMINI를 이용해 재작성한 것입니다.

스마트폰(태블릿)에서 Git 사용하기/termux, github

스마트폰(태블릿)에서 Git 사용하기/termux, github