victoriametrics/vmgateway

VictoriaMetrics vmgateway

镜像概述

VictoriaMetrics vmgateway 是 VictoriaMetrics 监控生态系统中的核心代理网关组件，作为客户端与 VictoriaMetrics 服务之间的中间层，提供安全访问控制、租户隔离和请求管理能力。该镜像封装了 vmgateway 应用程序，可快速部署并集成到 VictoriaMetrics 监控架构中，增强系统安全性与可管理性。

核心功能与特性

• 多租户隔离：支持基于租户 ID 的请求路由与数据隔离，满足多团队、多项目监控场景需求
• 灵活认证机制：兼容 JWT 令牌、API 密钥等多种认证方式，确保访问来源可信
• 细粒度授权控制：可配置租户级别的操作权限，限制特定资源的访问范围
• 请求限流保护：支持按租户配置请求速率限制，防止单个租户过载影响整体服务
• 反向代理能力：智能路由请求至后端 VictoriaMetrics 实例（单节点或集群模式）

使用场景与适用范围

• 企业级监控平台：为不同部门或业务线提供隔离的监控数据访问通道
• SaaS 监控服务：作为多租户 SaaS 监控产品的接入层，实现租户间安全隔离
• 生产环境防护：在公网暴露 VictoriaMetrics 服务时，通过网关拦截未授权请求
• API 访问治理：控制第三方系统或内部服务对监控数据的调用频率与权限

使用方法与配置说明

Docker 快速启动

bash
docker run -d \
  --name vmgateway \
  -p 8429:8429 \
  -v /path/to/your/config.yml:/etc/vmgateway/config.yml \
  victoriametrics/vmgateway:latest \
  -config.file=/etc/vmgateway/config.yml

核心配置参数

配置文件示例（YAML）

yaml
# 全局服务配置
server:
  listenAddr: ":8429"        # 监听端口
  readTimeout: 10s           # 请求读取超时
  writeTimeout: 30s          # 响应写入超时

# 租户配置列表
tenants:
  - id: "team-alpha"         # 租户唯一标识
    auth:                    # 认证配置
      apiKey: "alpha-secret-123"  # API 密钥认证
    limits:                  # 限流配置
      requestsPerSecond: 200  # 每秒请求上限
      burst: 500             # 突发请求缓冲
    backend:                 # 后端服务配置
      url: "http://victoria-metrics-single:8428"  # 目标 VictoriaMetrics 地址
      timeout: 15s           # 后端请求超时

  - id: "team-beta"
    auth:
      jwt:                   # JWT 认证配置
        issuer: "victoria-metrics"  # JWT 签发者
        audience: "vmgateway"       # JWT 受众
        jwksURL: "https://auth.example.com/.well-known/jwks.json"  # JWKS 密钥地址
    backend:
      url: "http://victoria-metrics-cluster:8481"  # 集群模式后端地址

相关资源

• 官方文档
• https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/app/vmgateway
• https://github.com/VictoriaMetrics/VictoriaMetrics/issues
• 社区支持（Slack）