中文

游戏服务器

如何创建您自己的 BeamMP 服务器

在 VPS 或专用 Linux 服务器上创建 BeamMP(BeamNG.drive 多人联机)服务器的完整指南:AuthKey、地图、模组、Lua 插件、systemd 服务和防火墙。

阅读约 11 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

BeamMP 是 BeamNG.drive 的社区多人联机模组。本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装其服务器,使用专用用户和 systemd 服务运行它,然后选择地图并添加模组和 Lua 插件。

订购服务器

BeamMP 很轻量:所需资源主要取决于玩家、车辆和模组的数量。HostMyServers 提供多种适合的方案:

前提条件

  • 以 root 或具有 sudo 权限的用户进行 SSH 访问
  • 64 位 x86_64 Linux 系统:Debian 12/13 或 Ubuntu 22.04/24.04
  • 已启用防火墙:nftables(推荐)、iptables 或 ufw(一次只使用一种防火墙工具)
  • 一个公网 IPv4 地址:BeamMP 服务器目前尚不支持玩家使用 IPv6
  • 一个 Discord 账号,用于在 BeamMP 的 Keymaster 上创建您的 AuthKey
  • 端口 30814 需同时开放 TCP 和 UDP

每位玩家都必须拥有 BeamNG.drive,并安装 BeamMP 启动器。

配置要求

BeamMP 公布了以下最低配置,不含操作系统的消耗。右侧一列是建议的起点,请根据您的使用情况调整。

组件 官方最低要求 建议起点
内存 50 MiB 可用 2 GB
CPU 高于 1 GHz,最好为多核 2 核
存储 10 MiB,另加模组和插件 10 GB SSD,模组较多时需要更多
网络 上行 5 至 10 Mbps 100 Mbps
显卡 无 无

系统更新

终端
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 链,二者在 Debian 的 /etc/nftables.conf 中默认存在。

终端
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. 前往 BeamMP 的 Keymaster,使用 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:English"
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 地址
  • 不支持 Hamachi 或 RadminVPN 之类的 VPN

服务器未出现在列表中

  • 检查是否设置了 Private = false
  • 在日志中查找 Authenticated! 或 Backend REFUSED the auth key
  • 在游戏中,关闭筛选条件并将地图设置为 Any

添加模组后连接被卡住

很可能是某个模组不兼容、已损坏,或与另一个模组冲突。请逐个从 Resources/Client 中移除模组,每次都重启服务器,以找出问题所在。

地图无法加载

  • 检查 Map 中的路径,它必须以 /info.json 结尾
  • 对于模组地图,检查其 .zip 是否位于 Resources/Client 中

使用 beammp-cmd 时出现 BeamMP 服务器未启动

控制台通道仅在服务运行时才存在。请使用 sudo systemctl start beammp.service 启动它。

AuthKey 已泄露

如果您的密钥泄露,BeamMP 建议在其官方 Discord 上创建 Account Support 工单。