Adlinkfly Telegram Bot
Adlinkfly Developer API를 사용하여 Adlinlfly PHP Link Shortener 웹 사이트와 함께 작동하도록 설계된 Python 기반 Telegram Bot 스크립트를 사용하는 간단합니다!
⚡ 1 클릭 배포 :
- 1 클릭 배포는이 봇을 배포하는 가장 쉬운 방법입니다! 해당 플랫폼에서 봇을 배포하려면이 버튼을 클릭하십시오. 요청할 때 적절한 환경 가변 값을 채우거나 교체하십시오. 매개 변수는 아래 세부 사항 (구성 / 환경 Vribles 섹션)으로 설명합니다.
? 요구 사항 :
- 파이썬 패키지 :
- Pytelegrambotapi
- 텔레 보트
- 요청
- 리그 즈
- 플라스크
- 나사산
- 건니콘
- Python-dotenv
- 유효한 도메인 이름으로 웹에서 호스팅 된 Adlinkfly 링크 Shortener 웹 사이트가 있어야합니다.
- Adlinkfly 웹 사이트에는 유효한 SSL 인증서가 설치되어 있습니다 (HTTPS 프로토콜을 통해 액세스 가능!)
- Python 스크립트를 실행하기 위해 적절한 런타임 환경 (WSGI 호환)을 구성해야합니다! (권장 : Render, Koyeb, Replit- 또는 사용자 정의 서버의 Docker 컨테이너)
? ️ 특징 :
- 통합하기 쉽고 사용자 정의가 가능합니다 (올인원 구성 파일!)
- 자동 URL 감지 및 단축 (추가 명령이 필요하지 않습니다! 링크를 보내기 만하면 너무 쉽습니다 .. !!)
- 사용자 정의 별칭으로 링크 단축을 지원합니다
- 오류 메시지를 통한 자동 사용자 인치 링크 링크 유효성 검사.
- 사용 가능한 Telegram 명령 :
- /시작 - 사용자가 봇과 첫 대화를 시작할 때 사용자 정의 환영 메시지 표시
- /도움말 - 사용자가 /help 명령을 내릴 때 사용자 정의 도움말 및 지원 메시지가 표시됩니다.
- /ADS- 광고 와 링크를 단축시킵니다. 또한 별도의 짧은 링크 페이지를 만듭니다! (* 기본적으로 링크 단축 메소드는 광고 및 짧은 링크 페이지없이 직접 단축 으로 설정되어 있습니다. 사용자가 광고 및 짧은 링크 페이지 로 링크를 단축하려면 /ADS 명령이 매번 필요합니다!)
- /별명 - 선택한 사용자 정의 별명으로 링크를 단축시킵니다 (예 : yourdomain.com/cool-alias)
- /alias_ads- 선택한 사용자 정의 별칭으로 링크를 단축하고 광고를 포함하는 별도의 짧은 링크 페이지를 만듭니다.
? 다운로드 :
- 대부분의 경우에 아무것도 다운로드 할 필요가 없습니다 (제외 : 자신의 사용자 정의 서버에 직접 배포하고 있습니다).
- Custom Server Deployment (Direct)의 경우 릴리스 섹션에서 최신 zip 다운로드 : Adlinkfly-Telegram-Bot-vx.xxzip 지금 다운로드
구성 / 환경 vriberbles :
- 봇에 대해 구성 해야하는 환경 변수라고도하는 글로벌 구성 파일 '.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)없이 nacked 도메인 이름을 쓰십시오.
- API_TOKEN = Telegram BOT API 토큰을 여기에 붙여 넣으십시오. 하나를 얻는 방법을 모르십니까? 여기를 읽으십시오
- adlinkfly_token = adlinkfly 개발자 API 토큰을 여기에 붙여 넣으십시오. 하나를 얻는 방법을 모르십니까? 여기를 읽으십시오
- 선택 필드 :
- host_port = 내부 Docker 컨테이너 포트 (8080)를 호스트 시스템의 지정된 포트에 맵핑합니다. 다른 프로세스가 어떤 이유로 호스트 머신의 동일한 포트에서 실행될 때 유용하여 오작동으로 이어질 수 있습니다. 기본적 으로이 변수에 의해 덮어 쓸 수있는 호스트 머신의 동일한 포트 (8080)를 사용합니다.
- 사용자 정의 메시지 :
- start = Telegram Command ' /start'를 사용할 때 사용자에게 표시하려는 사용자 정의 메시지를 작성하십시오.
- HELP = Telegram Command ' /Help' 를 사용할 때 사용자에게 표시하려는 사용자 정의 메시지를 작성하십시오.
- Python 소스 코드를 수정하여 명령의 추가 사용자 정의가 가능합니다 .... 원하는 경우 시도 할 수 있습니다 ... !!!
설치 / 배포 :
1 클릭 배포 (가장 쉬운) :
- 상단에 제공된 버튼 중 하나를 클릭하고 (배포 할 플랫폼) 단계를 따르십시오. 참고 : 버튼을 클릭하기 전에 먼저 플랫폼을 로그인해야합니다.
- 환경 변수 값을 채우도록 요청받습니다 (자세한 정보는 구성 / 환경 vrible 섹션 확인) 값을 올바르게 작성하고 진행하십시오. 그게 다야 ... !!
- 플랫폼이 나열되지 않습니까? -> 나는 점점 더 많은 플랫폼을 지속적으로 통합하려고 노력하고 있습니다. 그러나 여전히 나열되지 않은 경우 사용자 정의 배포 옵션을 시도하거나 추가 정보를 보려면 저에게 연락 할 수 있습니다.
배포 대답 :
- 'github에서 가져 오기'옵션을 사용 하여이 리포트를 가져 오십시오. 어떻게 해야할지 모르십니까? 여기를 읽으십시오
https://github.com/techishfellow/adlinkfly-telegram-bot.git
- '쉘'창을 열고이 명령을 실행하여 모든 종속성을 설치하십시오.
pip install -r requirements.txt
앞에서 설명한대로 '비밀'창을 열고 모든 비밀을 구성하십시오 (구성 / 환경 vribles 섹션). REPLIT SECRETS는 환경 변수와 동일하게 작동합니다. REPLIT 비밀을 사용하는 방법을 모르십니까? 여기를 읽으십시오
이제 상단의 녹색 '실행'버튼을 클릭하여 봇을 시작하십시오. 그게 다야 ... !!
사용자 정의 서버 배포 (Docker와 함께) (권장) :
- Docker 및 Docker Compose 플러그인 설치 (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 파일을 만들고 명령 줄 텍스트 편집기 Nano를 사용하여.
cd /opt/adlinkfly-telegram-bot && touch /opt/adlinkfly-telegram-bot/.env && nano /opt/adlinkfly-telegram-bot/.env
CTRL + O 로 저장 한 다음 Enter 누르고 나노 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 Compitable 서버에서만 작동합니다 (대부분의 Linux 배포판은 잘 작동합니다 ... !! Windows는 지원되지 않습니다 ... !!)
- 다운로드 된 릴리스 ZIP 파일을 압축 해제 (Zip Extractor 소프트웨어 사용. 예 : Winrar, 7ZIP 등)
- 추출 된 폴더를 열고 해당 위치에 새 '.env'파일을 만들고 앞에서 설명한대로 구성하십시오 (구성 / 환경 vriblebles 섹션에서) (텍스트 편집기 소프트웨어 또는 터미널 텍스트 편집기 사용. 예 : Notepad, Vim, Nano).
- 서버 루트의 .env 파일과 함께 추출 된 모든 파일을 업로드하십시오.
- 서버에 이미 Python3 및 PIP를 설치했는지 확인하십시오 (대부분의 Linux 배포판은 Python3과 함께 제공됩니다. PIP를 설치하면 PIP를 설치하면 Ubuntu의 APT 패키지 관리자와 함께 PIP를 설치해야합니다. 서버 터미널에서 아래 명령을 실행하십시오.
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에 따라 라이센스가 부여 된 오픈 소스 프로젝트입니다. 누구나 추가 권한이없는 소스를보고, 수정 또는 사용 할 수 있습니다 (개인 및 상업). 배포하려면 소스를 배포하려면이 repo의 속성을 제공하는 것이 좋습니다. 참고 :이 스크립트는 공식적으로 강력한 스크립트에 의해 개발, 지원 또는 소속되지 않습니다. 이것은 단지 취미 프로젝트입니다!
오픈 소스 프로젝트 - Subhamoy 의 ♥와 함께 개발되었습니다.
