Android 시작하기

Chute Android는 다른 에디션과 같은 엔진(Kotlin 이식판)으로 동작하며 같은 구성 파일을 읽습니다. 이 페이지는 첫 실행을 안내합니다. iOS, macOS, tvOS의 절차는 시작하기에 있으며, 그곳의 최소 구성은 Android에서도 그대로 동작합니다.

1. 구성 준비

구성이 하나도 없는 상태로 처음 실행하면 Chute는 설정 마법사("첫 번째 프록시 구성을 설정해 보세요")를 열고 세 가지 경로를 제시합니다: 제공자에게 받은 구독 URL, QR 코드, 또는 직접 입력하는 서버 정보와 그 뒤에 이어지는 프록시할 사이트 및 DNS 선택입니다. 마지막 단계인 생성 및 연결은 구성을 저장하고 선택한 뒤 터널을 시작합니다. 건너뛰기를 누르면 마법사가 닫힙니다. 구성이 여전히 하나도 없으면 다음에 Chute를 실행할 때 다시 열리지만, 화면을 회전하거나 앱으로 돌아올 때는 열리지 않습니다. 설정의 온보딩 보기로 마법사를 다시 열 수 있습니다.

구독 URL은 https:// 주소여야 합니다. 마법사가 내려받은 네이티브 프로필은 — 그 URL에서든, QR 코드에 담긴 주소에서든 — 관리형 구성으로 보관되어, 아래 구독 추가의 기본값인 86400초마다 갱신됩니다. Clash나 sing-box 프로필은 구독에서 왔든 QR 코드에서 왔든 구성 목록 페이지에서와 마찬가지로 갱신되지 않는 정적 스냅숏으로 변환됩니다. QR 코드는 그 페이지와 같은 방식으로 읽힙니다: chute://download 링크(또는 import, install-config, subscribe)는 내려받을 주소이고, 코드에 구성 전체가 담겨 있을 수도 있으며, chute://tv나 chute://remote 코드는 메인 화면의 원격 저장소 대화 상자를 엽니다.

나중에 구성을 추가하려면 메인 화면의 구성 바를 탭해 구성 목록을 연 다음 구성 추가 방법...을 탭합니다:

• 빈 구성 — 편집기를 열지 않고 템플릿을 Untitled.conf로 저장합니다. 해당 행의 ⋮ 메뉴에서 구조화 편집 또는 텍스트 편집으로 여세요.
• 구독 추가 — 제공자 URL에서 다운로드해 관리형 구성으로 보관하며, 대화상자에 입력한 간격(기본 86400초)으로 갱신합니다. Clash나 sing-box 구독은 가져오는 과정에서 변환되어 업데이트 헤더가 없는 정적 스냅숏으로 저장되므로 스스로 갱신하지 않습니다.
• 로컬 파일에서 가져오기 — Chute(.conf), sing-box(.json), Clash/mihomo(.yaml) 파일을 가져옵니다. 네이티브가 아닌 형식은 변환됩니다.
• URL에서 다운로드, QR 코드에서 다운로드, Wi-Fi로 파일 업로드 — 같은 일을 하는 다른 경로입니다. Wi-Fi 업로드 페이지는 같은 네트워크의 브라우저에서 열 주소를 보여 주며 PIN으로 보호됩니다.
• 원격 서버 — 원격 구성 저장소에서 구성을 불러옵니다.

앱 밖에서 연 chute://download?url=... 링크 — 탭했거나 카메라로 스캔한 링크 — 도 파일을 내려받으며, Clash나 sing-box 프로필은 구성 목록 페이지에서와 마찬가지로 정적 스냅숏으로 변환됩니다. 다만 이 링크는 구독을 추가하지 않습니다. chute://subscribe?url=...도 download의 별칭일 뿐입니다. 이런 링크로 저장한 네이티브 프로필은 앱이 갱신하지 않지만, 실행 중인 엔진은 24시간마다 그 URL을 다시 가져와 새 내용을 메모리에 적용합니다 — URL 스킴을 보세요. 같은 링크라도 네이티브 프로필을 가리키는 것을 설정 마법사에서 스캔하면, 앱이 86400초마다 갱신하는 관리형 구성이 됩니다.

라이선스가 없으면 Chute는 로컬 구성을 하나만 보관합니다. 어떤 채널로든 두 번째 구성을 추가하는 것은 Chute Pro 기능입니다 — 라이선스와 활성화를 보세요.

2. 선택

구성 목록 페이지에서 구성을 탭해 대기 중으로 표시한 다음 완료를 탭합니다. 그것이 Chute가 실행하는 구성입니다. 그 페이지에서 방금 추가한 구성은 이미 대기 중으로 표시된 채 돌아옵니다. 앱 밖에서 연 chute:// 링크가 추가한 구성도 마찬가지입니다: Chute가 이 페이지를 열어 그 구성을 표시해 두며, 완료를 탭하기 전에는 아무것도 바뀌지 않습니다 — 이런 링크가 Chute가 실행 중인 구성을 바꾸는 일은 없습니다. 선택한 구성은 라이선스 여부와 관계없이 Chute 실행 중에도 바꿀 수 있으며, 새 구성은 터널을 재시작해 적용됩니다.

