cm2network/valheim Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

![]([] ![Docker Cloud Build Status]([] ![Docker Stars]([] ![Docker Pulls]([] ![]([] ![]([***]

支持的标签及对应的 Dockerfile 链接

• base, latest (bookworm/Dockerfile)
• plus (bookworm/Dockerfile)

什么是 Valheim？

一款支持 1-10 名玩家的残酷探索生存游戏，设定在受北欧文化启发的程序化生成炼狱世界中。战斗、建造、征服，谱写一段值得奥丁青睐的传奇！

Valheim

如何使用此镜像

托管简单的游戏服务器

使用主机网络接口运行（推荐）：

console
$ docker run -d --net=host --name=valheim-dedicated cm2network/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 cm2network/valheim
---
$ docker volume create valheim-plus-data # 对于 valheim:plus - 创建额外的世界卷
$ 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 cm2network/valheim:plus

运行多个实例（将 SERVER_PORT 增加 2，Steam 查询端口无法覆盖，始终为 SERVER_PORT + 1！）：

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

建议使用 "--cpuset-cpus=" 限制游戏服务器使用特定的核心和线程。
容器会在启动时自动更新游戏，因此若有游戏更新，只需重启容器即可。

配置

环境变量

可使用 -e（--env）覆盖以下环境变量：

dockerfile
SERVER_PORT=2456（游戏端口（tcp & udp）；Steam 查询端口（udp）为 SERVER_PORT + 1）
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 [appid] [STEAMCMD_UPDATE_ARGS]；例如："validate"）
ADDITIONAL_ARGS=""（传递额外参数给服务器。确保正确转义！）

如需了解更多 Valheim 服务器配置信息，请查看此文档。

配置文件

adminlist.txt、bannedlist.txt 和 permittedlist.txt 位于：/home/steam/valheim-dedicated/Worlds。

世界数据库文件位置：

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

镜像变体

valheim 镜像提供两种版本，适用于不同场景。

valheim:latest

默认镜像。若不确定需求，建议使用此版本。基础 Valheim 专用服务器，不含第三方插件。

valheim:plus

专用镜像。包含流行模组 ValheimPlus。

注意：此标签的游戏世界保存在不同目录，容器重建时需创建额外卷以持久化世界数据。详见#托管简单的游戏服务器

贡献者

![Contributors Display]([***]