🎭 MASQUE Config Generator

WARP MASQUE → Xray • MahsaNG • Happ • Streisand • Clash • Shadowrocket • MahsaNG •

A zero-install, single-page web tool that generates Cloudflare WARP MASQUE configs for the most popular proxy clients, in seconds.

🇬🇧 English · 🇮🇷 فارسی

🇬🇧 English

📖 Table of Contents

What is this?
What is MASQUE?
Features
Quick Start
Step-by-Step Guide
Settings Reference
Endpoints
Supported Clients
Output Formats
Testing Your Connection
Troubleshooting
Self-Hosting / Running Locally
Privacy & Security Notes
FAQ
Contributing
License
Disclaimer

✨ What is this?

MASQUE Config Generator is a lightweight, fully client-side web app (one index.html file, no build step, no backend of its own) that:

Requests a fresh WARP MASQUE account (private key, endpoint public key, tunnel IPv4 / IPv6) from a pool of public APIs, or lets you import an existing one.
Lets you tune every important parameter: client, transport, endpoint, port, SNI, DNS, fragment masking, noise, MTU, routing rules, and more.
Builds ready-to-use configs live and lets you copy or download them with one click.

No terminal, no manual JSON editing, no key conversion: open the page, press a button, paste the result into your client.

🔗 Live tool: https://darknessshade.github.io/Masque-Generator/

🧠 What is MASQUE?

MASQUE (Multiplexed Application Substrate over QUIC Encryption) is an IETF family of standards for tunneling traffic (UDP, IP, HTTP) through HTTP/3 and QUIC. Cloudflare WARP supports MASQUE as a tunnel protocol alongside WireGuard. Because MASQUE traffic looks like ordinary HTTPS / HTTP/3 traffic to a Cloudflare endpoint, it is a useful alternative where plain WireGuard handshakes are blocked or throttled.

This tool takes a WARP MASQUE account and wraps it into Xray-core outbounds (and Clash / Shadowrocket formats) so that you can use it from the clients you already have.

🚀 Features

Feature	Details
🔑 One-click key generation	Requests a new WARP MASQUE account from a pool of 4 public API workers
🔁 Automatic API failover	Every press uses the next API in the pool; if one fails (e.g. Cloudflare error 1015 rate limit) the next is tried automatically
✍️ Manual fallback	Open an API link yourself, copy the JSON, paste it; fields auto-fill
📥 usque JSON import	Import an existing key file generated by usque
🧩 Multi-client output	Xray / v2rayNG / v2rayN / Happ / Streisand / OneXray / Throne / Shadowrocket / Clash (Mihomo) / MahsaNG
🌐 Transport choice	H2 (TCP + TLS 1.2, default) or H3 (QUIC + TLS 1.3)
🔢 Up to 10 configs at once	Generates multiple outbounds in a single run
🎯 Rich endpoint library	Official IPv4/IPv6, random ranges, combined pools, ZeroTrust, third-party backups
🔌 Port selection	`8095`, `443`, `8443`, `4443`, `1701`, `4500`, `500`
🕶️ SNI masking	24 preset SNIs (Cloudflare, Microsoft, Apple, universities, CDNs, ...)
🧭 DNS presets	Cloudflare / Google / Quad9 in IPv4, IPv6 and mixed combos
🧱 Fragment masking	Optional toggle to help with DPI
📡 Noise (wnoise)	`quic`, `quicv1`, `quicinit`, `random` presets for MahsaNG
🗺️ Routing rules	Built-in Iran and China profiles; local sites go direct
⚡ H3-L4 low-latency mode	One-switch Clash preset
👀 Live preview	Output updates instantly as you change any setting
📋 Copy / Download	One-click copy to clipboard or download as a file
🌑 Responsive dark UI	Works on phones, tablets and desktops

⚡ Quick Start

Open https://darknessshade.github.io/Masque-Generator/
Press Generate new key.
Pick your client and tweak settings (defaults work fine).
Press Copy or Download.
Import the result into your client and connect.

That's it. 🎉

🧭 Step-by-Step Guide

Step 1: Generate a WARP MASQUE key

Click Generate new key. A new account is requested from the API pool.
The four API chips below the button show the pool status: next in line, used successfully, or failed.
The following fields are filled in automatically:
- Private key (base64)
- Endpoint public key
- Tunnel IPv4
- Tunnel IPv6
Use the trash button to clear everything, or the upload button to import a usque JSON file.

