amonetta/tshock

Dockered tShock

Terraria的TShock服务器包装器

概述

!https://img.shields.io/badge/licence-GNUv3-blue.svg !https://img.shields.io/badge/tshock-v4.3.26-green.svg !https://img.shields.io/badge/TerrariaAPI-2.1-lightgrey.svg !https://img.shields.io/badge/terraria-1.3.5.3-brightgreen.svg

无论您是不了解服务器安装运行的普通玩家，还是希望轻松创建和维护服务器的TShock管理员，本Docker镜像都能帮助您实现目标。

唯一的要求是在您的机器/服务器上安装Docker（https://docs.docker.com/install/%EF%BC%89%E5%B9%B6%E6%8B%A5%E6%9C%89%E8%BF%90%E8%A1%8CDocker%E5%91%BD%E4%BB%A4%E7%9A%84%E6%9D%83%E9%99%90%E3%80%82

使用方法

简单启动

直接运行镜像即可开始游戏：

bash
$ docker run -d \
    -p 7777:7777 -p 7878:7878 \
    --name tshock \
    --network bridge \
    amonetta/tshock:latest

运行启用服务器端角色（SSC）的镜像：

bash
$ docker run -d \
    -p 7777:7777 -p 7878:7878 \
    --name tshock \
    --network bridge \
    amonetta/tshock:v4.3.26-ssc 

获取管理员认证PIN：

bash
$ docker attach tshock

复制PIN后，按 ctrl + p, ctrl + q 退出。

重要：不要通过关闭窗口或 ctrl + c 退出容器，这会导致服务器停止运行。

本地卷挂载

如需在主机存储世界数据，启动容器时需使用 -v 或 --volume 参数：

bash
$ docker run -d \
    -p 7777:7777 -p 7878:7878 \
    --name tshock \
    --network bridge \
    --volume $HOME/tschok/Terraria/Words:/opt/tshock/Terraria/Worlds \
    amonetta/tshock:latest

有关自定义卷配置的更多信息，请参阅Docker卷和挂载文档https://docs.docker.com/storage/volumes%E3%80%82

服务器控制

停止/重启

如需停止或重启容器：

bash
$ docker stop tshock

此操作将暂停服务器且不会丢失数据，可随时使用以下命令重启：

bash
$ docker restart tshock

备份

bash
$ docker commit -p tshock

-p：可选参数，在创建镜像期间暂停容器。

如需将新创建的镜像导出到其他机器，运行：

bash
docker save -o <生成的tar文件路径> <镜像名称>

保存生成的 .tar 文件，然后在目标机器上运行：

bash
docker load -i <镜像tar文件路径>

完整示例：

bash
$ docker commit -p tshock
sha256:18f834a8e6c997e22d3348f0883d9e718232f52f4175d5f1f62bb35d79c43e74
$ docker save -o ~/tshock/18f834a8e6c9.tar 18f834a8e6c9

将 18f834a8e6c9.tar 复制到目标机器后运行：

bash
$ docker load -i ~/tshock/18f834a8e6c9.tar
$ docker run -d \
      -p 7777:7777 -p 7878:7878 \
      --name tshock \
      --network bridge \
      18f834a8e6c9

服务器配置

tsc 命令

tsc（tshock命令）是一套自研命令集，用于简化TShock服务器的配置和管理。

• tsc config：获取/设置TShock服务器主配置
• tsc ssc：获取/设置TShock服务器SSC配置
• tsc health：显示TShock运行状态
• tsc update：将TShock服务器更新至最新版本
  警告：此操作可能影响插件兼容性，强烈建议更新前创建备份并检查插件兼容性。
• tsc version：获取当前TShock版本

tsc config：获取或设置服务器配置。运行后需重启服务器使配置生效。

bash
tsc config get|set [<config-key>] [<config-value>]

示例：

bash
$ tsc config get InvasionMultiplier
InvasionMultiplier:1

bash
$ tsc config set InvasionMultiplier 2
InvasionMultiplier:2

使用 -h 或 --help 选项获取命令详细信息。

可在容器外部运行命令：

bash
$ docker exec -it tshock tsc update

自定义配置

如需修改TShock服务器配置：

bash
$ docker exec -it tshock nano /opt/tshock/tshock/config.json
# 按 ctrl + p, ctrl + q 退出
$ docker restart tshock

修改SSC配置：

bash
$ docker exec -it tshock nano /opt/tshock/tshock/sscconfig.json
# 按 ctrl + p, ctrl + q 退出
$ docker restart tshock