- 楼主 编辑于
Crosis47/tModLoader 在 1Panel 上的小白部署教程
教程是我和 AI 讨论过,然后让 AI 帮忙整理,最后人工润色,不是直接由 AI 生成,是可以直接部署的,各位可以试试
适用项目:https://github.com/Crosis47/tmodloader
软件版本: 当前tmodloader-master版本编写为3.8.0
环境:vipcloud VPS + 1Panel
目标:用 1Panel 的 “编排(Compose)” 部署 tModLoader一、vipcloud 机器的配置
项目 参数 商家 VIPCloud 官网链接 vipserver.cloud 价格 免费获得(首次需支付 0.1 元) CPU 2 核 内存 2 GB 硬盘 20 GB 带宽 10 Mbps 线路 回程三网精品优化 机房 美西 适合的场景
- 适合:原版或少量 mod(例如更好的体验),2~4 人联机,小世界起步。
- 勉强:中型 modpack,4~8 人。2G 内存会比较紧,建议加 swap 并少开 mod。
- 不适合:灾厄这类大型整合包,或者人多长期挂机。内存和 20G 硬盘都不够宽裕。
二、整体思路与端口
玩家 ──TCP 7778──► VPS 上的 tmodloader 容器 管理员 ──HTTPS──► Cloudflare(黄云)──► 1Panel OpenResty(80/443) ──► 127.0.0.1:8083(WebUI后台管理器面板)端口 用途 对公网开放 7778 游戏端口,玩家直连 是 8083 tModLoader WebUI 否,只绑定 127.0.0.1,由 1Panel 反代 80/443 1Panel OpenResty 是 Cloudflare 免费版不代理 7778 这种游戏 TCP 端口,所以游戏只能直连 IP,或者用一条灰云的域名解析到 VPS。只有 WebUI 走黄云。
需要替换的值
占位符 说明 tmod.example.comWebUI 域名,必须托管在 Cloudflare 你的服务器IPVPS 公网 IPv4 ChangeMe_StrongPassword_123游戏密码,自己设一个强密码 World1世界名,建议先用英文或数字 三、部署步骤
前提:VPS 已装好 1Panel(含 Docker 和 OpenResty)。不同版本的菜单名称可能略有差异,以实际界面为准。
1. 部署前检查
在 1Panel 终端或 SSH 里执行:
# 检查端口是否空闲(无输出代表空闲) ss -lntp | grep -E ':(7778|8083)\b' # 检查 Docker 和 Compose docker --version docker compose version如果端口被占用,换个端口,并把后面所有出现的地方同步修改。
2. 创建编排
1Panel → 容器 → 编排 → 创建编排,名称填
tmodloader,选空模板,粘贴下面的内容后保存:services: tmodloader: image: ghcr.io/crosis47/tmodloader:latest container_name: tmodloader restart: unless-stopped stop_grace_period: 2m environment: TMOD_WEB_ENABLED: "1" TMOD_WEB_PORT: "8083" TMOD_WEB_ORIGIN: "https://tmod.example.com" TMOD_WEB_TRUSTED_PROXY: "172.17.0.1" TMOD_PORT: "7778" TMOD_PASS: "ChangeMe_StrongPassword_123" TMOD_MAXPLAYERS: "8" TMOD_MOTD: "Welcome to my tModLoader server!" TMOD_WORLDNAME: "World1" TMOD_WORLDSIZE: "1" TMOD_WORLDEVIL: "random" TMOD_WORLDSEED: "" TMOD_DIFFICULTY: "0" TMOD_MODS: "" TMOD_BACKUP_INTERVAL: "0" TMOD_AUTOSAVE_INTERVAL: "10" TMOD_AUTO_UPDATE: "1" healthcheck: # 首次启动要下载运行时并生成世界,给足宽限时间 start_period: 600s # 使用 Docker 默认 bridge,方便确定反代来源 IP network_mode: bridge ports: # 游戏端口:对公网开放 - "7778:7778/tcp" # WebUI:只绑定本机回环,不直接暴露公网 - "127.0.0.1:8083:8083/tcp" volumes: - "./data:/data" - "./backups:/backups" logging: driver: "json-file" options: max-size: "20m" max-file: "3"几个要点:
- 所有配置都写在
environment里,不需要.env,也不需要docker build,直接用现成镜像。 127.0.0.1:8083:8083不能漏掉127.0.0.1,否则 WebUI 会暴露到公网。TMOD_WEB_ORIGIN必须是https://域名,不能写 IP,不要带结尾斜杠。TMOD_PASS务必换成自己的强密码,并且不要和之后的 WebUI 管理员令牌相同。TMOD_WORLDNAME、TMOD_WORLDSIZE、TMOD_DIFFICULTY只影响新建世界。第一次建议小世界、不装 mod,跑通再说。- 如果 GHCR 拉取失败,把镜像改成
docker.io/crosis47/tmodloader:latest。 - YAML 只能用空格缩进,不能用 Tab。
3. Cloudflare DNS 与 SSL
DNS 里添加:
类型 名称 内容 代理状态 A tmod你的服务器 IP 黄云(已代理) A game你的服务器 IP 灰云(仅 DNS) 游戏域名必须是灰云。
cloudflare 上面的 SSL/TLS 设置:
- 加密模式选 Full (strict),千万别选 Flexible。选了之后源站收到的
X-Forwarded-Proto是 http,tModLoader 会直接 403。 - 开启 Always Use HTTPS。
- 部署阶段建议关闭 Rocket Loader、Bot Fight Mode、Under Attack Mode,否则初始化页面可能一直转圈。
4. 1Panel 反向代理与证书(很重要)
- 1Panel → 网站 → 创建网站 → 反向代理,域名填
tmod.example.com,代理地址填http://127.0.0.1:8083。 - 进入该网站的 HTTPS 设置,申请 Let's Encrypt 证书,然后开启 HTTPS 和强制 HTTPS。HTTP 验证失败的话,可以临时切灰云,签发后再切回黄云。
- 进入反向代理的源文 / 自定义配置,把
location ^~ / { ... }整段替换为:
location ^~ / { proxy_pass http://127.0.0.1:8083; proxy_http_version 1.1; proxy_set_header Host $http_host; # 把 Cloudflare 传来的真实客户端 IP 作为唯一的 X-Forwarded-For proxy_set_header X-Real-IP $http_cf_connecting_ip; proxy_set_header X-Forwarded-For $http_cf_connecting_ip; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $http_connection; # 备份、恢复、世界生成可能比较久 proxy_read_timeout 3600s; proxy_send_timeout 3600s; client_max_body_size 64m; }为什么要改? 1Panel 默认用
$proxy_add_x_forwarded_for,经过 Cloudflare 后 XFF 里会出现多个 IP,而 tModLoader 只接受单个客户端 IP,否则直接拒绝。CF-Connecting-IP永远是单个 IP,所以换成它。5. 启动并获取初始化代码
回到 容器 → 编排 → tmodloader,点击启动。然后查日志找一次性初始化代码:
docker logs tmodloader 2>&1 | grep -i "setup code"首次拉镜像和下载运行时可能要几分钟,日志里暂时没有的话耐心等。
检查端口监听:
ss -lntp | grep -E ':(7778|8083)\b'正常是 7778 对外监听,8083 只在
127.0.0.1。如果看到0.0.0.0:8083,说明端口绑定写错了。6. 初始化 WebUI
- 浏览器打开
https://tmod.example.com。 - 输入刚才的 One-time setup code。
- 设置 Admin token:8~256 个 ASCII 字符,不能有空格,建议用密码管理器生成 32 位以上随机字符串。它不是游戏密码,是登录 WebUI 用的,务必保存好。
提交后容器会继续下载 tModLoader、.NET 并生成世界,几分钟到十几分钟都正常。Overview 显示在线、日志出现
Listening on port 7778,就说明就绪了。没就绪前不要反复 "重建",世界生成被打断可能留下不完整文件。总结
这台 VIPCloud 免费 VPS 跑少量玩家的 tModLoader 是可行的,游戏服务器对于带宽的需求也很少,但是更吃线路的稳定性以及延迟。
如果后期需要多人玩,包含大型 mod(例如灾厄的 tmod loader),建议买更高配置。收藏支持 1反对打赏 1
学习了
- 该楼层已被作者或管理员删除,作者可以在「我的删帖」页面申请恢复
哇偶,学习了
好帖必须支持