If you get rate-limited (for example Cloudflare error 1015):

The tool automatically tries the next API in the pool.
Wait a few minutes between many consecutive requests.
Or use the Manual option: open one of the API links in a new tab, copy the entire JSON shown, and paste it into the box. All fields fill in automatically.

Step 2: Choose settings

Select your client (by OS tab, then by app), then adjust the options. See the Settings Reference for what each one does. If you are not sure, keep the defaults.

Step 3: Copy or download the output

The live preview shows the exact config that will be exported.
Press Copy to put it on your clipboard, or Download to save a file.
Paste / import it into your client.

⚙️ Settings Reference

General

Setting	Options	Notes
Client	OS tabs → client list	Decides the output format and which extra options appear
Transport	H2 `TCP + TLS1.2` (default) · H3 `QUIC + TLS1.3`	H2 works over TCP. H3 requires UDP to be allowed on your network
Number of configs	1 – 10	For combined endpoints, half are IPv4 and half IPv6 (when both exist)
Routing rules	Iran (default) · China	Applies to Clash and v2rayNG / Happ / Streisand. Local sites go direct
Endpoint	See Endpoints	Single endpoint, random range, or a combined pool
Port	`8095` · `443` · `8443` · `4443` · `1701` · `4500` · `500`	Try another port if one is blocked
SNI masking	24 presets	Default: `www.cloudflare.com`
DNS	14 presets	Default: `1.1.1.1, 8.8.8.8`
Name (Shadowrocket)	Free text	Default: `WARP-MASQUE`
Include tunnel IPv6 address	On / Off	Turn off if your tunnel address is IPv4-only
Fragment masking	On / Off (default off)	Turn off if requests fail or you see a `Mask` error

Clash options

Setting	Notes
Rules source (Geo)	Choose where geo rule data comes from
H3-L4 mode (low latency)	Forces a fixed SNI, DoH DNS and UDP off. Uses H3

MahsaNG options

Setting	Notes
Output	`masque://` links (one per line) or full JSON configs
Noise (wnoise)	`none` · `quic` · `quicv1` · `quicinit` · `random`. When enabled: count `15`, delay `1-2`, payload size `5-10`
MTU	Default `1280`
Keep alive	Default `5`

🎯 Endpoints

The endpoint dropdown groups everything in one place.

Random ranges (generated per selection)

Option	Range
Range IPv4 (default)	`162.159.198.0/24`
Range IPv6	`2606:4700:103::/64`
Range IPv4 + IPv6	Both of the above

Random picks stay the same until you regenerate the key or change the selection.

Combined pools

Option	Contents
Combined: IPv4 + IPv6	Official IPv4 + IPv6, plus US / Germany / Finland IPv6 and backup hosts
Combined: IPv6 only	Official IPv6 + regional IPv6 + IPv6 backups
Combined: IPv4 (official only)	`162.159.198.2`, `162.159.199.2`
Combined: IPv4 (incl. third-party)	Official IPv4 + IPv4 backup hosts
Combined: ZeroTrust only	Endpoints for ZeroTrust accounts only

Single endpoints

Official IPv4: 162.159.198.2 (primary), 162.159.199.2 (backup)
Official IPv6: 2606:4700:103::2 (primary), 2606:4700:104::2 (backup)
Third-party backups: masque1.bestcf.eu.cc and masque2.bestcf.eu.cc (IPv4), masque3.bestcf.eu.cc and masque4.bestcf.eu.cc (IPv6)
Regional IPv6 hosts: United States, Germany, Finland

⚠️ Official endpoints are recommended. Third-party endpoints are provided as a convenience only. See Privacy & Security Notes.

📱 Supported Clients

The generator targets the following clients (also reflected in the repository topics):

Family	Clients
Xray-core based	v2rayNG, v2rayN, Happ, Streisand, OneXray, Throne
Iran-focused Xray build	MahsaNG
Apple	Shadowrocket
Clash / Mihomo (Meta)	Clash Meta / Mihomo-based clients

The page also has a collapsible Clients section at the bottom with per-OS download links.

