Valheim Docker镜像文档

镜像概述与主要用途

Valheim Docker镜像是用于快速部署和运行Valheim（英灵神殿）专用游戏服务器的容器化解决方案。该镜像支持自动安装、更新服务器程序，提供灵活的启动命令选项，并允许通过环境变量自定义服务器配置，适用于个人玩家或游戏社区搭建稳定、可配置的Valheim专用服务器。

核心功能与特性

• 自动管理：默认启动时自动安装并更新服务器程序，支持独立的更新、验证和启动命令
• 数据持久化：游戏数据存储于/home/ips-hosting目录，默认使用Docker卷持久化数据，也可手动挂载主机目录
• 灵活配置：通过环境变量自定义服务器名称、世界文件、密码、端口、跨平台支持等参数
• 跨平台支持：启用CROSSPLAY后支持PlayFab后端，允许不同平台玩家加入
• 安全可控：支持设置服务器可见性（公开/私有），自动备份功能保障数据安全

使用场景与适用范围

• 个人玩家搭建私人Valheim服务器，与朋友联机游戏
• 游戏社区部署公共服务器，通过自定义配置管理玩家访问
• 需要频繁更新或迁移服务器的场景，利用Docker容器简化部署流程
• 希望启用跨平台游戏功能，支持非Steam平台玩家加入的场景

使用方法

基本操作

以下命令用于管理Valheim服务器容器：

shell
# 创建Docker容器
docker create -it --restart always \
  --name valheim-server \
  -p 2456:2456/udp \
  -p 2457:2457/udp \
  ipshosting/game-valheim:v2

# 启动服务器
docker start valheim-server

# 停止服务器
docker stop valheim-server

# 重启服务器
docker restart valheim-server

# 查看服务器日志
docker logs valheim-server

# 附加到服务器控制台（实时输入命令和查看输出，按CTRL-P + CTRL-Q断开连接）
docker attach valheim-server

# 删除容器
docker rm valheim-server

命令说明

默认情况下，启动容器时会自动安装、更新服务器程序并启动Valheim服务器。可通过指定命令修改行为：

• update：仅安装服务器最新版本，完成后容器退出，不启动服务器
• update_validate：与update类似，但会验证文件完整性，推荐初始安装时使用
• start：仅启动服务器，不执行安装或更新操作

数据持久化

游戏服务器数据存储于容器内的/home/ips-hosting目录。默认情况下，Docker会自动创建卷以持久化数据，容器重启后数据保留。但重新创建容器时会生成新卷，若需访问旧数据需手动挂载原卷（详见Docker卷文档）。

手动挂载主机目录

如需将数据存储于主机指定路径，创建容器时添加-v /主机绝对路径:/home/ips-hosting参数。容器内运行用户ID为1000，需确保主机目录权限正确：

• 方法1：修改主机目录所有者为1000：chown -R 1000 /主机绝对路径
• 方法2：（当前Valheim不支持）通过--user USER_ID指定主机用户ID运行容器（可能导致段错误）

端口配置

默认端口映射：

• 2456/udp：游戏端口
• 2457/udp：查询端口（始终为游戏端口+1）

可通过GAME_PORT环境变量修改游戏端口，需同时更新容器端口绑定（如-p 2458:2458/udp -p 2459:2459/udp）。

环境变量配置

创建容器时通过-e "KEY=VAL"参数配置环境变量（可多次使用），修改环境变量需重新创建容器。

适用于update和update_validate命令的变量

• BETA_BRANCH：指定服务器程序的测试分支名称
• BETA_PASSWORD：测试分支的访问密码

适用于start命令的变量

• GAME_PORT：游戏端口，默认2456（需同步修改端口绑定）
• NAME：服务器名称，默认A Valheim server
• WORLD：世界文件名称，默认Dedicated
• PASSWORD：服务器密码，不能为空且至少5个字符，不得包含在服务器名称中，默认secret
• PUBLIC：服务器是否在服务器浏览器可见，1为可见，0仅通过IP加入，默认1
• SAVEINTERVAL：世界自动保存间隔（秒），默认1800（30分钟）
• BACKUPS：保留自动备份的数量，默认4
• BACKUPSHORT：前几次自动备份的间隔（秒），默认7200（2小时）
• BACKUPLONG：后续自动备份的间隔（秒），默认43200（12小时）
• CROSSPLAY：设为true启用跨平台后端（PlayFab），允许所有平台玩家加入；默认仅Steam用户可见和加入