AdLinkfly Telegram Bot
برنامج بسيط لاستخدام برامج BOT TELEGRAM BOT القائمة على Python مصمم للعمل مع موقع Adlinlfly PHP Link Shortener باستخدام ADLINKFLY Developer API!
⚡ 1 انقر فوق النشر:
- 1 انقر النقر هو أسهل طريقة لنشر هذا الروبوت! انقر على هذه الأزرار لنشر الروبوت في النظام الأساسي المقابل. فقط تأكد من ملء/استبدال القيم المتغيرة البيئية المناسبة عند الطلب. يتم شرح المعلمات أدناه بالتفاصيل (في قسم التكوين / البيئة Vriables).
؟ متطلبات:
- حزم بيثون:
- Pytelegrambotapi
- Telebot
- الطلبات
- Regex
- قارورة
- الخيوط
- Gunicorn
- Python-dotenv
- يجب أن يكون لديك موقع ويب adlinkfly link shortener مستضاف على الويب يحمل اسم مجال صالح
- يحتوي موقع AdLinkfly الخاص بك على شهادة SSL صالحة مثبتة (يمكن الوصول إليها عبر بروتوكول HTTPS!)
- يجب أن تكون قد قمت بتكوين envioronment وقت تشغيل مناسب (WSGI متوافق) لتشغيل البرامج النصية Python! (موصى به: Render ، koyeb ، referen -or- حاوية Docker في خادمك المخصص)
؟ ️ الميزات:
- من السهل الاندماج والتخصيص (ملف التكوين الكل في واحد!)
- اكتشاف URL التلقائي وتقصيره (لا يلزم أي أوامر إضافية! فقط أرسل الرابط إلى تقصير ... إنه سهل للغاية .. !!)
- يدعم تقصير الارتباط مع الاسم المستعار المخصص
- التحقق من ارتباط المستخدم التلقائي مع رسائل الخطأ.
- أوامر Telegram المتاحة:
- /ابدأ - يعرض رسالة ترحيب مخصصة عندما يبدأ المستخدم في المحادثة الأولى مع الروبوت
- /مساعدة - يعرض رسالة مساعدة ودعم مخصصة عند إعطاء أمر /مساعدة من قبل المستخدم
- /الإعلانات - تقصر الرابط مع الإعلانات. يخلق أيضا صفحة رابط قصيرة منفصلة! (* بشكل افتراضي ، تم تعيين طريقة تقصير الارتباط على التقصير المباشر دون أي إعلانات وصفحة الارتباط القصير ، إذا أراد المستخدم تقصير الرابط بالإعلانات وصفحة الارتباط القصير ، يكون الأمر /الإعلانات مطلوبًا في كل مرة!)
- /الاسم المستعار - يقصر الرابط مع الاسم المستعار المخصص من اختيارك (على سبيل المثال: yourdomain.com/cool-alias)
- /alias_ads - يقصر الرابط مع الاسم المستعار المخصص من اختيارك ويقوم أيضًا بإنشاء صفحة ارتباط قصيرة منفصلة تتضمن إعلانات
؟ تحميل:
- لا تحتاج إلى تنزيل أي شيء لمعظم الحالات (باستثناء: أنت تنشر هذا في الخادم المخصص الخاص بك مباشرة)
- لنشر الخادم المخصص (مباشر) قم بتنزيل أحدث ZIP من الإصدارات القسم: adlinkfly-telegram-bot-vx.xxzip تنزيل الآن
التكوين / البيئة vribles:
- يوجد ملف تكوين عالمي واحد فقط. يتم عرض مثال على الحقول المتاحة في ملف ".env.example" وأيضًا موصوفًا أدناه (إذا كنت تستخدم حلول النشر بنقرة واحدة ، فلن تحتاج إلى إنشاء أي ملف منفصل.
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) من جهاز المضيف الخاص بك والذي يمكن كتابته بواسطة هذا المتغير
- الرسائل المخصصة:
- ابدأ = اكتب الرسالة المخصصة التي تريد عرضها على المستخدم عندما يستخدمون الأمر Telegram " /ابدأ"
- مساعدة = كتابة الرسالة المخصصة التي تريد عرضها على المستخدم عندما يستخدمون الأمر Telegram " /مساعدة"
- مزيد من التخصيص للأوامر ممكن عن طريق تعديل رمز مصدر Python .... إذا كنت تريد أن تجرب ... !!!
التثبيت / النشر:
1 انقر فوق النشر (أسهل):
- ما عليك سوى النقر على أي واحد من الزر المقدم في الأعلى (حيث تريد النشر) ومتابعة الخطوات. ملاحظة: تأكد من تسجيل الدخول إلى النظام الأساسي أولاً قبل النقر على الزر
- سيُطلب منك ملء القيم المتغيرة للبيئة (تحقق من قسم التكوين / البيئة Vriables لمزيد من المعلومات) قم بتعبئة القيم بشكل صحيح ومتابعة. هذا كل شيء...!!
- النظام الأساسي الخاص بك غير مدرج؟ -> أحاول باستمرار دمج المزيد والمزيد من المنصات. ولكن ، إذا كان لا يزال غير مدرج ، فيمكنك تجربة خيار النشر المخصص أو الاتصال بي للحصول على مزيد من المعلومات.
نشر الإعادة:
- استخدم خيار "استيراد من Github" لاستيراد هذا الريبو. لا أعرف كيف تفعل ذلك؟ اقرأ هنا
- استخدم عنوان URL هذا للاستيراد:
https://github.com/techishfellow/adlinkfly-telegram-bot.git
- افتح نافذة "شل" وقم بتشغيل هذا الأمر لتثبيت جميع التبعيات:
pip install -r requirements.txt
افتح نافذة "أسرار" وتكوين جميع الأسرار كما هو موضح سابقًا (في قسم التكوين / البيئة Vriables). تعمل أسرار الإعادة على نفس متغيرات البيئة. لا تعرف كيفية استخدام أسرار الإعادة؟ اقرأ هنا
الآن ما عليك سوى النقر على زر "تشغيل" الأخضر في الجزء العلوي لبدء الروبوت. هذا كل شيء...!!
نشر الخادم المخصص (مع Docker) (موصى به):
- تثبيت Docker و Docker Compose Plugin (على Ubuntu / Debian):
curl -sSL https://get.docker.com/ | CHANNEL=stable sh && apt install docker-compose-plugin
- استنساخ مستودع adlinkfly telegram bot 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. على سبيل المثال: 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 يمكن لأي شخص عرض أو تعديل أو استخدام مصادره (الشخصية والتجارية) دون أي أذونات إضافية. إذا كنت ترغب في توزيع مصادرها ، فيرجى التفكير في إعطائها إسنادًا لهذا الريبو. ملاحظة: لم يتم تطوير هذا البرنامج النصي رسميًا أو دعمه أو التابع له بواسطة MayyScripts. هذا مجرد مشروع هواية لي!
مشروع مفتوح من مصادر - تم تطويره مع ♥ بواسطة Subhamoy