adaliszk/valheim-server

Valheim服务器Docker镜像文档

镜像概述

本镜像提供Valheim服务器的干净、快速且独立的Docker及Kubernetes Helm部署方案。与其他镜像不同，本镜像避免使用Supervisor和Cron等反模式，同时提供完整的Valheim服务器管理与监控功能集。

核心功能与特性

• 无需Steam下载：完整可用的Valheim服务器，无需从互联网下载任何内容
• 非root用户运行：采用非root用户运行，降低潜在安全风险
• 优雅停止机制：支持服务器优雅停止，确保在关闭前正确保存世界，避免世界文件损坏
• 自动备份：服务器保存世界文件时自动备份
• 日志输出清理：过滤不重要的调试信息，提供清晰的服务器输出
• 健康检查：内置健康检查，监控镜像基本状态
• 监控 companion 镜像：提供配套监控镜像 https://hub.docker.com/r/adaliszk/valheim-server-monitoring

使用场景与适用范围

适用于需要快速部署、安全运行Valheim服务器的用户，支持单机Docker部署、Docker Compose编排及Kubernetes集群部署，同时满足 vanilla 服务器、BepInEx 模组加载器或 Valheim Plus 模组的使用需求。

服务器镜像

镜像地址

• 主镜像：https://hub.docker.com/r/adaliszk/valheim-server
• 替代地址：
  • ghcr.io/adaliszk/valheim-server
  • quay.io/adaliszk/valheim-server

标签说明

• vanilla latest：始终指向最新稳定版服务器
• 0.212.9 0.212：2022年12月20日发布的服务器版本
• bepinex-5.4.1901 bepinex-5.4.19 bepinex-5.4 bepinex：使用 denkinson's BepInEx 模组加载器的最新服务器
• plus-0.9.9.11 plus-0.9.9 plus-0.9 plus：使用 https://github.com/valheimPlus/ValheimPlus 模组的最新服务器
• develop：包含当前测试中的分支构建

此外，还提供带版本前缀的标签，可精确指定服务器版本，例如：0.204.04-bepinex-5.4.1601

Docker 部署示例

基本运行命令

bash
docker run -p 2456-2457:2456-2457/udp adaliszk/valheim-server -name "My Server" -password="super!secret"

Docker Compose 配置

yaml
version: "3.8"
services:
  valheim:
    image: adaliszk/valheim-server
    environment:
      SERVER_NAME: "服务器列表中的自定义消息"
      SERVER_PASSWORD: "super!secret"
    ports:
      - 2456:2456/udp
      - 2457:2457/udp

有关镜像使用的更多详情，请参见 使用文档

Kubernetes 部署

bash
helm repo add adaliszk https://charts.adaliszk.io
helm upgrade --install --create-namespace --wait my-valheim-server adaliszk/valheim-server

监控 Companion 镜像

镜像地址

• 主镜像：https://hub.docker.com/r/adaliszk/valheim-server-monitoring
• 替代地址：
  • ghcr.io/adaliszk/valheim-server-monitoring
  • quay.io/adaliszk/valheim-server-monitoring

标签说明

• metrics：基于最新服务器版本的 mtail 指标
• prometheus：预配置的适用于 Docker 环境的 Prometheus

部署示例

Docker 命令

bash
docker run --name my_server -d -p 2456-2457:2456-2457/udp adaliszk/valheim-server
docker run -d --volumes-from my_server:ro -p 3903:3903 adaliszk/valheim-server-monitoring:metrics

Docker Compose 配置

yaml
version: "3.8"
volumes:
  logs: {}
services:
  valheim:
    image: adaliszk/valheim-server
    environment:
      SERVER_NAME: "服务器列表中的自定义消息"
      SERVER_PASSWORD: "super!secret"
    volumes:
      - logs:/logs
    ports:
      - 2456:2456/udp
      - 2457:2457/udp

  metrics:
    image: adaliszk/valheim-server-monitoring:metrics
    volumes:
      - logs:/logs:ro
    ports:
      - 3903:3903