Перейти к содержанию

Запуск в CLI

Эта страница приведет вас из ничего к работающему боту. Никакого предварительного опыта работы с проект нужен. Если слово непонятно, проверьте Основные понятия страницы.

Прежде чем начать

Вам нужны две вещи от Telegram:

  1. Токен бота. Откройте чат с @BotFather, отправьте /newbot, следуйте инструкциям и скопируйте токен, который он вам предоставит. Это выглядит например 123456789:AAExampleTokenValue.
  2. Ваш числовой идентификатор пользователя. Это номер, а не ваш @username. Если вы его не знаете, не волнуйтесь — бот сообщит вам ваш идентификатор при первом посещении сообщите об этом (см. шаг 5).

Шаг 1: загрузка

Загрузите архив релиза и распакуйте его.

Загрузите и откройте папку выпуска

Download and extract the release
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

Внутри папки вы найдете:

Шаг 2: выберите бинарный файл

Какой файл предназначен для вашей машины?

Большинство серверов и компьютеров имеют код amd64 (также называемый x86_64). Маленькие платы ARM а некоторые облачные виртуальные машины — arm64.

Если вы не уверены, запустите uname -m: x86_64 означает amd64, aarch64 означает arm64.

Keep the amd64 program
mv telegram-commander-linux-amd64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-arm64
Keep the arm64 program
mv telegram-commander-linux-arm64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-amd64

Теперь у вас есть одна программа с именем telegram-commander.

Шаг 3: создайте свою конфигурацию

Скопируйте минимальный пример в рабочий файл. Он открывает категорию System Status с тремя кнопками только для чтения: Uptime, Memory и Disk Space. Кнопки для произвольной команды нет.

Создать редактируемый конфиг

Copy the example config
cp config-examples/config.minimal.yaml ./config.yaml

Откройте config.yaml и замените два заполнителя:

  • YOUR_BOT_TOKEN — токен от BotFather
  • YOUR_USER_ID — ваш числовой идентификатор (или пока оставьте его и смотрите шаг 5)

Чтобы узнать, что означает каждый параметр, прочтите Конфигурация.

Шаг 4: проверка

Всегда проверяйте конфигурацию перед запуском. Это выявляет опечатки и ошибки без запуск бота.

Проверьте работоспособность конфигурации

Validate the config
./telegram-commander validate --config config.yaml

Если он напечатает Valid configuration, все в порядке. Если нет, то там указано, что именно ошибается и где. Подробности см. на странице CLI.

Шаг 5: найдите свой идентификатор пользователя (при необходимости)

Если вы не знали свой идентификатор пользователя, задайте в config.yaml только токен, поставьте любой номер в allowed_users на данный момент, затем запустите бота:

Начните один раз, чтобы увидеть свой идентификатор пользователя

Run the bot to learn your id
./telegram-commander run --config config.yaml

Откройте Telegram, найдите своего бота и отправьте ему любое сообщение. Потому что вы не в разрешённых пользователей, бот отвечает вашим user_id и username. Скопируйте этот идентификатор в allowed_users, остановите бота с помощью Ctrl+C и запустите его еще раз.

Такое поведение является частью того, как работает контроль доступа; увидеть Конфигурация → telegram.

Шаг 6: запустить

Запустить бота в терминале

Start the bot
./telegram-commander run --config config.yaml

Откройте своего бота в Telegram и отправьте /start. Вы должны увидеть свое меню. Нажмите кнопка, чтобы запустить команду.

Ваш бот активен

Меню, которое вы описали в config.yaml, теперь есть в вашем чате, и каждое нажатие запускает свою команду на этой машине.

Чтобы бот продолжал работать после выхода из сервера, настройте его как службу. См. Запуск как служба .

Что дальше