Terraria_Server_Ops_Ubuntu_1.4.5.3

Terraria 服务器维护文档（Ubuntu / root / screen / 1453）

1. 基本信息

• 游戏：Terraria Dedicated Server
• 版本：1453（1.4.5.3）
• 系统：Ubuntu（云服务器）
• 运行用户：root
• 常驻方式：screen
• 默认端口：7777（可改）

3. 安装/更新（1453）

3.1 依赖

apt update
apt install -y wget unzip screen

3.2 下载并解压 1453

mkdir -p /opt/terraria && cd /opt/terraria
wget -O terraria-server.zip https://terraria.org/api/download/pc-dedicated-server/terraria-server-1453.zip
unzip -o terraria-server.zip
cd /opt/terraria/1453/Linux
chmod +x TerrariaServer.bin.x86_64

3.3 架构检查（避免 ARM 机器跑不起来）

uname -m
# 期望：x86_64

5. 启停与日常操作（screen）

5.1 启动（推荐标准流程）

cd /opt/terraria/1453/Linux
screen -S terraria
./TerrariaServer.bin.x86_64 -config serverconfig.txt

5.2 后台挂起（detach）

在 screen 内按：Ctrl + a 然后 d

5.3 查看/进入会话

screen -ls
screen -r terraria
# 若提示已占用：
screen -d -r terraria

5.4 优雅关服（一定要这样做，避免世界损坏）

进入 screen 控制台后输入：

save
exit

7. 备份策略（强烈建议）

目标：世界文件可恢复，升级/改配置不怕翻车。

7.1 手动备份（关服后做）

# 建议先在控制台执行 save + exit
mkdir -p /root/terraria_backups

ts=$(date +%F_%H%M%S)
tar -czf /root/terraria_backups/worlds_$ts.tar.gz \
  -C /root/.local/share/Terraria Worlds

7.2 在线备份（不关服也能做，但更推荐关服备份）

如果必须不停服备份，至少先在控制台输入：

save

然后再打包 Worlds 目录。

7.3 保留策略（简单版）

• 保留最近 7 天，每天 1 份
• 大版本升级前额外手动备份一份

9. 日志与排错

9.1 常用检查命令

端口是否监听

ss -lntup | grep 7777 || true

进程是否存在

ps aux | grep -E 'TerrariaServer|TerrariaServer\.bin' | grep -v grep

screen 是否还在

screen -ls

9.2 常见问题与处理

A）朋友连不上（超时）

• 先确认：安全组 TCP/UDP 7777 已放行
• 再确认：Ubuntu 防火墙没拦（UFW/iptables）
• 再确认：ss -lntup | grep 7777 有输出

B）启动失败 / 一闪而过

• 确认架构：uname -m 必须是 x86_64
• 确认权限：chmod +x TerrariaServer.bin.x86_64

• 直接在 shell 前台运行一次看报错：

  cd /opt/terraria/1453/Linux
  ./TerrariaServer.bin.x86_64 -config serverconfig.txt
  

C）世界丢失/变成新世界

• 你可能没写 world=，导致启动时自动创建了新世界
• 解决：在 serverconfig.txt 固定 world=/root/.local/share/Terraria/Worlds/xxx.wld

D）screen 里显示异常/TERM 问题

在 screen 内启动前加：

export TERM=xterm
./TerrariaServer.bin.x86_64 -config serverconfig.txt