URL-Schema für Chute iOS, Chute tvOS, Chute Mac und Chute Android

Chute iOS (ab 1.0.2) und Chute tvOS unterstützen die folgenden Aktionen und eine Option.

Chute Mac registriert dasselbe chute-Schema, beantwortet aber nur zwei Verben, install-config und import, jeweils in der Host- wie in der Pfadform: chute://import?url=... und chute:///install-config?url=.... Der Wert von url= muss eine http- oder https-Adresse oder ein Share-Link (ss://, vmess://, …) sein; alles andere wird abgelehnt. Chute Mac fragt nach einer Bestätigung, bevor es irgendetwas holt, und reicht die Adresse dann an den Tab Profile des Hauptfensters weiter, der sie importiert: Ein natives Profil wird als verwaltete Konfiguration mit einem Aktualisierungsintervall von 24 Stunden gespeichert, ein Clash- oder sing-box-Profil wird konvertiert und als statische Momentaufnahme gespeichert, und ein Share-Link — oder ein Abonnement, das eine Liste davon liefert — wird in ein Profil konvertiert. start, stop, toggle und tv sind keine Mac-Aktionen.

Chute Android verarbeitet nur die am Ende dieser Seite beschriebenen Import-Links.

Aktion:

• start | connect | on

  Startet mit ausgewählter Konfiguration.

  Beispiel: chute://start chute:///start

• stop | disconnect | off

  Stoppt die aktuelle Sitzung.

• toggle | switch

  Startet oder stoppt mit ausgewählter Konfiguration.

• tv (nur Chute iOS)

  Öffnet die Ansicht zum Import einer Remote-Konfiguration mit der angegebenen Konfigurations-URL. Diese Aktion ist nur unter Chute iOS verfügbar; Chute tvOS unterstützt lediglich start/stop/toggle.

  Anders als die übrigen Aktionen wird tv allein am Host erkannt; die Pfadform chute:///tv?url=... bewirkt daher nichts.

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

Option:

• autoclose=true

  Schließt Chute automatisch nach Abschluss der Aktion. Nur Chute iOS: Chute tvOS nimmt den Parameter entgegen und ignoriert ihn, die App bleibt offen.

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

Hinweis: Unter Chute iOS wird nur die erste URL einer Aktivierung verarbeitet; ein Kurzbefehl, der Chute mehrere chute://-URLs auf einmal übergibt, wirkt daher nur auf eine davon.

x-callback-url

Chute unterstützt die x-callback-url-Spezifikation. Das URL-Schema ist 'chute' und die verfügbaren Aktionen sind 'start', 'stop' und 'toggle'.

x-success und x-error müssen in doppelte geschweifte Klammern gesetzt werden, genau wie im Beispiel unten. Ein Wert ohne sie wird als leer gelesen, und es wird kein Callback geöffnet. x-cancel wird nicht verarbeitet.

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

x-success wird geöffnet, sobald Chute den Schalter betätigt hat. Es besagt, dass die Anfrage ausgeführt wurde, nicht, dass der Tunnel steht: Auch ein fehlgeschlagener Start oder eine abgelehnte VPN-Abfrage endet in x-success. x-error wird nur geöffnet, wenn start den Tunnel bereits laufend oder stop ihn bereits gestoppt vorfindet, nachdem der entsprechende Hinweis geschlossen wurde; toggle öffnet es nie. Ist keine Konfiguration ausgewählt, wird keiner der beiden Callbacks geöffnet.

Chute Android

Chute Android öffnet chute://-Links (und QR-Codes, die sie tragen und auf der Seite Konfigurationen oder im Einrichtungsassistenten gescannt werden) nur zum Importieren:

• chute://download?url=... (auch import, install-config) — lädt die Konfiguration unter url einmalig herunter. Ein natives Profil wird mit einem Header #!MANAGED-CONFIG <url> gesichert, der kein interval= trägt; ein Clash- oder sing-box-Profil wird konvertiert und als statische Momentaufnahme ohne diesen Header gesichert.
• chute://subscribe?url=... — ein Alias von download, kein Abonnement. Es nimmt denselben einmaligen Weg, und da die geschriebene Datei kein interval= hat, frischt die App sie nie auf. Bei einem nativen Profil ruft eine laufende Engine die URL dennoch alle 24 Stunden neu ab und übernimmt den neuen Inhalt im Speicher, und der nächste Start liest wieder die Datei — siehe Verwaltete Konfiguration. Damit Chute ein Abonnement aktuell hält, verwenden Sie Abonnement hinzufügen in der App, das nach dem Intervall fragt.
• chute://tv?url=... (auch remote) — lädt das Remote-Konfigurations-Repository unter url.

Eine Konfiguration, die ein von außerhalb der App geöffneter Link hinzufügt — heruntergeladen oder aus dem Repository gewählt, das ein tv-Link öffnet —, wird nicht ausgewählt: Chute öffnet die Seite Konfigurationen mit ihr als Ausstehend markiert, und erst ein Tippen auf Fertig macht sie zur laufenden Konfiguration; ein solcher Link wechselt also nie die Konfiguration, die Chute gerade ausführt.

Ein von außerhalb der App geöffneter Link konvertiert ein Clash- oder sing-box-Profil wie Von URL herunterladen auf der Seite Konfigurationen, ebenso derselbe Link, wenn er dort mit Von QR-Code herunterladen oder im Einrichtungsassistenten gescannt wird. Nur der Einrichtungsassistent behält ein natives Profil als Abonnement: Dort gescannt, ergibt der Link eine Konfiguration, die die App alle 86400 Sekunden aktualisiert, während derselbe Link, von außerhalb der App geöffnet, die Datei einmal herunterlädt und die App sie nie aktualisiert.

start, stop und toggle sind auf Android keine URL-Aktionen. Automatisierungs-Apps verwenden stattdessen Broadcast-Intents: com.r3studio.chute.action.START_VPN, com.r3studio.chute.action.STOP_VPN und com.r3studio.chute.action.TOGGLE_VPN.

Ein Broadcast kann den VPN-Zustimmungsdialog des Systems nicht anzeigen. START_VPN wird daher stillschweigend verworfen, solange die Zustimmung noch nicht erteilt wurde, während TOGGLE_VPN stattdessen Chute öffnet: Tippen Sie dort auf den Schalter, um die Zustimmung zu erteilen — dieses Tippen startet auch den Tunnel —, danach funktionieren die Broadcasts. Im Dienstmodus Lokaler Proxy gibt es keine Zustimmung zu erteilen, und beide funktionieren sofort.