sknnr/enshrouded-dedicated-server

enshrouded-server

镜像概述和主要用途

本镜像用于在容器中运行Enshrouded专用服务器，支持多种部署方式，包括Docker、Docker Compose、Podman及Kubernetes（通过Helm Chart）。

免责声明：这不是官方镜像。作者及任何相关方不对最终用户提供任何明示或暗示的支持。用户可自由使用本仓库内容。

核心功能和特性

• 容器内进程以非root用户（steam，uid:/gid:）运行，提升安全性
• 基于Proton环境构建（latest标签），Wine版本已停止更新
• 支持通过环境变量配置服务器参数或自定义配置文件
• 提供持久化存储方案，确保游戏存档数据不丢失
• 包含Helm Chart，支持在Kubernetes集群中部署

使用场景和适用范围

适用于需要快速部署和管理Enshrouded专用服务器的用户，可满足个人服务器、小型团队服务器及企业级Kubernetes集群环境的部署需求。

使用方法和配置说明

用户权限说明

容器内进程不以root用户运行，所有操作通过steam用户执行（默认uid:/gid:）。exec进入容器时默认目录为/home/steam，Enshrouded安装路径为/home/steam/enshrouded。持久化卷需挂载至/home/steam/enshrouded/savegame，且该目录必须属于***:***。

如需使用***以外的uid/gid，需基于提供的Dockerfile自定义构建镜像，详见https://github.com/jsknnr/enshrouded-server/issues/51%E3%80%82

Proton和Wine镜像版本

latest标签基于Proton构建，替代原Wine版本，过渡无缝。除latest外，还有wine-$release_version和proton-$release_version标签（$release_version为GitHub发布版本号），Wine版本已停止更新。

端口说明

环境变量配置

注意：使用Helm部署时，SERVER_IP参数会被忽略，因为Kubernetes环境中不适用此配置。

Docker部署

bash
docker volume create enshrouded-persistent-data
docker run \
  --detach \
  --name enshrouded-server \
  --mount type=volume,source=enshrouded-persistent-data,target=/home/steam/enshrouded/savegame \
  --publish 15637:15637/udp \
  --env=SERVER_NAME='Enshrouded Containerized Server' \
  --env=SERVER_SLOTS=16 \
  --env=SERVER_PASSWORD='ChangeThisPlease' \
  --env=PORT=15637 \
  sknnr/enshrouded-dedicated-server:latest

Docker Compose部署

复制仓库中container目录下的compose.yaml文件，编辑环境变量后运行：

bash
docker-compose up -d

停止服务：

bash
docker-compose down

compose.yaml文件内容：

yaml
version: "3"
services:
  enshrouded:
    image: sknnr/enshrouded-dedicated-server:latest
    ports:
      - "15637:15637/udp"
    environment:
      - SERVER_NAME=Enshrouded Containerized
      - SERVER_PASSWORD=PleaseChangeMe
      - PORT=15637
      - SERVER_SLOTS=16
      - SERVER_IP=0.0.0.0
    volumes:
      - enshrouded-persistent-data:/home/steam/enshrouded/savegame

volumes:
  enshrouded-persistent-data:

Podman部署

bash
podman volume create enshrouded-persistent-data
podman run \
  --detach \
  --name enshrouded-server \
  --mount type=volume,source=enshrouded-persistent-data,target=/home/steam/enshrouded/savegame \
  --publish 15637:15637/udp \
  --env=SERVER_NAME='Enshrouded Containerized Server' \
  --env=SERVER_SLOTS=16 \
  --env=SERVER_PASSWORD='ChangeThisPlease' \
  --env=PORT=15637 \
  docker.io/sknnr/enshrouded-dedicated-server:latest

Quadlet部署

在root用户下，创建/etc/containers/systemd/enshrouded.container文件：

text
[Unit]
Description=Enshrouded Game Server

[Container]
Image=docker.io/sknnr/enshrouded-dedicated-server:latest
Volume=enshrouded-persistent-data:/home/steam/enshrouded/savegame
PublishPort=15637:15637/udp
ContainerName=enshrouded-server
Environment=SERVER_NAME="Enshrouded Containerized Server"
Environment=SERVER_PASSWORD="ChangeThisPlease"
Environment=PORT=15637
Environment=SERVER_SLOTS=16

[Service]
# 睡眠结束后重启服务
Restart=always
# 延长超时时间以允许拉取镜像
TimeoutStartSec=900

[Install]
# 开机默认启动
WantedBy=multi-user.target default.target

Kubernetes部署

仓库helm目录包含Helm Chart，修改values.yaml后安装。也可通过作者的Helm仓库安装：

bash
helm repo add jsknnr https://jsknnr.github.io/helm-charts
helm repo update

安装Chart：

bash
helm install enshrouded jsknnr/enshrouded-dedicated-server --values myvalues.yaml
# myvalues.yaml为自定义配置的values文件

故障排除

连接性问题

容器部署后无法连接服务器，通常与镜像无关。需确保：

• 容器主机及路由器开放端口和（或自定义端口）
• 路由器将游戏端口和查询端口转发至容器主机私有IP
• 如仍有问题，可能是ISP封锁端口，需联系ISP排查

更多帮助可参考https://github.com/jsknnr/enshrouded-server/issues/16%E3%80%82

存储问题

建议由Docker或Podman管理挂载卷。如必须绑定挂载目录，需确保容器主机上的目录属主为***:***（chown -R 10000:10000 /path/to/directory），否则服务器无法持久化存档，容器无法启动。