sethmachineio/valheim-server

Valheim Server Docker镜像

镜像概述

本镜像提供了在Docker中运行Valheim游戏服务器的解决方案，支持在大多数操作系统（包括Valheim官方不支持的macOS）上部署。通过自定义启动脚本start-valheim-server.sh实现容器停止时的优雅关闭，确保世界数据正确保存；同时支持服务器自动更新功能，可定期检查并更新至最新版本，让服务器实现24/7稳定运行。

核心功能

• 跨平台兼容：支持Linux、macOS等多种操作系统部署。
• 优雅关闭：容器停止时自动保存世界数据，避免数据丢失。
• 自动更新：可配置定期检查Valheim服务器更新，自动重启应用新版本。
• 数据持久化：通过卷挂载保存世界数据、配置文件（管理员列表、黑名单等）及日志。
• 灵活配置：通过环境变量自定义服务器名称、世界名称、密码、端口等参数。

使用场景

• 个人或小团体搭建Valheim专用游戏服务器。
• 需要长期稳定运行且自动更新的游戏服务器场景。
• 在非官方支持的操作系统（如macOS）上部署Valheim服务器。

配置说明

环境变量

端口转发

需在主机开放UDP端口2456、2457、2458，确保服务器可被访问。

部署示例

Docker Compose

1. 克隆仓库并编辑docker-compose.yml配置。
2. 后台启动容器：

bash
docker-compose up -d

3. 停止容器：

bash
docker-compose down

Docker CLI

1. 拉取镜像：

bash
docker pull sethmachineio/valheim-server:latest

2. 运行容器（替换/your/local/path/valheim-data为实际路径）：

bash
docker run --name=valheim-server -d \
--restart always \
-p 2456:2456/udp -p 2457:2457/udp -p 2458:2458/udp \
-v /your/local/path/valheim-data:/home/steam/valheim-data \
--env VALHEIM_SERVER_NAME="MyValheimServer" \
--env VALHEIM_WORLD_NAME="MyValheimWorld" \
--env VALHEIM_PASSWORD="HardToGuessPassword" \
--env VALHEIM_PUBLIC=1 \
--env VALHEIM_SERVER_UPDATE_ON_START_UP=1 \
--env VALHEIM_SERVER_AUTO_UPDATE=1 \
--env VALHEIM_SERVER_AUTO_UPDATE_FREQUENCY=30m \
sethmachineio/valheim-server

日志查看

1. 启动脚本日志：

bash
docker logs valheim-server

2. 世界专属日志：查看主机挂载目录下的<WorldName>-logs.txt文件。

镜像构建

1. 克隆仓库并进入目录：

bash
git clone <仓库地址> && cd valheim-server-docker

2. 构建镜像：

bash
docker build -t sethmachineio/valheim-server .

3. 强制更新服务器版本（忽略缓存）：

bash
docker build -t sethmachineio/valheim-server --no-cache .

自动更新使用说明

启用自动更新后，服务器会定期检查新版本并自动重启应用。若需手动触发更新，可停止并重启容器（确保VALHEIM_SERVER_UPDATE_ON_START_UP为1）。

Known Issues / FAQ

暂无已知问题。