本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

mbround18/valheim

Valheim专用服务器Docker镜像，由Odin工具驱动，支持自动更新、自动备份及完整mod支持，简化服务器部署与管理。

57 收藏0 次下载activembround18镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Valheim

![所有贡献者](#贡献者-)

在Linux服务器上运行

本仓库的工具可以无需安装Docker直接运行！如果只想在Linux系统上不使用Docker运行，请查看以下链接 <3

安装和使用Odin 工具Odin负责管理服务器，执行启动、停止和管理Valheim服务器实例的大部分工作。
安装和使用Huginn 想查看服务器状态？Huginn就是答案！Huginn是一个基于Odin相同源代码构建的HTTP服务器，提供几个HTTP端点用于状态查询。

在Ubuntu服务器上使用二进制文件运行时，你需要手动配置一些内容。如果希望轻松管理服务器，建议查看Docker部分 <3

使用Docker运行

如需入门指南，请点击此处

Mod支持！支持使用BepInEx启动服务器，但请注意！你需要自行负责调试服务器启动问题。Valheim官方尚未正式支持mod，因此可能会遇到错误。本仓库已测试ValheimPlus作为示例mod，无明显问题。详见mod入门指南

下载地址

DockerHub

GitHub容器注册表

环境变量

高级环境变量详见下文。

变量名	默认值	是否必填	描述
PORT	`2456`	是	设置服务器监听端口，同时会监听+2端口（如2456、2457、2458）
NAME	`Valheim Docker`	是	服务器名称，建议设置得有趣且独特！
WORLD	`Dedicated`	是	用于生成世界名称
PUBLIC	`1`	否	设置服务器是否在服务器列表中公开
PASSWORD	`<please set me>`	是	设置服务器密码，建议使用独特密码！
TYPE	`Vanilla`	否	可设置为`ValheimPlus`、`BepInEx`、`BepInExFull`或`Vanilla`
MODS	`<nothing>`	否	以逗号和换行分隔的mod数组。点击查看示例支持的文件类型：`zip`、`dll`和`cfg`
WEBHOOK_URL	`<nothing>`	否	提供Webhook URL可获取服务器状态通知（如*）。点击查看如何获取* Webhook URL
UPDATE_ON_STARTUP	`1`	否	容器启动时尝试更新服务器

容器环境变量

变量名	默认值	是否必填	描述
TZ	`America/Los_Angeles`	否	设置容器时区，用于时间戳和Cron任务。点击查看有效时区列表
PUID	`1000`	否	设置steam用户的用户ID
PGID	`1000`	否	设置steam用户的组ID

自动更新

变量名	默认值	是否必填	描述
AUTO_UPDATE	`0`	否	设置为`1`启用自动更新。容器将在`AUTO_UPDATE_SCHEDULE`指定的时间检查服务器更新，如有更新，会关闭服务器、更新并重新启动（仅当服务器之前运行时）
AUTO_UPDATE_SCHEDULE	`0 1 * * *`	否	与`AUTO_UPDATE`配合使用，设置自动更新的Cron计划任务。如需帮助设置Cron计划任务，请点击此处
AUTO_UPDATE_PAUSE_WITH_PLAYERS	`0`	否	如果有玩家在线，则不执行更新

自动更新任务会查询Steam并比较本地文件版本差异。

自动备份

变量名	默认值	是否必填	描述
AUTO_BACKUP	`0`	否	设置为`1`启用自动备份。备份存储在`/home/steam/backups`，需为此目录挂载卷
AUTO_BACKUP_SCHEDULE	`/15 * * *`	否	设置自动备份的频率（Cron计划任务）。如需帮助设置Cron计划任务，请点击此处
AUTO_BACKUP_REMOVE_OLD	`1`	否	设置为`0`保留所有备份，需手动管理
AUTO_BACKUP_DAYS_TO_LIVE	`3`	否	备份保留天数。备份已压缩，通常体积较小，可根据需要调整此值
AUTO_BACKUP_ON_UPDATE	`0`	否	在更新和启动服务器前创建备份
AUTO_BACKUP_ON_SHUTDOWN	`0`	否	关闭服务器时创建备份
AUTO_BACKUP_PAUSE_WITH_NO_PLAYERS	`0`	否	如果没有玩家在线，则跳过备份。`PUBLIC`需设置为`1`才能生效

自动备份生成*.tar.gz文件，平均4人经常游玩的世界备份约30MB。注意：若将服务器文件夹放在存档文件夹中，备份体积可能会变得极大。为避免此问题，请按docker-compose.yml中的指南正确挂载卷。

Huginn HTTP服务器

变量名	默认值	是否必填	描述
ADDRESS	`Your Public IP`	否	与`odin status`配合使用，设置后`odin`将停止尝试获取公网IP
HTTP_PORT	`1024以上任意值`	否	设置后将启动小型HTTP服务器，提供两个端点：

/metrics：提供Prometheus风格的指标输出
/status：提供传统状态页面

关于ADDRESS：可设置为127.0.0.1:<查询端口>或<公网IP>:<查询端口>，无需必填。注意，查询端口是Valheim服务器PORT变量值+1。

Docker Compose

简单配置

以下是基础Docker Compose示例，可在environment部分添加上述任何变量，但需遵循各变量的描述说明！

version: "3"
services:
  valheim:
    image: mbround18/valheim:latest
    ports:
      - 2456:2456/udp
      - 2457:2457/udp
      - 2458:2458/udp
    environment:
      PORT: 2456
      NAME: "使用Valheim Docker创建"
      WORLD: "Dedicated"
      PASSWORD: "Banana Phone"
      TZ: "America/Chicago"
      PUBLIC: 1
    volumes:
      - ./valheim/saves:/home/steam/.config/unity3d/IronGate/Valheim
      - ./valheim/server:/home/steam/valheim

完整配置

version: "3"
services:
  valheim:
    image: mbround18/valheim:latest
    ports:
      - 2456:2456/udp
      - 2457:2457/udp
      - 2458:2458/udp
    environment:
      PORT: 2456
      NAME: "使用Valheim Docker创建"
      WORLD: "Dedicated"
      PASSWORD: "Strong! Password @ Here"
      TZ: "America/Chicago"
      PUBLIC: 1
      AUTO_UPDATE: 1
      AUTO_UPDATE_SCHEDULE: "0 1 * * *"
      AUTO_BACKUP: 1
      AUTO_BACKUP_SCHEDULE: "*/15 * * * *"
      AUTO_BACKUP_REMOVE_OLD: 1
      AUTO_BACKUP_DAYS_TO_LIVE: 3
      AUTO_BACKUP_ON_UPDATE: 1
      AUTO_BACKUP_ON_SHUTDOWN: 1
      WEBHOOK_URL: "[***]"
      UPDATE_ON_STARTUP: 0
    volumes:
      - ./valheim/saves:/home/steam/.config/unity3d/IronGate/Valheim
      - ./valheim/server:/home/steam/valheim
      - ./valheim/backups:/home/steam/backups