LinuxGSM项目在Ubuntu 24.04上安装UT99服务器的常见问题解析

问题背景

在Ubuntu 24.04 LTS系统上使用LinuxGSM工具安装Unreal Tournament 99(UT99)游戏服务器时，用户可能会遇到两个关键问题：

1. 安装脚本错误提示"jq未安装"，但实际上jq已经安装
2. 32位依赖库缺失导致安装失败

问题分析

jq依赖检查异常

LinuxGSM安装脚本在检查系统依赖时会验证jq工具是否存在。在Ubuntu 24.04环境中，即使jq已经正确安装，脚本仍可能报告jq缺失。这是由于脚本中的依赖检查逻辑存在缺陷，特别是在update_ut99.sh模块的第158行附近。

错误表现包括：

• 安装过程中提示"[ FAIL ] Installing ut99server: jq is not installed"
• 日志中显示"fn_script_log_fatal: command not found"错误
• 依赖检查通过但后续步骤仍报错

32位架构支持问题

Ubuntu 24.04默认不启用32位架构支持，而UT99服务器需要部分32位库才能正常运行。这会导致依赖安装阶段失败，表现为：

• 缺少i386架构的软件包
• 依赖解析失败
• 安装过程提前终止

解决方案

解决jq检查问题

1. 确保jq确实已安装：

   sudo apt-get update
   sudo apt-get install -y jq
   

2. 验证jq安装：

   which jq
   jq --version
   

3. 如果问题仍然存在，可以尝试手动修复脚本：

   • 定位到update_ut99.sh脚本
   • 检查依赖检查逻辑，特别是jq相关的部分
   • 确保所有日志函数(fn_script_log_fatal等)正确定义

启用32位架构支持

在开始安装前，必须启用i386架构支持：

sudo dpkg --add-architecture i386
sudo apt-get update

这将允许系统安装32位版本的依赖库，确保UT99服务器能够正常运行。

最佳实践

1. 安装前准备：

   sudo dpkg --add-architecture i386
   sudo apt-get update
   sudo apt-get install -y jq
   

2. 创建专用用户：

   sudo adduser ut99server
   sudo su - ut99server
   

3. 安装LinuxGSM和UT99服务器：

   wget -O linuxgsm.sh https://linuxgsm.sh
   chmod +x linuxgsm.sh
   bash linuxgsm.sh ut99server
   ./ut99server install
   

验证安装

安装完成后，可以通过以下方式验证：

./ut99server start
./ut99server details

检查服务器日志确认没有错误：

tail -f ~/log/server/console/ut99server-console.log

总结

在Ubuntu 24.04上使用LinuxGSM安装UT99服务器时，需要注意系统架构支持和依赖检查的特殊性。通过预先配置32位架构支持和验证jq安装，可以避免大多数安装问题。LinuxGSM团队已经发布了相关修复，保持工具更新至最新版本(v25.1.3或更高)可获得最佳体验。