Enshrouded专用服务器Docker镜像

Enshrouded游戏的Docker镜像，基于steamcmd镜像构建，使用supervisor管理启动、自动更新和清理流程。

环境变量

所有以SERVER_为前缀的环境变量，对应enshrouded_server.json配置文件中的选项（参考Enshrouded***文档）。

⚠️：表示功能开发中

补充说明

• 更新过程中，容器临时需要额外磁盘空间（最多为游戏大小的2倍）。
• 服务器角色配置可通过game/server目录下的enshrouded_server.json文件直接修改，或使用SERVER_ROLE_<index>_XYZ格式的环境变量。更多信息见***文档。

钩子（Hooks）

脚本会等待钩子命令执行完成后再继续。

镜像标签

端口（默认）

卷（Volumes）

注意：默认情况下，卷的文件所有者为UID和GID 4711（该用户通常不存在）。如需修改，可通过PUID和PGID环境变量指定。

推荐系统配置

• CPU：≥6核
• 内存：≥16GB
• 磁盘：≥30GB（建议使用SSD）

***配置说明

使用方法

Docker

bash
docker run -d --name enshrouded \
  --hostname enshrouded \
  --restart=unless-stopped \
  -p ***:***/udp \
  -v ./game:/opt/enshrouded \
  -e SERVER_NAME="Enshrouded服务器" \
  -e SERVER_PASSWORD="secret" \
  -e UPDATE_CRON="*/30 * * * *" \
  -e PUID=4711 \
  -e PGID=4711 \
  mornedhels/enshrouded-server:latest

Docker Compose

yaml
services:
  enshrouded:
    image: mornedhels/enshrouded-server:latest
    container_name: enshrouded
    hostname: enshrouded
    restart: unless-stopped
    stop_grace_period: 90s  # 停止前等待90秒（确保存档完成）
    ports:
      - "***:***/udp"
    volumes:
      - ./game:/opt/enshrouded  # 卷映射到当前目录下的game文件夹
    environment:
      - SERVER_NAME=Enshrouded服务器
      - SERVER_PASSWORD=secret  # 已弃用，仅作示例
      - UPDATE_CRON=*/30 * * * *  # 每30分钟检查更新
      - PUID=4711
      - PGID=4711

说明：上述配置中，卷会创建在docker-compose.yml文件所在目录。如需使用Docker默认卷路径（如/var/lib/docker），可改用以下配置：

yaml
services:
  enshrouded:
    image: mornedhels/enshrouded-server:latest
    container_name: enshrouded
    hostname: enshrouded
    restart: unless-stopped
    stop_grace_period: 90s
    ports:
      - "***:***/udp"
    volumes:
      - game:/opt/enshrouded  # 使用Docker命名卷
    environment:
      - SERVER_NAME=Enshrouded服务器
      - SERVER_PASSWORD=secret
      - UPDATE_CRON=*/30 * * * *
      - PUID=4711
      - PGID=4711

volumes:
  game:  # 定义命名卷

备份

镜像内置备份脚本，可将最新存档压缩为ZIP文件。启用备份需设置BACKUP_CRON环境变量（如每15分钟备份），限制备份数量可设置BACKUP_MAX_COUNT。

恢复备份

1. 停止服务器；
2. 将备份ZIP文件解压到存档文件夹（SERVER_SAVE_DIR指定路径）；
3. 启动服务器。

[!WARNING]
恢复后需验证文件权限：解压的文件所有者需与环境变量PUID和PGID匹配。若容器以特权模式运行，文件会自动调整为指定的UID和GID。

常用命令

• 强制更新：

  bash
  docker compose exec enshrouded supervisorctl start enshrouded-force-update
  

• 重置服务器角色：（会重启整个容器）⚠️

  bash
  docker compose exec enshrouded supervisorctl start enshrouded-reset-roles
  

• 重启服务器：（可用于定期维护）

  bash
  docker compose exec enshrouded supervisorctl restart enshrouded-server
  

已知问题

1. 服务器启动失败（未输出'HostOnline' (up)!日志）或更新失败，提示：

   Error! App '2278520' state is 0x202 after update job.
   

   原因：可能是文件权限错误或磁盘空间不足。
   解决：检查PUID和PGID是否正确，确保文件所有者匹配，且磁盘空间充足。

2. 自动更新失败，提示：

   Error! App '2278520' state is 0x6 after update job.
   

   *解释：更新器无法连接到内容服务器。
   可能原因：Steam应用清单损坏（参考#119）。
   解决：执行强制更新**命令。