joshhsoj1902/docker-linuxgsm-scripts

Docker LinuxGSM 脚本镜像文档

镜像概述

该Docker镜像基于LinuxGSM（Linux Game Server Manager）脚本构建，旨在通过容器化技术简化各类游戏服务器的部署与管理流程。LinuxGSM是一款功能强大的开源游戏服务器管理工具，提供统一的命令行界面用于管理多种游戏服务器。本镜像将LinuxGSM脚本与Docker容器结合，实现游戏服务器环境的快速搭建、隔离运行和便捷维护。

核心功能与特性

• 简化部署流程：集成LinuxGSM脚本，无需手动配置依赖，一键部署多种游戏服务器
• 多游戏支持：兼容LinuxGSM支持的各类游戏服务器（如CS:GO、Minecraft、ARK: Survival Evolved等）
• 自动化管理：支持服务器启动、停止、重启、更新、备份等全生命周期管理操作
• 容器化隔离：通过Docker容器实现游戏服务器环境隔离，避免系统环境冲突
• 数据持久化：支持通过数据卷挂载保存服务器配置、存档和日志文件
• 轻量级设计：基于精简基础镜像，优化资源占用，适配多种部署环境

使用场景与适用范围

• 个人游戏服务器：玩家快速搭建私人游戏服务器，用于朋友联机游戏
• 小型游戏社区：为小型游戏社区提供稳定、易管理的游戏服务器解决方案
• 开发者测试：游戏开发者测试服务器性能、兼容性及版本更新影响
• 教学环境：学习游戏服务器配置与管理的实践平台

使用方法与配置说明

基本部署命令

以CS:GO服务器为例，基本部署命令如下：

bash
docker run -d \
  --name csgo-server \
  -p 27015:27015/tcp \
  -p 27015:27015/udp \
  -v /path/to/serverdata:/data \
  joshhsoj1902/docker-linuxgsm-scripts:latest \
  ./csgoserver start

参数说明

端口映射

根据游戏服务器类型映射相应端口，常见游戏端口示例：

• CS:GO：27015/tcp、27015/udp
• Minecraft：25565/tcp
• ARK: Survival Evolved：7777/udp、27015/udp

数据卷挂载

-v /path/to/serverdata:/data：挂载宿主机目录到容器内/data目录，用于持久化存储服务器配置、游戏存档和日志文件，避免容器重启后数据丢失。

环境变量配置

通过-e参数自定义服务器配置：

• GAME：指定游戏服务器类型（如csgo、minecraft、ark等）
• SERVER_NAME：设置服务器名称
• MAX_PLAYERS：配置最大玩家数量
• PASSWORD：设置服务器访问密码（可选）
• UPDATE_ON_START：启动时自动更新服务器文件（true/false，默认true）

服务器管理命令

进入容器执行LinuxGSM命令管理服务器：

bash
# 进入容器
docker exec -it <container-name> /bin/bash

# 常用管理命令
./<game>server stop       # 停止服务器
./<game>server update     # 更新服务器文件
./<game>server restart    # 重启服务器
./<game>server status     # 查看服务器状态
./<game>server console    # 查看服务器控制台日志

注意事项

1. 确保宿主机已安装Docker并启动服务
2. 根据游戏需求配置足够的系统资源（CPU、内存、磁盘空间）
3. 首次启动会下载游戏服务器文件，耗时取决于网络速度和游戏大小
4. 持久化数据目录建议定期备份
5. 详细游戏服务器配置请参考LinuxGSM官方文档或对应游戏的服务器配置说明