ربات Telegram

یک ربات Telegram را به 3x-ui متصل کنید تا فرمان‌ها، گزارش‌های دوره‌ای، هشدارهای رویداد (ورود، CPU، بالا/پایین شدن نود)، پشتیبان‌گیری و سلف‌سرویس کلاینت‌ها را در اختیار داشته باشید.

3x-ui می‌تواند یک ربات Telegram را برای پایش، هشدار، پشتیبان‌گیری و مدیریت از راه دور به کار گیرد. ادمین‌ها کنترل کامل دارند؛ کاربران عادی (که با Telegram ID پیوند خورده‌اند) می‌توانند مصرف و لینک‌های خودشان را بررسی کنند.

دنبال اخبار و پشتیبانی انجمن هستید؟ به کانال رسمی Telegram یعنی @XrayUI بپیوندید. این از ربات زیر جداست، رباتی که خودتان آن را برای مدیریت پنل خودتان اجرا می‌کنید.

راه‌اندازی

ساختن یک ربات

به @BotFather پیام بدهید، /newbot را ارسال کنید و توکن ربات را کپی نمایید.

پیدا کردن Telegram ID خودتان

شناسه‌ی عددی کاربری Telegram خود را به دست آورید (پس از اتصال، فرمان /id خودِ ربات آن را گزارش می‌کند). این همان شناسه‌ی ادمین شماست.

پیکربندی پنل

در تنظیمات پنل، ربات Telegram را فعال کنید و توکن و شناسه‌(های) چت ادمین را (با کاما جداشده) تنظیم نمایید. ذخیره کنید، سپس به ربات خود پیام بدهید.

فرمان‌ها

این‌ها در منوی فرمان Telegram ظاهر می‌شوند: /start، /help، /status، /id. فرمان‌های دیگر:

فرمان	چه کسی	عملکرد
`/start`، `/help`	همه	پیام خوش‌آمدگویی و منوی دکمه‌های درون‌خطی
`/status`	همه	تأیید فعال بودن ربات
`/id`	همه	نمایش شناسه‌ی عددی Telegram شما
`/usage <arg>`	هر دو	ادمین‌ها کلاینت‌ها را جست‌وجو می‌کنند؛ کاربران مصرف خود را می‌بینند
`/inbound <remark>`	ادمین	نمایش جزئیات یک ورودی
`/restart`	ادمین	راه‌اندازی مجدد Xray

ادمین‌ها همچنین جریان‌های دکمه‌ی درون‌خطی برای مصرف سرور، گزارش‌های ترافیک مرتب‌شده، بازنشانی ترافیک، پشتیبان‌گیری از DB، گزارش‌های مسدودسازی، فهرست کردن ورودی‌ها/کلاینت‌ها، کلاینت‌های آنلاین، «به‌زودی تمام‌شونده» و یک جادوگر کامل افزودن کلاینت را در اختیار دارند. کاربران عادی دکمه‌هایی برای مصرف خودشان، لینک‌های اشتراک، لینک‌های منفرد و کدهای QR دارند.

گزارش‌ها و هشدارها

گزارش دوره‌ای — بر اساس زمان‌بندی tgRunTime (به‌صورت پیش‌فرض @daily)، ربات مصرف سرور (هاست، نسخه‌ها، آپ‌تایم، بار، حافظه، کلاینت‌های آنلاین، ترافیک)، فهرستی از کلاینت‌های تمام‌شده/در‌حال‌انقضا و — اگر tgBotBackup فعال باشد — یک نسخه‌ی پشتیبان از پایگاه‌داده و پیکربندی Xray را برای ادمین‌ها می‌فرستد. کلاینت‌هایی که با Telegram ID پیوند خورده‌اند، هشدارهای انقضا/سهمیه‌ی خودشان را دریافت می‌کنند.

هشدارهای رویداد — با tgEnabledEvents انتخاب می‌شوند (به‌صورت پیش‌فرض login.attempt,cpu.high):

رویداد	چه زمانی
`login.attempt`	ورود به پنل موفق یا ناموفق شود (همراه با IP و نام کاربری)
`cpu.high`	CPU از `tgCpu` درصد فراتر برود (به‌صورت پیش‌فرض ۸۰)
`memory.high`	حافظه از `tgMemory` درصد فراتر برود (به‌صورت پیش‌فرض ۸۰)
`xray.crash`	Xray-core کرش کند
`outbound.down` / `outbound.up`	یک خروجی از کار بیفتد / بازیابی شود
`node.down` / `node.up`	یک نود آفلاین شود / بازگردد

زمان‌های پیش‌هشدار از expireDiff (روزهای پیش از انقضا) و trafficDiff (گیگابایتِ باقی‌مانده از سهمیه) می‌آیند؛ هر دو به‌صورت پیش‌فرض 0 هستند (خاموش).

تنظیمات

تنظیم	پیش‌فرض	معنا
`tgBotEnable`	`false`	روشن/خاموش اصلی.
`tgBotToken`	(محرمانه)	توکن API ربات.
`tgBotChatId`	(هیچ‌کدام)	شناسه‌های Telegram ادمین، جداشده با کاما.
`tgBotProxy`	(هیچ‌کدام)	پروکسی `socks5://`، `http://` یا `https://`.
`tgBotAPIServer`	(پیش‌فرض)	سرور سفارشی Telegram Bot API.
`tgRunTime`	`@daily`	زمان‌بندی گزارش (cron / `@daily` / `@every …`).
`tgBotBackup`	`false`	ضمیمه کردن یک نسخه‌ی پشتیبان DB به گزارش دوره‌ای.
`tgCpu` / `tgMemory`	`80` / `80`	آستانه‌های هشدار CPU / حافظه (درصد).
`tgLang`	`en-US`	زبان ربات.
`tgEnabledEvents`	`login.attempt,cpu.high`	اینکه کدام رویدادها تحویل داده شوند.

توکن ربات کنترل ربات شما را در دست دارد — آن را محرمانه نگه دارید و فقط شناسه‌های چت ادمین مورد اعتماد را اضافه کنید. هشدارهای ورود هرگز شامل رمزهای عبور نمی‌شوند.

اگر ترجیح می‌دهید هشدارها را از طریق ایمیل دریافت کنید، اعلان‌های ایمیل (SMTP) همان رویدادها را بازتاب می‌دهند (smtpEnabledEvents) — SMTP را در تنظیمات پنل پیکربندی نمایید.