vkryvoruchko/quake3

镜像概述

该镜像提供Quake 3游戏服务器的快速部署方案，支持自定义配置、添加AI bots及端口映射。需用户自行提供正版Quake 3的pak0.pk3文件（零售包核心文件），镜像本身不包含任何侵权内容。

核心功能

• 支持通过server.cfg自定义服务器配置（地图循环、击杀限制、bots设置等）
• 允许添加多种AI bots并调整难度
• 提供docker-compose和命令行两种部署方式
• 支持查看服务器日志排查故障
• 端口映射27960/udp实现外部访问

使用场景

• 搭建私人Quake 3服务器与朋友联机对战
• 测试服务器配置及bots行为
• 学习Docker部署游戏服务器的方法

配置说明

1. 依赖准备：需准备正版Quake 3的pak0.pk3文件，可选自定义server.cfg文件。
2. 端口映射：必须映射27960/udp端口，否则外部无法连接。
3. 文件挂载：将pak0.pk3挂载到/usr/share/games/quake3/baseq3/pak0.pk3，自定义server.cfg挂载到同目录。

部署示例

Docker Compose方式

1. 克隆仓库：

bash
git clone https://github.com/vkryvoruchko/quake3.git
cd quake3

2. 编辑docker-compose.yml，修改volumes路径指向你的文件。
3. 启动容器：

bash
docker-compose up -d

4. 停止容器：

bash
docker-compose stop

命令行方式

替换路径后运行：

bash
docker run --name=quake3 -d \
  -v /home/${USER}/quake3/pak0.pk3:/usr/share/games/quake3/baseq3/pak0.pk3 \
  -v /home/${USER}/quake3/server.cfg:/usr/share/games/quake3/baseq3/server.cfg \
  -p 27960:27960/udp \
  vkryvoruchko/quake3

常用管理命令

连接服务器后使用以下命令：

\set rconpassword [密码]  # 设置管理密码
\rcon fraglimit ***     # 设置击杀限制
\rcon map q3tourney4      # 切换地图
\rcon bot_enable 1        # 启用bots
\rcon addbot anarki 5     # 添加难度5的anarki bot
\rcon status              # 查看服务器状态