Valheim专用服务器 - Docker镜像与Helm Chart

镜像概述和主要用途

该Docker镜像提供Valheim专用游戏服务器，同时包含用于在Kubernetes容器编排系统上运行Valheim服务器的Helm Chart。通过自动化机制每晚检查Valheim公共分支，当Iron Gate Studios发布新版本时，会自动构建包含新版本的Docker镜像。使用latest标签即可保持镜像始终为最新版本，无需手动更新服务器。

Docker Hub：[]
GitHub仓库：[]

核心功能和特性

• 自动更新：每晚检查Valheim公共分支，检测到新版本时自动构建并推送更新镜像，确保服务器始终使用最新版本
• 数据持久化：通过-savedir参数指定状态数据（配置、存档等）存储目录，需挂载Docker卷以持久化存储，避免容器更新时数据丢失
• 灵活配置：支持所有Valheim服务器配置参数（如-name、-world、-password等），作为命令行参数传递给服务器二进制文件
• 多部署方式：提供Docker Compose示例和Helm Chart，支持单机Docker部署和Kubernetes集群部署

使用场景和适用范围

• 快速搭建Valheim测试服务器，验证配置和功能
• 生产环境部署Valheim服务器，需自动更新和数据持久化的场景
• Kubernetes集群中部署Valheim服务器，利用Helm Chart简化管理

使用方法和配置说明

配置说明

Valheim服务器的所有配置选项均可作为命令行参数传递，语法如-name ValheimServer（服务器名称）、-public 1（公开服务器）等。关键参数：

• -savedir：指定状态数据存储目录，必须挂载Docker卷以确保数据持久化，避免容器更新时数据丢失
• -name：服务器名称（必填）
• -world：世界名称（必填）
• -password：服务器密码（必填，至少5个字符）
• -public：是否公开服务器（1=公开，0=私有，默认1）

Docker Run（测试用）

快速启动测试容器：

docker run -it --publish 2456:2456/udp pfeiffermax/valheim-dedicated-server:latest -name ValheimServer -world NewWorld -password supersecret -public 0

Docker Compose

完整部署示例及自动更新脚本可参考Docker Compose示例和文档。

Helm Chart（Kubernetes部署）

如需在Kubernetes集群中部署，可使用提供的Helm Chart：
仓库地址：[***]
Chart文档：charts/valheim/README.md

若在裸金属Kubernetes集群部署，可参考博客文章，了解如何结合kube-vip实现部署。

附加信息源

• SteamDB（Valheim应用信息）
• 官方Valheim专用服务器指南
• Valheim专用服务器Fandom Wiki

其他游戏服务器项目

• Rust专用服务器

致谢

感谢@jonakoudijs提供的Steamcmd Docker镜像，本项目基于该镜像构建。