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

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

Chute Mac도 같은 chute 스킴을 등록하지만, 답하는 동사는 install-config와 import(아래에서 Chute iOS 기준으로 설명합니다) 둘뿐이며 호스트 형식과 경로 형식을 모두 받습니다: 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

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

  • install-config | import (Chute iOS 1.3.0부터, 그리고 Chute Mac)

    url=에 있는 구성을 가져옵니다: http나 https 구독 주소, 공유 링크, 또는 그중 하나를 담은 다른 클라이언트의 원탭 설치 링크(clash://install-config?url=… 등)입니다. Chute는 무엇이든 가져오기 전에 주소를 보여 주고 확인을 요청합니다; 이 중 어느 것도 담지 않은 링크는 거부됩니다. 그런 다음 주소는 구독 추가와 같은 방식으로 가져옵니다: 네이티브 프로필은 관리형 구성으로 저장되고, Clash나 sing-box 프로필 또는 공유 링크 목록은 정적 스냅샷으로 변환되며, 공유 링크 하나는 편집기에서 열립니다. 설정 가이드가 표시 중이면 가져오기는 가이드 안에서 계속됩니다. 라이선스가 없으면 이미 구성을 보관한 기기에서는 대신 구매 안내가 뜹니다. 호스트 형식과 경로 형식 모두 동작합니다.

    예: chute://install-config?url=https://example.com/sub

  • 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를 엽니다: 거기서 스위치를 탭해 동의하면 — 그 탭으로 터널도 시작됩니다 — 그때부터 브로드캐스트가 동작합니다. 로컬 프록시 서비스 모드에서는 받을 동의가 없으므로 둘 다 곧바로 동작합니다.

S. Smart Rabbit LLC © All Rights Reserved            updated 2026-10-27 02:33:57

이 페이지는 영어판의 번역본입니다. 내용이 다를 경우 영어판이 우선합니다.

results matching ""

    No results matching ""