💡 Always use the latest Xray core and the latest version of your client. Older cores may not understand the MASQUE outbound and some clients may be incompatible.

📦 Output Formats

Client type	Output
Xray-based desktop clients	JSON with `log` + `outbounds`
Xray-based mobile clients	JSON array of full configs, each with DNS (hosts + servers), a `mixed` inbound on port `10808`, routing rules (geo-based direct rules for private / local traffic, UDP/443 blocked), `metrics` on `127.0.0.1:10812`, and outbound traffic stats
Clash (Mihomo)	Full YAML profile with proxies, `url-test` / `fallback` / `select` proxy groups, rule providers (MetaCubeX `meta-rules-dat`, ACL4SSR AI list), sniffer, TUN settings, fake-ip DNS, and optional chain-proxy providers
Shadowrocket	Node using your chosen name (default `WARP-MASQUE`)
MahsaNG	`masque://` links (one per line) or JSON configs

Config names carry the suffix MASQUE Nav plus an endpoint label (for example Official, Official IPv6, Backup, US IPv6) so you can tell nodes apart at a glance.

🧪 Testing Your Connection

Open the Cloudflare trace page through the proxy:

https://cloudflare.com/cdn-cgi/trace

Look for warp=on in the response. This is also the default latency-test URL used in the generated Clash profile.

🛠️ Troubleshooting

Problem	Fix
"Generate new key" fails / rate limit (`1015`)	Press again (next API is used automatically), wait a few minutes, or use the Manual option
Config imports but no traffic	Update your client and Xray core to the latest version
Requests fail or a `Mask` error appears	Turn Fragment masking OFF
H3 does not connect	Your network may block UDP. Switch Transport to H2
Specific endpoint is blocked	Try another endpoint, another port (`443`, `8443`, `4443`, ...) or a different SNI
IPv6 not working	Turn Include tunnel IPv6 address OFF, or pick an IPv4-only endpoint set
Slow / unstable	Try H3-L4 mode (Clash), lower MTU, or generate several configs and test them
Clash rule providers don't load	Pick a different Rules source (Geo)

💻 Self-Hosting / Running Locally

The whole project is one static file, so hosting is trivial.

# 1. Clone
git clone https://github.com/DarknessShade/Masque-Generator.git
cd Masque-Generator

# 2. Serve it (any static server works)
python3 -m http.server 8080
# or
npx serve .

Then open http://localhost:8080.

Deploy your own copy on GitHub Pages:

Fork this repository.
Go to Settings → Pages.
Set the source to the main branch, root folder.
Your copy goes live at https://<your-username>.github.io/Masque-Generator/.

ℹ️ Key generation calls public API workers from the browser, so you need internet access for Step 1. Importing an existing key and generating configs works from the page itself.

🔒 Privacy & Security Notes

🧩 The page is a static single-file app: there is no server-side component belonging to this project, and generated configs are built in your browser.
🌐 Key generation is the exception. When you press Generate new key, your browser contacts the public API pool to register a WARP MASQUE account. Those services are third-party. If you want full control, generate your own key with usque and use the import button instead.
🔑 Treat your private key like a password. Do not post generated configs publicly.
✅ Use official endpoints and official clients whenever possible. Third-party endpoints and resources may cause privacy leaks or losses.
🆓 This tool and its configs are free. Beware of anyone selling them, and share the link with your friends instead.

❓ FAQ

Is this free?

Yes, completely. The tool is MIT-licensed and free to use.

Do I need to install anything?

No. Open the web page, generate, copy. You only need a compatible client with an up-to-date Xray core (or Clash / Mihomo, Shadowrocket, MahsaNG).

H2 or H3?

Start with H2 (default, runs over TCP and works almost everywhere). Try H3 if your network allows UDP and you want QUIC's performance characteristics.

Which endpoint should I pick?

The default random range inside 162.159.198.0/24 is a good start. If it is blocked, try IPv6, combined pools, other ports or another SNI.

Can I use my own key?

Yes. Paste the fields manually or use the import button with a usque JSON file.

What are the ZeroTrust endpoints?

A dedicated set of endpoints for Cloudflare ZeroTrust MASQUE accounts. Use them only if your account is a ZeroTrust account.

How many configs can I generate at once?

Up to 10. With combined endpoints, half are IPv4 and half IPv6 when both exist.

