پرش به محتویات

اجرا در CLI

این صفحه شما را از نقطهٔ شروع تا یک ربات در حال اجرا پیش می‌برد. نیازی به تجربهٔ قبلی با پروژه ندارید. اگر واژه‌ای نامفهوم بود، صفحات مفاهیم را ببینید.

پیش از شروع

به دو مورد از تلگرام نیاز دارید:

  1. توکن ربات. گفتگویی با @BotFather باز کنید، /newbot را بفرستید، مراحل را دنبال کنید و توکنی را که می‌دهد کپی کنید. ظاهر آن شبیه 123456789:AAExampleTokenValue است.
  2. شناسهٔ عددی کاربر شما. این یک عدد است، نه @username شما. اگر آن را نمی‌دانید نگران نباشید؛ ربات نخستین بار که به آن پیام بدهید شناسه را اعلام می‌کند (گام ۵ را ببینید).

گام ۱: دریافت

بایگانی نسخه را دریافت و استخراج کنید.

دریافت و باز کردن پوشهٔ نسخه

دریافت و استخراج نسخه
wget -O telegram-commander.tar.gz https://github.com/azolfagharj/telegram-commander/releases/latest/download/telegram-commander.tar.gz
tar -xzf telegram-commander.tar.gz
cd telegram-commander

درون پوشه این موارد را می‌بینید:

گام ۲: انتخاب فایل اجرایی

کدام فایل برای دستگاه شماست؟

بیشتر سرورها و رایانه‌ها amd64 هستند (که x86_64 نیز نامیده می‌شود). بردهای کوچک ARM و برخی ماشین‌های مجازی ابری arm64 هستند.

اگر مطمئن نیستید، uname -m را اجرا کنید: x86_64 یعنی amd64 و aarch64 یعنی arm64.

نگه داشتن برنامهٔ amd64
mv telegram-commander-linux-amd64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-arm64
نگه داشتن برنامهٔ arm64
mv telegram-commander-linux-arm64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-amd64

اکنون یک برنامه به نام telegram-commander دارید.

گام ۳: ساخت پیکربندی

نمونهٔ کمینه را در یک فایل کاری کپی کنید. دستهٔ System Status با سه دکمهٔ فقط‌خواندنی باز می‌شود: Uptime، Memory و Disk Space. دکمهٔ فرمان آزاد وجود ندارد.

ساخت پیکربندی قابل ویرایش

کپی کردن پیکربندی نمونه
cp config-examples/config.minimal.yaml ./config.yaml

config.yaml را باز کنید و دو جایگزین را عوض کنید:

  • YOUR_BOT_TOKEN — توکن دریافتی از BotFather
  • YOUR_USER_ID — شناسهٔ عددی شما (یا فعلاً آن را رها کنید و گام ۵ را ببینید)

برای آشنایی با همهٔ تنظیمات، پیکربندی را بخوانید.

گام ۴: اعتبارسنجی

همیشه پیش از اجرا پیکربندی را بررسی کنید. این کار غلط‌های تایپی و اشتباه‌ها را بدون شروع ربات پیدا می‌کند.

بررسی کار کردن پیکربندی

اعتبارسنجی پیکربندی
./telegram-commander validate --config config.yaml

اگر Valid configuration چاپ شد، همه‌چیز آماده است. در غیر این صورت دقیقاً مشکل و محل آن فهرست می‌شود. برای جزئیات صفحهٔ CLI را ببینید.

گام ۵: یافتن شناسهٔ کاربر (در صورت نیاز)

اگر شناسهٔ کاربر خود را نمی‌دانید، فقط توکن را در config.yaml تنظیم کنید، فعلاً هر عددی در allowed_users بگذارید و سپس ربات را اجرا کنید:

یک‌بار اجرا برای دیدن شناسهٔ کاربر

اجرای ربات برای یافتن شناسه
./telegram-commander run --config config.yaml

تلگرام را باز کنید، ربات خود را پیدا کنید و هر پیامی برایش بفرستید. چون هنوز در کاربران مجاز نیستید، ربات با user_id و username شما پاسخ می‌دهد. آن شناسه را در allowed_users کپی کنید، ربات را با Ctrl+C متوقف کنید و دوباره اجرا کنید.

این رفتار بخشی از کنترل دسترسی است؛ پیکربندی ← telegram را ببینید.

گام ۶: اجرا

شروع ربات در ترمینال

شروع ربات
./telegram-commander run --config config.yaml

ربات خود را در تلگرام باز کنید و /start را بفرستید. باید منوی خود را ببینید. برای اجرای فرمان، یک دکمه را لمس کنید.

ربات شما فعال است

منویی که در config.yaml توصیف کرده‌اید اکنون در گفتگوی شماست و هر لمس، فرمان همان دکمه را روی این دستگاه اجرا می‌کند.

برای روشن ماندن ربات پس از خروج از سرور، آن را به‌صورت سرویس تنظیم کنید. اجرا به‌صورت سرویس را ببینید.

گام بعدی