didstopia/valheim-server

Valheim服务器Docker容器

镜像概述和主要用途

该镜像提供在Docker容器内运行的Valheim专用Linux服务器。它会自动安装/更新至最新的steamcmd和Valheim服务器，更新服务器只需重新部署容器。此外，可将整个/steamcmd/valheim目录挂载到主机系统，避免更新或重建容器时重新安装游戏。

核心功能和特性

• 自动更新：始终保持最新的steamcmd和Valheim服务器版本
• 数据持久化：支持挂载目录，确保服务器数据和游戏文件在容器更新或重建时不丢失
• 灵活配置：通过环境变量自定义服务器名称、世界、密码、管理员、可见性等参数
• 启动模式控制：可选择更新后启动（模式0）、仅更新（模式1）或仅启动（模式2），默认模式0
• 自动更新检测：启用后可在Steam推送服务器更新时自动重启并更新服务器
• 分支切换：支持切换游戏分支（如实验版），默认使用public分支

使用场景和适用范围

适用于需要便捷部署、管理和更新Valheim游戏服务器的用户，尤其适合希望通过Docker简化服务器搭建流程、确保数据持久化和版本控制的场景。

使用方法和配置说明

基本运行示例

以下是最小化使用示例（记得指定:latest标签，环境变量可省略以使用默认值）：

sh
docker run -d \
  --name valheim-server \
  --restart always \
  -e VALHEIM_SERVER_NAME="Didstopia Docker Server" \
  -e VALHEIM_SERVER_WORLD="docker" \
  -e VALHEIM_SERVER_PASSWORD="s3cr3t" \
  -p 2456-2458:2456-2458/udp \
  -v $(pwd)/valheim_data/saves:/app/.config/unity3d/IronGate/Valheim \
  -v $(pwd)/valheim_data/data:/steamcmd/valheim \
  didstopia/valheim-server:latest

注意：在撰写本文档时，Valheim服务器必须设置密码才能启动！

环境变量配置

可通过环境变量配置服务器参数，官方仓库的Dockerfile中提供了所有可用环境变量，以下是主要参数说明：

• VALHEIM_SERVER_NAME：服务器名称（默认值需参考Dockerfile）
• VALHEIM_SERVER_WORLD：世界名称（默认值需参考Dockerfile）
• VALHEIM_SERVER_PASSWORD：服务器密码（必填，无默认值）
• VALHEIM_START_MODE：启动模式，可选值：
  • 0：更新后启动（默认）
  • 1：仅更新
  • 2：仅启动
• VALHEIM_UPDATE_CHECKING：启用自动更新检测，1为启用，0为禁用（默认）
• VALHEIM_BRANCH：游戏分支，默认public，可设置为experimental以使用实验版

数据挂载说明

• /app/.config/unity3d/IronGate/Valheim：用于存储游戏存档，建议挂载到主机目录（如示例中的$(pwd)/valheim_data/saves）
• /steamcmd/valheim：用于存储游戏文件，建议挂载到主机目录（如示例中的$(pwd)/valheim_data/data），避免容器重建时重新下载游戏

许可证

参见 LICENSE