Bitnami VictoriaMetrics Auth 镜像文档

1. 镜像概述

1.1 关于 VictoriaMetrics Auth

VictoriaMetrics Auth（vmauth）是 VictoriaMetrics 生态的组件，用于为 VictoriaMetrics 监控系统提供认证与授权功能。VictoriaMetrics 本身是一款快速、经济高效且可扩展的监控解决方案及时序数据库，兼容 Prometheus 和 Graphite 协议。

1.2 镜像用途

Bitnami 提供的此镜像将 VictoriaMetrics Auth 组件打包为容器化格式，旨在简化其部署流程，同时提供安全优化的运行环境，适用于开发与生产环境中的监控系统认证授权管理。

2. 核心功能与特性

2.1 VictoriaMetrics Auth 功能

• 为 VictoriaMetrics 监控系统提供认证与授权控制
• 兼容 Prometheus 和 Graphite 协议的请求验证
• 与 VictoriaMetrics 时序数据库无缝集成，保障监控数据访问安全

2.2 Bitnami 安全镜像特性

• 安全优化：基于最小化操作系统（Photon Linux）构建，减少攻击面
• 漏洞透明：通过 VEX（漏洞可利用性交换）、KEV（已知被利用漏洞）和 EPSS 评分提供 CVE 风险透明度
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性
• 跨格式一致性：与 Bitnami 虚拟机、云镜像使用相同组件和配置方式，支持多环境无缝切换
• 合规元数据：提供签名证明（Notation）、SBOM（软件物料清单）、病毒扫描报告等 SLSA-3 合规元数据

3. 使用场景与适用范围

3.1 典型场景

• 企业级监控系统的访问控制部署
• Prometheus/Graphite 兼容监控架构的认证层构建
• 时序数据存储与查询的权限管理

3.2 适用范围

• 开发环境：免费提供 "latest" 标签镜像，适用于功能验证与开发测试
• 生产环境：需使用 Bitnami Secure Images 商业版，提供企业级支持、长期维护及全面安全合规保障

4. 镜像获取与标签支持

4.1 获取镜像

推荐从 Docker Hub 拉取预构建镜像：

# 拉取最新版（免费开发版）
docker pull bitnami/victoriametrics-vmauth:latest

指定版本（仅旧标签可用，2025年8月28日后迁移至 legacy 仓库）：

# 示例：拉取特定版本（2025年8月28日后需替换为 bitnamilegacy 仓库）
docker pull bitnami/victoriametrics-vmauth:[TAG]

4.2 标签策略与迁移说明

• 标签类型：支持滚动标签（如 latest）和不可变标签（如 2.50.0），具体参考 Bitnami 标签策略文档
• 2025年8月28日起迁移计划：
  • 所有现有镜像（含旧版本标签）将从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，不再更新
  • 免费版仅提供 latest 标签镜像，用于开发环境
  • 生产环境需订阅 Bitnami Secure Images 商业版

5. 使用方法与配置说明

5.1 基本运行

快速启动容器（默认配置）：

docker run --name victoriametrics-vmauth bitnami/victoriametrics-vmauth:latest

5.2 执行命令与参数配置

通过容器执行 vmauth 命令（如查看帮助）：

docker run --rm --name victoriametrics-vmauth bitnami/victoriametrics-vmauth:latest -- --help

配置参数详情请参考 VictoriaMetrics Auth 官方文档，可通过命令行参数或配置文件（需挂载）自定义认证规则。

5.3 非 root 容器说明

该镜像默认以非 root 用户运行，增强安全性：

• 限制特权操作，减少攻击面
• 遵循容器最佳实践，适用于多租户环境

6. 贡献与反馈

6.1 贡献代码

通过 bitnami/containers GitHub 仓库 提交 Issue 或 Pull Request 参与改进。

6.2 问题反馈

如遇使用问题，可在 GitHub Issues 提交，建议按模板提供详细信息以加速问题排查。

7. 许可信息

本镜像基于 Apache License 2.0 许可协议分发。详情请参见 Apache License 2.0。

商标说明："VictoriaMetrics" 为其 respective 所有者的商标，Bitnami 仅为打包分发，不暗示任何附属或背书关系。