maresh/hll_rcon

《地狱咫尺》(HLL)高级RCON工具

镜像概述

本Docker镜像提供《地狱咫尺》(Hell Let Loose)游戏的高级RCON管理工具，以自托管网站形式运行，旨在替代并超越官方RCON工具。它提供全面的服务器管理功能，包括实时玩家监控、游戏状态跟踪、多服务器支持、审计日志和自动化管理等，适用于需要24/7运行的游戏服务器管理场景。

核心功能与特性

玩家管理

• 实时玩家视图，支持消息发送、惩罚、踢出、临时封禁（可选择时长）、永久封禁
• 玩家搜索与排序（按游戏时间、惩罚记录、名称等）
• 玩家历史记录与档案：记录所有游戏会话、曾用名、惩罚记录及管理员信息
• 离线玩家操作：可对未在线玩家执行标记、监控、封禁、解封、添加VIP等操作
• 玩家国家识别：自动从Steam加载并显示玩家国家信息
• 玩家标记：支持自定义表情/图标标记玩家并添加备注
• 监控列表：玩家进入服务器时接收通知

游戏监控与管理

• 实时游戏状态更新：查看各队伍/小队玩家、角色、等级、分数等
• 批量操作：一键对多名玩家执行相同操作（如切换或踢出整个小队）
• 完整日志记录与过滤：按类型（击杀、聊天、投票等）和玩家筛选日志，支持CSV导出
• 地图历史记录：显示已玩地图及持续时间
• 基础计分板：显示最近N分钟内的总击杀/死亡/友伤/友伤死亡数据

多服务器支持

• 单实例管理多个游戏服务器，共享玩家数据库
• 跨服务器同步封禁、VIP、设置和广播消息
• 支持超过3台服务器的扩展配置

自动化与集成

• 自动广播循环
• 基于玩家数量的自动设置调整
• *** webhook集成：转发聊天、友伤、击杀到***服务器
• 触发词警报：游戏内聊天出现指定词时（如!admin或自定义词），在***标记指定人员/角色
• 预设惩罚消息：可预设常用惩罚理由，支持自动记忆新输入内容

安全与审计

• 用户账户系统：每个管理员拥有独立账户
• 审计日志：记录所有操作（谁在何时对谁执行了什么操作）
• 无需向管理员暴露真实RCON密码
• 封禁备份：更换服务器时自动重新应用封禁

高级功能

• VIP备份与恢复/导入
• 基本服务器设置管理：地图轮换、闲置踢除时间、最大延迟等
• 开发者支持：HTTP API、CLI工具、自定义插件开发环境（通过cron或supervisor服务）
• 实时统计：每局或每会话统计，支持公开访问的历史游戏统计页面

使用场景与适用范围

• 游戏服务器管理员：需要全面监控和管理服务器玩家行为
• 多服务器管理者：管理多个《地狱咫尺》服务器，实现数据同步
• 社区管理者：维护社区秩序，处理违规行为，记录玩家历史
• 需要自动化管理的场景：如自动广播、基于玩家数量的设置调整
• 需要审计与 accountability 的团队：追踪管理员操作，确保管理透明

安装与使用方法

前置条件

• 推荐系统：Linux（其他系统支持有限）
• 基础技能：基本命令行操作能力
• 环境要求：24/7运行的服务器（如VPS）
• 软件依赖：
  • Git（可选但推荐，用于获取源码）
  • Docker Engine（社区版）
  • Docker Compose

安装步骤

1. 获取源码

bash
git clone https://github.com/MarechJ/hll_rcon_tool.git
cd hll_rcon_tool

若无Git，可下载https://github.com/MarechJ/hll_rcon_tool/releases/latest%E5%B9%B6%E8%A7%A3%E5%8E%8B

2. 配置环境变量

复制默认配置文件并修改：

bash
cp default.env .env

编辑.env文件，至少设置以下必填项：

# 全局设置
HLL_DB_PASSWORD=your_secure_password
RCONWEB_API_SECRET=your_api_secret

# 服务器设置（每个服务器）
HLL_HOST=your_game_server_ip
HLL_PORT=21114  # 默认RCON端口
HLL_PASSWORD=your_rcon_password
RCONWEB_SERVER_URL=http://your_server_url:port  # 访问RCON的URL

多服务器配置需确保各服务器的RCONWEB_PORT唯一

3. 启动服务

根据系统选择命令：

Linux：

bash
docker compose up -d

Windows：

bash
docker volume create redis_data
docker volume create postgres_data
docker compose -f docker-compose.yml -f docker-compose.windows.yml up -d

树莓派/ARM32v7：

bash
docker compose -f docker-compose.yml -f docker-compose.arm32v7.yml up -d --build

服务启动后，通过http://<服务器IP>:<RCONWEB_PORT>访问（默认端口8010）

4. 初始化设置

1. 访问http://<服务器IP>:<RCONWEB_PORT>/admin
2. 使用默认账号登录：用户admin，密码admin
3. 立即修改管理员密码（页面右上角红色提示区域）
4. 添加管理员账户：
   • 进入用户管理页面，点击"添加用户"
   • 填写用户名、密码和Steam ID
   • 根据需求设置"Staff status"或"Superuser status"

多服务器配置

单实例管理多服务器

• 所有服务器共享数据库和管理员账户
• 超过3台服务器需修改.env和docker-compose.yml，添加新服务器配置段

多实例管理

• 在不同目录克隆源码：

  bash
  git clone https://github.com/MarechJ/hll_rcon_tool.git hll_rcon_tool_server_2
  cd hll_rcon_tool_server_2
  

• 需修改.env和docker-compose.yml中的端口，避免冲突

更新与维护

常规更新

bash
# 获取最新代码
git fetch --tags
git checkout vX.Y.Z  # 替换为最新版本号

# 更新镜像并重启
docker compose pull
docker compose up -d --remove-orphans

Windows和ARM设备需使用相应的docker compose命令

降级操作

1. 编辑.env文件，设置特定版本：

   TAGGED_VERSION=9.1.1  # 替换为目标版本
   

2. 回滚代码并重启：

   bash
   git checkout vX.Y.Z  # 对应版本标签
   docker compose up -d --remove-orphans
   

配置参数说明

核心环境变量

多服务器扩展变量

添加第4台服务器时，需在.env中添加：

HLL_HOST_4=server4_ip
HLL_PORT_4=21114
HLL_PASSWORD_4=server4_rcon_password
RCONWEB_PORT_4=8013  # 新端口

并在docker-compose.yml中复制服务器配置段，替换_3为_4，调整Redis数据库编号。

访问与使用

• 管理界面：http://<服务器IP>:<RCONWEB_PORT>/admin
• 公共统计：http://<服务器IP>:<RCONWEB_PORT>/api/scoreboard
• 用户指南：参见项目https://github.com/MarechJ/hll_rcon_tool/blob/master/USERGUIDE.md

社区支持

• *****：[*]
• Wiki：https://github.com/MarechJ/hll_rcon_tool/wiki