Маршрутизируемые IPv4-адреса от 0,70 евро за IP в месяц, без минимального количества, без контракта. См. цены

Разместить бота в Discord

В предыдущем разделе вы добавили игру на панель, импортировав egg-файл. Чтобы бот в Discord работал круглосуточно, сначала нужно создать его в Discord, а затем запустить его код таким же образом - как сервер, построенный на основе egg-файла Node.js или Python.

Бот Discord - это обычная программа, которая устанавливает постоянное соединение с Discord и реагирует на события. У него нет веб-страницы, и он не принимает входящий трафик. Благодаря этому он идеально подходит для размещения на платформе хостинга игр: панель управления обеспечивает его работу, перезапускает его после сбоя, отображает его журналы и ограничивает объем памяти, точно так же, как и в случае с игрой.

Создать бота в Discord

Вся информация, позволяющая Discord идентифицировать бота, хранится в Портал для разработчиков Discord. Войдите в систему с помощью своей учетной записи Discord, создайте приложение, добавьте в него бота и сгенерируйте его токен. Токен - это пароль бота: любой, кто его знает, может управлять ботом, а Discord отображает его только в момент генерации, поэтому сразу скопируйте его в менеджер паролей.

Прежде чем загружать код бота в Git: убедитесь, что токен нигде не фигурирует ни в коде, ни в репозитории. Для проверки выполните поиск первых символов токена в файлах, поскольку токен, загруженный в общедоступный репозиторий, следует рассматривать как утечку и сгенерировать его заново на портале.

В этом разделе токен вообще не фигурирует в коде. Панель сохраняет его в переменной и передает боту в виде переменной среды с именем DISCORD_TOKEN, который присутствует в обоих приведенных ниже примерах.

Напишите минималистичный бот

Этого одного крошечного бота на двух языках вполне достаточно для тестирования всего конвейера: он регистрирует /ping команда и ответы Pong!. Файлы бота помещаются в репозиторий Git на GitHub или любом другом хостинге Git, поскольку установка egg осуществляется путем клонирования этого репозитория.

Node.js с discord.js

Бот на Node.js состоит из двух файлов. Первый из них - package.json, в котором указана эта зависимость. В нём версия discord.js зафиксирована на серии 14, а текущая версия 14.27.0 требует Node 18 или более поздней версии:

{
  "name": "my-discord-bot",
  "version": "1.0.0",
  "main": "index.js",
  "dependencies": {
    "discord.js": "^14.27.0"
  }
}

Второй - это index.js. Он создаёт клиент, регистрирует команду, как только клиент готов, отвечает на неё и входит в систему с помощью токена из переменных среды:

const { Client, Events, GatewayIntentBits } = require("discord.js");

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once(Events.ClientReady, async (readyClient) => {
  await readyClient.application.commands.create({
    name: "ping",
    description: "Replies with Pong!",
  });
  console.log("Logged in as " + readyClient.user.tag);
});

client.on(Events.InteractionCreate, async (interaction) => {
  if (interaction.isChatInputCommand() && interaction.commandName === "ping") {
    await interaction.reply("Pong!");
  }
});

client.login(process.env.DISCORD_TOKEN);

Python с использованием discord.py

У бота на Python также есть два файла. requirements.txt содержит список библиотек, текущая версия которой - discord.py 2.7.1:

discord.py>=2.4

И bot.py выполняет ту же самую работу, что и версия на JavaScript:

import os

import discord
from discord import app_commands

client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)


@tree.command(name="ping", description="Replies with Pong!")
async def ping(interaction: discord.Interaction):
    await interaction.response.send_message("Pong!")


@client.event
async def on_ready():
    await tree.sync()
    print(f"Logged in as {client.user}")


client.run(os.environ["DISCORD_TOKEN"])

Разместите каждый бот в отдельном репозитории. Публичный репозиторий можно клонировать без ввода учетных данных. Для частного репозитория требуются имя пользователя и токен доступа; в скрипте egg есть переменные для обоих параметров, которые приведены ниже.

Импортируйте пакеты Node.js и Python Eggs

Ни одна из сред выполнения не поставляется в комплекте с панелью, поэтому импортируйте их, как описано в предыдущем разделе. Универсальные модули из каталога проекта охватывают обе среды: node.js - общие сведения и Python - общие сведения. Скачайте два файла JSON, создайте гнездо с названием «Discord Bots» и импортируйте в него оба «яйца».

Диалоговое окно «Импорт Egg» с выбранным файлом egg-node-js-generic.json и отмеченными ботами Discord из категории «nest»
Egg для Node.js помещается в «гнездо» Discord Bots, а egg для Python - точно так же.

Оба «egg» работают одинаково. При установке они клонируют репозиторий Git в папку на сервере и устанавливают зависимости, а при каждом запуске - если включена переменная «Auto Update» - загружают последнюю версию кода, устанавливают отсутствующие пакеты и запускают главный файл. Egg для Node.js предоставляет образы Docker от Node 12 до Node 25, а egg для Python - версии Python от 2.7 и 3.7 до 3.13.

Добавить переменную для токена

Стандартные модули «egg» знают адрес репозитория Git, ветку и главный файл, но ничего не знают о Discord. Токен хранится в новой переменной в каждом модуле «egg». Откройте вкладку «Переменные» модуля «egg» и выберите «Создать новую переменную». Имя переменной среды должно быть точно таким же, как DISCORD_TOKEN, потому что именно так написано в коде.

