Alex-Devera/3x-ui
1
0
Fork 0
mirror of https://github.com/MHSanaei/3x-ui.git synced 2026-06-06 21:24:10 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
3x-ui/docs/Tasktracking/2026-04-25-user-panel-url-schemes.md
root 3ba7e43bc3 feat: add URL Schemes for Quick Import buttons (Android/iOS/Desktop) 
- Android: clash://install-config (Clash Meta for Android)
- iOS: shadowrocket://add/sub/ (Shadowrocket)
- Desktop: clash-verge://install-config (Clash Verge)
- Extended API to return subEnable/subUrl for standard subscription
2026-04-25 22:46:35 +08:00

1.3 KiB
Raw Blame History

2026-04-25 — User Panel: Quick Import URL Schemes

Summary

Wired up the 3 Quick Import dropdown buttons (Android/iOS/Desktop) with deep link URL schemes to launch proxy client apps directly from the user panel.

Changes

Backend (web/controller/inbound.go)

  • Extended getUserSubscriptions API to also return subEnable and subUrl (standard subscription URL)
  • Previously only returned subClashEnable and subClashUrl

Frontend (web/html/user.html)

  • Added subEnable and subUrl data fields
  • Updated loadSubscriptions() to save the new fields
  • Added 3 URL scheme methods:
    • Android → clash://install-config?url=<encoded_url> (Clash Meta for Android)
    • iOS → shadowrocket://add/sub/<base64_url>?remark=<name> (Shadowrocket)
    • Desktop → clash-verge://install-config?url=<encoded_url>&name=<name> (Clash Verge)
  • Added @click handlers on the 3 dropdown menu items
  • Each method validates subscription availability before opening the URL scheme

URL Scheme Priority

  • Android/Desktop: prefers Clash URL (subClashUrl), falls back to standard URL (subUrl)
  • iOS (Shadowrocket): prefers standard URL (subUrl), falls back to Clash URL

Files Modified

  • web/controller/inbound.go — extended API response with subEnable/subUrl
  • web/html/user.html — added URL scheme methods and click handlers