Adlinkfly Telegram Bot
Простой в использовании скрипт бота на основе Python, предназначенный для работы с веб -сайтом Shrowner Link Adlinlfly PHP с использованием API Developer ADLinkfly Developer!
⚡ Развертывание 1 клика:
- Развертывание 1 клика-самый простой способ развернуть этот бот! Нажмите на эти кнопки, чтобы развернуть бот на соответствующей платформе. Просто убедитесь, что заполняйте/замените правильные значения переменной окружающей среды, когда их спрашивают. Параметры описаны ниже подробно (в разделе «Конфигурация / среда vriables»).
? Требования:
- Пакеты Python:
- Pytelegrambotapi
- Телебот
- запросы
- регулярно
- Колба
- резьба
- стрелобь
- Python-Dotenv
- Должен иметь веб -сайт Shrowner Sull Sulte Adlinkfly, размещенный в Интернете с действительным доменным именем
- На вашем веб -сайте Adlinkfly установлен действующий сертификат SSL (доступный через протокол HTTPS!)
- Должен был настроить подходящее среднее время выполнения (совместимое с WSGI) для запуска сценариев Python! (Рекомендуется: рендеринг, Koyeb, rettit -or- контейнер Docker на вашем пользовательском сервере)
? ️ функции:
- Легко интегрировать и настраивать (файл конфигурации All-in-One!)
- Обнаружение и сокращение автоматического URL (никаких дополнительных команд не требуется! Просто отправьте ссылку на Shorten ... Это слишком просто .. !!)
- Поддерживает укорочение ссылок с помощью пользовательского псевдонима
- Автоматическая пользовательская проверка ссылки с сообщениями об ошибках.
- Доступные команды телеграммы:
- /start - показывает пользовательское приветственное сообщение, когда пользователь начинает первый разговор с ботом
- /help - показывает пользовательское сообщение о справке и поддержке, когда пользователь дает команда /help
- /реклама - сокращает ссылку с рекламой. Также создает отдельную страницу коротких ссылок! (* По умолчанию метод сокращения ссылок устанавливается на прямое сокращение без каких -либо объявлений и короткой страницы ссылок , если пользователь хочет сократить ссылку с рекламой и короткой страницей ссылок, команда /объявление требуется каждый раз!)
- /псевдоним - сокращает ссылку с пользовательским псевдонимом по вашему выбору (например, yourdomain.com/cool-alias)
- /alias_ads - сокращает ссылку с пользовательским псевдонимом по вашему выбору, а также создает отдельную короткую страницу ссылки, которая включает в себя рекламу
? Скачать:
- Вам не нужно ничего скачать для большинства случаев (кроме: вы развертываете это напрямую на своем собственном сервере)
- Для пользовательского развертывания сервера (Direct) Загрузите последнюю ZIP из релизов.
Конфигурация / среда vriables:
- Существует только один глобальный файл конфигурации '.env', также известный как переменные среды, которые вам необходимы для настройки для вашего бота! Пример доступных полей показан в файле «.env.example», а также описан ниже (если вы используете решения для развертывания 1 клика, вам не нужно создавать какой-либо отдельный файл .Env.
HOST_PORT = 8080 #Only for Docker Container Deployment - OPTIONAL - DEFAULT: 8080
DOMAIN_NAME = yourdomain.com
BOT_TOKEN = Paste Your Telegram Bot API Token
ADLINKFLY_TOKEN = Paste Your Adlinkfly API Token
START = Type the start message here you want to show the user nNew Line Starts Here
HELP = Type the help message here you want to show the user nNew Line Starts Here
#Don't use https:// on DOMAIN_NAME field just type the nacked domain name as shown!
#To change the line (New Line) of START or HELP message use ' n ' between the lines (Works as Enter Key of Keyboard! Python Syntax... :-)
- Важные поля:
- Domain_name = напишите доменное имя вашего веб -сайта adlinkfly (напишите доменное имя без: www, http: //, https: //) (например: yourdomain.com)
- API_TOKEN = вставьте здесь свой токен API Telegram BOT. Не знаете, как его получить? Читайте здесь
- Adlinkfly_token = вставьте свой токен ADLinkfly Developer API здесь. Не знаете, как его получить? Читайте здесь
- Необязательные поля:
- HOST_PORT = отображает внутренний контейнер -порт Docker (8080) на указанный порт на вашем хост -машине. Полезно, когда по какой -то причине полезно, что другой процесс работает на одном и том же порте в вашем хост -машине, что может привести к неисправности. По умолчанию он использует тот же порт (8080) вашего хост -машины, который может быть перезаписан этой переменной
- Пользовательские сообщения:
- Start = напишите пользовательское сообщение, которое вы хотите показать пользователю, когда он использует команду Telegram ' /start'
- Справка = написать пользовательское сообщение, которое вы хотите показать пользователю, когда они используют команду Telegram ' /help'
- Дополнительная настройка команд возможна путем изменения исходного кода Python .... Если вы хотите, вы можете попробовать ... !!!
Установка / развертывание:
Развертывание 1 клика (самое простое):
- Просто нажмите на любую кнопку, приведенную вверху (в какой платформе вы хотите развернуть) и выполните шаги. Примечание: сначала обязательно входите в систему платформы, прежде чем нажать кнопку
- Вам будет предложено заполнить значения переменной среды (проверьте раздел конфигурации / среды Vriables для получения дополнительной информации) Заполните значения должным образом и продолжайте. Вот и все...!!
- Ваша платформа не указана? -> Я постоянно пытаюсь интегрировать все больше и больше платформ. Но, если он все еще не указан, вы можете попробовать опцию пользовательского развертывания или связаться со мной для получения дополнительной информации.
Применение развертывания:
- Используйте опцию «Импорт с github», чтобы импортировать это репо. Не знаете, как это сделать? Читайте здесь
- Используйте этот URL для импорта:
https://github.com/techishfellow/adlinkfly-telegram-bot.git
- Используйте эту команду Run:
- Откройте окно «оболочки» и запустите эту команду, чтобы установить все зависимости:
pip install -r requirements.txt
Откройте окно «Секреты» и настройте все секреты, как объяснено ранее (в разделе «Конфигурация / среда Vriables»). Секреты Repit работают так же, как и переменные среды. Не знаете, как использовать секретные секреты? Читайте здесь
Теперь просто нажмите кнопку «Зеленый» запустить вверху, чтобы запустить бот. Вот и все...!!
Пользовательское развертывание сервера (с Docker) (рекомендуется):
- Установите плагин Docker и Docker Compose (на Ubuntu / Debian):
curl -sSL https://get.docker.com/ | CHANNEL=stable sh && apt install docker-compose-plugin
- Клонировать репозиторий Adlinkfly Telegram GIT к /opt /adlinkfly-telegram-bot:
git clone https://github.com/techishfellow/adlinkfly-telegram-bot.git /opt/adlinkfly-telegram-bot
- Перейдите к /opt /adlinkfly-telegram-bot, затем создайте пустой файл .env и измените его (как объяснялось ранее, в разделе «Конфигурация /среда Vriables») с помощью редактора текстового редактора командной строки Nano:
cd /opt/adlinkfly-telegram-bot && touch /opt/adlinkfly-telegram-bot/.env && nano /opt/adlinkfly-telegram-bot/.env
Сохраните его с помощью CTRL + O , а затем нажатие Enter , выйдите из Nano CTRL + X
- Не создавать и не начинать Adlinkfly Telegram Bot, перейдите в /opt /adlinkfly-telegram-bot, затем создайте и запустите контейнеры Docker:
cd /opt/adlinkfly-telegram-bot && docker compose build && docker compose up -d
- Чтобы остановить бота, вы можете использовать эту команду в любое время:
cd /opt/adlinkfly-telegram-bot && docker compose down
Пользовательское развертывание сервера (напрямую) (не рекомендуется):
- Важно: этот сценарий работает только на коммерческих серверах WSGI (большинство дистрибутов Linux будут работать хорошо ... !! Windows не поддерживается ... !!)
- Расшиппируйте загруженный файл Zip Release (используя любое программное обеспечение Zip Extractor. Например: Winrar, 7zip и т. Д.)
- Откройте извлеченную папку и создайте новый файл .Env 'в этом месте и настройте его, как объяснялось ранее (в разделе «Конфигурация / среда Vriables») (используйте любое программное обеспечение текстового редактора или редакторы текста терминала. Например: Notepad, Vim, Nano)
- Загрузите все извлеченные файлы вместе с файлом .env в корне сервера
- Убедитесь, что вы уже установили Python3 и PIP на вашем сервере (большинство дистрибутов в Linux поставляется с предварительно установленным Python3. Вам просто нужно установить PIP), чтобы установить PIP с помощью APT Package Manager в Ubuntu Запустите эту команду ниже в терминале вашего сервера:
sudo apt install python3-pip
- Теперь, чтобы установить все зависимости запустить эту команду:
pip install -r requirements.txt
- Теперь, чтобы начать эту команду, запустить эту команду:
- Чтобы остановить бота, вы можете использовать Ctrl + C или эту команду:
pkill -SIGINT -f 'gunicorn -b 0.0.0.0:8080 -w 4 webserver:adlinkflytgbot'
Вклад / здание из источника:
- Хотите быть частью этого проекта? Не стесняйтесь вносить свой вклад .. !! Запросы на вытягивание всегда приветствуются .... !! Следуйте этим простым шагам, чтобы начать строительство. Полем Полем
- Использование среды разработки Linux требуется | Для Windows используйте WSL или просто разверните контейнер Docker
- Разветвляй эту репо в своей учетной записи GitHub
- Git клонировать раздвоенный репо в вашей местной машине
- Создайте свой файл .env, как объяснено ранее
- Установите все зависимости:
pip install -r requirements.txt
- Запустите бот:
- Сделайте изменения, отправьте запрос на привлечение с правильным описанием (примечание: запросы на вытягивание без надлежащего описания будут отклонены)
Лицензия и использование
Adlinkfly Telegram Bot-это проект с открытым источником, лицензированный в рамках GPL-3.0, каждый может просматривать, изменять или использовать (личные и коммерческие) его источники без каких-либо дополнительных разрешений. Если вы хотите распространять его источники, пожалуйста, рассмотрите возможность дать ему атрибуцию этого репо. Примечание. Этот сценарий официально не разработан, поддерживается или аффилирован Mightyscripts. Это всего лишь мой хобби -проект!
Проект с открытым источником - разработанный с ♥ Subhamoy