3. 시작과 권한 부여

스위치(탭하여 VPN 시작)를 탭합니다. 첫 시작에서 Android가 VPN 연결 요청을 허용할지 묻습니다. 모든 VPN 앱에 필요한 시스템 동의이며, 거부하면 Chute는 멈춘 상태로 남습니다. 터널이 무엇을 나르는지는 두 설정이 정합니다.

• 서비스 모드 — VPN(기본)은 시스템 VPN으로 기기 트래픽을 잡습니다. 로컬 프록시는 터널 없이 다른 앱이나 기기에서 프록시로 지정해 쓸 HTTP와 SOCKS5 리스너만 실행합니다.
• 앱 프록시 모드 — 전역은 모든 앱, 프록시는 선택한 앱만, 블랙리스트는 선택한 앱을 제외한 모든 앱을 라우팅합니다.

설정의 관련 스위치: 부팅 시 시작(VPN 동의가 한 번 필요), Wi-Fi 전용(VPN 모드 전용: 기반 네트워크가 종량제일 때 터널을 일시정지하고 종량제가 아니게 되면 재개합니다 — Android가 알려 주는 것은 전송 방식이 아니라 이 값이므로, 종량제 Wi-Fi에서도 일시정지하고 무제한 셀룰러 요금제에서는 정지하지 않습니다), 그리고 Android의 VPN 목록을 여는 상시 연결 VPN입니다. 상시 연결 화면 자체는 바로 열 수 있는 목적지가 아니라 목록이 대신 열리며, 거기서 Chute에 대해 상시 연결 VPN을 켜세요. 앱 밖에서는 홈 화면 바로가기 시작, 중지, 전환과 브로드캐스트 Intent, Tasker/Locale 플러그인이 터널을 시작·중지하며, 빠른 설정 타일도 마찬가지입니다 — 단, 설정의 빠른 작업에서 타일을 VPN 대신 모드(아웃바운드 모드 순환)나 그룹(위젯 그룹에서 고른 정책 그룹 순환. 여기에는 이미 골라 둔 그룹을 빼면 hidden=true이 붙은 그룹이 나오지 않습니다)으로 바꾸면 그렇지 않습니다. 홈 화면 위젯은 터널 실행 여부와 그 그룹의 정책을 보여 주며, 위젯을 탭하면 그 그룹이 다음 정책으로 넘어갑니다.

상시 연결 VPN을 켜면 Android가 직접 터널을 시작합니다 — 이 설정을 켤 때, 부팅할 때, Chute가 업데이트된 뒤에 — 선택한 구성으로, 그리고 서비스 모드가 로컬 프록시여도 항상 VPN으로 시작합니다. 이와 별개로, VPN이 실행 중일 때 Android가 Chute 프로세스를 종료하면 터널은 선택한 구성으로 스스로 돌아옵니다. 단, 사용자가 직접 중지했거나, Android의 VPN 설정에서 연결을 끊었거나, VPN 권한을 다른 앱에 넘긴 경우에는 돌아오지 않습니다. 로컬 프록시 모드도 마찬가지입니다: 실행 중이던 리스너는 사용자가 직접 중지하지 않았다면 돌아옵니다 — 다만 Android 12 이상에서는 Chute가 백그라운드에 있는 동안 시스템이 이 재시작을 거부할 수 있으며, 그러면 시작 실패로 표시됩니다.

4. 확인

아웃바운드 모드를 규칙에 두고(다이렉트 / 글로벌 모드는 프록시를 통째로 우회하거나 강제합니다) 웹사이트를 엽니다. 메인 화면의 대시보드는 통계, 터널, DNS, UDP, 로그 탭으로 실시간 트래픽을 보여 주며, 터널을 열면 요청과 응답 상세가 나옵니다. 제어판에는 런타임 스위치 — 로컬 HTTP·SOCKS5 리스너, HTTP 제어 API와 웹 콘솔, MitM, 트래픽 캡처, 프로토콜 스니핑, Optimus DNS — 와 DNS 캐시 비우기, 런타임 진단 번들이 있습니다.

플랫폼 차이

