alicianibbles/srb2kart

Sonic Robo Blast 2 Kart Docker 镜像

镜像概述和主要用途

这是SRB2Kart游戏的Docker容器，旨在简化专用服务器的搭建过程。它会自动从公开的SRB2Kart发布版本下载并构建源代码，无需手动处理编译步骤，适合快速部署游戏服务器。

Docker标签

该容器的标签具有不同的版本粒度，基础标签如下：

• latest：始终对应最新的主版本和次版本。
• <major_version>：例如 alicianibbles/srb2kart:1，表示该主版本下的最新Docker镜像，可能会更新次版本及依赖项。
• <major_version>.<minor_version>：例如 alicianibbles/srb2kart:1.6，表示对应主版本和次版本的最新Docker镜像，可能会更新依赖项，但主版本和次版本保持不变。

• <major_version>.<minor_version>.<build_number>：特定的主版本、次版本和构建号，完全固定，不会更新任何部分，是完全稳定的镜像。

环境变量

• PASSWORD：设置游戏内管理员登录密码（使用login命令登录）。
• BANDWIDTH：设置带宽（字节/秒），默认值为30000字节/秒，允许的最小值为1000字节/秒。
• EXTRATIC：指定每服务器 tic 向客户端发送的额外历史 tic 数量上限。
• IPV6：监听IPv6传入连接（注意：此功能未经测试）。
• PACKETSIZE：修改发送的UDP数据包大小。
• USEUPNP：启用通用即插即用（UPnP）支持（注意：此功能未经测试）。
• WARP：设置游戏开始时跳转的地图。

更多信息可参考官方文档中的命令行参数，容器的环境变量与这些参数对应。虽然也可通过命令行参数传递，但推荐使用环境变量。请注意，官方wiki主要针对SRB2，部分内容可能不适用于SRB2Kart。

持久化数据

您可能需要通过卷将SRB2Kart服务器使用的部分数据持久化到主机系统。

插件（Addons）

此文件夹作为卷映射到/addons，用于存储游戏插件，服务器会自动加载其中的文件。请注意，此处文件的文件名不得包含空格。

数据（Data）

此文件夹作为卷映射到/data，包含游戏数据和配置文件。主要文件包括：

• .srb2kart/kartserv.cfg：控制台脚本文件，专用服务器启动时会自动加载。可用于设置游戏配置、控制台变量，或配置彩色服务器名称等。

运行方法

使用Docker运行

要通过Docker正常运行服务器，执行以下命令：

sh
docker run -it --name srb2kart -v /主机上的/addons路径:/addons -v /主机上的/data路径:/data -e ROOM_ID=33 -p 5029:5029/udp alicianibbles/srb2kart:latest

参数说明：

• -it：以交互模式运行容器
• --name srb2kart：指定容器名称为srb2kart
• -v /主机上的/addons路径:/addons：将主机的插件目录挂载到容器的/addons
• -v /主机上的/data路径:/data：将主机的数据目录挂载到容器的/data
• -e ROOM_ID=33：设置环境变量ROOM_ID（示例值33）
• -p 5029:5029/udp：映射UDP端口5029（SRB2Kart默认端口）

使用Docker Compose运行

待补充