Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/awesome-remnawave.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ import RemnawaveCloudflareNodes from '/docs/awesome-remnawave/\_install-guides/r
import WarpNativeInstallerGuide from '/docs/awesome-remnawave/\_install-guides/warp-native-installer.md'
import RemnavaweBedolagaBotGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-bedolaga-bot.md'
import RemnashopGuide from '/docs/awesome-remnawave/\_install-guides/remnashop.md'
import RemnawaveStealthnetBotGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-stealthnet-bot.md'
import RemnawaveBackuperGuide from '/docs/awesome-remnawave/\_install-guides/remnawave-backuper.md'
import XrayCheckerGuide from '/docs/awesome-remnawave/\_install-guides/xray-checker.md'
import WhiteboxGuide from '/docs/awesome-remnawave/\_install-guides/whitebox.md'
Expand Down Expand Up @@ -154,6 +155,23 @@ import WhiteboxGuide from '/docs/awesome-remnawave/\_install-guides/whitebox.md'
<RemnashopGuide />
</ProjectCard>

<ProjectCard
id="remnawave-stealthnet-bot"
title="Remnawave STEALTHNET Bot"
description="A Complete Platform for Selling VPN Subscriptions: Telegram Bot & Mini App & Client Dashboard & Admin Panel — All in one package. One script — and you're up and running."
author="GOFONCK"
authorLink="https://github.com/GOFONCK"
image="/awesome/stealthnet.webp"
githubRepo="STEALTHNET-APP/remnawave-STEALTHNET-Bot"
links={{
github: 'https://github.com/STEALTHNET-APP/remnawave-STEALTHNET-Bot',
website: 'https://t.me/vpn_stealthnet_bot',
telegram: 'https://t.me/stealthnet_admin_panel'
}}
>
<RemnawaveStealthnetBotGuide />
</ProjectCard>

</CategorySection>

<CategorySection
Expand Down
111 changes: 111 additions & 0 deletions docs/awesome-remnawave/_install-guides/remnawave-stealthnet-bot.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
### 🏗 Architecture

```
┌──────────────────────────────────────────────────────────┐
│ STEALTHNET 3.0 │
├──────────────┬──────────────┬──────────────┬─────────────┤
│ Telegram │ Mini App │ Client │ Admin │
│ Bot │ (WebApp) │ Dashboard │ Panel │
│ Grammy │ React │ React │ React │
├──────────────┴──────────────┴──────────────┴─────────────┤
│ Backend API (Express) │
│ JWT Auth · Prisma ORM · Webhooks │
├──────────────────────────────────────────────────────────┤
│ PostgreSQL │ Remnawave API │
│ (data) │ (VPN core) │
├──────────────────────────────┴───────────────────────────┤
│ Nginx + Let's Encrypt · Docker Compose │
└──────────────────────────────────────────────────────────┘
```

| Service | Technologies | Purpose |
| ------------ | ------------------------------------------------------ | -------------------------------------------------------------------------------- |
| **backend** | Node.js, Express, Prisma, PostgreSQL | REST API: authentication, clients, plans, payments, referrals, promos, analytics |
| **frontend** | React 18, Vite, Tailwind CSS, shadcn/ui, Framer Motion | Admin panel + client dashboard + Telegram Mini App |
| **bot** | Grammy (TypeScript) | Full-featured Telegram bot with client account access |
| **nginx** | Nginx + Certbot | Reverse proxy, SSL, static files, gzip |
| **postgres** | PostgreSQL 16 | Data storage |

---

### ⚙️ Features

---

#### 💳 Payments & Subscriptions

* 💰 **Platega.io** — payment processing (cards, SBP, crypto, etc.); callback URL is available in the admin panel
* 🏦 **YooMoney** — balance top-ups and plan payments via card (transfer form, HTTP notifications); webhook URL with “Copy” button in settings
* 🧾 **YooKassa** — card and SBP payments via API (RUB only); 54-FZ receipts; `payment.succeeded` webhook; webhook URL can be copied from the admin panel
* 💼 **Internal balance payments** — deposit and charge from user balance
* ⚡ **Instant activation** — plans are activated automatically via webhook after payment (Platega, YooMoney, YooKassa)
* 🏷 **Payment description branding** — all payment providers automatically insert the **service name** from admin settings (General → Service Name) into the payment description
* 🧩 **Flexible plans** — categories, duration, traffic & device limits, binding to Remnawave squads
* 🌍 **Multi-currency support** — multiple currencies (USD, RUB, etc.)

---

#### 👥 Referral Program

* 🧱 **3 referral levels** — earn from direct invites and their referrals
* 📊 **Custom percentages** — configurable per level
* 🔄 **Automatic rewards** — bonuses credited to balance after each referral payment
* 🔗 **Referral links** — for both Telegram bot and website

---

#### 🎟 Promo System

* 🆓 **Promo groups** — free subscription via link (`/start promo_CODE`) with activation limits
* 🏷 **Promo codes** — percentage or fixed discounts, plus free days
* ⏳ **Usage limits** — total limit, per-client limit, expiration date
* 📈 **Activation statistics** — usage count, who activated, when

---

#### 🚀 Trial Period

* 🎁 **Free trial** — configurable duration, traffic and device limits
* 🔒 **One-time activation** — one trial per client
* 🧭 **Dedicated squads** — separate Remnawave squad for trial users

---

#### 🔗 Remnawave Integration

* 👤 **User management** — create, delete, block users in Remnawave
* 📦 **Subscriptions** — activation, renewal, status checks
* 🖥 **Nodes** — monitoring, enable/disable, restart
* 🗂 **Squads** — user distribution across servers
* 🔄 **Two-way synchronization** — data sync (Remnawave ↔ STEALTHNET)
* 📡 **Webhooks** — automatic processing of Remnawave events

---

#### 📱 Mobile & Mini App

* 📂 **Collapsible plan categories** — on narrow screens and inside the Mini App, categories are displayed as an accordion (first open by default, others expandable)
* 🧾 **Compact plan cards** — single-column layout on mobile, slim rows (name & parameters on the left, price and “Pay” button on the right)
* 🧭 **Unified mobile interface** — bottom navigation, compact header, identical UI in mobile browser and Telegram WebApp

---

#### 📊 Analytics & Reports

* 📈 **Dashboard** — real-time key metrics
* 💵 **Revenue charts** — daily data for the last 90 days
* 👥 **Client growth** — registration dynamics
* 🏆 **Top plans** — best-selling subscriptions
* 🧮 **Referral stats** — earnings per level
* 🔁 **Conversion tracking** — trial → paid subscription
* 🗃 **Sales reports** — filtering by date and payment provider

---

#### 🔐 Security

* 🛡 **JWT authentication** — access + refresh tokens
* 🔑 **Forced password change** — on first admin login
* 📧 **Email verification** — confirmation via email link
* 🚫 **Client blocking** — with reason specification
* 🔒 **SSL/TLS** — automatic Let's Encrypt certificates
Binary file added static/awesome/stealthnet.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.