corentincl/srcds_exporter

SRCDS Prometheus Exporter

镜像概述和主要用途

SRCDS Prometheus Exporter旨在提供一种简单方式，从各种Source专用服务器（SRCDS）获取指标并在Grafana中展示。支持多种热门Source引擎游戏服务器，帮助管理员监控服务器性能和状态。

核心功能和特性

• 支持多种Source引擎游戏服务器：CSGO、CSS、GMod、HL2、L4D2、TF2
• 暴露 metrics 接口，便于Prometheus采集
• 提供Grafana仪表盘模板，直观展示服务器指标
• 可通过Docker快速部署，也支持源码运行
• 支持自定义HTTP端口

使用场景和适用范围

适用于运行Source引擎游戏服务器的管理员，需要监控服务器状态、玩家数量、CPU使用率、网络流量等指标的场景。尤其适合多服务器环境的集中监控。

使用方法和配置说明

安装方法

方法1：使用Docker

bash
docker run -d -p <外部端口>:9591 --name srcds_exporter --restart=always corentincl/srcds_exporter

• <外部端口>：宿主机上用于访问exporter的端口
• 默认端口：9591
• 可通过环境变量HTTP_PORT自定义端口，例如：

  bash
  docker run -d -p 9090:9090 -e HTTP_PORT=9090 --name srcds_exporter corentincl/srcds_exporter
  

方法2：下载源码运行

需先安装NodeJS（推荐使用NVM：https://github.com/nvm-sh/nvm%EF%BC%89

1. 克隆仓库或下载源码压缩包
2. 进入srcds_exporter目录，运行npm i安装依赖
3. 使用node index.js启动服务（可创建系统服务或使用screen保持后台运行）

Prometheus配置

在Prometheus静态配置中添加以下内容：

yaml
- job_name: 'srcds'
  static_configs:
    - targets: ["<ip>:<port>:<rcon密码>:<游戏>"]

  relabel_configs:
    - source_labels: [__address__]
      regex: "(.+):.+:.+:.+"
      replacement: "$1"
      target_label: __param_ip
    - source_labels: [__address__]
      regex: ".+:(.+):.+:.+"
      replacement: "$1"
      target_label: __param_port
    - source_labels: [__address__]
      regex: ".+:.+:(.+):.+"
      replacement: "$1"
      target_label: __param_password
    - source_labels: [__address__]
      regex: ".+:.+:.+:(.+)"
      replacement: "$1"
      target_label: __param_game
    - source_labels: [__param_target]
      target_label: instance
    - target_label: __address__
      replacement: <IP>:<port>  # 实际exporter的IP:端口

游戏字段取值表：

访问方式

要查看exporter返回的指标，可访问：

http://<ip>:9591/metrics?ip=<srcds服务器IP>&port=<srcds服务器端口>&password=<rcon密码>&game=<游戏>

Grafana仪表盘

提供两种类型的Grafana仪表盘：

• "全局"仪表盘：监控所有服务器的状态、CPU、网络进出流量
• "单服务器"仪表盘：监控特定服务器的玩家数量、用户等详细指标

可用仪表盘：

• Counter Strike: Global Offensive：[***]

即将推出：

• Counter Strike: Source
• Garry's Mod
• Half Life 2
• Left 4 Dead 2
• Team Fortress 2

支持

如遇问题，可提交issue。也可通过以下方式联系：

• ***：@Unyxos
• Email：***