mark2dot0/tshock

tShock Docker应用

镜像概述和主要用途

tShock Docker应用是一个基于frolvlad/alpine-mono的Docker镜像，用于运行Terraria的tShock服务器。该镜像借鉴了silvertoken/tshock-docker的启动脚本，支持快速部署Terraria服务器，实现世界生成、配置管理、日志记录和插件扩展等功能，当前已更新至tshock 4.5.5版本。

核心功能和特性

• 基于轻量级的alpine-mono基础镜像，资源占用低
• 支持交互式世界生成，便于初始化服务器配置
• 通过卷挂载实现配置文件、日志、世界数据和插件的持久化存储
• 支持后台运行模式，满足服务器长期稳定运行需求
• 暴露Terraria默认端口7777，便于网络访问

使用场景和适用范围

适用于需要快速部署和管理Terraria服务器的用户，尤其是希望通过Docker简化部署流程、实现数据持久化和灵活扩展的场景。无论是个人搭建私有服务器还是小型社区服务器，均能满足基本需求。

使用方法和配置说明

1. 初始运行生成世界

通过交互式模式启动服务器，用于创建初始世界。需挂载配置、日志、世界和插件目录至本地路径（例如/opt/tshock）以实现数据持久化。

命令格式：

bash
docker run -it -p 7777:7777 -v <本地配置路径>:/config -v <本地日志路径>:/logs -v <本地世界路径>:/world -v <本地插件路径>:/plugins --name="tshock" docker.xuanyuan.run/mark2dot0/tshock

示例：

bash
docker run -it -p 7777:7777 -v /opt/tshock/config:/config -v /opt/tshock/logs:/logs -v /opt/tshock/world:/world -v /opt/tshock/plugins:/plugins --name="tshock" docker.xuanyuan.run/mark2dot0/tshock

说明：

• -it：以交互式模式运行，允许通过终端输入世界创建参数
• -p 7777:7777：映射容器Terraria服务端口到主机
• -v：挂载本地目录至容器内对应路径，确保数据持久化
• --name="tshock"：指定容器名称为tshock，便于管理

2. 自动加载世界并后台运行

在已生成世界后，使用后台模式启动服务器并自动加载指定世界，实现服务器持续运行。

命令格式：

bash
docker run -dit -p 7777:7777 -v /opt/tshock/config:/config -v /opt/tshock/logs:/logs -v /opt/tshock/world:/world -v /opt/tshock/plugins:/plugins docker.xuanyuan.run/mark2dot0/tshock -world /world/<世界文件名>.wld

说明：

• -dit：以后台交互式模式运行（分离终端）
• -world /world/<世界文件名>.wld：指定要加载的世界文件路径，需替换为实际生成的世界文件名（位于本地世界路径下）

卷挂载说明