martingwheeler/valheim

Valheim服务器镜像概述

Valheim是一款面向1-10名玩家的残酷生存探索游戏，背景设定在受维京文化启发的 procedurally生成的炼狱世界中。玩家可通过战斗、建造和征服，书写值得奥丁眷顾的传奇。本镜像基于CM2Walki/Valheim分叉，添加了对V+ Reforged mod的支持（原Valheim Plus mod已停止维护）。

核心功能

• 快速部署Valheim专用服务器
• 集成V+ Reforged mod（plus标签版本）
• 容器启动时自动更新游戏
• 支持数据持久化（通过卷挂载）
• 可配置多实例运行
• 灵活的环境变量自定义服务器参数

使用场景

• 搭建私人Valheim服务器供好友联机游玩
• 部署带V+ Reforged mod的服务器，增强游戏体验
• 需要自动更新功能的长期运行服务器

配置说明

环境变量

可通过-e参数覆盖以下环境变量：

dockerfile
SERVER_PORT=2456（游戏端口，TCP/UDP；Steam查询端口为SERVER_PORT+1，UDP）
SERVER_PUBLIC=1
SERVER_WORLD_NAME="BraveNewWorld"
SERVER_PW="changeme"
SERVER_NAME="New \"${STEAMAPP}\" Server"
SERVER_LOG_PATH="logs_output/outputlog_server.txt"
SERVER_SAVE_DIR="Worlds"
SCREEN_QUALITY="Fastest"
SCREEN_WIDTH=640
SCREEN_HEIGHT=480
STEAMCMD_UPDATE_ARGS=""（追加到+app_update命令后，示例："validate"）
ADDITIONAL_ARGS=""（传递额外服务器参数，需正确转义）

更多Valheim服务器配置细节可参考官方文档。

配置文件位置

• valheim:latest标签：/home/steam/valheim-dedicated/Worlds（包含adminlist.txt、bannedlist.txt、permittedlist.txt）
• valheim:plus标签：/home/steam/.config/unity3d/IronGate/Valheim/Worlds（同上配置文件）

世界数据库文件位置：

• valheim:latest：/home/steam/valheim-dedicated/Worlds/worlds
• valheim:plus：/home/steam/.config/unity3d/IronGate/Valheim/

镜像变体

valheim:latest

默认镜像，适用于大多数场景，包含基础Valheim专用服务器，无第三方插件。

valheim:plus

集成V+ Reforged mod的专用镜像，需注意该标签的世界数据存储路径不同，需额外创建卷以持久化数据（参考部署示例）。

部署示例

简单服务器部署（推荐使用host网络）

console
$ docker run -d --net=host --name=valheim-dedicated martingwheeler/valheim

数据持久化部署（绑定挂载目录）

console
$ mkdir -p $(pwd)/valheim-data
$ chmod 777 $(pwd)/valheim-data # 确保容器非特权用户可写
$ docker run -d --net=host -v $(pwd)/valheim-data:/home/steam/valheim-dedicated/ --name=valheim-dedicated martingwheeler/valheim
---
# 对于valheim:plus标签，需额外创建卷
$ docker volume create valheim-plus-data
$ docker run -d --net=host -v $(pwd)/valheim-data:/home/steam/valheim-dedicated/ -v valheim-plus-data:/home/steam/.config/unity3d/IronGate/Valheim/ --name=valheim-plus-dedicated martingwheeler/valheim:plus

多实例部署（端口需递增2，因为Steam查询端口固定为游戏端口+1）

console
$ docker run -d --net=host -e SERVER_PORT=2458 --name=valheim-dedicated2 martingwheeler/valheim

建议使用--cpuset-cpus=参数限制服务器使用特定核心和线程，提升性能。
容器启动时会自动更新游戏，若有版本更新只需重启容器即可。