PROXY6 Telegram Bot

🇷🇺 Русский | 🇬🇧 English

---

🇷🇺 О проекте

PROXY6 Bot — это полнофункциональный Telegram-бот для управления прокси-серверами через API сервиса PROXY6. Проект демонстрирует современные подходы к разработке Telegram-ботов на Python с использованием фреймворка aiogram 3.x.

✨ Особенности

• 🌍 Двуязычный интерфейс — Русский / English
• 🎨 Чистый UI — минималистичный дизайн с emoji
• ⚡ Оптимизированный код — без дублирования и лишних зависимостей
• 🔄 Корректное завершение — правильная очистка ресурсов
• 📱 Удобные клавиатуры — интуитивная навигация
• 🛡️ Обработка ошибок — стабильная работа при проблемах с API

🚀 Функции

Функция	Описание
💰 Баланс	Проверка баланса PROXY6
📦 Прокси	Просмотр активных прокси
🛒 Купить	Покупка новых прокси (IPv4/IPv6/Shared)
⏳ Продлить	Продление существующих
✏️ Тип	Изменение типа (HTTP/SOCKS5)
✅ Проверка	Тестирование работоспособности
🗑️ Удалить	Удаление ненужных прокси

🛠️ Технологии

Технология	Версия	Назначение
Python	3.10+	Язык программирования
aiogram	3.x	Telegram Bot API Framework
aiohttp	3.9+	Async HTTP клиент
python-dotenv	1.0+	Переменные окружения

📁 Структура

PROXY6BOT/
├── main.py                 # Точка входа
├── states.py               # FSM состояния
├── config.py               # Константы и настройки
├── locales.json            # Переводы (RU/EN)
├── requirements.txt        # Зависимости
├── handlers/               # Обработчики
│   ├── start.py           # /start, меню
│   ├── balance.py         # Баланс
│   ├── proxies.py         # Прокси
│   ├── buy.py             # Покупка
│   ├── prolong.py         # Продление
│   ├── proxy_actions.py   # Действия
│   ├── help.py            # Помощь
│   └── language.py        # Выбор языка
├── keyboards/             # Клавиатуры
│   └── menus.py           # Все клавиатуры
├── middlewares/           # Middleware
│   └── locale.py          # Локализация
└── utils/                 # Утилиты
    ├── client.py          # PROXY6 API клиент
    ├── formatters.py      # Форматирование
    └── i18n.py            # Система переводов

🚀 Быстрый старт

# Установка зависимостей
pip install -r requirements.txt

# Настройка (скопируйте .env.example в .env)
BOT_TOKEN=your_token
PROXY6_API_KEY=your_api_key

# Запуск
python main.py

---

🇬🇧 About

PROXY6 Bot is a full-featured Telegram bot for managing proxy servers via PROXY6 API. This project demonstrates modern approaches to Telegram bot development using Python and aiogram 3.x framework.

✨ Features

• 🌍 Bilingual Interface — Russian / English
• 🎨 Clean UI — minimalist design with emoji
• ⚡ Optimized Code — no duplication, minimal dependencies
• 🔄 Graceful Shutdown — proper resource cleanup
• 📱 User-friendly Keyboards — intuitive navigation
• 🛡️ Error Handling — stable operation with API issues

🚀 Capabilities

Feature	Description
💰 Balance	Check PROXY6 account balance
📦 Proxies	View active proxies list
🛒 Buy	Purchase new proxies (IPv4/IPv6/Shared)
⏳ Prolong	Extend existing proxies
✏️ Type	Change type (HTTP/SOCKS5)
✅ Check	Test proxy functionality
🗑️ Delete	Remove unwanted proxies

🛠️ Tech Stack

Technology	Version	Purpose
Python	3.10+	Programming language
aiogram	3.x	Telegram Bot API Framework
aiohttp	3.9+	Async HTTP client
python-dotenv	1.0+	Environment variables

📁 Project Structure

PROXY6BOT/
├── main.py                 # Entry point
├── states.py               # FSM states
├── config.py               # Constants and settings
├── locales.json            # Translations (RU/EN)
├── requirements.txt        # Python dependencies
├── handlers/               # Message handlers
│   ├── start.py           # /start, menu
│   ├── balance.py         # Balance check
│   ├── proxies.py         # Proxies list
│   ├── buy.py             # Buy flow
│   ├── prolong.py         # Prolong flow
│   ├── proxy_actions.py   # Actions (type, check, delete)
│   ├── help.py            # Help
│   └── language.py        # Language selection
├── keyboards/             # Keyboards
│   └── menus.py           # All keyboard functions
├── middlewares/           # Middleware
│   └── locale.py          # Localization
└── utils/                 # Utilities
    ├── client.py          # PROXY6 API client
    ├── formatters.py      # Text formatting
    └── i18n.py            # Translation system

🚀 Quick Start

# Install dependencies
pip install -r requirements.txt

# Setup (copy .env.example to .env)
BOT_TOKEN=your_token
PROXY6_API_KEY=your_api_key

# Run
python main.py

---

📄 License / Лицензия

MIT License

---

🤝 Contributing

Feel free to fork, modify, and submit pull requests!

---

PROXY6 Bot — готовое решение для управления прокси и пример профессиональной разработки Telegram-ботов.

PROXY6 Bot — ready-to-use proxy management solution and professional Telegram bot development example.