jberrenberg/quake3

Alpine Linux上的Quake3服务器

该镜像提供一个简单的Quake3专用服务器，最初基于Arch Linux，后迁移至Alpine Linux，镜像体积从约900MB降至32MB。

快速启动

要运行一个基础的baseq3专用服务器，请执行：

bash
export PAK0=/path/to/pak0.pk3
docker run -it --rm -v ${PAK0}:/pak0.pk3 \
-p 0.0.0.0:27960:27960/udp jberrenberg/quake3

若需后台运行，将-it --rm替换为命名和后台参数：

bash
export PAK0=/path/to/pak0.pk3
docker run --name quake -d -v ${PAK0}:/pak0.pk3 \
-p 0.0.0.0:27960:27960/udp jberrenberg/quake3

停止服务器：

bash
docker stop quake

删除容器：

bash
docker rm quake

实际部署

为添加额外地图和配置，需创建数据容器存储文件：

bash
docker run -v /home/ioq3srv/.q3a/baseq3 --name quake3-data busybox

复制配置文件到数据容器：

bash
export PAK0=/path/to/pak0.pk3
docker cp my-server.cfg quake3-data:/home/ioq3srv/.q3a/baseq3/my-server.cfg

或挂载数据容器下载地图：

bash
docker run --rm -it --volumes-from quake3-data alpine bash
cd /home/ioq3srv/.q3a/baseq3/
wget http://example.com/some_q3map.zip
unzip some_q3map.zip

将pak0.pk3复制到数据容器（启动时无需再挂载）：

bash
export PAK0=/path/to/pak0.pk3
docker cp ${PAK0} quake3-data:/home/ioq3srv/.q3a/baseq3/

使用自定义配置启动服务器：

bash
docker run \
-it \
--rm \
-v ${PAK0}:/pak0.pk3 \
-p 0.0.0.0:27960:27960/udp \
--volumes-from quake3-data \
jberrenberg/quake3 +exec my-server.cfg

通过systemd自动启动

创建/etc/systemd/system/quake3.service文件：

bash
[Unit]
Description=quake3 server
After=docker.service
Requires=docker.service

[Service]
Restart=always
RestartSec=60
ExecStartPre=/usr/bin/docker pull jberrenberg/quake3:latest
ExecStart=/bin/bash -c "/usr/bin/docker start quake3 || /usr/bin/docker \
        run --rm \
        --name quake3 \
        --volumes-from quake3-data \
		-p 0.0.0.0:27960:27960/udp \
        jberrenberg/quake3:latest"
ExecStop=/bin/bash -c '/usr/bin/docker stop quake3'

[Install]
WantedBy=multi-user.target

重新加载systemd并启动服务：

bash
systemctl daemon-reload
systemctl start quake3
systemctl enable quake3

使用HTTP/FTP下载支持

在服务器配置中添加sv_allowDownload 8和sv_dlURL http://example.org，可将下载请求重定向到HTTP服务器。

NGINX示例配置

启动NGINX容器时挂载数据容器：

server {
  listen 80;

  location / {
    root /home/ioq3srv/.q3a/;
    sendfile           on;
    sendfile_max_chunk 1m;

    if ($http_referer !~* (^ioQ3:\/\/.*)) {
      return 401;
    }
  }

  location ~ (\.cfg$) {
    return 401;
  }
}

故障排除

SELinux问题

若在CentOS上遇到VM_CompileX86: mprotect failed错误，需创建SELinux模块：

bash
sudo grep -e ioq /var/log/audit/audit.log |grep avc |tail -n 1 | audit2allow -M quake3
semodule -i quake3.pp

验证模块加载：

bash
semodule -l |grep quake3