# Aether

### اینترنت آزاد برای همه :))

**[🇬🇧 English README](README.md)** · **[📖 مستندات کامل](Docs/GUIDE.fa.md)**

Aether یک کلاینت دور زدن سانسور اینترنت است که برای شبکه‌های به‌شدت محدود و فیلترشده طراحی شده است. این برنامه به‌صورت خودکار مسیرهای قابل‌دسترس را پیدا می‌کند، یک تونل رمزنگاری‌شده برقرار می‌کند و یک پراکسی محلی SOCKS5 در اختیار برنامه‌های شما قرار می‌دهد.

برخلاف VPNهای سنتی، Aether برای محیط‌هایی ساخته شده که در آن‌ها بازرسی عمیق بسته‌ها (DPI)، شناسایی الگوی پروتکل، محدودسازی UDP و مسدودسازی مقصدها به‌طور گسترده انجام می‌شود.

## ویژگی‌ها

- کشف خودکار بهترین مسیر، همراه با تأیید واقعیِ عبور داده (data-plane) تا یه گیت‌وی فقط وقتی سالم حساب بشه که واقعاً داده رد کند، نه فقط چون به دست‌دادن جواب داده
- پشتیبانی از MASQUE (HTTP/3 و HTTP/2)، با امکان فرگمنت کردن TLS ClientHello روی HTTP/2
- پشتیبانی از WireGuard
- حالت تونل‌در‌تونل (`gool`)
- استتار ترافیک
- اتصال مجدد خودکار، و اتصال سریع به آخرین گیت‌وی سالم برای رد شدن از اسکن دوباره
- پراکسی محلی SOCKS5
- پرچم‌های خط فرمان، متغیرهای محیطی، یا سؤال‌های تعاملی — هرکدوم رو که بخوای
- پشتیبانی از Linux، Windows، macOS و Android (Termux)

## دانلود

نسخه‌های آماده (باینری) از بخش **Releases** برای سیستم‌عامل‌های زیر قابل دریافت هستند:

- Linux
- Windows
- macOS
- Android (Termux)

### نصب یک‌خطی روی Termux (اندروید)

این دستور رو کپی کن و توی ترموکس بزن:

```bash
curl -fsSL https://raw.githubusercontent.com/CluvexStudio/aether/main/aether.sh -o aether.sh && chmod +x aether.sh && ./aether.sh install
```

این اسکریپت خودش معماری دستگاهت رو تشخیص می‌ده، نسخه‌ی مناسب رو دانلود می‌کنه، چک‌سامش رو تأیید می‌کنه و `aether` رو توی `$PREFIX/bin` نصب می‌کنه. بعدش با دستور زیر اجراش کن:

```bash
aether
```

برای آپدیت بعداً: `./aether.sh update`
برای حذف: `./aether.sh uninstall`

## ساخت (Build)

### پیش‌نیازها

- Rust (آخرین نسخه پایدار)
- کامپایلر C/C++
- CMake

پوشه‌ی `quiche` باید در کنار پوشه‌ی `aether` قرار داشته باشد:

```text
<repo>/
  aether/
  quiche/
```

ساخت پروژه:

```bash
cargo build --release
```

فایل نهایی:

```text
target/release/aether
```

## داکر (Docker)

شما می‌توانید Aether را در یک محیط ایزوله با استفاده از داکر اجرا کنید. ایمیج رسمی برنامه روی GitHub Container Registry (GHCR) در دسترس است.

دریافت و اجرای ایمیج از پیش‌ساخته‌شده (برای تنظیمات اولیه به حالت تعاملی نیاز است):

```bash
docker run -it -p 1819:1819 ghcr.io/cluvexstudio/aether:latest
```

همچنین می‌توانید با ارسال متغیرهای محیطی از پرسش‌های اولیه عبور کنید:

```bash
docker run -it -p 1819:1819 \
  -e AETHER_PROTOCOL=masque \
  -e AETHER_SCAN=balanced \
  ghcr.io/cluvexstudio/aether:latest
```

در صورتی که ترجیح می‌دهید ایمیج را خودتان بیلد کنید:

```bash
docker build -t aether .
docker run -it -p 1819:1819 aether
```

## اجرا

برنامه را بدون هیچ آرگومانی اجرا کنید و به سؤال‌ها جواب بدید:

```bash
./target/release/aether
```

یا با پرچم‌ها از سؤال‌ها رد شید:

```bash
./target/release/aether --masque -4 --scan turbo --noize firewall
```

روی ویندوز، به‌جای اون کافیه روی `run-aether.bat` (که همراه zip ریلیز میاد) دابل‌کلیک کنی — یه ترمینال باز می‌کنه، `aether.exe` رو اجرا می‌کنه، و بعدش پنجره رو باز نگه می‌داره تا هر خطایی رو بتونی بخونی.

هر سؤال یه پرچم و یه متغیر محیطی معادل داره. برای لیست کامل `./target/release/aether --help` رو بزن، یا به راهنماهای پایین‌تر مراجعه کن.

پس از اجرا، پراکسی SOCKS5 روی آدرس زیر در دسترس خواهد بود:

```text
127.0.0.1:1819
```

نمونه تست:

```bash
curl -x socks5h://127.0.0.1:1819 https://www.cloudflare.com/cdn-cgi/trace
```

## پروتکل‌های پشتیبانی‌شده

### MASQUE (پیشنهادی)

ترافیک را از طریق HTTP/3 (QUIC) یا HTTP/2 (TLS) عبور می‌دهد تا تا حد ممکن شبیه ترافیک عادی HTTPS باشد.

### WireGuard

یک تونل سریع، سبک و کم‌هزینه که برای شبکه‌هایی با بازرسی کمتر مناسب است.

### تونل‌در‌تونل (`gool`)

یک اتصال WireGuard که داخل یک اتصال WireGuard دیگر اجرا می‌شود و یک لایه رمزنگاری اضافه فراهم می‌کند.

## مستندات

مستندات کامل در فایل‌های زیر موجود است:

- [Docs/GUIDE.fa.md](Docs/GUIDE.fa.md) — راهنمای فارسی
- [Docs/GUIDE.en.md](Docs/GUIDE.en.md) — English guide

## سازندگان

توسعه داده شده توسط **CluvexStudio**. :))

بخش MASQUE این پروژه بر پایه کتابخانه **Quiche** از Cloudflare توسعه یافته است.

تلگرام: https://t.me/CluvexStudio

## مشارکت

**اگر توسعه‌دهنده باتجربه شبکه یا مهندس پروتکل هستید، از مشارکت شما استقبال می‌کنیم.**

**لطفاً کد پروژه را تمیز، قابل نگهداری و مهندسی‌شده نگه دارید. مشارکت‌های بی‌کیفیت یا مبتنی بر وایب‌کدینگ پذیرفته نخواهند شد!!!**

## حمایت مالی (Donate)

اگه Aether به دردت خورده و می‌خوای از توسعه‌ش حمایت کنی:

- **TRX (Tron):** `TRxVSHcoADZnBfztFmFb2TQopusAwWYEVR`
- **BTC:** `bc1qnjnvzsa5avgj7n0uy383cv5zdxfjnvvp257egm`
- **TON:** `UQAH75bXaaRUhZMwiF0ZujOXFDDmvLSPASKoOsWF0HNasiaM`

## مجوز

برای اطلاعات بیشتر، فایل `LICENSE` را مطالعه کنید.