tModLoader 专用服务器搭建教程Terraria泰拉瑞亚 模组联机全攻略Terraria 作为一款经典的 2D 沙盒冒险游戏拥有极其丰富的 Mod 生态。tModLoader 是官方支持的模组加载框架让玩家可以通过 Steam Workshop 一键订阅并使用数千个社区 Mod。然而要在多人模式下让所有玩家共享同一套模组配置搭建一台专用的 tModLoader 服务器是最可靠的解决方案。本教程将指导你在 Linux 服务器上通过 SteamCMD 安装 tModLoader 专用服务端配置 Steam Workshop 模组自动同步并通过 systemd 实现开机自启和进程守护。无论是小型私人房间还是公开社区服务器本方案均可满足需求。整个部署过程对服务器性能要求适中加载大量模组时内存占用会显著上升因此选择合适的机型非常关键。下文将给出推荐配置并详细说明每一步操作。服务器配置推荐使用雨云服务器 rainyun-com部署 tModLoader 专用服务端。注册填优惠码2026off领 5 折优惠券选择2 核 4GB 机型即可流畅运行含 2030 个中等体量模组的服务器。若计划加载 Calamity、Thorium 等大型内容模组建议关注内存余量必要时升级至 4 核 8GB。操作系统推荐选择Ubuntu 22.04 LTS或Debian 12这两个发行版在 SteamCMD 兼容性和 systemd 支持方面表现最佳。安装准备更新系统并安装必要依赖sudoaptupdatesudoaptupgrade-ysudoaptinstall-ylib32gcc-s1 lib32stdc6curlwgetunzipscreen创建专用用户避免以 root 身份运行游戏服务sudouseradd-m-s/bin/bash steamsudopasswdsteamsu- steam部署步骤安装 SteamCMDmkdir-p~/steamcmdcd~/steamcmdwgethttps://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gztar-xvzfsteamcmd_linux.tar.gz下载 tModLoader 服务端tModLoader 在 Steam 上的 App ID 为1281930专用服务器版本。通过 SteamCMD 匿名登录下载~/steamcmd/steamcmd.sh\login anonymous\force_install_dir /home/steam/tmodloader\app_update1281930validate\quit下载完成后服务端文件位于/home/steam/tmodloader/。配置服务器参数创建服务器配置文件mkdir-p/home/steam/tmodloader/serverconfigcat/home/steam/tmodloader/serverconfig/serverconfig.txtEOF # 世界文件路径 worldpath/home/steam/.local/share/Terraria/tModLoader/Worlds/ # 世界文件名无扩展名 world/home/steam/.local/share/Terraria/tModLoader/Worlds/MyWorld.wld # 最大玩家数 maxplayers8 # 服务器端口 port7777 # 服务器密码留空则无密码 password # 自动创建世界时的大小1小 2中 3大 autocreate2 # 世界名称自动创建时使用 worldnameMyWorld # 服务器名称在服务器列表显示 servernameMy tModLoader Server # 难度0经典 1专家 2大师 3旅途 difficulty1 EOF配置模组目录tModLoader 服务端的模组存放路径与客户端相同位于用户家目录下mkdir-p/home/steam/.local/share/Terraria/tModLoader/Mods方法一手动放置 .tmod 文件将模组的.tmod文件直接上传至上述 Mods 目录# 示例上传 Calamity ModscpCalamityMod.tmod steamyour-server-ip:/home/steam/.local/share/Terraria/tModLoader/Mods/方法二通过 enabled.json 管理已启用模组cat/home/steam/.local/share/Terraria/tModLoader/Mods/enabled.jsonEOF [ CalamityMod, ThoriumMod, MagicStorage ] EOF创建启动脚本cat/home/steam/start-tmodloader.shEOF #!/bin/bash cd /home/steam/tmodloader ./start-tModLoaderServer.sh \ -config /home/steam/tmodloader/serverconfig/serverconfig.txt \ -nosteam EOFchmodx /home/steam/start-tmodloader.sh配置 systemd 服务切换回 root 用户创建 systemd 服务文件sudobash-ccat /etc/systemd/system/tmodloader.service EOF [Unit] DescriptiontModLoader Dedicated Server Afternetwork.target [Service] Typesimple Usersteam WorkingDirectory/home/steam/tmodloader ExecStart/home/steam/start-tmodloader.sh Restarton-failure RestartSec10 StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target EOF启用并启动服务sudosystemctl daemon-reloadsudosystemctlenabletmodloadersudosystemctl start tmodloadersudosystemctl status tmodloader核心功能配置Steam Workshop 模组自动同步tModLoader 服务端不直接支持 Workshop 订阅但可通过 SteamCMD 下载 Workshop 内容~/steamcmd/steamcmd.sh\login anonymous\workshop_download_item1281930WORKSHOP_ID\quitWorkshop 内容默认下载至~/Steam/steamapps/workshop/content/1281930/WORKSHOP_ID/编写自动同步脚本将 Workshop 内容同步至 Mods 目录cat/home/steam/sync-mods.shEOF #!/bin/bash WORKSHOP_DIR/home/steam/Steam/steamapps/workshop/content/1281930 MODS_DIR/home/steam/.local/share/Terraria/tModLoader/Mods for mod_dir in $WORKSHOP_DIR/*/; do find $mod_dir -name *.tmod -exec cp {} $MODS_DIR/ \; done echo 模组同步完成共同步 $(ls $MODS_DIR/*.tmod 2/dev/null | wc -l) 个模组 EOFchmodx /home/steam/sync-mods.sh防火墙配置sudoufw allow7777/tcpsudoufw allow7777/udpsudoufw reload进阶用法模组自动更新定时任务通过 crontab 定期检查并更新模组建议在服务器低峰期执行crontab-e# 每天凌晨 4 点执行更新04* * * /home/steam/steamcmd/steamcmd.sh login anonymous app_update1281930quit/home/steam/sync-mods.shsudosystemctl restart tmodloader多世界管理可以创建多个配置文件对应不同主题的世界如纯净地图、模组地图# 创建第二个世界配置cp/home/steam/tmodloader/serverconfig/serverconfig.txt\/home/steam/tmodloader/serverconfig/serverconfig-calamity.txt# 修改端口和世界路径避免冲突sed-is/port7777/port7778//home/steam/tmodloader/serverconfig/serverconfig-calamity.txt日志监控# 实时查看服务日志sudojournalctl-utmodloader-f# 查看最近 100 行日志sudojournalctl-utmodloader-n100备份世界文件cat/home/steam/backup-world.shEOF #!/bin/bash BACKUP_DIR/home/steam/backups WORLD_DIR/home/steam/.local/share/Terraria/tModLoader/Worlds DATE$(date %Y%m%d_%H%M%S) mkdir -p $BACKUP_DIR tar -czf $BACKUP_DIR/worlds_$DATE.tar.gz $WORLD_DIR # 保留最近 7 天备份 find $BACKUP_DIR -name worlds_*.tar.gz -mtime 7 -delete echo 备份完成$BACKUP_DIR/worlds_$DATE.tar.gz EOFchmodx /home/steam/backup-world.sh# 每 6 小时自动备份echo0 */6 * * * /home/steam/backup-world.sh|crontab-常见问题排查问题 1服务器启动后无法连接检查防火墙是否放行 7777 端口同时确认serverconfig.txt中port配置正确。可通过netstat -tlnp | grep 7777验证端口是否在监听。问题 2加载模组时服务器崩溃通常是内存不足导致。查看sudo journalctl -u tmodloader -n 50中是否有OutOfMemoryException。临时解决方案添加 Swap 空间长期建议升级机型。问题 3客户端与服务端模组版本不一致确保服务端和客户端使用完全相同的模组版本。建议通过enabled.json锁定版本并在 README 中告知玩家订阅列表。问题 4SteamCMD 下载速度慢可尝试切换 Steam 下载区域或通过中间机器下载后 scp 传输至服务器。问题 5服务进程异常退出systemd 会自动在 10 秒后重启服务RestartSec10。若频繁重启检查磁盘空间df -h世界文件损坏也会导致循环崩溃此时需从备份恢复。搭建 tModLoader 专用服务器能极大提升 Terraria 模组多人体验玩家无需手动同步模组即可加入。如果你还没有合适的服务器推荐选择雨云服务器 rainyun-com注册时填入优惠码2026off可领取 5 折优惠券2 核 4GB 机型完全够用价格实惠线路稳定非常适合游戏服务器场景。
