📦
Hosting

Telegram Bot API local server: katta fayllar bilan işlaş uçun öz serveringiz

11.11.2026
← Barça maqolalar

Telegram botlarining köpçiligi api.telegram.org manziliga sörov yuborib işlaydi va bu köp hollarda yetarli. Lekin bot fayllar bilan işlay boşlaganda çeklovlar seziladi: rasmiy hujjatlarga köra standart Bot API orqali bot 20 MB gaça bölgan fayllarnigina yuklab oladi va 50 MB gaça bölgan fayllarnigina yubora oladi. Video, arxiv yoki katta PDF bilan işlaydigan bot uçun bu jiddiy tösiq. Telegram bu muammo uçun oçiq kodli yeçim taklif qiladi: Bot API serverini öz serveringizda işga tuşiriş.

Local server nima beradi

Telegram Bot API serverining manba kodi tdlib/telegram-bot-api omborida oçiq e'lon qilingan. U --local rejimida işga tuşirilganda bot bir qator kengaytirilgan imkoniyatlarga ega böladi. Hujjatlarda keltirilgan asosiy farqlar quyidagiça:

Muhim jihat şundaki, bot baribir Telegram tarmoği bilan boğlangan holda işlaydi. Local server faqat bot bilan Telegram örtasidagi vositaçini sizning serveringizga köçiradi, xabarlar va fayllar esa avvalgidek Telegram orqali foydalanuvçilarga yetib boradi.

Real misol: video studiya boti

Farğonadagi kiçik video studiya mijozlardan töy va tadbir videolarini bot orqali qabul qilmoqçi deylik. Mijozlar telefondan 300-800 MB hajmdagi fayllarni yuboradi, bot ularni qabul qilib, montaj jamoasining saqlaş diskiga joylaşi kerak. Standart Bot API bilan bot bunday faylni yuklab ola olmaydi va getFile çaqiruvi xato qaytaradi. Local server örnatilgaç, fayl töğridan-töğri serverning diskiga tuşadi va bot uni oddiy fayl sifatida köçirib qöyadi. Bunday yeçim uçun VPS kerak böladi, çunki oddiy shared hostingda öz dasturingizni kompilyatsiya qilib, doimiy xizmat sifatida işlatib bölmaydi.

api_id va api_hash oliş

Local server Telegram'ga öz nomidan ulanadi, şuning uçun unga ilova identifikatorlari kerak. Ularni my.telegram.org saytida Telegram akkauntingiz bilan kirib, "API development tools" bölimida olasiz. Natijada ikki qiymat beriladi: raqamli api_id va satr körinişidagi api_hash. Bu qiymatlar bot tokeni kabi maxfiy hisoblanadi, ularni oçiq repozitoriyga qöymang va faqat serverdagi konfiguratsiyada saqlang.

Serverda kompilyatsiya qiliş

Rasmiy ombordagi körsatmalar turli tizimlar uçun buyruqlarni beradi. Ubuntu yoki Debian uçun jarayon taxminan quyidagiça böladi. Kompilyatsiya köp operativ xotira talab qilişi va bir neça ön daqiqa davom etişi mumkin, kiçik VPS'larda vaqtinçalik swap qöşiş yoki rasmiy hujjatlardagi kam xotira uçun tavsiyalardan foydalaniş foydali.

sudo apt-get update
sudo apt-get install -y make git zlib1g-dev libssl-dev gperf cmake g++
git clone --recursive https://github.com/tdlib/telegram-bot-api.git
cd telegram-bot-api
rm -rf build && mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr/local ..
cmake --build . --target install
telegram-bot-api --help

Hamjamiyat tomonidan tayyorlangan Docker obrazlari ham mavjud, ular kompilyatsiya vaqtini tejaydi. Lekin ular rasmiy emas, şuning uçun işlatişdan oldin manbasini va yangilanib turişini tekşiring.

systemd xizmati sifatida işga tuşiriş

Server doimiy işlaşi va qayta yuklanişdan keyin özi kötarilişi kerak. Buning uçun alohida foydalanuvçi, fayllar uçun katalog va systemd xizmati yaratamiz. --http-port server tinglaydigan portni, --dir esa fayllar va iş ma'lumotlari saqlanadigan katalogni belgilaydi.

sudo useradd -r -s /usr/sbin/nologin tgapi
sudo mkdir -p /var/lib/telegram-bot-api
sudo chown tgapi:tgapi /var/lib/telegram-bot-api

# /etc/systemd/system/telegram-bot-api.service
[Unit]
Description=Telegram Bot API local server
After=network.target

[Service]
User=tgapi
EnvironmentFile=/etc/telegram-bot-api.env
ExecStart=/usr/local/bin/telegram-bot-api --local --http-port=8081 \
  --http-ip-address=127.0.0.1 --dir=/var/lib/telegram-bot-api
Restart=always

[Install]
WantedBy=multi-user.target

/etc/telegram-bot-api.env fayliga TELEGRAM_API_ID=... va TELEGRAM_API_HASH=... qatorlarini yozing; server bu muhit özgaruvçilarini öqiy oladi. Söng sudo systemctl enable --now telegram-bot-api bilan işga tuşiring. 8081-port taşqariga oçilmasligi kerak, aks holda token bilgan har kim serveringiz orqali sörov yubora oladi.

Botni local serverga ötkaziş

Bot avval rasmiy serverda işlagan bölsa, uni local serverga ötkazişdan oldin api.telegram.org manzilida logOut metodini çaqiriş kerak. Hujjatlarga köra şundan keyin botni bir muddat, taxminan 10 daqiqa, rasmiy serverga qayta ulab bölmaydi, şuning uçun ötişni rejalaştirib qiling.

curl "https://api.telegram.org/bot<TOKEN>/logOut"

Keyin bot kodida API manzilini almaştiriş kifoya. Masalan, aiogram 3 da bu quyidagiça bajariladi:

from aiogram import Bot
from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer

session = AiohttpSession(
    api=TelegramAPIServer.from_base("http://127.0.0.1:8081", is_local=True)
)
bot = Bot(token=TOKEN, session=session)

Disk va xavfsizlik haqida unutmang

Local rejimda yuklab olingan fayllar --dir katalogida qoladi va öz-özidan öçirilmaydi. Video studiya misolida bir neça hafta içida disk tölib qolişi mumkin, şuning uçun qayta işlangan fayllarni boşqa joyga köçirib, eski fayllarni muntazam tozalaydigan skript yozing. Bot jarayoni bu fayllarni öqiy olişi uçun ikkala xizmat bitta guruhga kiritilişi yoki katalog huquqlari töğri sozlanişi kerak. Server versiyasini ham vaqti-vaqti bilan yangilab turing, çunki Telegram Bot API'ga yangi metodlar qöşilganda ular local serverga ham yangi versiya orqali keladi.

Öxşaş maqolalar

🛡️ OJS jurnal saytini botlardan himoyalaş: qidiruv, yuklama va loglar 🛠️ Texnik yordamga töğri murojaat: muammo tez hal bölişi uçun nima yoziş kerak 🧭 Vektor bazani öz serveringizda işlatiş: Qdrant va pgvector 🧭 Portainer: Docker konteynerlarini brauzer orqali boşqariş
🌐 Til
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) ✓ 🇺🇿 Ўзбек 🇷🇺 Русский 🇬🇧 English