kalhartt/tshock

docker-tshock

镜像概述和主要用途

docker-tshock是一个用于运行TShock Terraria服务器的Docker容器。TShock是Terraria的流行服务器管理工具，支持多人游戏、权限管理、插件扩展等功能。该镜像通过容器化方式简化了TShock服务器的部署流程，提供便捷的启动、管理和维护方式，适用于快速搭建稳定的Terraria多人游戏服务器。

核心功能和特性

• 简单部署：提供自动化构建镜像，可直接从Docker索引拉取使用
• 脚本辅助管理：包含tshock.sh脚本，支持服务器启动、附加和停止等操作
• 自定义配置：支持通过命令行参数覆盖默认服务器设置（如世界文件路径、最大玩家数等）
• 数据持久化：支持Docker卷挂载，可将世界文件、配置和日志存储在宿主机，便于备份和管理
• 端口灵活映射：可自定义Terraria游戏端口（默认7777）和TShock Web管理端口（默认7878）

使用场景和适用范围

• 游戏社区管理员快速部署Terraria多人服务器
• 玩家搭建私人Terraria服务器，与朋友进行多人游戏
• 需要简化服务器维护流程、实现数据持久化备份的场景
• 希望自定义服务器配置（如世界大小、玩家数量限制）的用户

详细使用方法和配置说明

安装

从Docker索引拉取最新的自动构建镜像：

bash
docker pull kalhartt/tshock:latest

快速启动

容器提供了一个bash脚本用于简化服务器管理。该脚本需要系统安装expect工具，且运行用户需具有Docker操作权限。操作步骤如下：

bash
# 下载脚本
wget https://raw.githubusercontent.com/kalhartt/docker-tshock/master/tshock.sh
# 添加执行权限
chmod +x tshock.sh

# 启动服务器（servername为自定义服务器名称）
./tshock.sh start servername

# 附加到服务器控制台（按ctrl-p ctrl-q组合键可分离）
./tshock.sh attach servername

# 停止服务器
./tshock.sh stop servername

执行上述命令后，会在$HOME/servername目录下创建文件夹，用于存储世界文件、日志和配置文件。脚本支持以下自定义选项：

bash
$ ./tshock.sh
用法:
    tshock [-g PORT] [-p PORT] [-d BASEDIR] start NAME
    tshock attach NAME
    tshock stop NAME

选项:
    NAME        Docker容器名称
    -d BASEDIR  挂载卷的目录（默认：$HOME/NAME）
    -p PORT     Terraria服务器绑定端口（默认：7777）

# 示例：使用自定义端口和目录启动服务器
$ ./tshock -p 1234 -d /abs/path/to/server start myserver

高级用法

自定义服务器启动参数

Terraria服务器默认使用参数-world /opt/tshock/Terraria/Worlds/Default.wld -autocreate 2启动。可通过docker run命令直接传递参数覆盖默认设置：

bash
docker run -it kalhartt/tshock:latest \
-world /opt/tshock/Terraria/Worlds/MyWorld.wld \  # 指定世界文件
-maxplayers 16  # 设置最大玩家数为16

挂载世界文件目录

为便于世界文件备份和管理，可将宿主机目录挂载到容器内的世界文件目录：

bash
docker run --name='tshock' -it \
-p 7777:7777 -p 7878:7878 \  # 映射游戏端口和Web管理端口
-v /path/to/local/Worlds:/opt/tshock/Worlds \  # 挂载本地世界文件目录
kalhartt/tshock:latest \
-world /opt/tshock/Worlds/MyWorld.wld \  # 使用挂载目录中的世界文件
-autocreate 2  # 自动创建世界（2=中等大小）

使用自定义配置文件

通过挂载配置目录，可使用自定义的config.json配置文件：

bash
docker run --name='tshock' -it \
-p 7777:7777 -p 7878:7878 \
-v /path/to/local/config:/opt/tshock/config \  # 挂载本地配置目录
kalhartt/tshock:latest \
-world /opt/tshock/Worlds/Default.wld \
-autocreate 2 \
-config /opt/tshock/config/config.json  # 指定使用自定义配置文件