tentaculo/quakejs-server

镜像概述

本镜像为QuakeJS游戏服务器的Docker化部署版本，基于voroninman/quakejs-server改进，修复了原镜像的websockets构建问题（通过使用Node.js 0.10和node-gyp 0.13.1版本），可快速搭建Quake3游戏服务器，支持用户通过浏览器访问并参与游戏。

核心功能

1. 部署Quake3游戏服务器，支持多人联机
2. 兼容浏览器端访问，无需额外安装客户端
3. 允许通过自定义server.cfg配置服务器参数（如名称、最大玩家数、游戏模式等）
4. 暴露UDP端口27960用于游戏数据传输

使用场景

1. 个人或小团队搭建私人Quake3游戏服务器
2. 游戏爱好者体验浏览器端Quake3游戏
3. 技术人员学习QuakeJS与Docker结合的部署方式

配置说明

需将自定义的server.cfg文件挂载到容器内的/server.cfg路径，可修改以下关键参数：

• sv_hostname：服务器名称
• sv_maxclients：最大玩家数
• g_gametype：游戏模式（0为死亡竞赛等）
• timelimit：单局时间限制
• fraglimit：单局击杀限制
• rconpassword：远程控制密码
• map：地图循环配置

部署示例

1. 运行服务器（替换/path/to/server.cfg为本地配置文件路径）：

bash
docker run -ti -v /path/to/server.cfg:/server.cfg -p 27960:27960 tentaculo/quakejs-server

2. 首次运行时按Enter键阅读并同意条款，直至出现"y/n"提示并确认
3. 在浏览器中访问：http://quakejs.com/play?connect%20localhost:27960（将localhost替换为服务器IP）

Dockerfile

dockerfile
FROM nodesource/jessie:0.10
WORKDIR /quakejs
RUN git clone https://github.com/inolen/quakejs.git .
RUN npm install -g node-gyp@0.13.1
RUN npm install 
RUN ln -s /quakejs/base/baseq3/server.cfg /server.cfg
EXPOSE 27960/udp
ENTRYPOINT node build/ioq3ded.js +set fs_game baseq3 +set dedicated 2 +exec server.cfg

server.cfg配置示例

seta sv_hostname "CHANGE ME"
seta sv_maxclients 12
seta g_motd "CHANGE ME"
seta g_quadfactor 3
seta g_gametype 0
seta timelimit 15
seta fraglimit 25
seta g_weaponrespawn 3
seta g_inactivity 3000
seta g_forcerespawn 0
seta rconpassword "CHANGE_ME"
set d1 "map q3dm7 ; set nextmap vstr d2"
set d2 "map q3dm17 ; set nextmap vstr d1"
vstr d1