December 2, 2023

Инструкция по установке #F4723c5e-dd1e-4B6F-ac72-5F858DA568f5

В этой статье вы можете прочитать:

  1. Первичная настройка(Создание бота, изменение текста, редактирование файлов)
  2. Установка на ОС Ubuntu 20.04

Первичная настройка

Создание телеграм бота

  1. Шаг первый, перейдите к диалогу с ботом https://t.me/BotFather и запустите его.
  2. Шаг второй, отправьте в чат с ботом команду /newbot.
  3. Шаг третий, введите имя для своего бота, именно оно будет отображаться в списке чатов.
  4. Шаг четвёртый, введите username бота, с помощью его бота можно будет найти в поиске.
  5. Поздравляем! Вы создали своего телеграм бота!

Настройка параметров

  1. В отправленном вам коде найдите файл .env(если он не отображается - включите отображение скрытых файлов в проводнике) откройте его с помощью блокнота.
  2. Перейдите к диалогу с ботом https://t.me/BotFather и скопируйте токен ранее созданного вами бота.
  3. Вставьте токен бота в поле TOKEN=YOURBOTTOKEN заменив при этом 'YOURBOTTOKEN' не указывая кавычки.
  4. Заполните остальные данные о вашей БД, в поля USER, PASSWORD вставьте соответствующие значения без указания кавычек.

Редактировани текста

Для того, чтобы отредактировать текст:

  1. Перейдите по пути: {folder}\locale\translate\{language}.js
    ** Где {folder} — папка в которую сохранён бот. ** А {language} — язык в ISO 639. Пример: ru.js.
  2. Все текста разделены на каталоги/подкаталоги/кнопки и подписаны максимально понятным языком (если у вас возникли трудности, свяжитесь с нами указав номер заказа).
  3. Отредактируйте нужный вам текст, редактированию подлежит только тот текст, что указан в кавычка '' или ``.

Любой текст поддерживает разметку HTML

Чего делать не стоит:

  1. Редактировать названия разделов/кнопок/переменных .
  2. Удалять запятые не указанные в кавычках '' или ``.
  3. Удалять функции вида ({variable}) => {return `Text`}.
text: (firstName) => {return `Привет, <b>${firstName}</b>!`},

На примере выше редайтированию подлежит только текст в кавычках. Для того чтобы не использовать переменную удалите ${variableName} где variableName название переменной.


Установка для системы Ubunu 22.04

Приобретите VDS / VPS сервер.

Скачайте и установите программу Putty или другую удобную вам консоль с возможностью SSH подключения.

Соединитесь с купленным ранее сервером по SSH соединению с данными выданными вам регистратором.

Скопируйте бота по путю ./root с помощью git или с помощью Filezilla(наиболее распростронёная) инструкции по этому вы сможете найти в интернете

Выполните следующие команды в том же порядке, в котором они идут:

sudo apt update
sudo apt upgrade
sudo apt install curl
curl -fsSL https://deb.nodesource.com/setup_18.x I sude -E bash -
sudo apt install nodejs
node -v && npm –v # На экран выведуться версии nodejs и npm если этого не произошло, свяжитесь с нами
sudo apt install mysql-server-8.0 # на всё отвечаем Y
# в следующем шаге вы установите пароль для подключения к базе данных
sudo systemctl start mysql.service
sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Pass'; # замените Pass на ваш пароль
exit
sudo mysql_secure_installation # авторизуйтесь с помощью введённого ранее вами пароля
# Отвечаем Y далее 2 далее 100 далее Y если хотите поменять пароль или N если не хотите его менять далее 100 и далее на всё отвечаем Y
sudo systemctl enable mysql.service # включение mysql в автозагрузку
sudo systemctl status mysql.service # проверка статуса mysql
cd ./{folder} # замените folder на название папки, в которую вы скопировали бота
# если вам необходимо отредактировать некоторые файлы используйте команду nano filename
# Пример
nano .env # Вы сможете редактировать файл .env
# Нажмите сочетание клавиш CNTR + S для сохранения файла, введите Y

Скачайте и установите любую программу для подключения к БД mysql через SSH.

Скопируйте и выполните код написанный в файле dump.sql

Находясь в главном каталоге с ботом выполните следующие команды:

npm install
npm install pm2 -g
pm2 startup
pm2 start index.js

🎉 Поздравляем! Ваш бот в сети!

Если у вас возникли трудности — обратитесь к нам.