Termux

이 페이지는 Termux에서 간단한 서버 환경을 구성하고 사용하는 방법을 안내합니다.

Termux 다운로드

이 페이지에서 실제로 사용한 구버전 Termux v0.118.0 APK입니다. 이 구성은 PHP 7.3까지만 사용하는 오래된 환경이며, 현재는 더 이상 지원되지 않습니다. 휴대전화에서 자신의 CPU 종류에 맞는 파일을 하나만 다운로드하세요.

대부분의 최근 스마트폰은 ARM64를 사용합니다. 구버전 Termux는 보안 업데이트와 공식 지원이 중단된 상태이므로 테스트나 기존 환경 재현 용도로만 사용하세요. 설치 전 기존 Termux를 백업하고, Android 설정에서 알 수 없는 앱 설치를 허용해야 할 수 있습니다.

Android에 설치하기

아래 설치 명령과 운영 절차는 현재 Termux와 최신 패키지를 기준으로 정리한 자료입니다.
이 페이지에서 사용하는 사례는 최신 버전이 아닌 Termux v0.118.0 구버전입니다. 구버전을 사용하려면 위의 ARM64 또는 Universal APK를 휴대전화에 직접 다운로드해 설치한 뒤 다음 단계로 진행합니다.
Termux를 열고 아래 명령어를 실행해 기본 패키지를 설치합니다.

pkg update && pkg upgrade
pkg install git curl wget proot nginx php php-fpm

이 페이지에서 스크립트를 다운로드한 뒤 Termux 홈 디렉터리에 저장합니다.
chmod +x termux_program.sh 실행 후 ./termux_program.sh로 스크립트를 실행합니다.

Nginx, PHP, PHP-FPM 설치

pkg install nginx php php-fpm
mkdir -p $HOME/www
cp -r . $HOME/www/

# start nginx
nginx

# start php-fpm
php-fpm

서버 테스트는 브라우저에서 http://127.0.0.1:8080/를 열거나 로컬 네트워크 주소로 확인하면 됩니다.

PHP 버전과 호환성

이 문서의 구 버전 구성과 일부 설치 스크립트는 PHP 7.3까지만 동작하는 환경을 기준으로 작성되었습니다. PHP 7.3을 별도로 설치하는 방법도 있지만, Termux 저장소에서 패키지를 구하기 어렵거나 의존성 충돌, PHP-FPM 설정 차이, 사용할 수 있는 확장 모듈 제한, 보안 업데이트 중단 등의 제약이 따를 수 있습니다.

PHP 8.x 등 최신 버전을 사용하려면 현재 사용 중인 Termux 앱에서 저장소를 갱신한 뒤 최신 PHP 패키지를 설치하는 방법을 권장합니다.

pkg update && pkg upgrade
pkg install php php-fpm
php -v

최신 PHP로 바꾸면 PHP 7.3 환경과 명령어, 설정 파일 위치, PHP-FPM 소켓, 확장 모듈 이름, 문법 및 오류 처리 방식이 많이 다를 수 있습니다. 따라서 기존 스크립트가 그대로 실행되지 않을 수 있으며, 설치 후 php -v, php -m, php-fpm -t로 버전과 확장을 확인하고 애플리케이션 코드를 하나씩 점검하세요.

DB 및 FTP/SSH 설치

웹 서버와 파일 전송, 원격 접속을 위해 다음 패키지를 함께 설치할 수 있습니다.

pkg install mariadb openssh proftpd

MariaDB를 초기화하려면 다음 명령을 실행합니다.

mysqld_safe -u root &
mysql -u root

SSH 서버를 실행하려면 아래 명령을 사용합니다.

sshd

FTP 서버를 사용하려면 proftpd 설정 후 서비스를 시작합니다.