Диалоговое окно «Создать новую переменную egg» в универсальном egg для node.js с именем «Discord Bot Token», переменной среды DISCORD_TOKEN и строкой, соответствующей требуемым правилам ввода
Новая переменная имеет отображаемое имя, имя среды, которое считывается кодом, и правило проверки.

Правило ввода required|string приводит к тому, что панель отказывается создавать сервер без токена. Поле «Права доступа» определяет, что владелец сервера может делать с переменной. Новая переменная изначально не имеет ни одного из этих прав, что полностью скрывает её от владельца, поэтому выберите «Пользователи могут просматривать» и «Пользователи могут редактировать», если владелец бота вставляет свой собственный токен. Оставьте эти поля незаполненными, чтобы токен оставался под контролем администратора.

Переменная «Discord Bot Token» на вкладке «Переменные» ядра с выбранными правами «Пользователи могут просматривать» и «Пользователи могут редактировать»
Если выбраны оба права доступа, владелец видит переменную на вкладке «Запуск» и может изменить её значение.

Повторите переменную в пакете Python egg, используя то же имя и то же правило.

Создание серверов ботов

Для создания сервера бота используется та же форма, что и ранее, но с меньшими ограничениями. В этом руководстве каждому боту выделяется 512 MiB памяти, 1500 MiB дискового пространства и половина потока ЦП, что подходит для бота, который только ожидает событий. Выберите раздел «Discord Bots», затем «egg», а затем образ Docker - Node 24 для первого бота и Python 3.13 для второго.

Нужен ли боту порт?

Нет. Бот открывает исходящее соединение с Discord, но обратное соединение не устанавливается. Панель по-прежнему запрашивает по одному адресу на каждый сервер, поэтому боты берут адреса 3000 и 3001 из диапазона, созданного в части 2, и ничто никогда не прослушивает эти адреса. Боту не нужен собственный публичный IPv4-адрес.

Важны именно те переменные, которые находятся внизу формы. Для бота Node.js в поле «Адрес репозитория Git» укажите HTTPS-адрес репозитория, а в поле «Основной файл» - index.js, а также токен бота Discord к токену из портала. Для бота на Python основной файл называется «App.py» и содержит bot.py.

Для частного репозитория заполните поля «Имя пользователя Git» и «Токен доступа Git». Скрипт установки переписывает адрес, добавляя в него эти данные, поэтому в этом случае используйте HTTPS-адрес репозитория.

Ознакомьтесь с вкладкой «Startup» и консолью

Как только контейнер установки клонирует репозиторий и устанавливает зависимости, сервер запускается автоматически. На вкладке «Запуск» отображается, какие процессы будет запускать сервер и с какими параметрами. В случае с пакетом Node.js egg команда запуска загружает репозиторий, если включена функция «Автообновление», устанавливает все дополнительные пакеты, запускает npm install когда а package.json существует и запускает главный файл.

Вкладка «Запуск» сервера бота Node.js с командой запуска, образом Docker «Nodejs 24» и переменными «Адрес репозитория Git», «Ветка установки», «Файлы, загруженные пользователем», «Автоматическое обновление», «Дополнительные пакеты Node», «Имя пользователя Git», «Токен доступа Git», «Основной файл», «Дополнительные аргументы» и «Токен бота Discord»
На вкладке «Запуск» владелец редактирует адрес репозитория, главный файл и токен.

На вкладке «Файлы» отображается информация о том, что было скопировано установщиком. Для бота Node.js это index.js, package.json, и node_modules папка, а также скрытые .git папка, из которой переменная «Автообновление» сможет впоследствии извлечь данные.

Вкладка «Файлы» бота Node.js, на которой отображаются папки .git, .npm и node_modules, а также файлы index.js, package-lock.json и package.json
Клонированный репозиторий находится в папке сервера вместе с установленными зависимостями.

Консоль - это место, где бот сообщает о том, что он находится в сети. При наличии действительного токена первой строкой после запуска будет Logged in as сообщение из кода, и бот отвечает /ping на любом сервере, к которому он присоединился. Если токен когда-либо будет отклонен, в консоли отобразится собственное сообщение Discord, например: An invalid token was provided, поэтому вставьте токен ещё раз на вкладке «Запуск» и нажмите «Пуск».

Демон также отслеживает работу процесса. Он отказывается перезапускать сервер, если с момента его последнего сбоя прошло менее минуты, что предотвращает бесконечный цикл перезапусков неисправного бота, а переменная «Auto Update», установленная в значение 1, загружает новые коммиты из репозитория при каждом запуске.

Если вы увидите ts-node В трассировке стека Node.js нет никаких ошибок: команда запуска egg сверяет имя главного файла с текстом в кавычках *.js, поэтому он обрабатывает файлы с помощью ts-node, который также поддерживает обычный JavaScript. Используйте имя файла, заканчивающееся на .ts если вы пишете бота на TypeScript.

В заключение

  • Бот Discord - это постоянно работающая программа, которая подключается к Discord, поэтому ей требуется выделенный ресурс, но не нужен публичный IPv4-адрес.
  • Универсальные пакеты для Node.js и Python клонируют репозиторий Git, устанавливают его зависимости и запускают главный файл.
  • A DISCORD_TOKEN Переменная в поле «яйцо» не позволяет поместить токен в репозиторий.
  • В консоли отображается строка входа в систему бота, а демон не перезапускает сервер, который вышел из строя менее минуты назад.

В следующем разделе вы присвоите серверу Minecraft собственный публичный IPv4-адрес через туннель Taipan.