📄 License

🇮🇷 فارسی

📖 فهرست مطالب

این پروژه چیست؟
MASQUE چیست؟
امکانات
شروع سریع
راهنمای گام‌به‌گام
راهنمای تنظیمات
اندپوینت‌ها
کلاینت‌های پشتیبانی‌شده
فرمت‌های خروجی
تست اتصال
رفع مشکلات رایج
اجرای محلی و میزبانی شخصی
نکات حریم خصوصی و امنیت
پرسش‌های متداول
مشارکت
مجوز
سلب مسئولیت

✨ این پروژه چیست؟

MASQUE Config Generator یک ابزار وب سبک و کاملاً سمت‌کاربر است (فقط یک فایل index.html، بدون نیاز به build و بدون بک‌اند اختصاصی) که:

۱. یک اکانت جدید WARP MASQUE (کلید خصوصی، کلید عمومی اندپوینت، آی‌پی تونل IPv4 و IPv6) را از مجموعه‌ای از APIهای عمومی می‌گیرد، یا به شما اجازه می‌دهد اکانت موجودتان را وارد کنید.

۲. همه پارامترهای مهم را در اختیارتان می‌گذارد: کلاینت، نوع ترنسپورت، اندپوینت، پورت، SNI، DNS، فرگمنت، نویز، MTU، قوانین مسیریابی و بیشتر.

۳. کانفیگ آماده را به‌صورت زنده می‌سازد و با یک کلیک می‌توانید کپی یا دانلودش کنید.

بدون ترمینال، بدون ویرایش دستی JSON، بدون تبدیل کلید: صفحه را باز کنید، یک دکمه بزنید، نتیجه را در کلاینت‌تان وارد کنید.

🔗 ابزار آنلاین: https://darknessshade.github.io/Masque-Generator/

🧠 MASQUE چیست؟

MASQUE (مخفف Multiplexed Application Substrate over QUIC Encryption) مجموعه‌ای از استانداردهای IETF برای تونل‌کردن ترافیک (UDP، IP و HTTP) از طریق HTTP/3 و QUIC است. Cloudflare WARP در کنار WireGuard، پروتکل MASQUE را هم به‌عنوان تونل پشتیبانی می‌کند. از آنجا که ترافیک MASQUE برای اندپوینت Cloudflare شبیه ترافیک عادی HTTPS / HTTP/3 دیده می‌شود، در شبکه‌هایی که هندشیک ساده WireGuard مسدود یا محدود شده، جایگزین مفیدی است.

این ابزار یک اکانت WARP MASQUE را به outbound برای Xray-core (و فرمت‌های Clash و Shadowrocket) تبدیل می‌کند تا بتوانید از کلاینت‌هایی که همین حالا دارید استفاده کنید.

🚀 امکانات

امکان	توضیحات
🔑 ساخت کلید با یک کلیک	درخواست اکانت جدید WARP MASQUE از مجموعه ۴ API عمومی
🔁 جایگزینی خودکار API	با هر بار فشردن دکمه، API بعدی استفاده می‌شود؛ اگر یکی خطا بدهد (مثلاً محدودیت 1015 کلودفلر)، خودکار API بعدی امتحان می‌شود
✍️ روش دستی	لینک API را خودتان باز کنید، JSON را کپی و اینجا پیست کنید؛ فیلدها خودکار پر می‌شوند
📥 ایمپورت فایل usque	وارد کردن فایل کلید ساخته‌شده با usque
🧩 خروجی چندکلاینتی	Xray / v2rayNG / v2rayN / Happ / Streisand / OneXray / Throne / Shadowrocket / Clash (Mihomo) / MahsaNG
🌐 انتخاب ترنسپورت	H2 (‏TCP + TLS 1.2، پیش‌فرض) یا H3 (‏QUIC + TLS 1.3)
🔢 تا ۱۰ کانفیگ هم‌زمان	ساخت چند outbound در یک بار اجرا
🎯 کتابخانه غنی اندپوینت	آی‌پی‌های رسمی IPv4/IPv6، رنج‌های تصادفی، مجموعه‌های ترکیبی، ZeroTrust و بکاپ‌های شخص ثالث
🔌 انتخاب پورت	`8095`، `443`، `8443`، `4443`، `1701`، `4500`، `500`
🕶️ ماسک SNI	۲۴ SNI آماده (Cloudflare، Microsoft، Apple، دانشگاه‌ها، CDNها و ...)
🧭 پریست DNS	Cloudflare / Google / Quad9 به‌صورت IPv4، IPv6 و ترکیبی
🧱 ماسک فرگمنت	کلید اختیاری برای کمک به عبور از DPI
📡 نویز (wnoise)	پریست‌های `quic`، `quicv1`، `quicinit` و `random` برای MahsaNG
🗺️ قوانین مسیریابی	پروفایل آماده ایران و چین؛ سایت‌های داخلی مستقیم باز می‌شوند
⚡ حالت H3-L4 با تأخیر کم	پریست یک‌کلیکی برای Clash
👀 پیش‌نمایش زنده	خروجی با تغییر هر تنظیم فوراً به‌روز می‌شود
📋 کپی / دانلود	کپی یک‌کلیکی در کلیپ‌بورد یا دانلود به‌صورت فایل
🌑 رابط تیره و واکنش‌گرا	روی موبایل، تبلت و دسکتاپ به‌خوبی کار می‌کند

