github IRNova/Nova-Proxy V3.7

latest releases: v4.5.5, v4.5.4, v4.5.2...
one month ago

Nova Proxy V3.7.0

🚀 Release Notes — v3.7.0 📅 Release Date: 2026-06-18

✨ Overview

Version 3.7.0 is a major reliability-and-usability release focused on Backend mode (forwarding to your own Xray/sing-box VPS to unlock VMess and working voice/video calls), a much smoother install experience, and a long list of fixes that came directly from real-world use in Iran. It keeps everything from V3.0–3.6 and adds a guided, near-zero-friction backend setup, automatic UUID matching, a one-line VPS installer that prints a ready-to-paste link, and a critical fix for connections that previously dropped after about ten seconds. The bilingual English/Persian dashboard is carried forward and polished for readability.

✨ New Features

🛰 Backend Mode (Xray / sing-box forwarding)

Forward all proxy traffic to your own VPS instead of terminating it in the Worker — the only way to get VMess and working voice/video calls (UDP). Includes a full in-panel workflow: enable, paste the Backend URL, run a real Health check, and a ready-to-use client QR/link.

⚡ One-Line VPS Installer (nova-backend.sh)

A single command installs Xray, writes the config, opens the firewall, and prints the exact Backend URL to paste into the panel. Hosted at IRNova/Tools. Your VPS credentials never leave your server.

🔑 Automatic UUID Matching

The panel's Quick-install command now bakes in the panel's own UUID (NOVA_UUID=…), so the backend always matches the panel automatically — no manual sed step, no "random UUID won't match" problem.

🌐 Guided Domain Prompt + Ready-to-Paste Link

During install the script asks for your gray-cloud domain, then prints one complete Backend URL you simply paste — nothing to edit. Fully unattended installs are supported via NOVA_DOMAIN.

🔌 In-Panel Port Picker with Validation

Choose the backend port interactively during install, validated against Cloudflare's allowed ports (8080, 8880, 2052, 2082, 2086, 2095 for HTTP). Invalid ports (e.g. 2076, 3080, 10000) are rejected before they can cause a silent failure. A matching live warning appears in the panel if a bad port is entered in the Backend URL field.

🛠 In-Panel "Change Port / Remove Backend"

A new section in the Backend card gives copy-able commands to change the port (reinstall) or fully remove Xray from the VPS — no need to leave the panel or read a separate guide.

📱 Health-Gated Client QR

The ready-to-use client QR/link now appears only after a successful Health check, so you never get a config for a backend that isn't actually reachable. It hides again if you change the URL until you re-verify.

🌍 Browser Auto-Installer + Desktop Wizard

Install Nova to your own Cloudflare account from a browser (paste a token) or a local desktop wizard (OAuth login) — it creates the database, deploys the Worker, and waits for it to come online. You set your own admin password on first visit to /install.

🐛 Fixes & Improvements

🔧 Connections No Longer Drop After ~10 Seconds (critical)

Fixed the Backend-mode relay so the Worker stays alive for the entire session. Previously the outbound relay socket was a subrequest tied to the request lifetime, so Cloudflare reclaimed the isolate ~10 seconds after the response returned — dropping every connection at once. The relay now holds the invocation open with waitUntil until the client disconnects, with a 2-minute idle watchdog to release abandoned sessions.

🔐 Admin Password No Longer Auto-Set

The installers no longer bind KEY/UUID/ADMIN as a hidden password. The Worker now correctly sends you to /install to choose your own password; it auto-generates its encryption key and node UUID on its own.

💾 Backend Settings Auto-Save

Enabling backend mode, editing the Backend URL, or running Health check now saves automatically — no more "looks broken until you find the Save button." The manual Save still works.

🖥️ Readiness Check After Install

The web installer waits for the new address to come online (Cloudflare can take 1–3 minutes to make a fresh Worker live worldwide) instead of leaving you on an error.

🧹 Backend QR Clears on Removal

Clearing the Backend URL or turning backend mode off now removes the client QR/link immediately, instead of leaving a stale QR until reload.

🎨 Light-Theme Readability

Fixed low-contrast text in light mode (warnings, hints, status messages now meet WCAG AA). Dark mode unchanged.

🚫 Removed Unnecessary Root-Password Prompt

The VPS installer no longer interrupts the flow to ask about changing the root password.

🔡 DoH POST Fix

DNS-over-HTTPS wire-format (RFC 8484) POST requests to /dns-query are handled correctly again, before any backend forward.

🧭 Clearer Setup Checklist & Raw-IP Guidance

The Backend card and guides now spell out the gray-cloud (DNS-only) domain requirement, the allowed-port list, and the exact reasons a backend can be unreachable (raw IP → 403, same-account loop → 522).

📁 Worker Files

worker.js — single obfuscated Worker built with string-array obfuscation and browser-no-eval to help avoid Cloudflare Error 1101. The cloudflare:sockets import is preserved. The dashboard is served from the repository public/ directory (or via an ASSETS binding) and is not embedded in the Worker.

