hexlo/terraria-server-docker

Terraria原版服务器

这是一个为Terraria PC版打造的原版服务器，打包为Docker镜像。

Docker Hub镜像

hexlo/terraria-server-docker:latest

环境要求

服务端

• Docker
• docker-compose（推荐）

客户端

• Terraria游戏客户端

基本配置

• 克隆本仓库或创建一个名为Worlds的文件夹
• 在与Worlds文件夹同级目录下创建docker-compose.yml文件（见下方示例）。也可将docker-compose-example.yml重命名为docker-compose.yml并进行修改。
• 根据需要编辑环境变量，下文表格将详细说明各变量含义。

docker-compose.yml示例

yaml
version: '3'
services:
  terraria-server:
    image: hexlo/terraria-server-docker:latest
    container_name: terraria-server
    restart: unless-stopped
    stdin_open: true
    tty: true
    ports:
      - 7779:7777
    volumes:
      - ./Worlds:/root/.local/share/Terraria/Worlds/
    environment:
      - world=/root/.local/share/Terraria/Worlds/world1.wld
      - autocreate=2
      - worldname=world1
      - difficulty=1
      - maxplayers=8
      - port=7777
      - password=mypassword
      - motd="欢迎来到hexlo的服务器！:)"

• 启动容器（若使用命令行界面）：
  docker-compose up -d

世界的创建与使用

使用现有世界

Terraria世界文件扩展名为.wld。若已有兼容的世界文件，只需将其放入Worlds目录，并确保world变量设置与文件名匹配。

创建新世界

有两种创建新世界的方式：

1. 使用docker-compose.yml文件中的变量（推荐）
2. 启动容器后手动连接并通过Terraria服务器的命令提示创建

1. 使用docker-compose.yml文件中的变量

需在docker-compose.yml的environment:部分设置以下变量：

yaml
...
    environment:
      - world=/root/.local/share/Terraria/Worlds/world1.wld
      - autocreate=2
      - worldname=world1
      - difficulty=1
...

2. 手动创建世界

可通过连接容器并手动执行服务器命令创建或选择世界：
docker attach <容器名称>

• 按回车键
• 按照服务器命令提示进行操作
• 按ctrl+p+ctrl+q断开连接（不停止容器）

重要提示

若要服务器在后续启动时自动运行，需通过world环境变量提供现有世界的路径。

环境变量

注意：变量区分大小写！

重要提示

若world变量留空或未设置，服务器需在容器启动后手动初始化。需连接容器并手动选择/创建世界、设置玩家数量、端口和密码。新创建的世界将保存在worldpath变量指定的目录。

1. docker attach <容器名称>
2. 按回车键
3. 按照提示操作
4. 按ctrl+p+ctrl+q断开连接

• 若使用特定种子创建世界后服务器仍无法自动初始化，请确保注释或移除docker-compose.yml中的seed=<yourseed>变量。

服务端控制台命令（来自非官方维基）

服务器运行时可执行以下命令（先通过docker attach <容器名称>连接容器）：

help - 显示命令列表
playing - 显示玩家列表（游戏内可通过/playing命令使用）
clear - 清空控制台
exit - 关闭服务器并保存
exit-nosave - 关闭服务器不保存
save - 保存游戏世界
kick <玩家名称> - 将玩家踢出服务器
ban <玩家名称> - 封禁玩家
password - 显示当前密码
password <密码> - 修改密码
version - 显示版本号
time - 显示游戏时间
port - 显示监听端口
maxplayers - 显示最大玩家数
say <消息> - 向所有玩家发送消息（玩家将看到黄色<server>前缀的消息）
motd - 显示服务器每日消息
motd <消息> - 修改服务器每日消息
dawn - 将时间设为黎明（4:30）
noon - 将时间设为正午（12:00）
dusk - 将时间设为黄昏（19:30）
midnight - 将时间设为午夜（0:00）
settle - 平静所有水体

封禁与解封

使用ban <玩家名称>命令封禁玩家，被封禁玩家登录时将显示提示信息。解封需编辑"banlist.txt"文件（位于Terraria目录），删除对应玩家名称和IP地址。

注意：命令前无需加斜杠/，部分命令界面可能需要。<|FCResponseEnd|>===SHORT_DESC=== 一个在Docker容器中运行的原版Terraria服务器

