a13332/dst-server

饥荒联机版专用服务器Docker镜像

官方服务器搭建文档较为繁琐，因此我们制作了该Docker镜像以简化流程。使用前请完整阅读本文档。

版本说明

饥荒服务器代码更新频繁，我们在Docker Hub提供多种标签变体：

• latest/vanilla：更新频率较低，适合日常使用
• nightly：每日构建，包含最新服务器代码
• steamcmd-rebase：基于cm2network/steamcmd:root，功能与latest一致

除nightly外，其他变体均有-slim版本（未预装服务器文件，启动时自动下载，无法离线运行）。latest由Docker Hub自动构建，其余变体通过Azure DevOps CI构建。

部署要求

• Linux x86_64系统，Docker 18.05.0-ce及以上版本
• 公网IP（如需外部访问）
• 开放4个UDP端口（-、-）
• CPU：1核可支持小型服务器（建议从15/30 tick开始，避免60 tick）
• 内存：建议预留1GiB基础内存+每活跃用户60MiB
• 磁盘：镜像占1.5GiB，需额外5MiB存储地图/配置/日志，推荐4GiB可用空间

快速部署

Docker Run方式

将服务器配置与数据保存至${HOME}/.klei/DoNotStarveTogether（默认路径）：

shell
docker run -v ${HOME}/.klei/DoNotStarveTogether:/data -p 10999-11000:10999-11000/udp -p 12346-12347:12346-12347/udp -it docker.xuanyuan.run/jamesits/dst-server:latest

Docker Compose方式

参考https://github.com/Jamesits/docker-dst-server/blob/master/docker-compose.yml%E3%80%82

停止服务器

按Ctrl+C等待正常关闭（避免强制终止导致数据丢失），或向supervisord进程发送SIGINT信号。服务器可能需要5分钟完成数据保存。

服务器配置

1. 生成初始配置：首次启动会自动生成默认配置，提示需填写集群令牌
2. 获取集群令牌：
   • 打开饥荒联机版客户端并登录
   • 点击"Play"→左下角"account"→浏览器中点击"GAMES"→"Don't Starve Together Servers"→"ADD NEW SERVER"生成令牌
3. 设置令牌：
   • 方式1：在docker run时添加环境变量-e DST_CLUSTER_TOKEN=你的令牌
   • 方式2：将令牌写入数据目录/DoNotStarveTogether/Cluster_1/cluster_token.txt
4. 自定义配置：修改Cluster_1/cluster.ini设置服务器名称，添加mod等，重新启动即可生效。

本地构建镜像

（通常无需此步骤，直接拉取预构建镜像即可）

shell
git clone https://github.com/Jamesits/docker-dst-server.git docker-dst-server
cd docker-dst-server
docker build . -t dst-server:latest

可通过--build-arg设置参数（如BASE_IMAGE、DST_DOWNLOAD等）。

常见问题

• 更新服务器/mod：重启服务器自动下载更新
• LAN连接：客户端控制台输入c_connect("IP地址", 端口, "密码")
• 端口要求：需开放UDP （主世界）、（洞穴）、-（Steam连接）
• 磁盘满：出现App '343050' state is 0x202错误
• 权限问题：出现App '343050' state is 0x602错误，检查文件系统权限

维护者

• James Swineson

许可协议

本项目基于GPL v2协议开源，详见https://github.com/Jamesits/docker-dst-server/blob/master/LICENSE%E3%80%82