florianpiesche/ioquake3-server

Docker化ioquake3服务器

!https://github.com/fpiesche/docker-ioquake3-server/actions/workflows/main.yml/badge.svg

快速参考

• 镜像仓库:

  • Docker Hub: https://hub.docker.com/r/florianpiesche/ioquake3-server
  • GitHub Packages: https://ghcr.io/fpiesche/ioquake3-server

• 维护者:
  https://github.com/fpiesche

• 问题反馈地址:
  https://github.com/fpiesche/ioquake3-server/issues

• Dockerfile:
  https://github.com/fpiesche/docker-ioquake3-server/blob/main/Dockerfile

• 支持的架构:
  每个镜像为以下架构提供多架构清单: amd64, arm64, armv7, armv6

• 描述来源: https://github.com/fpiesche/docker-ioquake3-server/tree/main/README.md (https://github.com/fpiesche/docker-ioquake3-server/commits/main/README.md)

支持的标签

• latest: 基于最新的Alpine基础镜像及其系统包构建，使用ioquake3 main分支的最新提交(https://github.com/ioquake/ioq3/tree/main)%E3%80%82%E9%95%9C%E5%83%8F%E5%90%8C%E6%97%B6%E4%BC%9A%E4%BD%BF%E7%94%A8ioquake3%E6%8F%90%E4%BA%A4%E7%9A%84%E7%AE%80%E5%86%99commit ID作为标签。

如何使用此镜像

您需要将Quake 3 Arena的数据文件挂载到容器的/usr/local/games/quake3/baseq3目录。可通过复制已安装的Quake 3 Arena中的baseq3目录内容获取这些文件。游戏可通过多个渠道合法购买；虽然游戏引擎和服务器是开源的，但游戏数据仍受版权保护，无法免费获取。

基本死亡竞赛配置运行

console
$ docker run -d \
  -p 27960:27960/udp \
  -v /home/myuser/baseq3:/usr/local/games/quake3/baseq3 \
  florianpiesche/ioquake3-server

启动完成后，Quake 3服务器可通过主机的IP地址或主机名访问。

高级配置

有关配置ioquake3服务器的详细信息，请参考ioquake3系统管理员指南。

管理员控制台

要在启动后控制服务器，最简单的方法是使用Quake 3游戏客户端连接服务器并使用rcon（远程控制台）功能。运行容器时，需通过ADMIN_PASSWORD环境变量设置自定义管理员密码：

console
$ docker run -d \
  -p 27960:27960/udp \
  -e ADMIN_PASSWORD=my_custom_admin_password \
  -v /home/myuser/baseq3:/usr/local/games/quake3/baseq3 \
  florianpiesche/ioquake3-server

连接后，使用```或~键（取决于键盘布局，通常是主键盘数字行左侧的键）打开控制台。

然后输入\rconpassword my_custom_admin_password命令登录远程控制台。此后，在连接服务器期间，可在游戏控制台中使用\rcon [命令]运行任何标准Quake 3控制台命令，例如输入\rcon map q3dm17切换地图。

有关常用Quake 3控制台命令的信息，请参考ioquake3系统管理员指南。还有其他更全面的Quake 3控制台命令和变量指南，例如此指南。

自定义问候语

要更改玩家连接服务器时收到的问候语，只需在运行容器时设置SERVER_MOTD环境变量：

console
$ docker run -d \
  -p 27960:27960/udp \
  -e SERVER_MOTD="pew pew" \
  -v /home/myuser/baseq3:/usr/local/games/quake3/baseq3 \
  florianpiesche/ioquake3-server

服务器命令行参数

要在Quake 3服务器启动时执行控制台命令，可使用+作为前缀将命令添加到服务器命令行参数。容器的服务器命令行参数可通过SERVER_ARGS环境变量设置。例如，要让服务器启动时加载q3dm17地图：

console
$ docker run -d \
  -p 27960:27960/udp \
  -e SERVER_ARGS="+map q3dm17" \
  -v /home/myuser/baseq3:/usr/local/games/quake3/baseq3 \
  florianpiesche/ioquake3-server

自定义服务器配置文件

如果需要对游戏默认配置进行大量修改（例如设置自定义地图轮换），创建自定义配置文件通常比通过命令行参数传递所有必要命令更简单。配置文件是纯文本文件，每行包含一个Quake 3控制台命令，可通过服务器控制台的exec命令运行。

要使用自定义服务器配置文件，可将配置文件挂载到/usr/local/games/quake3/configs/目录，容器入口点会在启动时使这些文件对服务器可用。然后通过设置SERVER_ARGS环境变量（例如+exec myconfig.cfg）在服务器启动时运行配置文件：

console
$ docker run -d \
  -p 27960:27960/udp \
  -v /home/myuser/baseq3:/usr/local/games/quake3/baseq3 \
  -v /home/myuser/myq3configs:/usr/local/games/quake3/configs \
  -e SERVER_ARGS="+exec myconfig.cfg" \
  florianpiesche/ioquake3-server

模组

要运行的任何模组可挂载到ioquake3目录下的子目录中，例如将“Catch the Chicken”模组挂载到/usr/local/games/quake3/q3ctc即可被游戏访问。要运行模组，可在SERVER_ARGS中添加+set fs_game mod_directory，或从服务器管理员控制台运行set fs_game mod_directory命令。

console
$ docker run -d \
  -p 27960:27960/udp \
  -v /home/myuser/quake3/data/baseq3:/usr/local/games/quake3/baseq3 \
  -v /home/myuser/quake3/mods/q3ctc:/usr/local/games/quake3/q3ctc \
  -e SERVER_ARGS="+set fs_game q3ctc" \
  florianpiesche/ioquake3-server

使用docker-compose

获取可随时启动、停止和恢复的可重现设置的最简单方法是使用docker-compose文件。以下是配置示例：

在主机上新建一个空目录，创建docker-compose.yaml文件并粘贴以下内容：

yaml
version: '3.2'

volumes:
  baseq3:
    driver: local
    driver_opts:
      type: 'none'
      o: 'bind'
      device: '/home/myuser/quake3/data/baseq3'
  q3ctc:
    driver: local
    driver_opts:
      type: 'none'
      o: 'bind'
      device: '/home/myuser/quake3/mods/q3ctc'

services:
  quake3-server:
    image: florianpiesche/ioquake3-server
    restart: always
    volumes:
      - baseq3:/usr/local/games/quake3/baseq3
      - q3ctc:/usr/local/games/quake3/q3ctc
    ports:
      - 27960:27960/udp
    environment:
      SERVER_MOTD: "buhGAWK!"
      ADMIN_PASSWORD: "lookatmycluckers"
      SERVER_ARGS: "+game q3ctc +exec server_q3ctc.cfg"

在包含compose文件的目录中运行docker-compose up -d，Quake 3服务器将启动。可使用docker-compose down停止服务器，再次运行docker-compose up -d可恢复带有存储配置的服务器。