grepnull/gloomhaven-helper-headless

无头Gloomhaven Helper服务器镜像

镜像概述

Gloomhaven Helper（GHH）的服务器/客户端模式对玩家来说非常实用，但原模式中需要玩家作为服务器，导致IP可能变动，远程游戏时还需设置端口转发。本镜像提供一个长期运行的无头GHH服务器，玩家可通过固定地址连接，解决上述问题。

核心功能

• 无头模式运行GHH服务器，无需图形界面
• 提供稳定的固定连接地址，支持多人远程游戏
• 支持保存游戏状态到宿主机，避免容器重建丢失数据
• 提供调试日志选项，方便排查问题

使用场景

• 朋友间远程玩Gloomhaven桌游，需要稳定的服务器连接点
• 避免每次游戏更换服务器IP和设置端口转发的繁琐操作
• 希望在无图形界面的服务器上运行GHH服务器

配置说明

安装与运行

镜像已发布至Docker Hub，可直接运行：

bash
docker run -p 58888:58888 --name ghh-headless -d grepnull/gloomhaven-helper-headless

运行后查看日志确认启动：

bash
docker logs --follow ghh-headless

预期输出：

Setting up config.
No existing config. Setting up basic one.
Starting Gloomhaven Helper
00:00  INFO: [broadcast] Listening on port: UDP 58887
00:01  INFO: [server] Listening on port: TCP 58888

Docker Compose

可通过Docker Compose简化部署。下载https://raw.githubusercontent.com/vincer/gloomhaven-helper-headless/master/docker-compose.yml%E5%90%8E%EF%BC%8C%E6%89%A7%E8%A1%8C%EF%BC%9A

bash
docker-compose up -d

保存游戏状态

为避免容器重建丢失游戏状态，需挂载宿主机目录：

1. 创建目录：mkdir ghh
2. 运行时添加卷参数：-v $PWD/ghh:/root/.ghh

迁移现有状态

若已有GHH状态文件：

1. 从原GHH配置目录复制state文件到上述ghh目录
2. 若使用移动应用，可先通过桌面版GHH连接移动服务器获取状态，再复制~/.ghh/state到宿主机目录

调试选项

添加环境变量DEBUG=1获取更多日志：

bash
docker run -p 58888:58888 -e DEBUG=1 --name ghh-headless -d grepnull/gloomhaven-helper-headless

端口转发与DNS

若服务器在防火墙/NAT后，需：

1. 在路由器设置端口转发（TCP 58888、UDP 58887）到服务器
2. 若无静态IP，设置动态DNS以使用固定域名访问

实现细节

• 基于Debian的OpenJDK镜像，安装LWJGL依赖
• 使用Xvfb创建虚拟显示器实现无头运行
• 自动配置GHH服务器启用状态，无需图形界面设置

支持

若想支持该项目，建议直接支持Gloomhaven Helper官方：***或购买iOS、Android应用。