⚡ شروع سریع

۱. صفحه https://darknessshade.github.io/Masque-Generator/ را باز کنید.

۲. روی Generate new key بزنید.

۳. کلاینت خود را انتخاب کنید و در صورت نیاز تنظیمات را تغییر دهید (مقادیر پیش‌فرض معمولاً کافی‌اند).

۴. دکمه Copy یا Download را بزنید.

۵. خروجی را در کلاینت‌تان وارد کنید و وصل شوید.

همین! 🎉

🧭 راهنمای گام‌به‌گام

گام ۱: ساخت کلید WARP MASQUE

روی Generate new key کلیک کنید. یک اکانت جدید از مجموعه APIها درخواست می‌شود.
چهار چیپ API زیر دکمه، وضعیت مجموعه را نشان می‌دهند: نوبت بعدی، استفاده‌شده با موفقیت، یا ناموفق.
فیلدهای زیر به‌صورت خودکار پر می‌شوند:
- Private key (base64): کلید خصوصی
- Endpoint public key: کلید عمومی اندپوینت
- Tunnel IPv4: آی‌پی تونل نسخه ۴
- Tunnel IPv6: آی‌پی تونل نسخه ۶
دکمه سطل زباله همه‌چیز را پاک می‌کند و دکمه آپلود برای وارد کردن فایل usque JSON است.

اگر با محدودیت (Rate limit) مواجه شدید (مثلاً خطای 1015 کلودفلر):

ابزار خودکار API بعدی را امتحان می‌کند.
بین درخواست‌های پشت‌سرهم چند دقیقه صبر کنید.
یا از Manual option استفاده کنید: یکی از لینک‌های API را در تب جدید باز کنید، کل JSON نمایش‌داده‌شده را کپی کنید و در کادر پیست کنید. تمام فیلدها خودکار پر می‌شوند.

گام ۲: انتخاب تنظیمات

کلاینت خود را انتخاب کنید (اول تب سیستم‌عامل، بعد خود برنامه) و سپس گزینه‌ها را تنظیم کنید. توضیح هر گزینه در بخش راهنمای تنظیمات آمده است. اگر مطمئن نیستید، مقادیر پیش‌فرض را نگه دارید.

گام ۳: کپی یا دانلود خروجی

پیش‌نمایش زنده دقیقاً همان کانفیگی را نشان می‌دهد که خروجی گرفته می‌شود.
با Copy در کلیپ‌بورد کپی کنید یا با Download به‌صورت فایل ذخیره کنید.
آن را در کلاینت خود پیست / ایمپورت کنید.

⚙️ راهنمای تنظیمات

تنظیمات عمومی