📝 Deployment Notes

  • Deploy worker.js to your Worker, and serve the dashboard from public/ (via GitHub raw) or bundle it as ASSETS.
  • The backend installer lives in the IRNova/Tools repository: nova-backend.sh.
  • Backend mode is optional — normal free in-Worker mode (VLESS/Trojan) works without a VPS.
  • After deploying, open your Worker URL → /install to set your admin password.
  • All V3.0–3.6 functionality is retained; nothing is removed in this release.

🇮🇷 یادداشت انتشار — نسخه ۳.۷.۰

📅 تاریخ انتشار: ۱۴۰۵/۰۳/۲۸

✨ خلاصه

نسخه ۳.۷.۰ یک انتشار مهم در زمینهٔ پایداری و تجربهٔ کاربری است که روی حالت Backend (ارسال ترافیک به سرور Xray/sing-box خودت برای فعال‌سازی VMess و تماس صوتی/تصویری)، فرایند نصب بسیار ساده‌تر، و مجموعه‌ای از رفع‌ اشکال‌ها که مستقیماً از استفادهٔ واقعی در ایران به‌دست آمده، تمرکز دارد. همهٔ قابلیت‌های نسخه‌های ۳.۰ تا ۳.۶ حفظ شده و راه‌اندازی backend تقریباً بدون دردسر، تطبیق خودکار UUID، نصب‌کنندهٔ تک‌خطی که یک لینک آمادهٔ جای‌گذاری چاپ می‌کند، و رفع یک ایراد مهم که قبلاً اتصال‌ها بعد از حدود ده ثانیه قطع می‌شدند، اضافه شده است. پنل دوزبانهٔ انگلیسی/فارسی حفظ و برای خوانایی بهتر بهبود یافته است.

✨ امکانات جدید

🛰 حالت Backend (ارسال به Xray / sing-box)

ارسال تمام ترافیک پروکسی به VPS خودت به‌جای پردازش در Worker — تنها راه داشتن VMess و تماس صوتی/تصویری (UDP). شامل یک فرایند کامل داخل پنل: فعال‌سازی، جای‌گذاری Backend URL، اجرای «بررسی سلامت» واقعی، و QR/لینک آمادهٔ کلاینت.

⚡ نصب‌کنندهٔ تک‌خطی VPS (nova-backend.sh)

یک دستور، Xray را نصب می‌کند، کانفیگ را می‌نویسد، فایروال را باز می‌کند و Backend URL دقیق را برای جای‌گذاری در پنل چاپ می‌کند. در مخزن IRNova/Tools میزبانی می‌شود. اطلاعات VPS تو هرگز از سرورت خارج نمی‌شود.

🔑 تطبیق خودکار UUID

دستور نصب در پنل اکنون UUID خودِ پنل را داخل دستور قرار می‌دهد (NOVA_UUID=…)، پس backend همیشه به‌طور خودکار با پنل هماهنگ می‌شود — بدون مرحلهٔ دستی sed و بدون مشکل «UUID تصادفی هماهنگ نیست».

🌐 پرسش راهنمای دامنه + لینک آمادهٔ جای‌گذاری

هنگام نصب، اسکریپت نام دامنهٔ ابرخاکستری را می‌پرسد و در پایان یک Backend URL کامل چاپ می‌کند که فقط آن را جای‌گذاری می‌کنی — بدون نیاز به ویرایش. نصب کاملاً خودکار با NOVA_DOMAIN پشتیبانی می‌شود.

🔌 انتخاب پورت داخل پنل با اعتبارسنجی

انتخاب تعاملی پورت backend هنگام نصب، که با فهرست پورت‌های مجاز Cloudflare (۸۰۸۰، ۸۸۸۰، ۲۰۵۲، ۲۰۸۲، ۲۰۸۶، ۲۰۹۵ برای HTTP) بررسی می‌شود. پورت‌های نامعتبر (مثل ۲۰۷۶، ۳۰۸۰، ۱۰۰۰۰) قبل از اینکه باعث خطای پنهان شوند رد می‌شوند. یک هشدار زنده هم در پنل نمایش داده می‌شود اگر پورت نامعتبر در فیلد Backend URL وارد شود.

🛠 «تغییر پورت / حذف backend» در پنل

یک بخش جدید در کارت Backend با دستورهای قابل‌کپی برای تغییر پورت (نصب مجدد) یا حذف کامل Xray از VPS — بدون نیاز به خروج از پنل یا خواندن راهنمای جداگانه.

📱 QR کلاینت مشروط به بررسی سلامت

QR/لینک آمادهٔ کلاینت اکنون فقط بعد از «بررسی سلامت» موفق نمایش داده می‌شود، پس هرگز برای backendی که واقعاً در دسترس نیست کانفیگ نمی‌گیری. اگر آدرس را تغییر دهی، تا تأیید دوباره پنهان می‌شود.

