tedtramonte/valheim-server

Valheim Server

镜像概述

Valheim Server 是一个 OCI 容器镜像，用于托管游戏《Valheim》的专用服务器。该镜像旨在简化 Valheim 服务器的部署和管理流程，确保玩家能够快速搭建稳定的游戏服务器环境。

查看 GitLab 仓库及完整文档

核心功能与特性

• 自动构建机制：当 Steam 平台上的 Valheim 游戏更新时，镜像会自动构建并更新，确保服务器始终运行最新版本。
• 容器化部署：基于 OCI 标准容器格式，支持跨平台部署，具备良好的隔离性和可移植性。
• 简化管理：通过容器化方式减少服务器配置复杂度，降低维护成本。

使用场景与适用范围

• 私人游戏服务器：供朋友或小团体搭建专属联机环境。
• 社区服务器：支持较大规模玩家群体的长期稳定运行。
• 快速部署需求：需要快速搭建或迁移 Valheim 服务器的场景。

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name valheim-server \
  -p 2456:2456/udp \
  -p 2457:2457/udp \
  -p 2458:2458/udp \
  -v /path/to/valheim/data:/root/.config/unity3d/IronGate/Valheim \
  --env SERVER_NAME="My Valheim Server" \
  --env SERVER_PASSWORD="securepassword" \
  --env WORLD_NAME="DedicatedWorld" \
  tedtramonte/valheim-server

参数说明：

• 端口映射：Valheim 服务器需要映射 UDP 端口 2456-2458（默认游戏端口、查询端口和备用端口）。
• 数据卷挂载：/path/to/valheim/data 本地目录用于持久化存储游戏存档和配置文件，避免容器重启后数据丢失。
• 环境变量：
  • SERVER_NAME：服务器名称（显示在服务器列表中）。
  • SERVER_PASSWORD：连接服务器的密码（必填，至少5个字符）。
  • WORLD_NAME：世界名称（用于生成或加载游戏世界）。

docker-compose 配置示例

yaml
version: '3'
services:
  valheim-server:
    image: tedtramonte/valheim-server
    container_name: valheim-server
    ports:
      - "2456:2456/udp"
      - "2457:2457/udp"
      - "2458:2458/udp"
    volumes:
      - ./valheim-data:/root/.config/unity3d/IronGate/Valheim
    environment:
      - SERVER_NAME=My Valheim Server
      - SERVER_PASSWORD=securepassword
      - WORLD_NAME=DedicatedWorld
    restart: unless-stopped

注意事项

• 首次启动时，服务器会自动下载并安装 Valheim 游戏文件，可能需要几分钟时间。
• 确保宿主机有足够的存储空间（建议至少 10GB）用于游戏文件和存档。
• 如需自定义服务器配置（如最大玩家数、难度等），可通过修改挂载目录中的 server.cfg 文件实现。