# quake3js

**Repository Path**: firfe/quake3js

## Basic Information

- **Project Name**: quake3js
- **Description**: 雷神之锤 3 网页版3d射击游戏 汉化镜像优化
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 雷神之锤 3

网页版3d射击游戏

- 原项目地址
  - 官网 https://gibs.oldschoolfrag.com/
  - GitHub仓库 https://github.com/JackBrenn/quakejs-rootless
- 我汉化和构建docker镜像的仓库
  - GitHub仓库 https://github.com/Firfr/quake3js
  - Gitee仓库 https://gitee.com/firfe/quake3js
  - DockerHub https://hub.docker.com/r/firfe/quake3js

## 汉化&修改&镜像制作

如果镜像拉取失败，请B站发私信，或提issues，  
华为云上的镜像仓库默认推送的镜像不是公开的，有可能是我忘记设置公开了。

当前制作镜像版本(或截止更新日期)：2026.02.10

首先感谢原作者的开源。  
原项目没有中文且无法自定义端口，我就行了汉化和修改，制作了中文docker镜像。且优化了镜像构建流程，原镜像有 360M 左右，优化后镜像大小只有 260M 左右，我制作的镜像比原版小了 100M左右。

修改说明
- 增加修改部分具体见 [汉化和修改.md](./汉化和修改.md)。
- 项目中固定在项目中的前后端地址改成动态获取
 - 前端端口：从当前页面获取
 - 服务端端口：前端端口 + 1


只做了汉化和简单修改，有问题，请到原作者仓库处反馈。

欢迎关注我B站账号 [秦曱凧](https://space.bilibili.com/17547201) (读作 qín yuē zhēng)  

有需要帮忙部署这个项目的朋友,一杯奶茶,即可程远程帮你部署，需要可联系。  
微信号 `E-0_0-`  
闲鱼搜索用户 `明月人间`  
或者邮箱 `firfe163@163.com`  
如果这个项目有帮到你。欢迎start。也厚颜期待您的打赏。

如有其他问题，请提`issues`，或发送B站私信。

## 镜像

从阿里云或华为云镜像仓库拉取镜像，注意填写镜像标签，镜像仓库中没有`latest`标签

容器内部端口`8080`，`27960`。

- 关于端口说明
  - 容器中`8080`为网页访问端口，`27960`为服务端端口，
  - 部署的时候端口映射是要注意：`网页访问端口`自定义，`务端端口`要映射成`网页访问端口`号加上1，或者通过环境变量`SERVER`自定义，格式：`IP或域名:端口`，例如：`192.168.1.11:1235`
  - 使用默认`服务端端口`示例：
    - 网页访问端口：`8080` 映射成 `5180`
    - 服务端端口：`27960` 映射成 `5181`
  - `服务端端口`也要自定义
    - 设置环境变量`SERVER`
    - 格式：`IP或域名:端口`
    - 示例：`192.168.1.11:1235`，这时就把`27960` 映射成 `1235`
- 国内仓库
  - AMD64镜像
    ```bash
    swr.cn-north-4.myhuaweicloud.com/firfe/quake3js:2026.02.10
    ```
  - ARM64镜像
    ```bash
    swr.cn-north-4.myhuaweicloud.com/firfe/quake3js:2026.02.10-arm64
    ```
- DockerHub仓库
  - AMD64镜像
    ```bash
    firfe/quake3js:2026.02.10
    ```
  - ARM64镜像
    ```bash
    firfe/quake3js:2026.02.10-arm64
    ```

## 部署

### docker run 命令部署

```bash
docker run -d \
--name quake3js \
--network bridge \
--restart always \
--log-opt max-size=1m \
--log-opt max-file=1 \
-p 端口:8080 \
-p 上面端口+1:27960 \
swr.cn-north-4.myhuaweicloud.com/firfe/quake3js:2026.02.10
```

### compose 文件部署 👍推荐

```yaml
#version: '3'
name: quake3js
services:
  quake3js:
    container_name: quake3js
    image: swr.cn-north-4.myhuaweicloud.com/firfe/quake3js:2026.02.10
    network_mode: bridge
    restart: always
    logging:
      options:
        max-size: 1m
        max-file: '1'
    ports:
      - 端口:8080
      - 上面端口+1:27960
```

## 效果截图

![游戏画面](图片/游戏画面.jpg)