如何创建您的 Hytale 服务器

本指南介绍如何在您的 VPS 或专用 Linux 服务器上安装和配置 Hytale 专用服务器。

订购服务器

要托管您的 Hytale 服务器，HostMyServers 提供多种游戏优化选择：

Performance VPS - 适合小型服务器
NVMe VPS - 极佳性价比
经济型专用服务器 - 适合多玩家服务器
性能专用服务器 - 最佳性能

前提条件

以 root 或具有 sudo 权限的用户进行 SSH 访问
64 位 Linux 系统（推荐 Ubuntu/Debian）
x64 或 ARM64 处理器
最少 4 GB 内存（推荐 8 GB）
约 10 GB 可用磁盘空间（推荐 SSD）
端口 5520 UDP 可访问
有效的 Hytale 账户

配置要求

组件	最低	推荐
内存	4 GB	8-16 GB
CPU	2 核	4 核
存储	10 GB SSD	20 GB SSD
网络	100 Mbps	1 Gbps

网络协议

Hytale 使用 QUIC over UDP 协议（不是像 Minecraft 那样的 TCP）。默认端口是 5520 UDP。

系统更新

sudo apt update && sudo apt upgrade -y

安装 Java 25

Hytale 至少需要 Java 25。早期版本将无法工作。

安装 Adoptium Temurin 25

# 添加 Adoptium 仓库
sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# 安装 Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

验证安装

java --version

创建专用用户

出于安全考虑，创建专用用户：

sudo adduser --disabled-password --gecos "" hytale

防火墙配置

开放 UDP 端口 5520：

使用 UFW

sudo ufw allow 5520/udp
sudo ufw reload

使用 iptables

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

下载 Hytale 服务器

推荐方法：Hytale Downloader CLI

以 hytale 用户身份连接：

sudo -u hytale bash
cd ~

创建目录并下载工具：

mkdir -p ~/hytale-server
cd ~/hytale-server
wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64

下载服务器文件

./hytale-downloader-linux-amd64

终端会要求您访问 oauth.accounts.hytale.com 以授权下载。请按照显示的说明操作。

验证后，您将获得一个存档（例如：2026.01.13-xxxx.zip）。

解压文件

unzip 2026.01.*.zip

您将获得一个 Server/ 文件夹和一个 Assets.zip 文件。

首次启动和身份验证

启动服务器

cd ~/hytale-server
java -jar Server/HytaleServer.jar --assets Assets.zip

验证服务器

首次启动时，服务器显示"No Server Token Configured"。您必须将其链接到您的 Hytale 账户。

在服务器控制台中，输入：
```
/auth login device
```
控制台显示一个代码（例如：ABCD-1234）和一个 URL
访问 https://accounts.hytale.com/device
输入显示的代码
验证后，控制台将显示：身份验证成功！模式：OAUTH_DEVICE

注意

每个 Hytale 账户最多可以创建 100 个服务器。

服务器配置

config.json 文件

首次启动后，编辑配置文件：

nano ~/hytale-server/config.json

主要参数

参数	类型	描述
`ServerName`	文本	公共服务器名称
`MOTD`	文本	欢迎消息
`Password`	文本	密码（空 = 公开）
`MaxPlayers`	整数	最大玩家数
`MaxViewRadius`	整数	以区块为单位的视距（推荐 12-16）
`LocalCompressionEnabled`	布尔值	数据压缩（推荐：true）
`Defaults > World`	文本	默认世界名称
`Defaults > GameMode`	文本	游戏模式（Adventure 或 Creative）

启动优化

内存分配

java -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

服务器规模	推荐内存
小型（1-10 玩家）	4 GB
中型（10-20 玩家）	6-8 GB
大型（20+ 玩家）	10-16 GB

AOT 缓存（Ahead-Of-Time）

提高启动时间：

java -XX:AOTCache=HytaleServer.aot -Xms4G -Xmx8G -jar Server/HytaleServer.jar --assets Assets.zip

配置为 systemd 服务

创建服务文件

sudo nano /etc/systemd/system/hytale.service

文件内容：

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
Group=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot -jar /home/hytale/hytale-server/Server/HytaleServer.jar --assets /home/hytale/hytale-server/Assets.zip
Restart=on-failure
RestartSec=20

[Install]
WantedBy=multi-user.target

启用并启动服务

sudo systemctl daemon-reload
sudo systemctl enable hytale.service
sudo systemctl start hytale.service

管理命令

# 检查状态
sudo systemctl status hytale.service

# 停止服务器
sudo systemctl stop hytale.service

# 重启服务器
sudo systemctl restart hytale.service

# 查看日志
sudo journalctl -u hytale.service -f

控制台命令

命令	描述
`/auth login device`	验证服务器
`/stop`	停止服务器
`/save`	保存世界
`/kick <玩家>`	踢出玩家
`/ban <玩家>`	封禁玩家
`/unban <玩家>`	解封玩家
`/whitelist add <玩家>`	添加到白名单
`/whitelist remove <玩家>`	从白名单移除
`/op <玩家>`	给予管理员权限
`/deop <玩家>`	移除管理员权限

自动备份

备份脚本

sudo nano /home/hytale/backup.sh

#!/bin/bash
BACKUP_DIR="/home/hytale/backups"
SERVER_DIR="/home/hytale/hytale-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p $BACKUP_DIR

# 备份宇宙和配置
tar -czf $BACKUP_DIR/hytale_$DATE.tar.gz -C $SERVER_DIR universe config.json bans.json whitelist.json permissions.json

# 删除超过7天的备份
find $BACKUP_DIR -name "hytale_*.tar.gz" -mtime +7 -delete

echo "备份完成：hytale_$DATE.tar.gz"

sudo chown hytale:hytale /home/hytale/backup.sh
sudo chmod +x /home/hytale/backup.sh

计划备份

sudo crontab -u hytale -e

添加：

# 每6小时备份
0 */6 * * * /home/hytale/backup.sh

连接到服务器

玩家可以通过以下方式连接：

启动 Hytale
进入"多人游戏"
输入地址：服务器IP:5520
如果配置了密码，请输入

故障排除

服务器无法启动

检查 Java 版本：java --version（必须是 25+）
检查日志：sudo journalctl -u hytale.service -n 100
验证 Assets.zip 和 Server/ 文件是否存在

身份验证错误

在控制台中重新运行 /auth login device
验证您的 Hytale 账户是否有效
检查服务器网络连接

玩家无法连接

验证端口 5520 UDP 已开放：sudo ufw status
验证服务器正在监听：ss -ulnp | grep 5520
使用 nc -zvu 服务器IP 5520 测试

性能问题

增加分配的内存（-Xmx）
在 config.json 中降低 MaxViewRadius
启用 LocalCompressionEnabled
安排定期重启

订购服务器​

前提条件​

配置要求​

系统更新​

安装 Java 25​

安装 Adoptium Temurin 25​

验证安装​

创建专用用户​

防火墙配置​

使用 UFW​

使用 iptables​

下载 Hytale 服务器​

推荐方法：Hytale Downloader CLI​

下载服务器文件​

解压文件​

首次启动和身份验证​

启动服务器​

验证服务器​

服务器配置​

config.json 文件​

主要参数​

启动优化​

内存分配​

AOT 缓存（Ahead-Of-Time）​

配置为 systemd 服务​

创建服务文件​

启用并启动服务​

管理命令​

控制台命令​

自动备份​

备份脚本​

计划备份​

连接到服务器​

故障排除​

服务器无法启动​

身份验证错误​

玩家无法连接​

性能问题​