qwick/terasology

docker-terasology

镜像概述和主要用途

docker-terasology是Terasology游戏服务器的Docker化镜像，提供自动构建服务。该镜像旨在为爱好者提供便捷的服务器部署方案，同时为开发者提供用于调试和测试的不稳定版本。通过Docker容器化，简化了Terasology服务器的安装和运行流程。

核心功能和特性

• 多版本支持：提供稳定版和开发版两种标签，满足不同使用需求
• 自动构建：由DockerHub和Jenkins实例自动构建，确保镜像时效性
• 可配置性：支持通过卷挂载自定义服务器配置，启用特定模块
• 版本化标签：清晰的标签命名规则，便于版本管理和选择

版本控制

为避免混淆，镜像标签遵循以下规则：

稳定版

• 格式：<engineVersion>-<displayVersion>
• 示例：1.2.1-alpha

开发版

• 格式：unstable-<engineVersion>-<buildNumber>
• 示例：unstable-1.2.2-SNAPSHOT-1806

注意：版本化标签可能会随时间变化。

使用场景和适用范围

• 游戏爱好者：快速部署稳定的Terasology服务器
• 开发者：使用不稳定版本进行调试、测试新功能
• 服务器管理员：通过容器化管理服务器，简化维护流程

使用方法和配置说明

拉取镜像

稳定版

bash
# 最新稳定版
docker pull qwick/terasology:latest

# 指定版本
docker pull qwick/terasology:1.2.1-alpha

开发版

bash
# 最新不稳定版
docker pull qwick/terasology:unstable-latest

# 指定版本化开发版
docker pull qwick/terasology:unstable-<engineVersion>-<buildNumber>

基本使用指南

该镜像提供基础的Terasology服务器，如需启用特定模块，需手动配置：

1. 绑定卷目录：将容器内的卷挂载到本地目录，以便持久化配置
2. 首次运行：启动容器后会生成默认配置文件config.cfg
3. 编辑配置：在本地挂载目录中编辑config.cfg，自定义服务器设置和模块

使用Docker Compose（推荐）

1. 克隆仓库并编辑docker-compose.yml，指定卷挂载位置：

   yaml
   version: '3'
   services:
     terasology:
       image: qwick/terasology:latest
       volumes:
         - /path/to/local/config:/terasology/server
       ports:
         - "25565:25565"  # 默认游戏端口
       restart: unless-stopped
   

2. 拉取镜像：

   bash
   docker-compose pull
   

3. 启动服务并查看输出：

   bash
   docker-compose up
   

4. 根据输出调整配置文件，如需修改配置，编辑本地挂载目录中的config.cfg，然后重启服务：

   bash
   docker-compose restart
   

直接运行容器

bash
docker run -d \
  -v /path/to/local/config:/terasology/server \
  -p 25565:25565 \
  --name terasology-server \
  qwick/terasology:latest

更多信息

• Terasology项目GitHub：https://github.com/MovingBlocks/Terasology
• Terasology官方网站：[***]