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容器注册表

环境变量

高级环境变量详见下文。

容器环境变量

自动更新

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

自动备份

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

Huginn HTTP服务器

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

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

Docker Compose

简单配置

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

yaml
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

完整配置

yaml
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

Odin

本仓库包含名为Odin的CLI工具，用于在容器内管理服务器。点击查看Odin使用说明

点击查看Odin的高级环境变量

BepInEx支持

本仓库自动为BepInEx设置必要的环境变量，但由于Valheim mod社区尚在发展初期，你需要手动在容器中安装BepInEx。

点击查看BepInEx支持文档

Webhook支持

通过WEBHOOK_URL变量可自动向***发送通知。如需高级设置，请查看以下文档：

点击查看Webhook支持文档

文件传输指南

本指南介绍如何在主机间传输文件（如世界文件、BepInEx配置或备份）。

点击查看文件传输教程

赞助商

寻找赞助商中！

版本通知

如需将版本通知集成到***服务器，请点击：

注意：此***仅用于版本通知，已禁用所有聊天消息权限。本仓库支持需在Discussions中进行

版本历史

• latest（稳定版）：支持mod，代码库优化
• 1.4.x（稳定版）：*** Webhook升级
• 1.3.x（稳定版）：代码库健康度改进
• 1.2.0（稳定版）：新增停止功能和信号处理
• 1.1.1（稳定版）：修复参数补丁
• 1.1.0（不稳定版）：镜像清理和提速
• 1.0.0（稳定版）：基础功能可用

//: <> (图片基础URL: [***]

贡献者 ✨

感谢以下贡献者（emoji键）：