anthonyneto/tshock

tShock Docker镜像文档

镜像概述

tShock Docker镜像是一个用于运行Terraria tShock服务器的容器化应用，基于frolvlad/alpine-mono基础镜像构建，启动脚本借鉴自silvertoken/tshock-docker项目。该镜像提供了便捷的Terraria服务器部署方式，支持世界生成、配置持久化及后台运行等核心功能。

核心功能与特性

• 轻量级基础：基于Alpine Linux和Mono框架，镜像体积小，资源占用低
• 数据持久化：通过卷挂载实现配置文件、日志、世界数据和插件的持久化存储
• 交互式世界生成：支持通过交互式模式创建新的Terraria世界
• 后台运行支持：可配置为自动加载世界并在后台运行，适合生产环境部署
• 端口映射：默认映射Terraria服务器端口7777，支持自定义端口配置

使用场景

• 个人或小型游戏社区部署Terraria多人服务器
• 需要快速搭建和迁移的Terraria服务器环境
• 希望通过容器化方式简化服务器管理和维护的场景

使用方法

1. 初始运行生成世界

通过交互式模式启动服务器，用于创建新的游戏世界。需指定本地目录挂载到容器内的配置、日志、世界和插件目录。

命令格式：

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

示例（使用/opt/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：映射容器7777端口到主机7777端口（Terraria默认端口）
• -v：挂载本地目录到容器对应目录，确保数据持久化
• --name：指定容器名称为"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：指定要加载的世界文件路径，需替换为实际创建的世界文件名
• 其他参数与初始运行命令保持一致，确保使用相同的挂载目录

数据卷说明

所有卷挂载均为可选，但建议挂载以确保数据持久化，避免容器重启后配置和世界数据丢失。