Инструкция по установке #d7Fb3Bcd-BFa5-4FC5-A2Ec-f1E51B0427Ab

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

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. Отредактируйте нужный вам текст, редактированию подлежит только тот текст, что указан в кавычка '' или ``.
4. Для переноса строки используйте \n - один перенос внутри кавычек

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

1. Разметка HTML - это теги вида <tagName></tagName>, где у открывающего тега вида <> должен быть закрывающий тэг вида </>
2. Примеры:

Правильно:

<b> Ваш текст </b> -- Жирный
<i> Ваш текст </i> -- Курсив
<u> Ваш текст </u> -- Подчёркнутый
<del> Ваш текст </del> -- Перечёркнутый
<tt> Ваш текст </tt> -- Моноширный(тот текст, который можно копировать в тг)
<code> Ваш текст </code> -- Блок кода, в тг моноширный
<a href=""> Ваш текст </a> -- Текст ссылка, обязательный параметр href="" где в кавычках должна быть указано скобка
<blockquote> Ваш текст </blockquote> -- Цитата
<pre language=""> Ваш текст </pre> -- Блок кода, обязательный параметр language="" где в кавычка необходимо указать название языка программирования
// TG
<tg-spoiler> Ваш текст </tg-spoiler> -- Спойлер

Не правильно:

<b><i> Ваш текст </b></i>
Чего делать не стоит:

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
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 20.10.0
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 --name bot
# остановить
pm2 stop
# логи
pm2 logs
# очистить логи
pm2 flush

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

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