===FULL_DESC===# Terraria原版服务器

这是一个为Terraria PC版打造的原版服务器，打包为Docker镜像。

Docker Hub镜像

hexlo/terraria-server-docker:latest

环境要求

服务端

• Docker
• docker-compose（推荐）

客户端

• Terraria游戏客户端

基本配置

• 克隆本仓库或创建一个名为Worlds的文件夹
• 在与Worlds文件夹同级目录下创建docker-compose.yml文件（见下方示例）。也可将docker-compose-example.yml重命名为docker-compose.yml并进行修改。
• 根据需要编辑环境变量，下文表格将详细说明各变量含义。

docker-compose.yml示例

yaml
version: '3'
services:
  terraria-server:
    image: hexlo/terraria-server-docker:latest
    container_name: terraria-server
    restart: unless-stopped
    stdin_open: true
    tty: true
    ports:
      - 7779:7777
    volumes:
      - ./Worlds:/root/.local/share/Terraria/Worlds/
    environment:
      - world=/root/.local/share/Terraria/Worlds/world1.wld
      - autocreate=2
      - worldname=world1
      - difficulty=1
      - maxplayers=8
      - port=7777
      - password=mypassword
      - motd="欢迎来到hexlo的服务器！:)"

• 启动容器（若使用命令行界面）：
  docker-compose up -d

世界的创建与使用

使用现有世界

Terraria世界文件扩展名为.wld。若已有兼容的世界文件，只需将其放入Worlds目录，并确保world变量设置与文件名匹配。

创建新世界

有两种创建新世界的方式：

1. 使用docker-compose.yml文件中的变量（推荐）
2. 启动容器后手动连接并通过Terraria服务器的命令提示创建

1. 使用docker-compose.yml文件中的变量

需在docker-compose.yml的environment:部分设置以下变量：

yaml
...
    environment:
      - world=/root/.local/share/Terraria/Worlds/world1.wld
      - autocreate=2
      - worldname=world1
      - difficulty=1
...

2. 手动创建世界

可通过连接容器并手动执行服务器命令创建或选择世界：
docker attach <容器名称>

• 按回车键
• 按照服务器命令提示进行操作
• 按ctrl+p+ctrl+q断开连接（不停止容器）

重要提示

若要服务器在后续启动时自动运行，需通过world环境变量提供现有世界的路径。

环境变量

注意：变量区分大小写！

重要提示

若world变量留空或未设置，服务器需在容器启动后手动初始化。需连接容器并手动选择/创建世界、设置玩家数量、端口和密码。新创建的世界将保存在worldpath变量指定的目录。

1. docker attach <容器名称>
2. 按回车键
3. 按照提示操作
4. 按ctrl+p+ctrl+q断开连接

• 若使用特定种子创建世界后服务器仍无法自动初始化，请确保注释或移除docker-compose.yml中的seed=<yourseed>变量。

服务端控制台命令（来自非官方维基）

服务器运行时可执行以下命令（先通过docker attach <容器名称>连接容器）：

help - 显示命令列表
playing - 显示玩家列表（游戏内可通过/playing命令使用）
clear - 清空控制台
exit - 关闭服务器并保存
exit-nosave - 关闭服务器不保存
save - 保存游戏世界
kick <玩家名称> - 将玩家踢出服务器
ban <玩家名称> - 封禁玩家
password - 显示当前密码
password <密码> - 修改密码
version - 显示版本号
time - 显示游戏时间
port - 显示监听端口
maxplayers - 显示最大玩家数
say <消息> - 向所有玩家发送消息（玩家将看到黄色<server>前缀的消息）
motd - 显示服务器每日消息
motd <消息> - 修改服务器每日消息
dawn - 将时间设为黎明（4:30）
noon - 将时间设为正午（12:00）
dusk - 将时间设为黄昏（19:30）
midnight - 将时间设为午夜（0:00）
settle - 平静所有水体

封禁与解封

使用ban <玩家名称>命令封禁玩家，被封禁玩家登录时将显示提示信息。解封需编辑"banlist.txt"文件（位于Terraria目录），删除对应玩家名称和IP地址。

注意：命令前无需加斜杠/，部分命令界面可能需要。