Terraria 服务器

一键专用 Terraria 服务器。

Service #game#server#terraria

基于官方 ryshe/terraria 镜像的 Pier 托管 Terraria 专用服务器。自动生成或恢复世界，支持 vanilla 和 tModLoader（带 mod）风味，可配置难度 / 大小 / 游戏模式，并跨重启持久化。

使用 Pier 部署

1 打开 Pier 控制台，点击 Add service。
2 从模板列表中选择 Terraria Server。
3 选择版本、设置服务名称，Pier 会自动配置容器、存储和端口。
4 如需 HTTPS，请绑定域名。Traefik 会自动签发 Let's Encrypt 证书。

什么是 Pier 托管的 Terraria 服务器？

本模板包装社区 Terraria 服务器 Docker 镜像，并将常见配置作为 Pier env vars 公开。你选择世界大小、难度、种子、最大玩家、密码 —— Pier 配置服务器、在首次启动时生成世界、跨重启持久化数据并在崩溃时重启。

vanilla Terraria 和 tModLoader 风味都可用（后者启用丰富的 Terraria mod 生态系统 —— Calamity、Thorium、Fargo’s 等）。

Pier 如何部署它

默认端口：7777/tcp（Terraria 标准）。数据卷挂载在 /world（或镜像的等效）—— .wld 世界文件、服务器配置、可选 mod 都在那里持久化。

首次启动时服务器根据 SIZE、DIFFICULTY、MODE、SEED env vars 自动生成世界。后续启动加载现有世界。通过更改 WORLD_FILENAME env var 切换世界 —— 旧世界保留在磁盘上直到你删除它们。

从 Terraria 客户端通过 Multiplayer → Join via IP 连接 —— 指向你的 VPS 公共 IP 和端口 7777，如果设置了密码则输入。

何时不要使用本模板

对于带自定义事件脚本、ops 工具、插件系统的大型服务器 —— 在本镜像之上使用 TShock（服务器 mod）。对于朋友之间的微型私人游戏，从一个玩家的 PC 在客户端内托管而无需专用服务器即可工作。Pier 上的自托管是”我想要一个始终在线的服务器，以便我们可以随时进入”的正确答案。

核心功能

自动生成世界

选择世界大小（小/中/大）、难度（普通/专家/大师/旅程）和种子 —— 服务器在首次启动时生成世界。

Vanilla 和 tModLoader

选择 vanilla 服务器进行无 mod 游戏，或 tModLoader 变体以启用 mod。Mod 文件夹作为卷挂载。

世界持久化 + 多世界

世界跨重启持久化。通过更改 WORLD_FILENAME env var 切换世界；旧世界保留在挂载卷的磁盘上。

可配置游戏设置

SIZE、DIFFICULTY、MODE、SEED、MAXPLAYERS、PASSWORD、MOTD 都作为 env vars 公开。在 Pier env 设置中实时编辑。

微小占用

空闲约 200 MB RAM，低 CPU。在小 VPS 上与其他服务舒适运行。

应用场景

朋友群服务器

小群体的密码保护服务器。比 Terraria 的"无官方托管服务器"替代品便宜 —— 你自托管或付费给托管服务。

带 mod 的 tModLoader 服务器

Calamity、Thorium、Fargo's、大型内容 mod —— tModLoader 风味的服务器处理它们。

长期运行的世界存档

在始终在线的服务器上建造数月的大型基地。通过卷快照备份。

PvP / 活动服务器

游戏模式设为专家/大师，自定义 MOTD，时间有限的公共活动。

代码示例

基本 vanilla 服务器（Pier env） text

WORLD_FILENAME = mybase.wld
AUTOCREATE = 2          # 1=小, 2=中, 3=大
DIFFICULTY = expert
MAXPLAYERS = 8
PASSWORD = friends2026
MOTD = 欢迎来到 Pier 服务器

tModLoader（启用 mod） text

# 在版本选择器中使用 tModLoader 镜像变体
# 将 mod 放入挂载的 Mods 文件夹
WORLD_FILENAME = calamity-world.wld
AUTOCREATE = 3
DIFFICULTY = master

自定义种子 text

WORLD_FILENAME = themidnight.wld
AUTOCREATE = 2
SEED = 12345-67890
MODE = 0

通过 docker exec 的服务器控制台 bash

docker exec -it pier-terraria attach

对比

vs Re-Logic 托管的 Terraria 服务器	Re-Logic 不提供托管服务器；唯一选项是自托管或第三方主机。Pier 上的自托管比专用 Terraria 主机便宜。
vs Minecraft（本目录）	不同的游戏。Minecraft Java Edition 有更丰富的 mod 生态系统（Forge/Fabric）和更大的玩家基础。
vs TShock（带 mod 的服务器）	TShock 是 vanilla Terraria 的服务器 mod，添加管理工具、权限、插件。如果你需要 ops 级服务器管理，值得运行 —— 将 TShock 二进制放入卷中。

常见问题

玩家如何连接？

他们使用 Terraria 中的 Multiplayer → Join via IP 选项，指向你的 VPS 公共 IP 和端口 7777，输入密码（如果设置了）。

我可以使用域名而不是 IP 吗？

Terraria 的 Join via IP 接受主机名（一些客户端需要字面 IP）。Pier 公开端口；在外部配置域名。

世界能多大？

大型世界 —— 8400×2400 块 —— 是 vanilla 支持的最大。游戏期间内存使用适度（约 500 MB-2 GB）。

Mod？

使用 tModLoader 镜像变体（通过 Pier 版本下拉选择）。Mod 放置在挂载的 Mods 文件夹中；加载顺序在 /home/terraria 配置中配置。

备份策略？

停止容器（让世界刷新到磁盘），快照数据卷，重启。或将 save 命令 docker exec 到运行中的服务器控制台。

世界损坏 / 恢复？

Terraria 写入 `.wld.bak` 自动备份。如果主世界损坏，将 .bak 重命名为 .wld 并重启。

端口如何公开？

7777/tcp —— Pier 公开它；确保你的 VPS 防火墙允许它。通过 SERVER_PORT env var 使用不同的端口。

在你的 VPS 上部署

部署此服务 →