Android TV에 설치하기 전 확인할 사항
NekoBox를 Android TV 또는 TV 박스에서 사용하려면 APK 설치, 리모컨 조작, 구독 가져오기, VPN 권한 허용이라는 네 단계를 순서대로 처리해야 합니다. 휴대전화용 앱과 달리 TV 화면에서는 파일 관리자, 키보드, 클립보드 사용이 불편하므로 설치 전에 필요한 파일과 구독 주소를 준비해 두는 것이 좋습니다. 이 글은 Android TV 10·11·12 계열과 일반적인 ARM64 TV 박스를 기준으로 작성했으며, 제조사별 메뉴 이름은 조금 다를 수 있습니다.
먼저 TV 박스의 설정 → 기기 환경설정 → 정보에서 Android 버전과 프로세서 유형을 확인하세요. APK가 TV 박스의 CPU와 맞지 않으면 설치가 중단되거나 앱이 실행 직후 종료될 수 있습니다. 대부분의 최근 TV 박스는 ARM64를 사용하지만, 오래된 기기나 저가형 제품은 ARM32일 수 있습니다. 저장 공간도 최소 150MB 이상 남겨 두고, 설치 중에는 전원 케이블을 분리하지 않는 편이 안전합니다.
NekoBox Android TV 설치에 필요한 APK 준비, 알 수 없는 앱 허용, 리모컨으로 구독을 추가하는 방법, VPN 권한과 노드 연결 확인까지 한 번에 안내합니다. TV 화면에서 입력하기 어려운 부분은 QR 코드나 USB 저장 장치를 활용하고, 연결되지 않을 때 확인할 로그와 네트워크 조건도 함께 설명합니다.
APK를 준비하고 설치 권한 설정하기
NekoBox APK는 TV에서 직접 받거나, 컴퓨터·휴대전화에서 먼저 받은 뒤 USB 메모리로 옮길 수 있습니다. TV에 기본 브라우저가 있고 리모컨 입력이 편하다면 공식 배포 경로에서 최신 안정 버전의 Android APK를 내려받으세요. 출처가 불분명한 수정 APK는 설정 파일이나 개인 정보가 변조될 가능성이 있으므로 피해야 합니다. 파일 이름에 ARM64, armeabi-v7a처럼 CPU 유형이 표시되어 있다면 TV 박스 정보 화면과 일치하는 파일을 선택합니다.
APK 준비
TV 브라우저로 APK를 받거나 USB 메모리에 복사합니다. 다운로드가 끝난 뒤 파일 관리자에서 확장자가
.apk인지 확인하세요.설치 권한 허용
「설정」→「앱」→「특별 앱 접근」→「알 수 없는 앱 설치」에서 APK를 열 앱의 권한을 허용합니다. 제조사에 따라 「보안」→「알 수 없는 소스」로 표시될 수 있습니다.
파일 열기
「파일 관리자」→「Download」 또는 USB 저장 장치로 이동해 NekoBox APK를 선택한 뒤 「설치」를 누릅니다. 기존 버전이 있다면 먼저 설정을 백업한 후 업데이트하세요.
앱 실행
설치가 끝나면 「열기」를 선택합니다. VPN 연결 요청이 표시되면 내용을 확인하고 「확인」 또는 「허용」을 선택해야 실제 프록시 연결을 시작할 수 있습니다.
「앱이 설치되지 않았습니다」라는 메시지가 나타나면 APK가 손상되었거나 CPU 아키텍처가 맞지 않거나, 이미 설치된 앱과 서명이 다른 경우가 많습니다. 이전 NekoBox를 삭제하면 저장된 프로필이 함께 사라질 수 있으므로 먼저 내보내기 기능이 제공되는지 확인하세요. 설치 권한을 허용했는데도 같은 메시지가 반복되면 다른 파일 관리자에서 열거나 APK를 다시 내려받아 파일 크기를 비교해 보는 것이 좋습니다.
TV 화면에서 구독을 추가하는 방법
NekoBox가 실행되면 먼저 구독을 추가해야 합니다. 서비스에서 받은 구독 주소는 일반 웹페이지 주소와 달리 여러 노드 설정을 내려주는 링크입니다. 주소를 리모컨으로 직접 입력하면 오타가 생기기 쉬우므로 USB 키보드, 블루투스 키보드 또는 TV 제조사의 모바일 리모컨 앱을 사용하는 것이 편합니다. 클립보드 공유가 지원되지 않는 환경에서는 QR 코드로 구독 주소를 표시하는 방법도 사용할 수 있습니다.
| 입력 방법 | 장점 | 주의할 점 |
|---|---|---|
| USB 또는 블루투스 키보드 | 긴 주소와 특수 문자를 빠르게 입력 | TV 박스가 OTG 또는 블루투스를 지원하는지 확인 |
| QR 코드 스캔 | 오타가 적고 리모컨만으로 화면 이동 가능 | QR 이미지가 작으면 인식이 늦어질 수 있음 |
| USB 저장 장치 | 미리 준비한 설정 파일을 옮기기 쉬움 | 파일 형식과 NekoBox가 지원하는 가져오기 방식 확인 |
일반적인 흐름은 NekoBox의 프로필 또는 그룹 화면에서 추가 버튼을 열고, 구독 URL을 입력한 다음 저장하거나 업데이트하는 방식입니다. 버전에 따라 메뉴가 「프로필」, 「그룹」, 「구독」 또는 「Subscription」으로 다르게 표시될 수 있습니다. 주소를 입력한 뒤에는 즉시 연결하지 말고 먼저 업데이트가 완료되었는지 확인하세요. 노드 목록이 비어 있다면 주소 끝의 공백, 줄바꿈, 만료된 토큰이 포함되지 않았는지 점검해야 합니다.
추천 방식: 입력 환경에 따라 구독을 가져오기
키보드가 있는 TV
- 구독 주소를 직접 붙여넣기
- 업데이트 후 노드 이름 확인
- 자동 업데이트는 긴 주기로 설정
리모컨만 있는 TV
- QR 코드 또는 짧은 주소 사용
- USB 파일 관리자로 설정 가져오기
- 필요할 때 수동 업데이트
TV에서는 입력 오류가 가장 흔한 원인이므로, 주소를 여러 번 수정하기보다 외부 키보드나 QR 코드로 한 번에 가져오는 편이 안정적입니다.
노드를 선택하고 VPN 연결 확인하기
구독 업데이트가 끝나면 목록에서 노드를 하나 선택합니다. 처음에는 지연 시간이 가장 낮은 항목 또는 서비스에서 추천한 기본 항목을 사용하세요. 노드 이름에 국가나 지역이 표시되어 있어도 실제 응답 속도는 TV와 서버 사이의 회선 상태, Wi-Fi 신호, 서버 혼잡도에 따라 달라집니다. 이름만 보고 가장 먼 지역을 고르기보다 두세 개를 차례로 테스트하는 것이 정확합니다.
연결 버튼을 누르면 Android 시스템에서 VPN 연결 권한을 요청할 수 있습니다. 이 권한은 NekoBox가 기기의 네트워크 요청을 가상 VPN 인터페이스로 받아 설정된 프록시 경로로 전달하는 데 필요합니다. 승인 후 상태 표시가 연결됨으로 바뀌었는지 확인하고, 화면 상단이나 상태 영역에 VPN 아이콘이 나타나는지도 살펴보세요. 이미 다른 VPN 앱이 실행 중이면 새 VPN 연결이 거부될 수 있으므로 하나만 활성화해야 합니다.
연결 테스트는 TV의 브라우저에서 한 페이지를 여는 것만으로 끝내지 말고 세 가지를 확인하는 것이 좋습니다. 첫째, 일반 웹페이지가 10초 안에 표시되는지 확인합니다. 둘째, 동영상 서비스에서 1080p 미리보기를 재생해 버퍼링이 반복되는지 살펴봅니다. 셋째, 연결을 끊은 뒤 다시 연결하여 30초 안에 복구되는지 확인합니다. 이 과정에서 한 번에 여러 설정을 바꾸면 어떤 변경이 효과가 있었는지 알 수 없으므로 노드와 설정을 하나씩 비교하세요.
| 증상 | 우선 확인할 항목 | 권장 조치 |
|---|---|---|
| VPN 아이콘이 없음 | 시스템 권한과 다른 VPN 앱 실행 여부 | VPN 권한을 다시 허용하고 기존 VPN을 종료 |
| 노드 목록이 비어 있음 | 구독 주소, 업데이트 결과, 만료 상태 | 주소를 다시 입력하고 Wi-Fi 연결 상태에서 수동 업데이트 |
| 연결됨이지만 웹페이지가 안 열림 | 노드 매개변수와 DNS 응답 | 다른 노드를 선택하고 NekoBox 로그에서 오류 확인 |
| 동영상이 자주 멈춤 | Wi-Fi 신호, 서버 혼잡, TV 성능 | 공유기 가까이 이동하고 낮은 지연의 다른 노드 테스트 |
TV 박스에 맞춘 안정성 설정
TV 박스는 휴대기기보다 화면과 입력 장치가 단순하고, 제조사에 따라 백그라운드 앱 정리 정책이 강하게 적용됩니다. NekoBox를 장시간 사용하다가 연결이 끊긴다면 「설정」→「앱」→「NekoBox」에서 배터리 제한이나 백그라운드 실행 제한을 확인하세요. 해당 메뉴가 있다면 제한 없음 또는 최적화 안 함으로 바꿀 수 있지만, 기기 발열과 전력 소비가 늘어날 수 있으므로 실제 사용 시간에 맞춰 판단해야 합니다.
Wi-Fi 연결에서는 5GHz가 항상 더 좋은 것은 아닙니다. 공유기와 TV 박스 사이에 벽이 많거나 거리가 멀면 5GHz 신호가 약해져 지연과 패킷 손실이 늘어날 수 있습니다. 같은 위치에서 2.4GHz와 5GHz를 각각 10분씩 사용해 동영상 버퍼링과 연결 복구 시간을 비교하세요. 가능하다면 유선 LAN을 사용하면 무선 간섭을 줄일 수 있지만, 유선 연결이 프록시 서버와의 지연을 자동으로 낮춰 주는 것은 아닙니다.
NekoBox 내부의 로컬 프록시 포트는 다른 기기에서 TV 박스의 프록시를 공유할 때만 필요합니다. TV 자체의 앱 트래픽만 처리하려면 임의로 HTTP 포트나 SOCKS 포트를 변경할 이유가 없습니다. 다른 장치가 TV 박스에 연결하도록 설정할 때는 해당 포트가 외부에 노출되지 않도록 하고, 공유기 방화벽과 같은 네트워크 안에서만 사용하는지 확인하세요. 일반적인 가정용 TV 사용에서는 시스템 VPN 모드가 가장 간단한 출발점입니다.
APK를 눌렀는데 설치 버튼이 비활성화되나요?
「알 수 없는 앱 설치」에서 현재 APK를 여는 파일 관리자 또는 브라우저의 권한을 허용한 뒤 다시 파일을 열어 보세요. 저장 공간이 부족하거나 CPU 유형이 맞지 않는 경우에도 설치가 중단될 수 있습니다.
구독은 추가됐는데 노드가 보이지 않나요?
구독 그룹을 선택한 뒤 수동 업데이트를 실행하고, 주소 앞뒤에 공백이나 줄바꿈이 없는지 확인하세요. 서비스가 만료된 구독을 제공하는 경우에는 새 주소를 받아야 합니다.
연결됨인데 TV 앱은 계속 오프라인인가요?
먼저 브라우저에서 일반 페이지를 열어 실제 네트워크가 통과하는지 확인하세요. 특정 앱만 실패한다면 해당 앱의 DNS, 지역 제한 또는 자체 네트워크 정책일 수 있으므로 다른 노드와 다른 앱으로 범위를 나눠 테스트하세요.
리모컨으로 긴 구독 주소를 입력하기 너무 어렵나요?
USB 키보드나 블루투스 키보드를 연결하거나, 휴대전화에서 주소를 QR 코드로 표시해 TV에서 스캔하는 방법을 사용하세요. 주소를 여러 번 직접 수정하는 것보다 오타를 줄일 수 있습니다.
연결 실패 시 로그로 원인 좁히기
연결이 실패하면 노드를 계속 바꾸기보다 NekoBox의 로그 또는 이벤트 화면에서 첫 번째 오류를 확인하세요. timeout은 서버 주소나 포트에 도달하지 못했거나 회선이 불안정하다는 뜻일 수 있고, 인증 오류는 사용자 식별자·비밀번호·UUID 같은 서버 매개변수가 맞지 않을 가능성이 큽니다. 구독에서 가져온 항목을 직접 편집했다면 원래 값으로 되돌린 뒤 다시 테스트하는 것이 좋습니다.
报错: connection timeout
원인과 해결: 서버 주소 또는 포트에 도달하지 못한 상태입니다. Wi-Fi를 확인하고 다른 노드를 선택한 뒤, 같은 노드가 다른 네트워크에서도 실패하는지 비교하세요.
报错: failed to start VPN service
원인과 해결: Android VPN 권한이 거부되었거나 다른 VPN이 이미 실행 중일 수 있습니다. NekoBox를 종료한 뒤 다른 VPN을 끄고 권한 요청을 다시 승인하세요.
报错: authentication failed
원인과 해결: 서버 인증 정보가 만료되었거나 설정이 변경된 것입니다. 노드를 수동으로 고치지 말고 최신 구독을 다시 업데이트하세요.
报错: no route to host
원인과 해결: 현재 네트워크에서 대상 서버로 가는 경로가 차단되었거나 주소가 잘못되었을 수 있습니다. 다른 회선과 다른 노드로 교차 확인하세요.
모든 노드가 동시에 실패한다면 TV 자체보다 구독 서비스, 공유기 DNS, 서버 장애를 먼저 의심할 수 있습니다. 반대로 한 노드만 실패한다면 해당 서버의 포트나 만료 상태 문제일 가능성이 높습니다. 테스트 결과를 기록할 때는 날짜, 사용한 노드, Wi-Fi 대역, 연결까지 걸린 시간, 동영상 재생 여부를 함께 적어 두면 문제 재현과 서비스 문의에 도움이 됩니다.