تنظیم	گزینه‌ها	توضیحات
Client (کلاینت)	تب سیستم‌عامل ← لیست کلاینت‌ها	فرمت خروجی و گزینه‌های اضافی را تعیین می‌کند
Transport (ترنسپورت)	H2 ‏`TCP + TLS1.2` (پیش‌فرض) · H3 ‏`QUIC + TLS1.3`	H2 روی TCP کار می‌کند. H3 نیاز دارد UDP در شبکه‌تان آزاد باشد
Number of configs (تعداد کانفیگ)	۱ تا ۱۰	در اندپوینت‌های ترکیبی، نیمی IPv4 و نیمی IPv6 است (اگر هر دو موجود باشند)
Routing rules (قوانین مسیریابی)	Iran (پیش‌فرض) · China	روی Clash و v2rayNG / Happ / Streisand اعمال می‌شود. سایت‌های داخلی مستقیم باز می‌شوند
Endpoint (اندپوینت)	بخش اندپوینت‌ها	تکی، رنج تصادفی یا مجموعه ترکیبی
Port (پورت)	`8095` · `443` · `8443` · `4443` · `1701` · `4500` · `500`	اگر یک پورت بسته بود، پورت دیگری را امتحان کنید
SNI masking	۲۴ پریست	پیش‌فرض: `www.cloudflare.com`
DNS	۱۴ پریست	پیش‌فرض: `1.1.1.1, 8.8.8.8`
Name (Shadowrocket)	متن آزاد	پیش‌فرض: `WARP-MASQUE`
Include tunnel IPv6 address	روشن / خاموش	اگر آی‌پی تونل شما فقط IPv4 دارد، خاموش کنید
Fragment masking	روشن / خاموش (پیش‌فرض خاموش)	اگر درخواست‌ها شکست خورد یا خطای `Mask` دیدید، خاموش کنید

گزینه‌های Clash

تنظیم	توضیحات
Rules source (Geo)	منبع داده‌های قوانین جغرافیایی را انتخاب کنید
H3-L4 mode (low latency)	SNI ثابت، DNS از نوع DoH و UDP خاموش را اعمال می‌کند. از H3 استفاده می‌کند

گزینه‌های MahsaNG

تنظیم	توضیحات
Output (خروجی)	لینک‌های `masque://` (هر خط یکی) یا کانفیگ کامل JSON
Noise (wnoise)	`none` · `quic` · `quicv1` · `quicinit` · `random`. در صورت فعال بودن: تعداد `15`، تأخیر `1-2`، اندازه payload برابر `5-10`
MTU	پیش‌فرض `1280`
Keep alive	پیش‌فرض `5`

🎯 اندپوینت‌ها

منوی اندپوینت همه گزینه‌ها را یک‌جا دسته‌بندی کرده است.

رنج‌های تصادفی (به ازای هر انتخاب ساخته می‌شود)

گزینه	رنج
Range IPv4 (پیش‌فرض)	`162.159.198.0/24`
Range IPv6	`2606:4700:103::/64`
Range IPv4 + IPv6	هر دو مورد بالا

آی‌پی‌های تصادفی تا وقتی کلید را دوباره نسازید یا انتخاب را عوض نکنید، ثابت می‌مانند.

مجموعه‌های ترکیبی

گزینه	محتوا
Combined: IPv4 + IPv6	آی‌پی‌های رسمی IPv4 و IPv6، به‌علاوه IPv6 آمریکا / آلمان / فنلاند و میزبان‌های بکاپ
Combined: IPv6 only	IPv6 رسمی + IPv6 منطقه‌ای + بکاپ‌های IPv6
Combined: IPv4 (official only)	‏`162.159.198.2` و `162.159.199.2`
Combined: IPv4 (incl. third-party)	IPv4 رسمی + میزبان‌های بکاپ IPv4
Combined: ZeroTrust only	فقط اندپوینت‌های مخصوص اکانت‌های ZeroTrust

اندپوینت‌های تکی

IPv4 رسمی: ‏162.159.198.2 (اصلی)، 162.159.199.2 (پشتیبان)
IPv6 رسمی: ‏2606:4700:103::2 (اصلی)، 2606:4700:104::2 (پشتیبان)
بکاپ‌های شخص ثالث: ‏masque1.bestcf.eu.cc و masque2.bestcf.eu.cc (برای IPv4)، masque3.bestcf.eu.cc و masque4.bestcf.eu.cc (برای IPv6)
میزبان‌های IPv6 منطقه‌ای: آمریکا، آلمان، فنلاند

⚠️ استفاده از اندپوینت‌های رسمی توصیه می‌شود. اندپوینت‌های شخص ثالث فقط برای راحتی ارائه شده‌اند. بخش نکات حریم خصوصی و امنیت را ببینید.

