lloesche/valheim-server

lloesche/valheim-server Docker镜像

Docker容器化的Valheim服务器（支持BepInEx和ValheimPlus）
项目托管于https://github.com/lloesche/valheim-server-docker

目录

• 基本Docker使用方法
• 环境变量
  • 日志过滤器
    • 日志过滤器事件钩子
      • ***日志过滤器事件钩子示例
  • 事件钩子
    • 事件钩子示例
      • 安装额外软件包
      • 将备份复制到其他位置
      • ***通知
  • 通过环境变量配置模组
• 系统要求
• 部署
  • 使用Docker和systemd部署
  • 使用docker-compose部署
  • 部署到Kubernetes
  • 部署到AWS ECS
  • 部署到Nomad
• 更新
• 备份
  • 手动备份
• 查找服务器
  • 游戏内
    • 通过主机名/IP直接加入
  • Steam服务器浏览器
  • Steam服务器收藏夹与局域网游戏
• 管理员命令
  • 启用管理员控制台
• Supervisor
  • Supervisor API
• 状态Web服务器
• 模组
  • BepInExPack Valheim
    • 配置
  • ValheimPlus
    • 更新
    • 配置
      • 禁用服务器密码
• 在Portainer中更改启动命令
• 群晖帮助
  • 首次安装
  • 将容器镜像更新到最新版本
    • 下载新容器镜像后出错
• QNAP NAS帮助
  • 创建容器
  • 更新镜像
  • QNAP ZFS问题
• OpenMediaVault帮助
  • 权限被拒绝错误
• 许可证
• ***免责声明

基本Docker使用方法

Docker镜像名称为lloesche/valheim-server。

需将服务器配置目录挂载到Docker容器内的/config目录。

如果在Windows系统上已有存档世界，可从例如C:\Users\Lukas\AppData\LocalLow\IronGate\Valheim\worlds复制到$HOME/valheim-server/config/worlds，并将$HOME/valheim-server/config目录挂载到容器内的/config目录运行镜像。容器目录/opt/valheim包含已下载的服务器，可选择挂载此目录以避免每次启动时重新下载服务器。

bash
$ mkdir -p $HOME/valheim-server/config/worlds $HOME/valheim-server/data
# 复制现有世界
$ docker run -d \
    --name valheim-server \
    --cap-add=sys_nice \
    --stop-timeout 120 \
    -p 2456-2457:2456-2457/udp \
    -v $HOME/valheim-server/config:/config \
    -v $HOME/valheim-server/data:/opt/valheim \
    -e SERVER_NAME="我的服务器" \
    -e WORLD_NAME="Neotopia" \
    -e SERVER_PASS="secret" \
    lloesche/valheim-server

警告：SERVER_PASS必须至少5个字符，否则valheim_server.x86_64将无法启动！

首次启动需要几分钟时间，具体取决于互联网连接速度，因为容器会从Steam下载Valheim专用服务器（约1GB）。

不要忘记修改WORLD_NAME以匹配你的世界名称！对于现有世界，这是worlds/文件夹中不带.db/.fwl扩展名的文件名。

如果要通过互联网与朋友一起玩且处于NAT之后，请确保UDP端口2456-2457已转发到容器主机，并确保在任何防火墙中这些端口可公开访问。

更多信息请参见查找服务器部分。

仅局域网游戏请参见Steam服务器收藏夹与局域网游戏部分。

更多部署选项请参见部署部分。

向容器授予CAP_SYS_NICE权限是可选的，它允许Valheim使用的Steam库为自身分配更多CPU周期。没有此权限，启动日志中会显示Warning: failed to set thread priority消息。

环境变量

所有变量名称和值均区分大小写！

有一些未文档化的环境变量，若配置错误可能导致问题，可在defaults中找到。

日志过滤器

Valheim服务器默认日志包含大量噪音，这些环境变量允许用户移除不需要的日志行。

默认过滤器移除以下内容：

• 空日志行
• 仅包含单个空格的日志行
• 重复出现的(Filename: ./Runtime/Export/Debug/Debug.bindings.h Line: 35)行
• 因数据包处理超时导致的Assertion Failed警告日志行（参见https://github.com/lloesche/valheim-server-docker/discussions/104）
• 启用ValheimPlus时，以Fallback handler could not load library开头的行

日志过滤器事件钩子

如果存在与日志过滤器同名的ON_前缀环境变量，当日志过滤器匹配时，不会移除日志行，而是执行该变量内容，并将日志行通过标准输入传递给命令。

除VALHEIM_LOG_FILTER_EMPTY和VALHEIM_LOG_FILTER_UTF8外，所有环境变量都是前缀，可定义多个匹配条件，例如：

-e VALHEIM_LOG_FILTER_STARTSWITH=foo \
-e VALHEIM_LOG_FILTER_STARTSWITH_BAR=bar \
-e VALHEIM_LOG_FILTER_STARTSWITH_SOMETHING_ELSE="some other filter"
-e VALHEIM_LOG_FILTER_CONTAINS_Connected="Got character ZDOID from"
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Connected="cat >> /tmp/character_login"

***日志过滤器事件钩子示例

当玩家生成时发送***消息：

-e DISCORD_WEBHOOK="https://discord.com/api/webhooks/8171522530..." \
-e VALHEIM_LOG_FILTER_CONTAINS_Spawned="Got character ZDOID from" \
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned='{ read l; l=${l//*ZDOID from /}; l=${l// :*/}; msg="玩家 $l 进入世界"; curl -sfSL -X POST -H "Content-Type: application/json" -d "{\"username\":\"Valheim\",\"content\":\"$msg\"}" "$DISCORD_WEBHOOK"; }'

关于在环境变量和compose文件中的正确引用方式，参见下面的***通知。

如果运行ValheimPlus且此过滤器触发两次，请检查https://github.com/valheimPlus/ValheimPlus/issues/318，原因是`BepInEx.cfg`配置错误导致日志行重复。

事件钩子

以下环境变量可用于在特定事件发生时执行命令。