RU

Игровые серверы

Как создать свой сервер BeamMP

Полное руководство по созданию сервера BeamMP (мультиплеер BeamNG.drive) на VPS или выделенном сервере Linux: AuthKey, карта, моды, плагины Lua, сервис systemd и брандмауэр.

11 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

BeamMP — это мультиплеерный мод для BeamNG.drive, созданный сообществом. Это руководство объясняет, как установить его сервер на ваш VPS или выделенный Linux-сервер, запустить его от выделенного пользователя через сервис systemd, затем выбрать карту и добавить моды и плагины Lua.

Заказать сервер

BeamMP нетребователен: необходимые ресурсы определяются в основном количеством игроков, автомобилей и модов. HostMyServers предлагает несколько подходящих вариантов:

Предварительные требования

  • SSH-доступ как root или пользователь с правами sudo
  • 64-разрядная система Linux x86_64: Debian 12/13 или Ubuntu 22.04/24.04
  • Активный брандмауэр: nftables (рекомендуется), iptables или ufw (используйте только один инструмент брандмауэра одновременно)
  • Публичный адрес IPv4: сервер BeamMP пока не поддерживает IPv6 для игроков
  • Аккаунт Discord, чтобы создать ваш AuthKey на Keymaster BeamMP
  • Порт 30814 доступен по TCP и по UDP

Каждый игрок должен владеть BeamNG.drive и установить лаунчер BeamMP.

Требуемая конфигурация

BeamMP публикует следующие минимальные значения, не учитывающие потребление операционной системы. Правый столбец — рекомендуемая отправная точка, которую следует корректировать в зависимости от вашего использования.

Компонент Официальный минимум Рекомендуемая отправная точка
RAM 50 МиБ свободно 2 ГБ
CPU Более 1 ГГц, желательно многоядерный 2 ядра
Хранилище 10 МиБ, плюс моды и плагины 10 ГБ SSD, больше при большом количестве модов
Сеть 5-10 Мбит/с на исходящий трафик 100 Мбит/с
Видеокарта Не требуется Не требуется

Обновление системы

Терминал
sudo apt update && sudo apt upgrade -y

Установка зависимостей

BeamMP требует библиотеку Lua 5.3 (liblua5.3-0). Остальные пакеты нужны для загрузки, модов и резервного копирования:

Терминал
sudo apt install -y liblua5.3-0 curl tar unzip nano cron

Создание выделенного пользователя

BeamMP не рекомендует запускать сервер от root или от вашей личной учётной записи. Создайте выделенного пользователя:

Терминал
sudo adduser --disabled-password --gecos "" beammp

Используемые порты

Порт Протокол Назначение
30814 TCP Подключение игроков, загрузка модов
30814 UDP Игровые данные в реальном времени

В BeamMP нет ни RCON, ни веб-интерфейса: открывать порты администрирования не нужно. Консоль доступна только с самого сервера (см. Администрирование).

Настройка брандмауэра

С UFW

Терминал
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reload

С iptables

Терминал
sudo iptables -A INPUT -p tcp --dport 30814 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30814 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Сохранение правил после перезагрузки требует пакета iptables-persistent.

С nftables

Эти команды используют таблицу inet filter и цепочку input, присутствующие по умолчанию в /etc/nftables.conf в Debian.

Терминал
sudo nft add rule inet filter input tcp dport 30814 accept
sudo nft add rule inet filter input udp dport 30814 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Создание AuthKey

AuthKey идентифицирует ваш сервер в BeamMP. Без него сервер отказывается запускаться, даже если он остаётся приватным.

  1. Перейдите на Keymaster BeamMP и войдите через Discord.
  2. Откройте раздел Keys.
  3. Нажмите зелёную кнопку +.
  4. Введите имя сервера, затем нажмите Create.
  5. Скопируйте полученный ключ.

Установка сервера

Войдите как пользователь beammp и создайте папку сервера:

Терминал
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-server

Загрузите последнюю версию для вашей системы. Первая строка определяет ваш дистрибутив, чтобы получить, например, debian.12 или ubuntu.24.04:

Терминал
. /etc/os-release
curl -fL -o BeamMP-Server "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server

Запустите сервер один раз, чтобы сгенерировать его конфигурацию:

Терминал
./BeamMP-Server

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

Откройте файл конфигурации:

Терминал
nano ~/beammp-server/ServerConfig.toml

Измените как минимум эти значения в разделе [General], не трогая остальные строки. Порядок строк в вашем файле может отличаться:

