📚 Table of Contents
✨ Overview
Mirza Bot is a feature-rich Telegram bot for selling VPN subscriptions and automating the entire sales workflow — from purchase and payment to config creation and service management.
It connects directly to your panels, builds configurations automatically, accepts a wide range of payment methods, and gives both customers and admins a clean experience through a Telegram Mini App and a web admin panel.
Whether you’re handing out trial accounts or running a large-scale reseller business, Mirza Bot has the tools to run it end to end.
📖 Documentation
The complete user manual lives at mirzabot.com/docs — 61 pages covering every part of the bot, written in Persian (فارسی).
It is not a feature list: every menu is documented with the exact order of the steps the bot asks for, what each field accepts, the error message you get when it rejects your input, and the mistake that most often breaks that feature.
| Section |
What it covers |
| شروع (Getting started) |
Architecture, requirements, server install, shared-host install, CLI flags, updating and removing |
| ساختار (Structure) |
Repository layout, database tables, which file does what |
| پنلها (Panels) |
Adding each of the 13 panel types, protocol & inbound setup, per-panel menus, manual config creation, node management |
| فروشگاه (Shop) |
Products, categories, trial accounts, On-Hold services, bulk purchase, manual sale, renewals and location changes |
| پرداخت (Payments) |
Card-to-card with receipt approval, every online and crypto gateway, wallet and refunds |
| مدیریت (Administration) |
Admin roles, feature switches, report channel and topics, texts, forced-join channel, web panel |
| رشد و بازاریابی (Growth) |
Referrals, cashback, discount and gift codes, lottery and wheel, reseller system |
| نگهداری (Operations) |
Cron jobs, backup and restore, optimization, security checklist, troubleshooting |
The docs are generated from the bot’s own source, so menu names, limits and error strings match the code rather than an older release.
🧩 Supported Panels
Mirza Bot integrates with the most popular VPN and network management panels:
| Panel |
Panel |
| 🟢 Marzban |
🟢 Marzneshin |
| 🟢 Sanaei / Alireza |
|
| 🟢 S-UI |
🟢 Hiddify |
| 🟢 WGDashboard (WireGuard) |
🟢 MikroTik |
| 🟢 IBSng |
🟢 Pasarguard |
Configs are generated automatically and are compatible with all common protocols.
💳 Payment Gateways
| Gateway |
Type |
| 💵 Card-to-Card |
Manual (receipt + admin approval) |
| 🪙 NowPayments |
Crypto |
| 🪙 Plisio |
Crypto |
| 🪙 CubePay |
TRON / crypto |
| 🇮🇷 Zarinpal |
Online gateway |
| 🇮🇷 Aqayepardakht |
Online gateway |
| 🇮🇷 IranPay |
Online gateway |
⚙️ Features
🛒 Sales & Configuration
- ✅ VPN purchase with fully automated config creation
- ✅ Trial / test accounts for new users
- ✅ Compatibility with all common protocols
- ✅ QR codes for fast config import
- ✅ Protocol-based configuration settings
- ✅ Product, panel & gateway management
👤 User Experience
- ✅ Telegram Mini App for a modern, in-app interface
- ✅ View & manage purchased services:
- Renew a service
- Buy additional volume
- Retrieve config / update subscription links
- ✅ Wallet & balance system
- ✅ Detailed purchase & trial reports
- ✅ Support section, FAQ & customizable tutorials
- ✅ Phone-number verification
- ✅ Mandatory channel membership for purchases
📈 Growth & Marketing
- ✅ Affiliate / referral system
- ✅ Cashback rewards
- ✅ Discount codes
- ✅ Gift codes
- ✅ Lottery system
- ✅ Agent / reseller system
🛠️ Administration
- ✅ Web admin panel (login-protected dashboard)
- ✅ Multiple admins support
- ✅ Balance & user management
- ✅ Full text/message customization from the bot
- ✅ Configurable username-generation methods
- ✅ Automatic backups
- ✅ Notification & expiry-reminder services (cron)
- ✅ On-hold configurations
🚀 Installation
Prerequisites
| Requirement |
Details |
| 🖥️ OS |
A clean Ubuntu 22.04/24.04/26.04 or Debian 12/13 server |
| 🌐 Domain |
A domain name pointed to your server’s IP |
| ⚙️ Stack |
PHP 8.5.12+, Apache, MySQL/MariaDB, SSL — installed automatically by the script |
💡 Start from a fresh server with no existing web server, database, or panel installed.
Install
Run the following command on your server as root:
curl -o install.sh -L https://raw.githubusercontent.com/mahdiMGF2/mirzabot/main/install.sh && bash install.sh
An interactive menu will appear:
1) Install Mirza
2) Update Mirza
3) Remove Mirza
4) Migrate: Free → Pro (Beta)
5) Renew SSL certificate
6) Help & Parameters
7) Exit
➡️ Select 1 to install the bot, then follow the prompts.
Update
Run the same command and select 2:
curl -o install.sh -L https://raw.githubusercontent.com/mahdiMGF2/mirzabot/main/install.sh && bash install.sh
Remove
Run the same command and select 3 to completely remove the bot and its services.
Non-Interactive (CLI) Usage
You can also drive the installer entirely from the command line — handy for automation and scripted deployments.
Commands
| Command |
Description |
install |
Install Mirza |
update |
Update Mirza (choose channel / version) |
remove |
Remove Mirza and its services |
migrate |
Migrate Free → Pro |
renew |
Renew the bot’s SSL certificate |
menu |
Open the interactive panel (default) |
Install parameters
| Parameter |
Description |
--name |
Bot username |
--token |
Telegram bot token |
--admin |
Admin chat ID |
--domain |
Domain name (e.g. bot.example.com) |
--db-user |
Database username |
--db-pass |
Database password |
--version |
Specific release tag (e.g. 0.1.7) |
--channel |
beta · release · auto |
-h, --help |
Show CLI help and exit |
Examples
# Auto-pick the best channel
mirza install --channel auto
# Fully non-interactive install
mirza install --name myvpnbot --token 123:ABC \
--admin 111 --domain bot.example.com --version 0.1.7
# Update to a specific version or channel
mirza update --version 0.1.6
mirza update --channel release
# Remove
mirza remove
💎 Free vs. Pro
|
Free 🆓 |
Pro 💎 |
| Automated VPN sales & config creation |
✅ |
✅ |
| Trial accounts, wallet & service management |
✅ |
✅ |
| All supported panels & payment gateways |
✅ |
✅ |
| Advanced customization & analytics |
— |
✅ |
| Enhanced management & extra modules |
— |
✅ |
📌 Pro purchase guide: View on Telegram »
🌍 Languages
Mirza Bot ships with full translations for:
🇬🇧 English · 🇮🇷 Persian (فارسی) · 🇷🇺 Russian (Русский) · 🇨🇳 Chinese (中文)
💵 Support the Project
If Mirza Bot helps your business, please consider supporting its development with a crypto donation:
Your support keeps the updates and improvements coming. Thank you! 🙌
👥 Contributors
Thanks to everyone who has contributed to making Mirza Bot better:
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
评论