kaysond/docker-terraria

Docker化原版泰拉瑞亚服务器

镜像概述和主要用途

本镜像提供Docker化的原版泰拉瑞亚服务器，用于快速部署和运行泰拉瑞亚多人游戏服务器。通过挂载卷实现世界文件和配置的持久化存储，支持安全配置和灵活管理，适合个人或小型团队搭建泰拉瑞亚多人游戏环境。

核心功能和特性

• 持久化存储：通过挂载卷保存世界文件（/world）和配置文件（/config），确保数据不丢失
• 配置灵活：支持自定义serverconfig.txt配置文件，可设置世界参数、难度、自动创建世界等
• 安全加固：支持使用专用用户运行，限制容器权限（如只读文件系统、capabilities删除、无新权限等）
• 交互式控制台：可通过docker attach连接服务器控制台，进行实时管理
• 自动世界创建：当指定世界文件不存在时，可通过autocreate选项自动生成世界

使用场景和适用范围

• 个人玩家搭建泰拉瑞亚多人服务器，与朋友联机游戏
• 小型游戏社区部署稳定的泰拉瑞亚服务器
• 需要简化服务器部署和管理流程的场景
• 对服务器安全性有要求，希望限制容器权限的场景

使用方法和配置说明

文件夹设置

需准备两个文件夹，用于挂载到容器：

• world文件夹：存放泰拉瑞亚世界文件（.wld），挂载到容器的/world路径
• config文件夹：存放服务器配置文件serverconfig.txt，挂载到容器的/config路径

配置文件说明

config文件夹中必须包含serverconfig.txt文件，配置项参考泰拉瑞亚官方文档，关键配置如下：

• worldpath=/world：指定世界文件存放路径（必须设置为此值）
• world=/world/<worldname>.wld：指定要加载的世界文件路径
• autocreate=<size>：当世界文件不存在时自动创建世界，0=小世界，1=中世界，2=大世界
• difficulty=<level>：设置世界难度，0=普通，1=专家，2=大师，3=旅程

部署示例

docker-compose.yml 示例

yaml
---
services:
  terraria:
    image: kaysond/docker-terraria
    container_name: terraria
    user: 7777:65534  # 替换为实际的用户ID和组ID
    restart: unless-stopped
    stdin_open: true  # 保持标准输入打开
    tty: true  # 分配伪终端
    ports:
      - 7777:7777  # 泰拉瑞亚默认端口
    volumes:
      - ./config:/config  # 配置文件目录
      - ./world:/world    # 世界文件目录
    read_only: true  # 容器文件系统设为只读
    cap_drop:
      - ALL  # 删除所有Linux capabilities
    security_opt:
      - no-new-privileges  # 防止权限提升
    pids_limit: 512  # 限制进程数
    mem_limit: 4G    # 内存限制
    cpus: 2          # CPU核心限制

serverconfig.txt 示例

world=/world/World.wld  # 世界文件路径，若不存在可通过autocreate创建
autocreate=2            # 自动创建中世界（2=中世界）
worldpath=/world        # 世界文件保存路径
worldname=Terraria      # 世界名称
difficulty=0            # 难度：0=普通，1=专家，2=大师，3=旅程

交互式控制台使用

部署后，可通过以下命令连接服务器控制台：

bash
docker attach terraria

如需退出控制台且不关闭服务器，按Ctrl+P后再按Ctrl+Q。

安全建议

• 创建专用用户运行容器，避免使用root用户
• 确保world和config文件夹权限正确，仅允许容器用户访问
• 启用read_only、cap_drop=ALL和no-new-privileges等安全选项，限制容器权限