📱 کلاینت‌های پشتیبانی‌شده

این ابزار کلاینت‌های زیر را هدف قرار می‌دهد (در تاپیک‌های ریپو هم آمده است):

دسته	کلاینت‌ها
مبتنی بر Xray-core	v2rayNG، v2rayN، Happ، Streisand، OneXray، Throne
نسخه Xray متمرکز بر ایران	MahsaNG
اپل	Shadowrocket
Clash / Mihomo (Meta)	کلاینت‌های مبتنی بر Clash Meta / Mihomo

در پایین صفحه یک بخش جمع‌شونده به نام Clients هم وجود دارد که لینک دانلود هر سیستم‌عامل را نشان می‌دهد.

💡 همیشه از آخرین نسخه هسته Xray و آخرین نسخه کلاینت خود استفاده کنید. هسته‌های قدیمی ممکن است outbound مربوط به MASQUE را نشناسند و بعضی کلاینت‌ها ممکن است ناسازگار باشند.

📦 فرمت‌های خروجی

نوع کلاینت	خروجی
کلاینت‌های دسکتاپ مبتنی بر Xray	فایل JSON شامل `log` و `outbounds`
کلاینت‌های موبایل مبتنی بر Xray	آرایه JSON از کانفیگ‌های کامل؛ هر کدام شامل DNS (هاست‌ها و سرورها)، یک inbound از نوع `mixed` روی پورت `10808`، قوانین مسیریابی (ترافیک خصوصی و داخلی مستقیم، UDP/443 مسدود)، بخش `metrics` روی `127.0.0.1:10812` و آمار ترافیک outbound
Clash (Mihomo)	پروفایل کامل YAML شامل پروکسی‌ها، گروه‌های `url-test` / `fallback` / `select`، rule providerها (‏MetaCubeX `meta-rules-dat` و لیست AI از ACL4SSR)، sniffer، تنظیمات TUN، DNS از نوع fake-ip و پرووایدرهای اختیاری chain-proxy
Shadowrocket	یک نود با نامی که انتخاب می‌کنید (پیش‌فرض `WARP-MASQUE`)
MahsaNG	لینک‌های `masque://` (هر خط یکی) یا کانفیگ JSON

نام کانفیگ‌ها پسوند MASQUE Nav و برچسب اندپوینت (مثل Official، Official IPv6، Backup، US IPv6) دارد تا نودها را راحت از هم تشخیص دهید.

🧪 تست اتصال

صفحه trace کلودفلر را از طریق پروکسی باز کنید:

https://cloudflare.com/cdn-cgi/trace

در پاسخ دنبال warp=on بگردید. همین آدرس، آدرس تست تأخیر پیش‌فرض در پروفایل Clash تولیدشده هم هست.

🛠️ رفع مشکلات رایج

مشکل	راه‌حل
دکمه «Generate new key» خطا می‌دهد / محدودیت (`1015`)	دوباره بزنید (API بعدی خودکار استفاده می‌شود)، چند دقیقه صبر کنید یا از Manual option استفاده کنید
کانفیگ وارد می‌شود ولی ترافیک رد نمی‌شود	کلاینت و هسته Xray را به آخرین نسخه به‌روز کنید
درخواست‌ها شکست می‌خورند یا خطای `Mask` می‌آید	Fragment masking را خاموش کنید
H3 وصل نمی‌شود	احتمالاً شبکه‌تان UDP را مسدود کرده. ترنسپورت را روی H2 بگذارید
یک اندپوینت خاص بسته است	اندپوینت، پورت (`443`، `8443`، `4443` و ...) یا SNI دیگری را امتحان کنید
IPv6 کار نمی‌کند	گزینه Include tunnel IPv6 address را خاموش کنید یا مجموعه اندپوینت فقط IPv4 انتخاب کنید
کند یا ناپایدار است	حالت H3-L4 (در Clash) را امتحان کنید، MTU را کمتر کنید یا چند کانفیگ بسازید و تست کنید
rule providerهای Clash بارگذاری نمی‌شوند	یک Rules source (Geo) دیگر انتخاب کنید

💻 اجرای محلی و میزبانی شخصی

کل پروژه یک فایل استاتیک است، پس میزبانی‌اش خیلی ساده است.

