⚡ Aether Gateway

Enterprise-Grade VLESS + SOCKS5 Multi-Relay Platform on Cloudflare Workers & D1 Database

English Documentation • مستندات فارسی

---

English Documentation

A modern, high-performance, serverless VLESS-over-WebSocket tunneling platform featuring automated SOCKS5 multi-relaying, Cloudflare D1 distributed SQLite database, dynamic client subscriptions, and an intuitive bilingual admin panel.

🌟 Key Features

• 🚀 Cloudflare D1 Engine: Zero KV write quota limits (100k writes/day) for high-frequency telemetry and user bandwidth tracking.
• 🛡️ Strict Proxy Whitelisting: Prevents unauthorized relay injection and protects against open-relay network abuse.
• 📈 D1-Persisted Telemetry Engine: Reliable background testing for latency and speed with state persistence (Pause / Resume across browser reloads).
• 🌍 GeoIP & Uptime Telemetry: Automatic country identification using ip-api with regional flag emojis and reliability percentages.
• 👥 Multi-User Management: Accurate bandwidth calculation (upload/download bytes), traffic limits, and expiration dates with automatic cut-off.
• 📱 Smart Subscription Portal: Auto-detects client User-Agents (Clash, Sing-box, V2Ray) with an interactive web portal featuring live filtering, custom config naming, and instant QR codes.
• 🌐 Bilingual UI: Live English and Persian (RTL / Vazirmatn font) toggle with dark and light themes.

---

🚀 Deployment Options (Easiest to Advanced)

Method 1: 1-Click Deploy (Easiest)

Deploy directly to your Cloudflare account with a single click. Cloudflare will automatically provision the D1 database and configure all bindings.

