lsiodev/minetest

linuxserver/minetest

Minetest（服务器）是一款近无限世界的方块沙盒游戏及游戏引擎，灵感源自InfiniMiner、Minecraft等作品。LinuxServer.io团队提供的此镜像具备定期更新、用户权限映射、安全更新等特性，便于快速部署和管理Minetest服务器。

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/minetest:latest即可自动匹配对应架构，也可通过标签指定特定架构。支持的架构如下：

应用设置

世界地图、mods文件夹及配置文件位于/config/.minetest目录。若需覆盖广播端口，需在CLI_ARGS中添加--port参数，并确保端口映射与之匹配（如设置端口40000，需映射40000:40000/udp）。

客户端与服务器版本必须一致，可通过https://hub.docker.com/r/linuxserver/minetest/tags%E9%80%89%E6%8B%A9%E5%AF%B9%E5%BA%94%E7%89%88%E6%9C%AC%E3%80%82

捆绑游戏

根据https://github.com/minetest/minetest/releases/tag/5.8.0%EF%BC%8C%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%8D%E5%86%8D%E5%8C%85%E5%90%ABhttps://github.com/minetest/minetest_game%E3%80%82%E5%A6%82%E9%9C%80%E4%BD%BF%E7%94%A8%EF%BC%8C%E9%9C%80%E9%80%9A%E8%BF%87ContentDB%E5%AE%89%E8%A3%85%E6%88%96%E4%BB%8E%E6%BA%90%E7%A0%81%E4%B8%8B%E8%BD%BD%E5%B9%B6%E5%A4%8D%E5%88%B6%E5%88%B0%60/config/.minetest/games/minetest%60%E7%9B%AE%E5%BD%95%E3%80%82

使用方法

可通过docker-compose或docker cli创建容器。

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  minetest:
    image: lscr.io/linuxserver/minetest:latest
    container_name: minetest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - "CLI_ARGS=--gameid minetest --port 30000" #可选
    volumes:
      - /path/to/data:/config/.minetest
    ports:
      - 30000:30000/udp
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=minetest \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e CLI_ARGS="--gameid minetest --port 30000" `#可选` \
  -p 30000:30000/udp \
  -v /path/to/data:/config/.minetest \
  --restart unless-stopped \
  lscr.io/linuxserver/minetest:latest

参数

容器通过运行时参数配置，格式为<外部>:<内部>。

环境变量文件（Docker secrets）

可通过FILE__前缀从文件加载环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

上述命令会将/run/secrets/mysecretvariable文件内容设为MYVAR环境变量。

应用运行的Umask设置

可通过-e UMASK=022覆盖容器内服务的默认umask设置。注意umask是权限减法而非加法，详见umask说明。

用户/组ID

使用卷（-v）时，主机与容器可能存在权限问题。通过指定PUID和PGID可避免此问题，确保主机卷目录所有者与指定ID一致。使用id your_user命令获取当前用户的ID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=minetest&query=%24.mods%5B%27minetest%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=minetest "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=universal "查看通用mods")

可通过https://github.com/linuxserver/docker-mods%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E5%8F%AF%E7%94%A8mods%E3%80%82

支持信息

• 容器运行时的Shell访问：

  bash
  docker exec -it minetest /bin/bash
  

• 实时查看容器日志：

  bash
  docker logs -f minetest
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' minetest
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/minetest:latest
  

更新信息

大多数镜像为静态版本，需更新镜像并重建容器以更新应用。以下是更新方法：

通过Docker Compose

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull minetest
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d minetest
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/minetest:latest
  

• 停止运行中的容器：

  bash
  docker stop minetest
  

• 删除容器：

  bash
  docker rm minetest
  

• 使用相同参数重建容器（配置文件和数据通过卷映射保留）

• 清理旧镜像：

  bash
  docker image prune
  

通过Watchtower自动更新（仅用于忘记原始参数时）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once minetest

警告：不推荐使用Watchtower进行自动更新，建议使用https://docs.linuxserver.io/general/docker-compose%E3%80%82

镜像更新通知 - Diun

推荐使用https://crazymax.dev/diun/%E6%8E%A5%E6%94%B6%E6%9B%B4%E6%96%B0%E9%80%9A%E7%9F%A5%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E5%B7%A5%E5%85%B7%E3%80%82

本地构建

如需本地修改或开发：

bash
git clone https://github.com/linuxserver/docker-minetest.git
cd docker-minetest
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/minetest:latest .

在x86_64硬件上构建ARM变体需使用multiarch/qemu-user-static：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

然后使用-f Dockerfile.aarch64指定架构Dockerfile。

版本历史

• 12.07.23: 基于Alpine 3.18重建，移除minetest_game。
• 06.07.23: 弃用armhf架构。
• 09.04.23: 构建逻辑调整，将devtest复制到默认游戏目录。
• 17.03.23: 修复README中的CLI_ARGS示例。
• 23.02.23: 基于Alpine 3.17重建，迁移至s6v3。
• 06.08.22: 更新irrlicht依赖。
• 02.05.22: 支持指定广播端口。
• 17.03.22: 安装分叉的irrlicht，添加zstd。
• 19.01.22: 基于Alpine 3.15重建。
• 02.06.20: 基于Alpine 3.12重建。
• 19.12.19: 基于Alpine 3.11重建。
• 12.07.19: 修复支持多CLI变量的问题。
• 28.06.19: 基于Alpine 3.10重建。
• 03.06.19: 添加自定义CLI变量选项。
• 23.03.19: 切换到新基础镜像，迁移至arm32v7标签。
• 04.03.19: 基于Alpine 3.9重建，使用新构建参数编译Minetest 5.0.0。
• 14.01.19: 添加流水线逻辑和多架构支持。
• 08.08.18: 基于Alpine 3.8重建，从最新发布标签而非master分支构建。
• 03.01.18: 弃用cpu_core例程，因缺乏扩展性。
• 08.12.17: 基于Alpine 3.7重建。
• 30.11.17: 使用cpu核心计数例程加快构建速度。
• 26.05.17: 基于Alpine 3.6重建。
• 14.02.17: 基于Alpine 3.5重建。
• 25.11.16: 基于Alpine Linux重建，迁移至主仓库。
• 27.02.16: 升级到最新版本。
• 19.02.16: 将端口改为UDP。
• 15.02.16: 将Minetest应用设为服务。
• 01.02.16: 添加lua-socket依赖。
• 06.11.15: 初始发布。