• 프로세스 규칙은 패키지 이름과 일치합니다. PROCESS-NAME은 연결을 연 앱의 패키지 이름과 비교합니다(예: PROCESS-NAME,com.android.chrome,Proxy). Chute는 VPN 인터페이스가 나르는 각 TCP 연결의 소유 앱을 Android에 묻습니다. 대신 리스너로 들어오는 연결 — 로컬 프록시 모드의 모든 연결과 시스템 HTTP 프록시를 쓰는 앱의 연결 — 에는 패키지 이름이 없으므로 이 규칙과 결코 일치하지 않습니다.
• HTTPS 복호화에는 직접 마련한 CA가 필요합니다. 인증서 생성기가 없습니다. 편집기 MitM 아래의 CA 구성 페이지에서 P12 가져오기는 PKCS#12를 base64로 구성의 ca-p12에 기록합니다. Chute가 Apple 기기에서 쓰는 것과 같은 형식이라 구성이 자신의 CA를 어느 기기로든 가져갑니다. 암호를 채우고 나면 CA 설치가 그 CA 인증서에 대해 Android 인증서 설치 프로그램을 엽니다. 편집기 페이지에는 라이선스가 필요 없지만 엔진에는 필요합니다. Chute Pro가 없으면 프로필의 [MITM] enable = true가 무엇을 요구하든 아무것도 복호화되지 않으며, 제어판과 대시보드에 있는 MitM 런타임 토글도 함께 막힙니다.
• SSID 기반 기능은 동작합니다 — ssid 정책 그룹, SUBNET 규칙, [SSID Setting] — 단, 네트워크 이름을 읽기 위해 시스템이 요구하는 위치(Android 12 이하) 또는 근처 Wi-Fi 기기(Android 13 이상) 권한이 필요합니다. 메인 스위치로 시작하고 구성에 ssid나 subnet 정책 그룹, SUBNET,SSID:나 SUBNET,BSSID: 규칙, 또는 [SSID Setting] / [SSID Suspend] 섹션이 있으면 Chute가 그 권한을 요청합니다. 요청 창을 띄울 수 없는 시작 방식 — 빠른 설정 타일, 바로가기, 부팅 시 시작, 브로드캐스트, 상시 연결 VPN — 에서는 대신 SSID 권한 필요 알림을 구성마다 한 번 보내며, 알림을 탭하면 요청합니다. 엔진은 1분마다 네트워크를 다시 읽으므로, 허용하면 재시작 없이 1분 안에 적용됩니다. 외부 규칙 세트 안의 SUBNET 규칙은 감지되지 않으므로, 규칙이 그곳에 있다면 시스템 설정에서 직접 허용하세요. VPN 모드에서는 SSID 일시 중단의 suspend 항목이 기기가 일치하는 네트워크에 있는 동안 VPN 인터페이스를 내립니다. 로컬 프록시 모드는 이를 무시합니다.
• Tailscale을 쓸 수 있으며 편집기에 Tailscale 페이지가 있습니다.
• 플랫폼 지시문 — #!IOS-ONLY, #!MACOS-ONLY, #!TVOS-ONLY 줄은 여기서 주석이므로 Android에서는 어느 것도 적용되지 않습니다.
• 이전 버전이 쓴 Trojan 줄. Trojan 정책에는 모든 플랫폼에서 명시적인 tls=true가 필요합니다. 이전 버전의 Chute Android는 Trojan을 TLS로 간주했고 편집기도 기본적으로 이 옵션을 쓰지 않았으므로, 업데이트 후 처음 실행할 때 로컬 구성에서 tls 옵션이 전혀 없는 Trojan 정책마다 tls=true를 추가하고 모든 변경을 앱의 서비스 로그에 남깁니다. 관리형 구성은 건드리지 않으며 — 원본이 그것을 대체합니다 — tls=false라고 쓴 줄도 그대로 둡니다.
• 두 가지 로그. 엔진의 로그는 메모리에만 있습니다. 웹 콘솔의 로그 페이지나 GET /api/logs로 읽거나, 런타임 진단 번들(제어판, 터널 실행 중)로 가져가거나, adb logcat으로 따라가며 봅니다. 앱이 디스크에 쓰는 것은 자체 서비스 로그 — 시작과 중지, 일시 중단, 네트워크 변경, 앱이 보낸 알림 — 뿐이며, 비공개 저장소의 logs/runtime.log와 sessions/<run id>/ 아래 실행별 사본에 기록됩니다. 대시보드의 로그 탭은 그 파일의 마지막 80줄을, 세션의 로그 탭은 그 실행의 사본을 보여 줍니다. 설정 → 진단의 오프라인 진단 번들 저장에는 이 파일이 들어가며, 설정의 로컬 로그 정리는 이 파일을 지우지만 실행별 사본은 지우지 않습니다 — 문제 해결을 보세요.
• Mac의 Chute Dashboard는 adb를 통해 USB로, 또는 네트워크로 휴대폰에 연결합니다 — Chute Dashboard를 보세요.
• 알림은 다른 앱과 같은 엔진 이벤트를 다룹니다(설정 → 알림). "네트워크가 트래픽을 전달하지 않음"은 대량 연결 실패 스위치를 따릅니다. 알림은 VPN 모드에서만 표시되며, 로컬 프록시 모드에서는 엔진 이벤트 알림이 하나도 뜨지 않습니다.
• Android에 없는 것: Mac 전용 향상 모드와 VIF, iCloud 동기화, chute://start / stop / toggle URL 액션 — 이를 대신하는 브로드캐스트 Intent는 URL 스킴을 보세요. 브로드캐스트는 VPN 동의 창을 띄울 수 없으므로, 동의를 한 번도 하지 않았다면 START_VPN은 조용히 무시됩니다. TOGGLE_VPN은 대신 앱을 열며, 거기서 스위치를 탭하면 동의 창이 뜹니다. 로컬 프록시 모드에는 동의 자체가 필요 없습니다.