Как запустить Discord-бота на Node.js

Это руководство для ботов, написанных на Node.js, например с discord.js.

Настройте сервер

1. Откройте сервер в панели. Новый сервер для бота стартует как Node.js Bot, поэтому менять тип не нужно.

2. Откройте Files и загрузите своего бота, включая package.json. Не загружайте папку node_modules, сервер установит её сам.

   • Предпочитаете git? Откройте Настройки, затем Настройки игры и заполните Git-репозиторий (и ветку, если она нужна). Файлы скачиваются при установке сервера. Для приватного репозитория укажите также git-имя пользователя и токен доступа.
3. В Настройки игры укажите в поле Основной файл файл, который запускает бота, например index.js или src/bot.js. Файлы с расширением .ts тоже работают.
4. Вставьте токен в поле Токен Discord-бота (необязательно). Ваш код читает его как process.env.DISCORD_TOKEN.
5. По умолчанию сервер работает на Node 22. Чтобы использовать Node 20, 24, 25 или 26, выберите нужную версию в Настройки, Docker-образ, затем перезапустите сервер.

Запустите бота

Откройте Console и запустите сервер. При каждом запуске сервер выполняет npm install, если есть package.json, и затем запускает ваш основной файл. Первый запуск длится дольше, пока скачиваются пакеты.

Полезно знать

• Дополнительные пакеты: поле Доп. пакеты npm (необязательно) устанавливает дополнительные пакеты при каждом запуске без правки package.json.
• Память: Node ограничен 80 процентами памяти вашего тарифа, чтобы осталось место для остального процесса и сервер не останавливали за слишком большой расход.
• TypeScript: основной файл .ts запускается напрямую. Скомпилированный JavaScript стартует чуть быстрее.
• Обновления из git: включите Обновлять из git при каждом запуске, чтобы подтягивать свежий код при каждом перезапуске сервера.

Если бот сразу останавливается: прочитайте Почему ваш Discord-бот постоянно останавливается.