🌍 نصب‌کنندهٔ مرورگری + ویزارد دسکتاپ

نصب Nova روی حساب Cloudflare خودت از مرورگر (جای‌گذاری توکن) یا ویزارد دسکتاپ محلی (ورود OAuth) — دیتابیس را می‌سازد، Worker را دیپلوی می‌کند و منتظر آنلاین شدنش می‌ماند. رمز مدیریت را خودت در اولین ورود به /install تنظیم می‌کنی.

🐛 رفع اشکال‌ها و بهبودها

🔧 اتصال‌ها دیگر بعد از حدود ۱۰ ثانیه قطع نمی‌شوند (مهم)

رله حالت Backend اصلاح شد تا Worker در طول کل نشست زنده بماند. قبلاً سوکت خروجی رله یک subrequest وابسته به طول‌عمر درخواست بود، پس Cloudflare حدود ۱۰ ثانیه بعد از بازگشت پاسخ، isolate را آزاد می‌کرد و همهٔ اتصال‌ها یک‌جا قطع می‌شدند. اکنون رله با waitUntil تا قطع شدن کلاینت زنده می‌ماند، با یک نگهبان بی‌کاری ۲ دقیقه‌ای برای آزادسازی نشست‌های رهاشده.

🔐 رمز مدیریت دیگر خودکار تنظیم نمی‌شود

نصب‌کننده‌ها دیگر KEY/UUID/ADMIN را به‌عنوان رمز پنهان قرار نمی‌دهند. Worker اکنون درست تو را به /install می‌فرستد تا رمز خودت را انتخاب کنی؛ کلید رمزنگاری و UUID نود را خودش می‌سازد.

💾 ذخیرهٔ خودکار تنظیمات Backend

فعال‌سازی حالت backend، ویرایش Backend URL یا اجرای «بررسی سلامت» اکنون به‌صورت خودکار ذخیره می‌شود — دیگر «انگار خراب است تا وقتی دکمهٔ Save را پیدا کنی» وجود ندارد. دکمهٔ Save دستی هم همچنان کار می‌کند.

🖥️ بررسی آمادگی بعد از نصب

نصب‌کنندهٔ وب منتظر آنلاین شدن آدرس جدید می‌ماند (Cloudflare ممکن است ۱ تا ۳ دقیقه طول بکشد تا یک Worker تازه در سراسر دنیا فعال شود) به‌جای اینکه تو را روی خطا رها کند.

🧹 پاک شدن QR هنگام حذف

خالی کردن Backend URL یا خاموش کردن حالت backend اکنون QR/لینک کلاینت را بلافاصله حذف می‌کند، به‌جای ماندن یک QR قدیمی تا بارگذاری مجدد.

🎨 خوانایی تم روشن

رفع متن‌های کم‌کنتراست در حالت روشن (هشدارها، راهنماها و پیام‌های وضعیت اکنون استاندارد WCAG AA را برآورده می‌کنند). حالت تیره بدون تغییر.

🚫 حذف پرسش غیرضروری رمز root

نصب‌کنندهٔ VPS دیگر برای تغییر رمز root فرایند را قطع نمی‌کند.

🔡 رفع DoH POST

درخواست‌های wire-format (RFC 8484) از نوع POST به /dns-query دوباره درست پردازش می‌شوند، پیش از هر ارسال به backend.

🧭 چک‌لیست راه‌اندازی و راهنمای IP خام شفاف‌تر

کارت Backend و راهنماها اکنون نیاز به دامنهٔ ابرخاکستری (DNS-only)، فهرست پورت‌های مجاز، و دلایل دقیق در دسترس نبودن backend (IP خام ← ۴۰۳، حلقهٔ هم‌حساب ← ۵۲۲) را به‌روشنی توضیح می‌دهند.

📁 فایل‌های Worker

worker.js — یک Worker واحد و obfuscated با string-array و browser-no-eval برای کمک به جلوگیری از Cloudflare Error 1101. ایمپورت cloudflare:sockets حفظ شده است. پنل از پوشهٔ public/ مخزن (یا از طریق ASSETS binding) سرو می‌شود و داخل Worker باندل نشده است.

📝 یادداشت‌های استقرار

  • worker.js را روی Worker خود دیپلوی کن و پنل را از public/ (از طریق GitHub raw) سرو کن یا به‌صورت ASSETS باندل کن.
  • نصب‌کنندهٔ backend در مخزن IRNova/Tools قرار دارد: nova-backend.sh.
  • حالت backend اختیاری است — حالت رایگانِ معمولی داخل Worker (VLESS/Trojan) بدون VPS کار می‌کند.
  • بعد از دیپلوی، آدرس Worker خود را باز کن ← /install تا رمز مدیریت را تنظیم کنی.
  • همهٔ قابلیت‌های نسخه‌های ۳.۰ تا ۳.۶ حفظ شده و چیزی در این نسخه حذف نشده است.

Don't miss a new Nova-Proxy release

NewReleases is sending notifications on new releases.