# 1. Clone
git clone https://github.com/DarknessShade/Masque-Generator.git
cd Masque-Generator

# 2. Serve it (any static server works)
python3 -m http.server 8080
# or
npx serve .

سپس http://localhost:8080 را باز کنید.

ساخت نسخه شخصی روی GitHub Pages:

۱. این ریپو را Fork کنید.

۲. به Settings ← Pages بروید.

۳. منبع را روی شاخه main و پوشه root بگذارید.

۴. نسخه شما در آدرس https://<your-username>.github.io/Masque-Generator/ فعال می‌شود.

ℹ️ ساخت کلید از مرورگر به APIهای عمومی درخواست می‌زند، بنابراین برای گام ۱ به اینترنت نیاز دارید. وارد کردن کلید موجود و ساخت کانفیگ‌ها خود صفحه انجام می‌دهد.

🔒 نکات حریم خصوصی و امنیت

🧩 صفحه یک اپلیکیشن استاتیک تک‌فایلی است: هیچ بخش سمت‌سرور متعلق به این پروژه وجود ندارد و کانفیگ‌ها داخل مرورگر شما ساخته می‌شوند.
🌐 ساخت کلید استثناست. وقتی Generate new key را می‌زنید، مرورگرتان برای ثبت یک اکانت WARP MASQUE به مجموعه APIهای عمومی وصل می‌شود. این سرویس‌ها متعلق به اشخاص ثالث هستند. اگر کنترل کامل می‌خواهید، کلید خودتان را با usque بسازید و با دکمه import وارد کنید.
🔑 کلید خصوصی را مثل رمز عبور حفظ کنید. کانفیگ‌های ساخته‌شده را علنی منتشر نکنید.
✅ تا جای ممکن از اندپوینت‌ها و کلاینت‌های رسمی استفاده کنید. منابع و اندپوینت‌های شخص ثالث ممکن است باعث نشت حریم خصوصی یا ضرر شوند.
🆓 این ابزار و کانفیگ‌هایش رایگان است. مراقب فروشندگان و کلاهبرداران باشید و به‌جای آن لینک را برای دوستانتان بفرستید.

❓ پرسش‌های متداول

آیا رایگان است؟

بله، کاملاً. این ابزار با مجوز MIT منتشر شده و استفاده از آن رایگان است.

نیاز به نصب چیزی دارم؟

خیر. صفحه را باز کنید، کانفیگ بسازید و کپی کنید. فقط به یک کلاینت سازگار با هسته Xray به‌روز (یا Clash / Mihomo، Shadowrocket، MahsaNG) نیاز دارید.

H2 یا H3؟

با H2 شروع کنید (پیش‌فرض است، روی TCP کار می‌کند و تقریباً همه‌جا جواب می‌دهد). اگر شبکه‌تان UDP را آزاد می‌گذارد و ویژگی‌های QUIC را می‌خواهید، H3 را امتحان کنید.

کدام اندپوینت را انتخاب کنم؟

رنج تصادفی پیش‌فرض داخل 162.159.198.0/24 نقطه شروع خوبی است. اگر مسدود بود، IPv6، مجموعه‌های ترکیبی، پورت‌های دیگر یا SNI دیگری را امتحان کنید.

می‌توانم از کلید خودم استفاده کنم؟

بله. فیلدها را دستی پر کنید یا با دکمه import فایل usque JSON را وارد کنید.

اندپوینت‌های ZeroTrust چیستند؟

مجموعه‌ای اختصاصی برای اکانت‌های Cloudflare ZeroTrust با MASQUE. فقط اگر اکانت شما از نوع ZeroTrust است از آن‌ها استفاده کنید.

هم‌زمان چند کانفیگ می‌توانم بسازم؟

تا ۱۰ کانفیگ. در اندپوینت‌های ترکیبی، اگر هر دو نوع موجود باشد، نیمی IPv4 و نیمی IPv6 خواهد بود.

📄 مجوز

Made with ❤️ by DarknessShade

⭐ If this tool helped you, consider giving the repo a star!

⭐ اگر این ابزار برایتان مفید بود، به ریپو ستاره بدهید!

Name		Name	Last commit message	Last commit date
LICENSE		LICENSE
README.md		README.md
index.html		index.html

Latest commit

History

Folders and files

Repository files navigation