pfeiffermax/valheim-dedicated-server

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

镜像概述和主要用途

该Docker镜像提供Valheim专用游戏服务器，同时包含用于在https://kubernetes.io/%E4%B8%8A%E8%BF%90%E8%A1%8CValheim%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84https://helm.sh/%E3%80%82%E9%80%9A%E8%BF%87%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9C%BA%E5%88%B6%E6%AF%8F%E6%99%9A%E6%A3%80%E6%9F%A5Valheim%E5%85%AC%E5%85%B1%E5%88%86%E6%94%AF%EF%BC%8C%E5%BD%93Iron Gate Studios发布新版本时，会自动构建包含新版本的Docker镜像。使用latest标签即可保持镜像始终为最新版本，无需手动更新服务器。

Docker Hub：https://hub.docker.com/r/pfeiffermax/valheim-dedicated-server
GitHub仓库：https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm

核心功能和特性

• 自动更新：每晚检查Valheim公共分支，检测到新版本时自动构建并推送更新镜像，确保服务器始终使用最新版本
• 数据持久化：通过-savedir参数指定状态数据（配置、存档等）存储目录，需挂载https://docs.docker.com/storage/volumes/%E4%BB%A5%E6%8C%81%E4%B9%85%E5%8C%96%E5%AD%98%E5%82%A8%EF%BC%8C%E9%81%BF%E5%85%8D%E5%AE%B9%E5%99%A8%E6%9B%B4%E6%96%B0%E6%97%B6%E6%95%B0%E6%8D%AE%E4%B8%A2%E5%A4%B1
• 灵活配置：支持所有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（测试用）

快速启动测试容器：

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

Docker Compose

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

Helm Chart（Kubernetes部署）

如需在Kubernetes集群中部署，可使用提供的Helm Chart：
仓库地址：https://max-pfeiffer.github.io/valheim-dedicated-server-docker-helm
Chart文档：charts/valheim/README.md

若在裸金属Kubernetes集群部署，可参考https://max-pfeiffer.github.io/blog/hosting-game-servers-on-bare-metal-kubernetes-with-kube-vip.html%EF%BC%8C%E4%BA%86%E8%A7%A3%E5%A6%82%E4%BD%95%E7%BB%93%E5%90%88kube-vip%E5%AE%9E%E7%8E%B0%E9%83%A8%E7%BD%B2%E3%80%82

附加信息源

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

其他游戏服务器项目

• https://github.com/max-pfeiffer/rust-game-server-docker

致谢

感谢https://github.com/jonakoudijs%E6%8F%90%E4%BE%9B%E7%9A%84https://github.com/steamcmd/docker%EF%BC%8C%E6%9C%AC%E9%A1%B9%E7%9B%AE%E5%9F%BA%E4%BA%8E%E8%AF%A5%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E3%80%82