joshhsoj1902/linuxgsm-docker

linuxgsm-docker

Linux Game Server Manager（https://github.com/GameServerManagers/LinuxGSM）项目的非官方Docker化版本，旨在简化各类游戏服务器的部署与管理流程。

镜像概述和主要用途

本镜像将LinuxGSM工具打包为Docker容器，提供了一种标准化、可移植的方式来部署游戏服务器。LinuxGSM是一款用于管理Linux系统上游戏服务器的命令行工具，支持多种热门游戏服务器的安装、配置、启动和监控。通过Docker化，用户可避免繁琐的系统依赖配置，快速搭建所需的游戏服务器环境。

核心功能和特性

• 多游戏支持：支持多种热门游戏服务器，examples文件夹提供多种游戏的部署示例
• 环境变量配置：通过环境变量灵活配置服务器参数，无需直接修改配置文件
• 数据持久化：支持Docker卷和本地路径映射两种方式保存服务器数据，确保数据不丢失
• 配置模板：提供游戏配置文件模板，支持环境变量注入，简化配置流程
• 状态跟踪：示例配置文件包含服务器状态说明，明确标记可正常运行的服务器

使用场景和适用范围

• 个人游戏服务器搭建
• 游戏社区服务器部署
• 快速测试不同游戏服务器配置
• 需要隔离环境的游戏服务器管理
• 对系统依赖配置不熟悉的用户

使用方法和配置说明

基本使用

启动服务器的最简单方式是使用docker-compose命令：

shell
docker-compose -p css -f examples/docker-compose.css.yml up

参数说明：

• -p：设置项目名称，有助于区分多个服务器实例（可选）
• -f：指定要使用的compose文件

示例配置

examples文件夹中包含多种游戏服务器的示例配置，每个compose文件都有状态说明部分，标明该服务器的当前状态（如是否可正常运行）。对于未测试的服务器，欢迎用户测试后反馈状态，以便更新说明。示例配置还包含该服务器的可用配置选项链接和存档文件详细信息。

配置说明

所有配置通过环境变量实现，具体配置项参考LinuxGSM项目的默认配置文件（如CSS服务器的配置文件https://github.com/GameServerManagers/LinuxGSM/blob/master/lgsm/config-default/config-lgsm/cssserver/_default.cfg%EF%BC%89%E3%80%82%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E4%B8%AD%E7%9A%84%E6%89%80%E6%9C%89%E8%AE%BE%E7%BD%AE%E5%9D%87%E5%8F%AF%E9%80%9A%E8%BF%87%E6%B7%BB%E5%8A%A0%60LGSM_%60%E5%89%8D%E7%BC%80%E5%B9%B6%E5%A4%A7%E5%86%99%E5%90%8D%E7%A7%B0%E6%9D%A5%E8%AE%BE%E7%BD%AE%E4%B8%BA%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E3%80%82

示例：设置CSS服务器的GSLT值

yaml
environment:
  - LGSM_GAMESERVERNAME=cssserver
  - LGSM_UPDATEINSTALLSKIP=UPDATE
  - LGSM_PORT=27015
  - LGSM_GSLT=myValue

部分游戏支持自定义配置文件，目前支持的配置文件模板见https://github.com/joshhsoj1902/linuxgsm-docker/tree/master/config-game-template%E3%80%82%E6%A8%A1%E6%9D%BF%E6%96%87%E4%BB%B6%E6%94%AF%E6%8C%81%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%B3%A8%E5%85%A5%EF%BC%8C%E8%8B%A5%E9%9C%80%E8%A6%81%E6%B7%BB%E5%8A%A0%E6%88%96%E6%9B%B4%E6%96%B0%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4issue%E5%8F%8D%E9%A6%88%E3%80%82

示例：设置Minecraft服务器的最大玩家数

Minecraft服务器配置模板https://github.com/joshhsoj1902/linuxgsm-docker/blob/master/config-game-template/Minecraft/server.properties.tmpl#L20%EF%BC%8C%E9%80%9A%E8%BF%87%60LGSM_MAX_PLAYERS%60%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E8%AE%BE%E7%BD%AE%EF%BC%9A

yaml
environment:
  ## 基础LGSM配置
  - LGSM_GAMESERVERNAME=mcserver
  - LGSM_UPDATEINSTALLSKIP=UPDATE
  - LGSM_PORT=25565
  - LGSM_MAX_PLAYERS=10

存档文件管理

大多数游戏服务器会生成存档文件，默认情况下，所有compose文件会创建名为[project]_serverfiles的卷，用于保存服务器文件，确保容器重启后数据不丢失。但删除卷会导致数据丢失。

另一种方式是将文件保存到本地路径，修改compose文件的volumes部分：

yaml
volumes:
  - /本地保存路径:/home/linuxgsm/linuxgsm/serverfiles

左侧为本地计算机上的文件夹路径，服务器文件将保存到该路径，便于管理和备份。