설치 및 환경 구성 가이드
프로덕션 배포, 하드웨어 의존성 및 단말기 환경 프로비저닝 (Termux-Playwright)
핵심 가치 제안 (Why It Matters)
복잡한 데스크톱 브라우저 환경 설정 없이, 스마트폰 터미널 창에서 웹 브라우저를 자유자재로 조종하는 로봇을 설치합니다.
1. 표준 패키지 매니저 설치
공식 배포 레지스트리 엔드포인트를 통해 직접 설치할 수 있습니다:
# 파이썬 공식 패키지 매니저
pip install termux-playwright
# Node.js 공식 패키지 매니저
npm install termux-playwright2. 필수 시스템 패키지 의존성
안드로이드 Bionic libc 및 POSIX 툴체인 연결을 위해 사전에 설치되어야 하는 시스템 패키지 목록입니다:
| 패키지명 | 엔지니어링 도입 목적 (한 줄 명확한 사유) |
|---|---|
chromium | 안드로이드 네이티브 ARM64 헤드리스 브라우저 렌더링 엔진 |
nodejs | Chrome DevTools Protocol(CDP) 고속 비동기 제어 런타임 |
curl | 로컬 CDP 웹소켓 엔드포인트 헬스체크 및 연결 상태 모니터링 |
3. install.sh 원클릭 자동 프로비저닝
단말기 SoC 아키텍처를 자동 감지하고 최적 NEON/Vulkan 커널을 한 번에 컴파일 및 검증하려면 아래 명령어를 실행하세요:
curl -fsSL https://raw.githubusercontent.com/uno-km/termux-playwright/main/install.sh | bash4. 패키지 단독 설치 vs 풀스택 자동화 설치 비교
| 설치 경로 | 런타임 실행 특성 | 제약사항 및 폴백 메커니즘 |
|---|---|---|
| 패키지 매니저 단독 설치 | 고수준 언어 바인딩 및 기본 CPU 추론 코어 위주 로딩. | 시스템 C++ 런타임 및 GPU 가속 드라이버가 수동 구성되어야 합니다. |
| 자동화 풀 패키지 설치 | Vulkan SPIR-V 셰이더 컴파일, 제로카피 IPC 셋업 및 실리콘 벤치마크 검증 완료. | 지연시간 최소화가 필요한 실제 프로덕션 워크로드에 적극 권장됩니다. |
5. 선택적 빌드 및 런타임 플래그 파라미터
| 옵션 파라미터 | 아키텍처 동작 및 하드웨어 효과 |
|---|---|
--headless | 화면 표시 없는 백그라운드 고속 브라우징 모드 (기본값: true) |
--stealth | navigator.webdriver 은닉 및 모바일 브라우저 핑거프린트 스텔스 활성화 |
--user-data-dir= | 쿠키, 세션, 로그인 상태 유지를 위한 사용자 프로필 디렉터리 경로 |