Конфигурация
[General]
AuthKey = "PASTE_YOUR_KEY_HERE"
Name = "Мой сервер BeamMP"
Description = "Добро пожаловать на мой сервер"
Tags = "Freeroam,Lang:Russian"
Map = "/levels/west_coast_usa/info.json"
MaxPlayers = 8
MaxCars = 2
Private = true
AllowGuests = false

Затем защитите этот файл, содержащий ваш ключ, и выйдите из сессии пользователя beammp:

Терминал
chmod 600 ~/beammp-server/ServerConfig.toml
exit

Основные параметры

Параметр Значение по умолчанию Описание
AuthKey пусто Ключ, созданный на Keymaster (обязателен)
Name BeamMP Server Имя, отображаемое в списке серверов (не более 250 символов)
Description BeamMP Default Description Описание сервера (не более 1000 символов)
Tags Freeroam Теги для поиска через запятую (не более 100 символов)
Map /levels/gridmap_v2/info.json Размещаемая карта
MaxPlayers 8 Максимальное количество игроков
MaxCars 1 Максимальное количество автомобилей на игрока
Port 30814 TCP- и UDP-порт сервера
Private true true скрывает сервер из публичного списка, false публикует его там
AllowGuests true Разрешает подключение игроков без аккаунта BeamMP
LogChat true Записывает чат в журналы
Debug false Подробные журналы, значительно большего объёма
ResourceFolder Resources Папка модов и плагинов

Если вы меняете Port, измените и правила брандмауэра.

Форматирование имени

Name и Description принимают коды форматирования, которые ставятся перед текстом: ^l жирный, ^o курсив, ^n подчёркнутый, ^r сброс, ^4 красный, ^2 зелёный, ^e жёлтый, ^f белый. Например: Name = "^l^4Мой сервер ^r^fBeamMP". Документация BeamMP содержит полный список, а также список распознаваемых тегов.

Выбор карты

Укажите путь к карте в параметре Map. Карты, входящие в игру, не требуют установки:

Карта Значение Map
Grid Map /levels/gridmap_v2/info.json
Small Grid /levels/smallgrid/info.json
West Coast USA /levels/west_coast_usa/info.json
East Coast USA /levels/east_coast_usa/info.json
Utah /levels/utah/info.json
Italy /levels/italy/info.json
Jungle Rock Island /levels/jungle_rock_island/info.json
Johnson Valley /levels/johnson_valley/info.json
Hirochi Raceway /levels/hirochi_raceway/info.json
Automation Test Track /levels/automation_test_track/info.json
Industrial /levels/industrial/info.json
Small Island /levels/small_island/info.json
Driver Training /levels/driver_training/info.json
Derby /levels/derby/info.json

Настройка как сервис systemd

Приведённый ниже сервис запускает BeamMP автоматически. К нему добавлен небольшой локальный канал (/run/beammp.stdin), позволяющий отправлять команды в консоль сервера.

Создание канала консоли

Терминал
sudo nano /etc/systemd/system/beammp.socket
Конфигурация
[Unit]
Description=BeamMP Server console
PartOf=beammp.service

