휴대전화에서 폴더를 살펴보거나 리눅스 명령어를 입력하고 싶다면 Termux를 사용할 수 있습니다. 무료 오픈소스 Android 앱이며, 공식 GitHub에서 0.118.3 APK를 제공합니다. Android 7.0 이상에서 공식 파일을 고르고 첫 터미널 화면에서 현재 위치와 폴더 목록을 확인하는 순서까지 설명합니다.
Termux로 휴대전화에서 무엇을 할 수 있나요?
Termux는 Android 안에서 터미널 화면을 열어 명령어를 입력하는 앱입니다. 공식 프로젝트는 별도의 루팅이나 복잡한 초기 설정 없이 기본 환경을 쓸 수 있다고 설명합니다. 그래픽 메뉴에서 파일을 누르는 방식과 달리, 명령어를 직접 적고 결과를 읽는 도구입니다.
처음에는 현재 위치를 알려 주는 pwd와 그 위치에 있는 항목을 보여 주는 ls만 써 봐도 화면의 성격을 알 수 있습니다. 익숙해진 뒤에는 패키지 관리 도구인 pkg로 필요한 도구를 찾거나 설치할 수 있습니다. 앱 첫 실행 화면의 도움말에도 검색·설치·업그레이드 명령 예시가 보입니다.
휴대전화의 작은 화면에서도 명령어를 입력할 수 있도록 공식 화면에는 ESC와 CTRL 같은 키가 따로 놓여 있습니다. 그래서 컴퓨터 키보드의 모든 키를 화면 키보드에서 찾느라 헤매지 않아도 됩니다. 다만 사진에 보이는 키 위치는 촬영 당시의 구성입니다. 설치 후에는 터미널 아래쪽의 추가 키 행을 직접 보고 필요한 키를 누르세요.
다만 Android 앱 안의 리눅스 환경이지 휴대전화 운영체제 전체를 데스크톱 리눅스로 바꾸는 프로그램은 아닙니다. 모든 PC용 명령이나 패키지가 그대로 되는 것은 아니며, 기기의 권한과 Android 제한도 적용됩니다. 처음부터 시스템 폴더를 바꾸려 하기보다 개인 작업 폴더에서 명령 결과를 확인하세요.
이 글의 공식 화면 사진은 Termux 저장소에 공개된 실제 앱 화면입니다. 스크린샷에 촬영한 앱 버전이 표시되지 않고 오래된 예시도 있으므로, 설치한 0.118.3의 키보드나 문구가 조금 다를 수 있습니다. 사진은 터미널의 구성과 조작 위치를 이해하는 데만 사용하세요.
공식 화면으로 보는 첫 터미널과 명령 결과
공식 저장소의 실제 앱 화면입니다. 촬영 버전이 표시되지 않아 설치한 0.118.3의 도움말이나 키보드 모습과 다를 수 있습니다.
| 앱 | Termux |
| 개발 | Termux 프로젝트 |
| 공식 릴리스 | 0.118.3 |
| 정상 패키지 지원 | Android 7.0 이상 |
| 공식 범용 파일 | termux-app_v0.118.3+github-debug_universal.apk |
| 파일 크기 | 약 118MB |
| 첫 작업 | 현재 위치·폴더 목록 확인 |
Android 버전과 공식 APK를 먼저 확인하기
Termux 공식 README는 Android 7.0 이상에서 앱과 패키지를 완전히 지원한다고 안내합니다. Android 5·6에서도 GitHub 빌드의 앱 자체가 열릴 수 있지만 패키지 갱신 지원은 없습니다. 리눅스 명령과 패키지 작업까지 하려면 기기 설정에서 Android 7.0 이상인지 먼저 확인하세요.
GitHub의 안정판 릴리스는 v0.118.3입니다. 파일을 직접 골라야 한다면 이름에 universal이 들어간 termux-app_v0.118.3+github-debug_universal.apk가 기기 구조를 모를 때 선택할 수 있는 범용 빌드입니다. 릴리스에는 arm64-v8a 등 특정 CPU용 APK도 함께 있으므로, 범용 파일과 전용 파일을 모두 설치할 필요는 없습니다.
범용 APK 크기는 약 118MB입니다. 앱을 처음 열면 기본 환경을 구성하므로 설치 파일 크기만큼의 공간만 남겨 두면 충분하다고 생각하지 마세요. 공식 README는 F-Droid의 범용 APK와 초기 환경까지 합치면 약 180MB가 필요하다고 설명합니다. 저장 공간과 네트워크 연결을 미리 확인하면 첫 실행에서 오래 기다리는 일을 줄일 수 있습니다.
기존 Termux를 F-Droid에서 설치했다면 GitHub APK를 바로 덮어쓰지 마세요. 공식 README는 배포처별 서명 키가 달라 서로 설치·업데이트가 맞지 않을 수 있고, 플러그인도 출처를 섞지 말라고 경고합니다. 명령 기록과 작업 파일이 있다면 먼저 현재 설치 출처를 확인하고 필요한 자료를 백업하세요.
- 기기의 Android 버전이 7.0 이상인지 봅니다.
- 공식 v0.118.3 릴리스의 universal APK 이름을 확인합니다.
- 이미 설치한 앱이 있으면 F-Droid 또는 GitHub 중 기존 출처를 확인합니다.
첫 화면에서 현재 위치와 폴더 목록 보기
앱을 처음 열면 검은색 터미널에 환영 문구와 입력 커서가 나타납니다. 공식 화면 아래쪽에는 ESC, CTRL, ALT 같은 추가 키 행도 보입니다. 긴 명령을 외우기 전에 커서가 있는 입력 줄과 결과가 나오는 영역을 구분해 보세요.
입력 줄에 pwd를 적고 키보드의 Enter를 누르면 현재 작업 위치가 한 줄로 표시됩니다. 화면에 나온 경로가 지금 명령을 실행하는 기준 위치입니다. 이어서 ls를 입력하면 그 폴더의 파일과 디렉터리 이름을 나열합니다. 목록이 비어 있어도 오류는 아닙니다. 아직 그 위치에 저장한 항목이 없을 수 있습니다.
다른 폴더의 내용을 보고 싶다면 먼저 ls 결과에 실제로 있는 폴더 이름을 확인한 뒤 cd 폴더이름으로 이동할 수 있습니다. 다시 pwd를 입력해 위치가 바뀌었는지 확인하고 ls로 새 목록을 봅니다. 이름에 공백이 있는 폴더는 입력 방식이 달라지므로 처음에는 공백이 없는 항목으로 연습하는 편이 쉽습니다.
목록에서 보이는 파일 이름을 눌러 열려고 해도 터미널 화면에서는 일반 파일 관리 앱처럼 작동하지 않습니다. 명령어를 통해 위치를 바꾸고 결과를 읽는 방식이기 때문입니다. 현재 위치와 목록이 헷갈리면 pwd와 ls를 다시 입력해 두 결과를 함께 보세요. 화면을 위로 스크롤해 앞선 결과와 비교할 수도 있습니다.
명령어를 친 뒤 아무 반응이 없는 것처럼 보이면 커서가 입력 줄에 있는지, Enter를 눌렀는지 먼저 살피세요. 잘못 적은 명령에는 찾을 수 없다는 오류가 나올 수 있습니다. 오류 메시지에 나온 철자를 보고 다시 입력하면 되고, 이유를 모르는 명령을 여러 개 연달아 붙여 실행할 필요는 없습니다.
- 터미널 입력 줄에 pwd를 적고 Enter를 누릅니다.
- 표시된 현재 경로를 확인한 다음 ls를 입력합니다.
- 원하는 항목이 보이면 cd로 이동하고 pwd와 ls로 결과를 다시 확인합니다.
필요한 도구를 pkg에서 찾고 설치하기
기본 터미널로 충분하지 않을 때는 Termux의 pkg 도구로 패키지를 찾습니다. 공식 첫 실행 화면은 pkg search <query>와 pkg install <package> 형식을 안내합니다. 예를 들어 필요한 도구의 이름을 알고 있다면 먼저 pkg search 뒤에 그 이름을 넣어 목록에 있는지 확인하세요. 검색 결과가 없으면 이름이나 저장소 상태를 다시 봐야 합니다.
패키지 목록이 오래됐을 수 있으므로 새로 설치하기 전 pkg update로 목록을 갱신할 수 있습니다. 업데이트 과정에는 네트워크가 필요합니다. 명령이 제안하는 패키지 이름과 필요한 용량을 읽고 설치 여부를 결정하세요. 휴대전화 저장 공간이 부족한데 무작정 큰 패키지를 여러 개 설치하는 방식은 피하는 편이 좋습니다.
원하는 패키지가 확인되면 pkg install 패키지이름을 입력합니다. 예를 들어 공식 Termux 패키지 저장소에는 Python 패키지가 있습니다. 검색 결과에서 python이 보이고 사용 목적에 맞을 때 pkg install python으로 설치할 수 있습니다. 설치 뒤에는 python –version처럼 버전 표시 명령으로 사용 가능한지 확인합니다.
터미널 안의 도구 설치와 Android 앱 자체의 업데이트는 다른 작업입니다. pkg는 Termux 안에서 쓰는 패키지를 관리하지만, Termux 앱 APK의 버전은 공식 배포처에서 확인해야 합니다. 앱과 패키지를 혼동하면 설치 오류를 해결하기 어렵습니다. 앱 버전을 먼저 확인하고, 이어서 pkg 명령의 오류 내용을 살피세요.
pkg search의 결과에는 비슷한 이름의 여러 패키지가 나올 수 있습니다. 설치하려는 이름과 설명을 읽고 맞는 항목 하나를 고르세요. 설치 완료 메시지가 나온 뒤에도 명령이 실행되지 않는다면 명령 이름이 패키지 이름과 같은지 확인해야 합니다. 공식 패키지 정보를 찾아 실제 실행 명령을 확인하고, 오류 메시지를 남겨 두면 다음 조치를 판단하기 쉽습니다.
- pkg update로 패키지 목록을 갱신합니다.
- pkg search python으로 원하는 패키지가 있는지 확인합니다.
- 필요하다면 pkg install python을 실행하고 python –version 결과를 봅니다.
패키지 오류와 기존 설치본 충돌 해결하기
pkg 명령에서 저장소에 접속하지 못한다는 메시지가 나오면 인터넷 연결과 오류 문구를 먼저 확인하세요. Termux 공식 패키지 안내는 오래된 저장소 주소나 접속되지 않는 미러가 원인일 수 있다고 설명합니다. 여러 설치 명령을 반복하기보다 현재 저장소를 확인하는 편이 빠릅니다.
미러 문제로 보이면 공식 안내의 termux-change-repo 명령으로 주 저장소를 다른 미러로 바꿀 수 있습니다. 바꾼 뒤 pkg update를 다시 실행해 목록이 갱신되는지 확인하세요. 저장소 변경은 기존에 넣어 둔 추가 저장소까지 자동으로 모두 고쳐 주지는 않으므로, 오류 메시지에 어느 주소가 실패했는지도 읽어야 합니다.
APK를 열었는데 기존 앱과 충돌하거나 업데이트할 수 없다는 안내가 나오면 먼저 설치 출처를 확인합니다. 공식 README는 F-Droid와 GitHub 배포본의 서명 키가 서로 다르다고 설명합니다. 앱 데이터를 지우거나 제거하기 전에는 작업 파일과 필요한 설정을 백업하고, 같은 출처에서 제공하는 업데이트가 있는지 먼저 찾아보세요.
Android 5·6 기기에서는 앱이 설치되더라도 패키지 업데이트가 지원되지 않는다는 점이 별도의 한계입니다. pkg 오류를 고치려고 무작정 APK 버전만 바꾸지 말고 지원 환경부터 확인하세요. Android 7 이상인데도 첫 환경 구성이 오래 걸린다면 저장 공간, 네트워크 상태, 내려받은 파일 이름을 차례로 확인할 수 있습니다.
- 실패한 명령과 오류에 나온 저장소 주소를 확인합니다.
- 미러 접속 문제라면 공식 안내에 따라 termux-change-repo를 검토합니다.
- 설치 충돌이라면 배포처와 백업 상태를 확인한 뒤 같은 출처의 업데이트를 찾습니다.
자주 묻는 질문
Termux는 무료인가요?
네. 공식 프로젝트가 무료 오픈소스 Android 앱을 배포합니다.
Android 6에서 패키지를 설치할 수 있나요?
공식 README는 Android 5·6의 앱 자체만 예외적으로 지원하고 패키지 갱신은 지원하지 않는다고 밝힙니다. 정상적인 패키지 작업은 Android 7 이상을 기준으로 하세요.
내 휴대전화 CPU를 모르면 어떤 APK를 고르나요?
공식 v0.118.3 릴리스에서 이름에 universal이 들어간 범용 APK를 확인하세요.
F-Droid 앱 위에 GitHub APK를 설치해도 되나요?
배포처별 서명 키가 달라 업데이트가 거부될 수 있습니다. 현재 출처와 데이터 백업을 먼저 확인하세요.
터미널에서 폴더를 어떻게 확인하나요?
pwd로 현재 위치를 확인하고 ls로 그 위치의 목록을 볼 수 있습니다.
처음에는 pwd와 ls의 결과부터 확인하세요
Android 7 이상 기기에서 공식 0.118.3 APK를 설치했다면 첫 화면에서 pwd와 ls를 차례로 입력해 보세요. 현재 경로와 목록이 보이면 터미널 입력부터 결과 확인까지 한 번 마친 셈입니다.
그다음 필요한 패키지를 pkg search로 찾고, 설치할 이유가 분명할 때만 pkg install을 사용하면 됩니다. 기존 Termux가 있다면 배포처와 자료 백업을 먼저 확인하세요.
공식 자료와 확인일
Termux 공식 사이트 · Termux 0.118.3 공식 릴리스 · Termux 공식 설치·지원 안내 · Termux 공식 패키지 관리 도움말 | 2026-10-19
