maresh/hll_rcon_frontend

《地狱潜者》(HLL)高级RCON工具

镜像概述和主要用途

该Docker镜像提供了一个扩展的RCON工具，专为《地狱潜者》游戏服务器设计，旨在替代并超越官方RCON工具。它以自托管网站形式运行，提供全面的服务器管理功能，包括玩家监控、多服务器支持、自动化任务和第三方集成等，适合游戏服务器管理员进行高效、便捷的服务器管理。

核心功能和特性

• 实时玩家管理：查看在线玩家信息，支持消息发送、惩罚、踢除、临时封禁（可选择时长）、永久封禁；支持按游戏时间、惩罚记录、名称等搜索和排序玩家。
• 实时游戏视图：显示各队伍、小队的玩家分布，包括角色、等级、分数等信息，可对个人、小队、整个队伍或服务器执行操作。
• 用户账户与审计日志：每个管理员拥有独立账户，记录所有操作（谁在何时对谁执行了什么操作），支持将RCON操作转发至***。
• 批量操作：一键对多名玩家执行相同操作（如切换或踢除整个小队）。
• 日志与过滤：实时日志查看，支持按类型（击杀、聊天、投票等）和玩家筛选。
• 集成：支持Webhook，可将游戏内聊天、团队伤害(TK)和击杀信息转发至服务器；设置触发词（如!admin）在游戏内聊天时触发***提醒。
• 玩家标记与国家显示：可自定义表情/图标标记玩家并添加备注，自动从Steam加载并显示玩家国家。
• 玩家历史与档案：记录玩家所有游戏会话、曾用名、惩罚记录及执行管理员等信息，支持对离线玩家执行操作（标记、监控、封禁等）。
• 永久日志与搜索：存储完整游戏日志历史，提供搜索工具，支持导出为CSV。
• 多服务器支持：管理多个服务器，共享玩家数据库，支持跨服务器同步封禁、VIP、设置和广播消息。
• 自动化功能：自动广播循环、基于玩家数量的自动化设置、预设惩罚/消息文本（支持自动补全）。
• 封禁管理：按名称、原因或Steam ID搜索封禁记录，支持快速解封；自动备份封禁列表，新服务器可自动应用封禁。
• 地图历史与统计：记录地图播放历史及持续时间；基础计分板显示最近N分钟的总击杀/死亡/TK/被TK死亡数。
• VIP管理：备份和恢复/导入VIP列表。
• 基础设置：地图轮换管理、闲置踢除时间、最大 ping 值等滑块设置。
• 扩展能力：支持通过cron或supervisor服务添加自定义插件；提供HTTP API和CLI接口；支持玩家监控列表（玩家进入服务器时通知）。
• 统计与公开页面：实时游戏/会话统计，提供友好的公开版本及可收藏的历史游戏记录。

使用场景和适用范围

• 《地狱潜者》游戏服务器管理员：需要高效管理服务器、监控玩家行为、执行惩罚和维护秩序。
• 多服务器管理：同时管理多个《地狱潜者》服务器，需要统一玩家数据库和跨服务器操作。
• 社区服务器运营：需要与***社区集成，实现聊天转发、事件提醒和管理员协作。
• 自动化管理需求：希望通过预设规则自动执行广播、调整服务器设置，减少手动操作。

详细使用方法和配置说明

前置要求

• 操作系统：推荐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%E3%80%82

2. 配置服务器信息

复制默认环境变量文件并命名为.env：

bash
cp default.env .env

编辑.env文件，至少配置以下参数：

• 全局设置：HLL_DB_PASSWORD（数据库密码）、RCONWEB_API_SECRET（API密钥）。
• 每服务器设置：HLL_HOST（游戏服务器IP）、HLL_PORT（游戏服务器RCON端口）、HLL_PASSWORD（游戏服务器RCON密码）。
• 服务器URL：通过GUI（设置 > CRCON设置）或CLI设置server_url，需与访问RCON的URL一致（如http://localhost:8010或https://example.com），否则会因CSRF保护无法访问管理界面。

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
  

服务启动后，可通过<服务器IP>:<RCONWEB_PORT>（默认端口8010）访问Web界面。

4. 修改管理员密码

访问<服务器IP>:<RCONWEB_PORT>/admin，使用默认账号admin/admin登录，立即修改密码（页面右上角红色提示区域）。随后可添加其他管理员账户（需指定Steam ID）。

多服务器配置

• 单RCON管理多服务器：所有管理员对所有服务器有同等访问权限，数据存储在单一数据库中。超过3个服务器需编辑.env和docker-compose.yml，添加新服务器配置（如复制现有服务器部分并修改序号）。
• 多RCON实例：在不同目录克隆源码（如hll_rcon_tool_server_2），分别配置.env，需解决Redis/Postgres端口冲突。

更新方法

1. 获取最新源码：

   bash
   git fetch --tags
   git checkout <版本号，如v7.0.2>
   

2. 拉取最新镜像并重启：
   • Linux：

     bash
     docker compose pull
     docker compose up -d --remove-orphans
     

   • Windows：

     bash
     docker compose pull && docker compose -f docker-compose.yml -f docker-compose.windows.yml up -d --remove-orphans
     

   • ARM32v7：

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

降级方法

1. 编辑.env，将TAGGED_VERSION设为目标版本（如TAGGED_VERSION=9.1.1）。
2. 参考更新步骤重启服务。

示例配置

docker-compose.yml核心配置片段

yaml
version: '3'
services:
  postgres:
    image: postgres:13
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - POSTGRES_PASSWORD=${HLL_DB_PASSWORD}
      - POSTGRES_USER=${HLL_DB_USER:-hll}
      - POSTGRES_DB=${HLL_DB_NAME:-hll}
    restart: unless-stopped

  redis:
    image: redis:6
    volumes:
      - redis_data:/data
    restart: unless-stopped

  backend_1:
    image: ${BACKEND_DOCKER_REPOSITORY:-maresh/hll_rcon}:${TAGGED_VERSION:-latest}
    depends_on:
      - postgres
      - redis
    environment:
      - HLL_HOST=${HLL_HOST}
      - HLL_PORT=${HLL_PORT}
      - HLL_PASSWORD=${HLL_PASSWORD}
      - HLL_DB_PASSWORD=${HLL_DB_PASSWORD}
      - RCONWEB_API_SECRET=${RCONWEB_API_SECRET}
    restart: unless-stopped

注意事项

• 修改.env后需执行docker compose up -d --remove-orphans使配置生效，仅重启容器无效。
• 多服务器配置时需确保各服务器的RCONWEB_PORT唯一，避免端口冲突。
• 社区Wiki（https://github.com/MarechJ/hll_rcon_tool/wiki%EF%BC%89%E6%8F%90%E4%BE%9B%E6%9B%B4%E5%A4%9A%E8%AF%A6%E7%BB%86%E8%AF%B4%E6%98%8E%EF%BC%8C***%E7%A4%BE%E5%8C%BA%EF%BC%88https://***.gg/hZx6gn3%EF%BC%89%E5%8F%AF%E8%8E%B7%E5%8F%96%E6%94%AF%E6%8C%81%E3%80%82