1. Click the button above and log in to your Cloudflare account.
2. Authorize repository access and click Deploy.
3. Once deployed, open your worker URL at /setup (e.g. https://aether-gateway.<subdomain>.workers.dev/setup) to initialize your random admin credentials.

---

Method 2: Interactive CLI via NPX (Automated)

Run the automated deployment wizard right from your terminal without downloading files manually:

npx aether-gateway

The wizard will interactively:

• Clone the repository into your preferred folder.
• Install dependencies.
• Authenticate with your Cloudflare account (wrangler login).
• Automatically create the D1 database, extract the Database ID, and update wrangler.toml.
• Build and deploy the worker to the Cloudflare Edge network.

---

Method 3: Manual Installation (Advanced)

For developers who want full control over code and configurations:

# 1. Clone the repository
git clone https://github.com/arshia-ab-dev/aether-gateway.git
cd aether-gateway

# 2. Install dependencies
npm install

# 3. Log in to Cloudflare
npx wrangler login

# 4. Create D1 Database
npm run d1:create

Copy the returned database_id and paste it into wrangler.toml:

[[d1_databases]]
binding = "DB"
database_name = "aether-gateway-db"
database_id = "PASTE_YOUR_DATABASE_ID_HERE"

Then build and deploy:

npm run deploy

---

🔐 First-Run Setup & Access

1. Navigate to: https://YOUR_WORKER_DOMAIN/setup
2. Save your generated credentials immediately (Admin Panel URL, Initial Password, Secret Tunnel Path).
3. Log in to your control center and start adding or fetching endpoints!

---

💡 Pro Tips for Stability & Anti-Censorship

• Custom Domain: Always bind a custom domain (e.g., gateway.yourdomain.com) in the Cloudflare Dashboard under Worker Settings > Triggers. Default *.workers.dev domains are heavily filtered in restricted regions.
• Cloudflare Zero Trust (Access): For zero-overhead admin protection, add an Access Application for /panel-* in Cloudflare Zero Trust to require email pin verification before accessing the admin dashboard.

---

مستندات فارسی

پلتفرم سازمانی و مدرن تانلینگ VLESS بر بستر WebSocket با پشتیبانی از رله‌های چندگانه SOCKS5، پایگاه داده توزیع‌شده Cloudflare D1، تولید سابسکریپشن هوشمند و پرتال کاربری دو زبانه.

🌟 ویژگی‌های کلیدی

• 🚀 موتور ابری Cloudflare D1: عبور از محدودیت‌های نوشتن دیتابیس KV (پشتیبانی از ۱۰۰,۰۰۰ درخواست نوشتن روزانه) برای پایش لحظه‌ای و محاسبه دقیق ترافیک کاربران.
• 🛡️ لیست سفید سخت‌گیرانه (Strict Whitelist): جلوگیری از تزریق پروکسی‌های نامعتبر و بستن راه سوءاستفاده به عنوان Open Relay.
• 📈 تست پایدار در پس‌زمینه: موتور تست ذخیره‌شده در دیتابیس D1 با امکان مکث (Pause)، ادامه (Resume) و بازیابی وضعیت پس از رفرش صفحه.
• 🌍 شناسایی خودکار کشورها و آپ‌تایم: شناسایی لوکیشن با ip-api، نمایش پرچم‌ها با فونت اختصاصی و محاسبه درصد پایداری هر نود.
• 👥 سیستم چندکاربره پیشرفته: محاسبه بایت‌به‌بایت مصرف ترافیک (آپلود/دانلود)، تعیین سقف حجم و تاریخ انقضا به همراه قطع دسترسی خودکار.
• 📱 پرتال سابسکریپشن هوشمند: دارای نوار وضعیت در کلاینت‌ها، بارکد اسکن سریع QR Code، قابلیت فیلتر زنده و پنهان‌سازی هوشمند پروکسی‌ها در صورت اتمام اشتراک.
• 🌐 رابط کاربری دو زبانه: جابجایی در لحظه بین زبان‌های فارسی (راست‌چین با فونت وزیرمتن) و انگلیسی به همراه تم‌های شب و روز.

---

🚀 روش‌های نصب و استقرار (از ساده‌ترین تا پیشرفته‌ترین)

روش ۱: استقرار با ۱ کلیک (آسان‌ترین روش)

پروژه را بدون نیاز به هیچ ابزار یا کامپیوتری، مستقیماً روی حساب کلودفلر خود مستقر کنید. دیتابیس D1 و تمام پیش‌نیازها به صورت کاملاً اتوماتیک توسط کلودفلر ساخته می‌شوند.

1. روی دکمه بالا کلیک کنید و وارد حساب کاربری Cloudflare خود شوید.
2. دسترسی به مخزن را تایید کرده و دکمه Deploy را بزنید.
3. پس از اتمام دیپلوی، آدرس ورکر خود را با پسوند setup/ باز کنید (مثلاً https://aether-gateway.<subdomain>.workers.dev/setup) تا مشخصات اولیه پنل به شما نمایش داده شود.

---

روش ۲: نصب خودکار با دستور NPX در ترمینال

بدون نیاز به دانلود دستی فایل‌ها، جادوگر نصب تعاملی را در ترمینال سیستم خود اجرا کنید:

npx aether-gateway

این دستور به صورت خودکار:

• مخزن را در پوشه انتخابی شما کلون می‌کند.
• پکیج‌ها را نصب می‌کند.
• شما را وارد حساب کلودفلر می‌کند (wrangler login).
• دیتابیس D1 را ایجاد کرده، شناسه آن را خوانده و مستقیماً در wrangler.toml ذخیره می‌کند.
• پروژه را بیلد کرده و روی شبکه کلودفلر مستقر می‌کند.

---

روش ۳: استقرار دستی (ویژه برنامه‌نویسان و توسعه‌دهندگان)

برای افرادی که می‌خواهند کنترل کاملی روی سورس‌کد و فرآیند بیلد داشته باشند:

# ۱. دریافت سورس کد
git clone https://github.com/arshia-ab-dev/aether-gateway.git
cd aether-gateway

# ۲. نصب پیش‌نیازها
npm install

# ۳. ورود به حساب کلودفلر
npx wrangler login

# ۴. ساخت دیتابیس D1
npm run d1:create

مقدار database_id نمایش داده‌شده در خروجی ترمینال را کپی کرده و در فایل wrangler.toml قرار دهید:

[[d1_databases]]
binding = "DB"
database_name = "aether-gateway-db"
database_id = "شناسه_دیتابیس_شما"

سپس دستور بیلد و دیپلوی را اجرا کنید:

npm run deploy

---

🔐 راه‌اندازی اولیه

1. پس از دیپلوی، آدرس ورکر خود را به این صورت باز کنید: https://YOUR_WORKER_DOMAIN/setup
2. اطلاعات امنیتی تولیدشده (آدرس پنل، رمز عبور و مسیر مخفی تونل) را در جایی ذخیره کنید.
3. وارد پنل مدیریت شوید و از امکانات پلتفرم استفاده کنید!

---

💡 نکات طلایی برای پایداری و ضد فیلترینگ

• دامنه اختصاصی (Custom Domain): حتماً در پنل کلودفلر در تنظیمات ورکر (بخش Triggers > Custom Domains) یک دامنه یا ساب‌دامین اختصاصی ثبت کنید. دامنه‌های پیش‌فرض workers.dev توسط سیستم فیلترینگ شناسایی و مسدود می‌شوند.
• لایسنس کلودفلر Zero Trust: برای امنیت صددرصدی پنل، در بخش Cloudflare Zero Trust یک رول Access برای آدرس panel-* تعریف کنید تا ورود به پنل نیازمند ارسال کد یک‌بارمصرف به ایمیل شما باشد.

---

📄 لایسنس

پروژه تحت لایسنس MIT منتشر شده است.