Chute iOS, Chute tvOS, Chute Mac 및 Chute Android용 URL 스킴

Chute iOS(1.0.2부터) 및 Chute tvOS는 다음 액션과 하나의 옵션을 지원합니다.

Chute Mac도 같은 chute 스킴을 등록하지만, 답하는 동사는 install-config와 import 둘뿐이며 호스트 형식과 경로 형식을 모두 받습니다: chute://import?url=...와 chute:///install-config?url=.... url= 값은 http나 https 주소, 또는 공유 링크(ss://, vmess://, …)여야 하며 그 밖의 것은 거부됩니다. Chute Mac은 무엇이든 가져오기 전에 확인을 요청한 다음 그 주소를 메인 창의 프로필 탭에 넘기고, 프로필 탭이 이를 가져옵니다: 네이티브 프로필은 업데이트 간격이 24시간인 관리형 구성으로 저장되고, Clash나 sing-box 프로필은 변환되어 정적 스냅샷으로 저장되며, 공유 링크 — 또는 공유 링크 목록을 반환하는 구독 — 는 프로필로 변환됩니다. start, stop, toggle, tv는 Mac의 액션이 아닙니다.

Chute Android는 이 페이지 끝에 설명한 가져오기 링크만 처리합니다.

액션:

• start | connect | on

  선택한 구성으로 시작합니다.

  예: chute://start chute:///start

• stop | disconnect | off

  현재 세션을 중지합니다.

• toggle | switch

  선택한 구성으로 시작 또는 중지합니다.

• tv (Chute iOS 전용)

  지정한 구성 URL로 원격 구성 가져오기 화면을 엽니다. 이 액션은 Chute iOS에서만 사용할 수 있으며, Chute tvOS는 start/stop/toggle만 처리합니다.

  다른 액션과 달리 tv는 호스트 자리에서만 일치하므로, 경로 형식인 chute:///tv?url=...은 아무 일도 하지 않습니다.

  예: chute://tv?url=https://example.com/chute.conf

옵션:

• autoclose=true

  액션 완료 후 Chute 자동 종료. Chute iOS 전용입니다: Chute tvOS는 이 매개변수를 받아들이지만 무시하며, 앱은 열린 채로 남습니다.

  예: chute:///toggle?autoclose=true

주의: Chute iOS는 한 번의 활성화에서 첫 번째 URL만 처리하므로, 단축어가 chute:// URL을 한꺼번에 여러 개 넘기면 그중 하나에만 작동합니다.

x-callback-url

Chute는 x-callback-url 사양을 지원합니다. URL 스킴은 'chute'이며 사용 가능한 액션은 'start', 'stop', 'toggle'입니다.

x-success와 x-error는 아래 예시처럼 반드시 이중 중괄호로 감싸야 합니다. 중괄호 없이 쓴 값은 빈 값으로 읽혀 콜백이 열리지 않습니다. x-cancel은 처리하지 않습니다.

예: chute://x-callback-url/start?x-success={{ "{{sms://}}" }}&x-error={{ "{{tel://}}" }}

x-success는 Chute가 스위치를 조작한 뒤에 열립니다. 요청이 수행됐다는 뜻일 뿐 터널이 올라왔다는 뜻은 아닙니다: 시작에 실패하거나 VPN 요청을 거부해도 결과는 x-success입니다. x-error는 start 시 터널이 이미 실행 중이거나 stop 시 이미 멈춰 있을 때만, 그 사실을 알리는 경고를 닫은 뒤에 열립니다. toggle은 이를 절대 열지 않습니다. 선택된 구성이 없으면 어느 콜백도 열리지 않습니다.

Chute Android

Chute Android는 chute:// 링크(및 이를 담아 구성 목록 페이지나 설정 마법사에서 스캔한 QR 코드)를 가져오기 용도로만 엽니다.

• chute://download?url=...(import, install-config도 가능) — url의 구성을 한 번 다운로드합니다. 네이티브 프로필은 interval=이 없는 #!MANAGED-CONFIG <url> 헤더를 붙여 저장하고, Clash나 sing-box 프로필은 변환해 이 헤더가 없는 정적 스냅샷으로 저장합니다.
• chute://subscribe?url=... — 구독이 아니라 download의 별칭입니다. 같은 일회성 경로를 타고, 기록되는 파일에 interval=이 없으므로 앱이 이를 갱신하는 일은 결코 없습니다. 그래도 네이티브 프로필이라면 실행 중인 엔진이 24시간마다 URL을 다시 가져와 새 내용을 메모리에 적용하며, 다음 시작 때는 다시 파일을 읽습니다 — 관리형 구성을 보세요. Chute가 구독을 최신으로 유지하게 하려면 앱의 구독 추가를 사용하세요 — 여기서는 간격을 묻습니다.
• chute://tv?url=...(remote도 가능) — url의 원격 구성 저장소를 불러옵니다.

앱 밖에서 연 링크가 추가한 구성 — 내려받은 것, 또는 tv 링크가 연 저장소에서 고른 것 — 은 선택되지 않습니다: Chute가 구성 목록 페이지를 열어 그 구성을 대기 중으로 표시하고, 완료를 탭해야 비로소 실행 중인 구성이 됩니다. 따라서 이런 링크가 Chute가 실행 중인 구성을 바꾸는 일은 없습니다.

앱 밖에서 연 링크도 구성 목록 페이지의 URL에서 다운로드처럼 Clash나 sing-box 프로필을 변환합니다. 같은 링크를 그 페이지의 QR 코드에서 다운로드나 설정 마법사에서 스캔해도 마찬가지입니다. 네이티브 프로필을 구독으로 보관하는 것은 설정 마법사뿐입니다: 거기서 스캔한 링크는 앱이 86400초마다 갱신하는 구성이 되지만, 같은 링크를 앱 밖에서 열면 파일을 한 번 내려받을 뿐 앱이 갱신하지 않습니다.

start, stop, toggle은 Android에서 URL 액션이 아닙니다. 자동화 앱은 대신 브로드캐스트 Intent를 사용합니다: com.r3studio.chute.action.START_VPN, com.r3studio.chute.action.STOP_VPN, com.r3studio.chute.action.TOGGLE_VPN.

브로드캐스트는 시스템 VPN 동의 대화상자를 띄울 수 없습니다. 그래서 아직 동의를 받지 않았다면 START_VPN은 조용히 버려지고, TOGGLE_VPN은 대신 Chute를 엽니다: 거기서 스위치를 탭해 동의하면 — 그 탭으로 터널도 시작됩니다 — 그때부터 브로드캐스트가 동작합니다. 로컬 프록시 서비스 모드에서는 받을 동의가 없으므로 둘 다 곧바로 동작합니다.