🏳️ WhitePanel - Cloudflare Worker Proxy Management Panel

یک پنل مدیریتی قدرتمند، سبک و پیشرفته بر بستر Cloudflare Workers برای ایجاد، مدیریت و بهینه‌سازی کانفیگ‌های پروکسی (VLESS و Trojan) همراه با پشتیبانی از کلاینت‌های محبوب مانند Clash.

---

🚀 قابلیت‌ها (Features)

• پشتیبانی از پروتکل‌های مدرن: قابلیت تولید و پردازش کانفیگ‌های امن پروتکل‌های VLESS و Trojan (کدگذاری شده به صورت پویا به صورت ساختارهای آلفا و بتا).
• تولید اشتراک کلاش (Clash Subscription): تبدیل و فرمت‌بندی خودکار تنظیمات شبکه به پروفایل‌های استاندارد فایل YAML جهت استفاده مستقیم در نرم‌افزار Clash.
• پنل وب داخلی مستقل (Built-in Web UI): دارای یک رابط کاربری وب مدرن، زیبا و کاملاً واکنش‌گرا (Responsive) با نام WhitePanel برای مدیریت آسان متغیرها بدون نیاز به هیچ‌گونه دیتابیس خارجی.
• سیستم احراز هویت و مدیریت نشست ایمن: مجهز به ورود رمزنگاری‌شده بر پایه masterKey و ذخیره‌سازی توکن‌های منقضی‌شونده در localStorage برای امنیت بالاتر مرورگر.
• مدیریت آی‌پی‌های تمیز (Clean IPs): امکان تعریف، مانیتورینگ و گردش خودکار آی‌پی‌های سالم کلودفلر جهت بهبود پینگ، پایداری و دور زدن محدودیت‌های شبکه.
• یکپارچه‌سازی با ربات تلگرام (Telegram Bot Notification): قابلیت اتصال مستقیم به API تلگرام جهت ارسال هشدارهای وضعیت سیستم، ورودهای ناشناس و گزارش‌های حیاتی به چت یا کانال شخصی شما.
• سیستم به‌روزرسانی خودکار هوشمند: بررسی خودکار و لحظه‌ای نسخه مستقر شده با آخرین نسخه موجود در مخزن گیت‌هاب شما و نمایش بنر اطلاع‌رسانی هوشمند به مدیر.
• پشتیبانی از DNS سفارشی امن (DoH): ادغام با پروتکل‌های DNS over HTTPS مانند cloudflare-dns.com جهت از بین بردن احتمال نشت DNS (DNS Leak) و تسریع در رزولوشن دامنه.

---

🛠️ پیش‌نیازها (Prerequisites)

1. یک حساب کاربری فعال در پلتفرم Cloudflare.
2. یک دامنه اختصاصی متصل به کلودفلر (جهت دور زدن فیلترینگ آدرس‌های پیش‌فرض workers.dev و عملکرد صحیح ساب‌دومین‌ها شدیداً توصیه می‌شود).
3. ساخت دیتابیس D1: پیش از شروع، از منوی سمت چپ کلودفلر به بخش Storage & Databases -> D1 بروید، روی Create Database کلیک کرده و یک دیتابیس با نام دلخواه ایجاد کنید.

---

📦 راهنمای نصب و راه‌اندازی (Installation Guide)

روش اول: نصب سریع از طریق داشبورد وب کلودفلر (توصیه شده)

1. کپی کردن سورس کد: ابتدا تمام محتویات فایل اصلی worker.js را به طور کامل کپی (Ctrl+A و سپس Ctrl+C) کنید.
2. ورود به بخش Workers: وارد حساب کاربری خود در کلودفلر شوید و از منوی سمت چپ به بخش Compute -> Workers & Pages بروید.
3. ایجاد ورکر جدید: روی دکمه Create Application و سپس Create Worker کلیک کنید. یک نام دلخواه برای ورکر خود بنویسید و روی دکمه Deploy کلیک کنید.
4. جایگذاری کد: پس از اتمام ساخت، روی دکمه Edit Code یا Quick Edit کلیک کنید تا ادیتور آنلاین کلودفلر برای شما باز شود.
5. پاکسازی و ذخیره اولیه: کدهای نمونه پیش‌فرض درون ادیتور را کاملاً حذف کنید. سپس سورس کد کپی شده در مرحله اول را پیست کرده و در نهایت از بالای صفحه سمت راست روی دکمه Save and Deploy کلیک کنید. بعد از ذخیره، از ادیتور خارج شوید و به صفحه اصلی تنظیمات این ورکر برگردید.
6. اتصال دیتابیس (D1 Binding): * در صفحه ورکر خود، به تب Settings بروید و از منوی سمت چپ آن، گزینه Variables را انتخاب کنید.
   • صفحه را به پایین اسکرول کنید تا به بخش D1 Database Bindings برسید و روی دکمه Add Binding کلیک کنید.
   • مقدار فیلد Variable name را دقیقاً و با حروف کوچک wl_db وارد کنید.
   • در فیلد Target D1 Database، دیتابیسی که در مرحله پیش‌نیازها ساختید را انتخاب کنید.
   • در آخر روی دکمه Save and deploy کلیک کنید تا تغییرات اعمال شوند.

روش دوم: نصب و توسعه از طریق ابزار Wrangler (محیط خط فرمان)

اگر پروژه را از طریق ترمینال مدیریت می‌کنید، کافیست فایل wrangler.toml خود را باز کرده و بایندیگ د1 را به صورت زیر تعریف کنید و سپس wrangler deploy بزنید:

[[d1_databases]]
binding = "wl_db"
database_name = "نام_دیتابیس_شما"
database_id = "آیدی_دیتابیس_شما"



``با تشکر از پروزه نهان```