Hiddify-API-Telegram

Описание

Telegram-бот для управления подписками и пользователями сервиса Hiddify через API. Позволяет пользователям получать ссылки для подключения, управлять балансом, оформлять подписки, а администраторам — подтверждать платежи и просматривать статистику.

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

1. Клонируйте репозиторий и установите зависимости:

   git clone https://github.com/prasx/Hiddify-API-telegram-bot-public.git
   cd Hiddify-API-telegram
   pip install -r requirements.txt
   

2. Настройте файл config.py (см. ниже).
3. Запустите бота:

   python main.py
   

Структура проекта

• main.py — основной файл Telegram-бота.
• config.py — файл конфигурации, где задаются ключевые параметры работы.
• hiddify_api.py — взаимодействие с Hiddify API.
• database.py — работа с локальной базой данных пользователей.
• requirements.txt — зависимости Python.
• readme.md — документация.

Настройка файла конфигурации (config.py)

Файл config.py содержит все основные параметры для работы бота и подключения к Hiddify API. Перед запуском обязательно проверьте и настройте значения:

Основные параметры

• ADMIN_PAYMENTS — Telegram ID администратора, который подтверждает платежи.
• TOKEN — токен Telegram-бота (получить у @BotFather).
• HOSTING_URL — URL вашего сервера Hiddify.
• API_URL — URL для доступа к Hiddify API (обычно формируется на основе HOSTING_URL).
• API_KEY — ключ для авторизации в Hiddify API (выдается в панели Hiddify).
• API_PUBLIC_KEY — публичный ключ для формирования ссылок на конфигурации.

Тарифы

В переменной TARIFFS задаются доступные тарифные планы для пользователей:

TARIFFS = {
	 "30day": {"package_days": 30, "usage_limit_GB": 130, "price": 400, "emoji": "🤏"},
	 "60day": {"package_days": 60, "usage_limit_GB": 370, "price": 800, "emoji": "👍"},
	 "90day": {"package_days": 90, "usage_limit_GB": 690, "price": 1200, "emoji": "🤘"},
}

• package_days — срок действия подписки.
• usage_limit_GB — лимит трафика.
• price — стоимость тарифа (в рублях).
• emoji — иконка для отображения в интерфейсе.

Принципы работы

• Пользователь взаимодействует с ботом через команды и кнопки.
• Все действия (регистрация, пополнение баланса, получение ссылки) фиксируются в базе данных.
• Для подтверждения платежа пользователь отправляет скриншот, администратор подтверждает вручную - можно автоматизировать через платежный шлюз.
• Ссылки на конфигурации генерируются автоматически на основе данных из config.py.

Безопасность

• Не публикуйте свой токен бота, API-ключи и публичные ключи в открытом доступе.
• Рекомендуется использовать отдельного администратора для подтверждения платежей.