Skip to main content
[ PIER ]

Terraria 服务器

一键专用 Terraria 服务器。

Service#game#server#terraria

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

使用 Pier 部署

  1. 1打开 Pier 控制台,点击 Add service。
  2. 2从模板列表中选择 Terraria Server。
  3. 3选择版本、设置服务名称,Pier 会自动配置容器、存储和端口。
  4. 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 上部署

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

部署此服务 →