URL Scheme สำหรับ Chute iOS, Chute tvOS, Chute Mac และ Chute Android

Chute iOS (ตั้งแต่ 1.0.2) และ Chute tvOS รองรับการกระทำต่อไปนี้และหนึ่งตัวเลือก

Chute Mac ลงทะเบียนสคีม chute เดียวกันไว้ แต่ตอบสนองเพียงสองคำสั่งคือ install-config และ import โดยเขียนในรูปแบบ host หรือ path ก็ได้: 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 ถูกจับคู่จากส่วน host เพียงอย่างเดียว รูปแบบ path อย่าง 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 แรกของการเปิดใช้งานแต่ละครั้งเท่านั้น ดังนั้นช็อตคัตที่ส่ง URL แบบ chute:// หลายรายการให้ Chute พร้อมกันจะมีผลเพียงรายการเดียว

x-callback-url

Chute รองรับข้อกำหนด x-callback-url URL สคีมคือ 'chute' และการกระทำที่ใช้ได้คือ 'start', 'stop' และ 'toggle'

x-success และ x-error ต้องครอบด้วยวงเล็บปีกกาคู่ ตรงตามตัวอย่างด้านล่างทุกประการ ค่าที่เขียนโดยไม่มีวงเล็บนี้จะถูกอ่านเป็นค่าว่างและจะไม่มีการเปิด callback ใด ๆ ส่วน x-cancel ไม่ถูกจัดการ

ตัวอย่าง: chute://x-callback-url/start?x-success={{ "{{sms://}}" }}&x-error={{ "{{tel://}}" }}

x-success จะถูกเปิดเมื่อ Chute สั่งสวิตช์แล้ว ซึ่งบอกว่าคำขอได้รับการดำเนินการ ไม่ได้บอกว่าทันเนลเชื่อมต่อสำเร็จ: การเริ่มที่ล้มเหลว หรือการที่คุณปฏิเสธกล่องขออนุญาต VPN ก็ยังจบที่ x-success ส่วน x-error จะถูกเปิดเฉพาะเมื่อ start พบว่าทันเนลทำงานอยู่แล้ว หรือ stop พบว่าทันเนลหยุดอยู่แล้ว หลังจากปิดการแจ้งเตือนที่บอกเช่นนั้น; toggle ไม่เคยเปิดมัน หากไม่มีการกำหนดค่าใดถูกเลือก จะไม่มี callback ใดถูกเปิดเลย

Chute Android

Chute Android เปิดลิงก์ chute:// (และ QR Code ที่มีลิงก์เหล่านี้ ซึ่งสแกนในหน้า การกำหนดค่า หรือในตัวช่วยตั้งค่า) เพื่อการนำเข้าเท่านั้น:

• chute://download?url=... (รวมถึง import, install-config) — ดาวน์โหลดการกำหนดค่าที่ url หนึ่งครั้ง โปรไฟล์เนทีฟจะถูกบันทึกพร้อมส่วนหัว #!MANAGED-CONFIG <url> ที่ไม่มี interval= กำกับ ส่วนโปรไฟล์ Clash หรือ sing-box จะถูกแปลงและบันทึกเป็นสแนปช็อตแบบคงที่ที่ไม่มีส่วนหัวนี้
• chute://subscribe?url=... — เป็นชื่อแฝงของ download ไม่ใช่การสมัครสมาชิก มันใช้เส้นทางครั้งเดียวจบแบบเดียวกัน และเนื่องจากไฟล์ที่มันเขียนไม่มี interval= แอปจึงไม่เคยรีเฟรชไฟล์นั้นเลย อย่างไรก็ตาม สำหรับโปรไฟล์เนทีฟ เอนจินที่กำลังทำงานยังคงดึง URL ใหม่ทุก 24 ชั่วโมงและนำเนื้อหาใหม่ไปใช้ในหน่วยความจำ และการเริ่มครั้งถัดไปจะอ่านไฟล์นั้นอีกครั้ง — ดูการกำหนดค่าแบบจัดการ หากต้องการให้ Chute คอยอัปเดตการสมัครสมาชิกให้ ใช้ เพิ่มการสมัครสมาชิก ในแอป ซึ่งจะถามช่วงเวลาให้
• chute://tv?url=... (รวมถึง remote) — โหลดคลังการกำหนดค่าระยะไกลที่ url

การกำหนดค่าที่ลิงก์ซึ่งเปิดจากภายนอกแอปเพิ่มเข้ามา — ดาวน์โหลดมา หรือเลือกจากคลังที่ลิงก์ tv เปิด — จะไม่ถูกเลือก: Chute จะเปิดหน้า การกำหนดค่า พร้อมทำเครื่องหมาย รอดำเนินการ ไว้ที่รายการนั้น และมันจะกลายเป็นการกำหนดค่าที่รันอยู่ก็ต่อเมื่อคุณแตะ เสร็จสิ้น ลิงก์เช่นนี้จึงไม่เคยสลับการกำหนดค่าที่ Chute กำลังรันอยู่

ลิงก์ที่เปิดจากภายนอกแอปจะแปลงโปรไฟล์ Clash หรือ sing-box เหมือน ดาวน์โหลดจาก URL ในหน้า การกำหนดค่า และลิงก์เดียวกันที่สแกนในหน้านั้นด้วย ดาวน์โหลดจาก QR Code หรือในตัวช่วยตั้งค่าก็เช่นกัน มีเพียงตัวช่วยตั้งค่าเท่านั้นที่เก็บโปรไฟล์เนทีฟไว้เป็นการสมัครสมาชิก: เมื่อสแกนที่นั่น ลิงก์จะให้การกำหนดค่าที่แอปรีเฟรชทุก 86400 วินาที ขณะที่ลิงก์เดียวกันที่เปิดจากภายนอกแอปจะดาวน์โหลดไฟล์เพียงครั้งเดียวและแอปจะไม่รีเฟรชมันเลย

start, stop และ toggle ไม่ใช่การกระทำผ่าน URL บน Android แอประบบอัตโนมัติ (automation) ใช้ Broadcast Intent แทน: com.r3studio.chute.action.START_VPN, com.r3studio.chute.action.STOP_VPN และ com.r3studio.chute.action.TOGGLE_VPN

Broadcast ไม่สามารถแสดงกล่องยินยอม VPN ของระบบได้ ดังนั้น START_VPN จึงถูกทิ้งไปอย่างเงียบ ๆ เมื่อยังไม่เคยให้การยินยอม ส่วน TOGGLE_VPN จะเปิด Chute ขึ้นมาแทน: แตะสวิตช์ในแอปเพื่อให้การยินยอม — การแตะนั้นจะเริ่มทันเนลไปด้วย — และหลังจากนั้น Broadcast จะใช้งานได้ ในโหมดบริการ พร็อกซีท้องถิ่น ไม่มีการยินยอมใดให้ต้องให้ ทั้งสองคำสั่งจึงทำงานได้ทันที