KJGX66F/usque-custom-pro

What it solves

Usque MASQUE Pro is a visual tool designed to simplify the complex process of registering and configuring Cloudflare WARP / MASQUE. It eliminates the need for manual registration, complex field editing in YAML or JSON files, and the manual creation of configurations for various proxy clients.

How it works

The tool operates as a web application that can be deployed on Cloudflare Pages or Workers. It handles the registration process by interacting with Cloudflare's WARP registration API via a relay worker.

Key technical steps include:

• Local Key Generation: P-256 MASQUE private keys are generated locally in the browser using WebCrypto to ensure security.
• Configuration Management: It generates a config.json file which serves as the single source of truth for the user's device credentials.
• Node Generation: It creates multiple MASQUE candidate nodes by combining a single set of credentials with various endpoints and ports, allowing users to find the most stable connection.
• Client Conversion: It converts these settings into formats compatible with Clash/Mihomo, Shadowrocket, sing-box, and local VLESS bridges.

Who it’s for

• Users new to Usque / MASQUE who want a visual interface instead of command-line tools.
• People who want to avoid manual editing of complex configuration files.
• Users needing to generate a large number of MASQUE candidate nodes for speed testing and selection.
• Users who want intelligent traffic splitting (smart routing) for services like ChatGPT, YouTube, and Netflix.

Highlights

• One-Click Registration: Handles WARP device registration and MASQUE key enrollment in the browser.
• Multi-Client Support: Generates configurations for Clash, Mihomo, Shadowrocket, and sing-box.
• Smart Routing: Includes pre-configured rules for AI and streaming services using MetaCubeX MRS rule sets.
• Flexible Node Generation: Supports generating between 13 and 500 candidate nodes using QUIC/H3 or H2/TCP.
• Local VLESS Bridge: Provides a way to bridge MASQUE to VLESS for local use.
• Egress Detection: An advanced feature to detect the actual exit IP and country of different MASQUE nodes via the Mihomo API.