[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=true

Создание файла сервиса

Терминал
sudo nano /etc/systemd/system/beammp.service
Конфигурация
[Unit]
Description=BeamMP Server
Wants=network-online.target
After=network-online.target beammp.socket
Requires=beammp.socket

[Service]
Type=simple
User=beammp
Group=beammp
WorkingDirectory=/home/beammp/beammp-server
ExecStart=/home/beammp/beammp-server/BeamMP-Server
Sockets=beammp.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
Restart=on-failure
RestartSec=10
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

Активация и запуск сервиса

Терминал
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.service

Команды управления

Терминал
# Проверить статус
sudo systemctl status beammp.service

# Остановить сервер
sudo systemctl stop beammp.service

# Перезапустить сервер
sudo systemctl restart beammp.service

# Просмотр логов
sudo journalctl -u beammp.service -f

Проверка работы

Сервер готов, когда в логах появляется ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY:

Терминал
sudo journalctl -u beammp.service -n 30 --no-pager

Проверьте, что он слушает и по TCP, и по UDP:

Терминал
sudo ss -tulpn | grep 30814

Вы должны получить строку tcp и строку udp, связанные с BeamMP-Server. При Private = false в логах также должно появиться Authenticated!.

Подключение к серверу

  1. Запустите лаунчер BeamMP, который запускает BeamNG.drive.
  2. Откройте мультиплеерное меню BeamMP.
  3. Используйте Direct Connect, затем введите IP_СЕРВЕРА и порт 30814.

Если сервер публичный (Private = false), игроки также могут найти его по имени в списке. Для этого им нужно отключить фильтры и установить для карты значение Any.

Добавление модов

Моды автомобилей и карт помещаются в формате .zip в Resources/Client. Не распаковывайте их. Игроки загружают их автоматически при подключении к серверу.

С вашего компьютера отправьте мод на сервер от имени вашей учётной записи администратора:

Терминал
scp my_mod.zip ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_СЕРВЕРА:/tmp/

На сервере установите его, затем перезапустите BeamMP:

Терминал
sudo install -o beammp -g beammp -m 644 /tmp/my_mod.zip /home/beammp/beammp-server/Resources/Client/
sudo rm /tmp/my_mod.zip
sudo systemctl restart beammp.service

Использование модифицированной карты

Файл .zip карты содержит папку levels/<название_карты>. Найдите это название:

Терминал
unzip -l /home/beammp/beammp-server/Resources/Client/my_map.zip | grep 'levels/.*/info.json'

Если в выведенной строке есть levels/my_map/info.json, измените ServerConfig.toml:

Конфигурация
Map = "/levels/my_map/info.json"

Затем перезапустите сервис. Если файл info.json не найден в архиве, загрузите карту в одиночной игре в BeamNG.drive, откройте консоль клавишей ~ и выполните print(getMissionFilename()), чтобы получить точный путь.

Добавление плагинов Lua

Плагины выполняются на сервере. У каждого из них своя папка в Resources/Server:

Текст
Resources/
├── Client/              Моды, отправляемые игрокам (.zip)
└── Server/
    └── Welcome/         Одна папка на плагин
        └── main.lua

Все файлы .lua, расположенные непосредственно в папке плагина, загружаются при запуске в алфавитном порядке. Сервер автоматически перезагружает плагин при изменении любого из этих файлов. Вложенные папки не загружаются автоматически: используйте require(). Справочник по плагинам подробно описывает доступные события и функции.

Пример: приветственное сообщение

Терминал
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Welcome
nano ~/beammp-server/Resources/Server/Welcome/main.lua
lua
function onInit()
    print("Плагин Welcome загружен")
end

function onPlayerArrival(player_id)
    MP.SendChatMessage(player_id, "Добро пожаловать на сервер!")
end

MP.RegisterEvent("onPlayerJoin", "onPlayerArrival")

Пример: белый список

Этот плагин принимает только перечисленные ники BeamMP и отклоняет гостей. По-прежнему от имени пользователя beammp:

Терминал
mkdir -p ~/beammp-server/Resources/Server/Whitelist
nano ~/beammp-server/Resources/Server/Whitelist/main.lua
lua
local allowedPlayers = {
    ["Player1"] = true,
    ["Player2"] = true,
}

function checkPlayer(name, role, isGuest, identifiers)
    if isGuest or not allowedPlayers[name] then
        return "Этот сервер доступен только для авторизованных игроков."
    end
end

MP.RegisterEvent("onPlayerAuth", "checkPlayer")

Затем выйдите из сессии пользователя beammp и перезапустите сервер, так как новый плагин не обнаруживается на лету:

Терминал
exit
sudo systemctl restart beammp.service

Сообщение Плагин Welcome загружен должно появиться в логах.

Администрирование

Отправка команд в консоль

Создайте небольшую команду, которая записывает в консоль и показывает её ответ:

Терминал
sudo nano /usr/local/bin/beammp-cmd
Терминал
#!/bin/bash
if [ ! -p /run/beammp.stdin ]; then
    echo "Сервер BeamMP не запущен." >&2
    exit 1
fi
echo "$*" > /run/beammp.stdin
sleep 1
journalctl -u beammp.service -n 15 --no-pager -o cat
Терминал
sudo chmod 755 /usr/local/bin/beammp-cmd

Затем вы можете выполнить, например:

Терминал
sudo beammp-cmd list
sudo beammp-cmd say Перезапуск через 5 минут

Доступные команды

Команда Описание
help Показывает справку
list Список подключённых игроков
status Показывает состояние сервера
say <сообщение> Отправляет сообщение всем игрокам
kick <имя> [причина] Выгоняет игрока
version Показывает версию сервера
reloadmods Перезагружает моды из Resources/Client
protectmod <файл.zip> <true/false> Защищает платный или приватный мод: он больше не отправляется игрокам, которым нужно получить его самостоятельно
settings help Показывает справку по просмотру и изменению настроек

Чтобы остановить сервер, используйте sudo systemctl stop beammp.service.

Обновление сервера

BeamMP не обновляется автоматически. О новых версиях сообщается на странице релизов. Проверьте свою версию командой sudo beammp-cmd version.

Загрузите новую версию рядом со старой:

Терминал
sudo -iu beammp
cd ~/beammp-server
. /etc/os-release
curl -fL -o BeamMP-Server.new "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server.new
exit

Затем замените исполняемый файл и перезапустите:

Терминал
sudo systemctl stop beammp.service
sudo -u beammp mv /home/beammp/beammp-server/BeamMP-Server.new /home/beammp/beammp-server/BeamMP-Server
sudo systemctl start beammp.service

Если вы меняете версию Debian или Ubuntu, повторите эту процедуру: исполняемый файл зависит от дистрибутива.

Автоматическое резервное копирование

Достаточно сохранять конфигурацию и папку Resources.

Скрипт резервного копирования

Терминал
sudo nano /home/beammp/backup.sh
Терминал
#!/bin/bash
umask 077
BACKUP_DIR="/home/beammp/backups"
SERVER_DIR="/home/beammp/beammp-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p "$BACKUP_DIR"

# Резервная копия конфигурации, модов и плагинов
tar -czf "$BACKUP_DIR/beammp_$DATE.tar.gz" -C "$SERVER_DIR" ServerConfig.toml Resources

# Удаление резервных копий старше 7 дней
find "$BACKUP_DIR" -name "beammp_*.tar.gz" -mtime +7 -delete

echo "Резервное копирование завершено: beammp_$DATE.tar.gz"
Терминал
sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.sh

Планирование резервного копирования

Терминал
sudo crontab -u beammp -e

Добавьте:

Текст
# Резервное копирование каждый день в 5 часов
0 5 * * * /home/beammp/backup.sh

При возникновении проблем

Сервер не запускается

Проверьте логи:

Терминал
sudo journalctl -u beammp.service -n 100 --no-pager

Файл /home/beammp/beammp-server/Server.log содержит ту же информацию и не содержит вашего AuthKey. Он полезен, когда вы просите помощи у сообщества BeamMP.

Сообщение Причина и решение
No AuthKey specified Ключ отсутствует в ServerConfig.toml
AuthKey specified is the wrong length Ключ неполный или скопирован неверно
Backend REFUSED the auth key Ключ отклонён BeamMP: проверьте его на Keymaster или убедитесь, что он ещё не используется другим сервером
Error parsing config file value Синтаксическая ошибка, часто пропущенные кавычки, или файл недоступен для чтения: проверьте, что его владелец beammp
bind() failed: Address already in use Порт уже используется другой программой: определите её командой sudo ss -tulpn | grep 30814

Если ServerConfig.toml больше не принадлежит beammp, исправьте его права:

Терминал
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.toml

Ошибка GLIBC_ или cannot execute binary file

Исполняемый файл не соответствует вашей системе. Проверьте версию командой cat /etc/os-release, затем загрузите подходящий файл заново. Исполняемые файлы, предлагаемые в этом руководстве, предназначены для процессоров x86_64.

Игроки не могут подключиться

Коды ошибок 10060, 10061 или 10030 на стороне игрока чаще всего означают, что сервер недоступен или введён неверный адрес.

  • Проверьте, что сервис активен: sudo systemctl status beammp.service
  • Проверьте, что порт слушается и по TCP, и по UDP: sudo ss -tulpn | grep 30814
  • Проверьте правила брандмауэра для обоих протоколов
  • Проверьте, что игрок использует именно адрес IPv4 сервера
  • VPN вроде Hamachi или RadminVPN не поддерживаются

Сервер не появляется в списке

  • Проверьте, что Private = false
  • Поищите Authenticated! или Backend REFUSED the auth key в логах
  • В игре отключите фильтры и установите для карты значение Any

Подключение блокируется после добавления мода

Вероятно, мод несовместим, повреждён или конфликтует с другим. Убирайте моды из Resources/Client по одному, перезапуская сервер каждый раз, чтобы найти виновника.

Карта не загружается

  • Проверьте путь в Map, он должен заканчиваться на /info.json
  • Для модифицированной карты проверьте, что её .zip находится в Resources/Client

Сервер BeamMP не запущен при использовании beammp-cmd

Канал консоли существует только пока работает сервис. Запустите его командой sudo systemctl start beammp.service.

AuthKey был раскрыт

Если ваш ключ утёк, BeamMP предлагает открыть тикет Account Support на своём официальном Discord.