Valheim服务器Docker容器中Discord玩家上线通知配置指南

在Valheim服务器管理过程中，实时掌握玩家上线情况对于管理员来说非常重要。本文将详细介绍如何在lloesche/valheim-server-docker容器中配置Discord玩家上线通知功能，并分享一些常见问题的解决方案。

基础配置原理

Valheim服务器Docker镜像通过日志过滤机制实现事件触发功能。当服务器日志中出现特定内容时，可以触发预设的Shell脚本执行操作。对于玩家上线通知，我们需要监控日志中包含"Got character ZDOID from"的行，然后提取玩家名称并发送到Discord Webhook。

完整配置示例

以下是一个完整的docker-compose.yml配置示例，包含了Discord通知相关设置：

environment:
  - DISCORD_WEBHOOK=你的Discord Webhook地址
  # Discord服务器启动消息
  - DISCORD_START_MESSAGE=Valheim服务器$$SERVER_NAME正在启动
  - PRE_BOOTSTRAP_HOOK=curl -sfSL -X POST -H "Content-Type:application/json" -d "{\"username\":\"Valheim\",\"content\":\"$$(eval echo $$DISCORD_START_MESSAGE)\"}" "$$DISCORD_WEBHOOK"
  # Discord玩家上线消息
  - VALHEIM_LOG_FILTER_CONTAINS_Spawned=Got character ZDOID from
  - 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"; }
  # Discord服务器重启消息
  - DISCORD_RESTART_MESSAGE=Valheim服务器将在一分钟后重启!
  - PRE_RESTART_HOOK=curl -sfSL -X POST -H "Content-Type:application/json" -d "{\"username\":\"Valheim\",\"content\":\"$$DISCORD_RESTART_MESSAGE\"}" "$$DISCORD_WEBHOOK" && sleep 60
  # 自动更新设置
  - UPDATE_IF_IDLE=true
  - RESTART_CRON=0 5 * * *
  - RESTART_IF_IDLE=true

关键配置解析

1. DISCORD_WEBHOOK：这是Discord频道的Webhook地址，用于接收通知消息。

2. VALHEIM_LOG_FILTER_CONTAINS_Spawned：设置日志过滤条件，当日志中出现"Got character ZDOID from"时触发。

3. ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned：这是处理日志行并发送Discord通知的Shell脚本：

   • read l：读取日志行
   • l=$${l//*ZDOID from /}：提取玩家名称部分
   • l=$${l// :*/}：移除玩家名称后的多余信息
   • 使用curl向Discord Webhook发送格式化消息

常见问题解决方案

1. 通知不工作：最常见的原因是VALHEIM_LOG_FILTER_CONTAINS_Spawned的值被错误地加上了引号。正确的写法应该是：

   - VALHEIM_LOG_FILTER_CONTAINS_Spawned=Got character ZDOID from
   

   而不是：

   - VALHEIM_LOG_FILTER_CONTAINS_Spawned="Got character ZDOID from"
   

2. Docker Compose解析错误：当出现"unexpected type map[string]interface {}"错误时，通常是因为YAML解析问题。确保整个ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned值被正确引用。

3. Content-Type格式问题：在curl命令中，"Content-Type:application/json"不能有空格，写成"Content-Type: application/json"会导致命令失败。

高级配置建议

1. 多语言支持：你可以轻松修改通知消息的语言，只需更改msg变量的内容即可。

2. 格式化增强：可以在Discord消息中使用Markdown格式增强可读性，例如：

   msg="**玩家 $$l** 已进入世界 :video_game:"
   

3. 多事件监控：同样的机制可以用于监控其他服务器事件，如玩家退出、死亡等，只需设置不同的日志过滤条件即可。

调试技巧

如果配置后仍然无法正常工作，可以尝试以下调试方法：

1. 检查Docker容器日志，确认日志行是否被正确捕获：

   docker logs valheim-server
   

2. 简化curl命令，先测试是否能发送最简单的消息到Discord。

3. 在容器内手动执行ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned中的命令，检查是否有错误输出。

通过以上配置和调试方法，你应该能够成功实现Valheim服务器的Discord玩家上线通知功能，大大提升服务器管理的便捷性。