Bitnami Grafana Loki 镜像文档

镜像概述和主要用途

关于 Grafana Loki

Grafana Loki 是一款水平可扩展、高可用且支持多租户的日志聚合系统，提供实时日志追踪和对象存储持久化能力。它专为高效收集、存储和查询大规模日志数据设计，与 Grafana 无缝集成，适合构建统一的日志监控平台。

Bitnami 镜像特点

Bitnami Grafana Loki 镜像是基于 Bitnami Secure Images 计划构建的安全优化容器镜像，旨在简化 Grafana Loki 的部署流程，同时提供增强的安全性和可维护性。

核心功能和特性

Grafana Loki 核心功能

• 水平扩展：支持分布式部署，可通过添加节点轻松扩展处理能力
• 多租户支持：原生隔离多租户日志数据，确保数据安全性
• 高效存储：采用标签索引（而非全文索引），降低存储成本，提高查询效率
• 持久化能力：支持将日志数据持久化到对象存储（如 S3、GCS 等）
• Grafana 集成：与 Grafana 仪表盘无缝对接，提供直观的日志可视化和查询界面

Bitnami 安全镜像特性

• 安全加固：基于 Photon Linux 最小化操作系统，减少攻击面
• 漏洞透明性：通过 VEX/KEV 标准提供 CVE 风险透明度，支持 EPSS 评分
• 供应链安全：SLSA-3 合规构建流程，提供签名验证（Notation）、SBOM（软件物料清单）和病毒扫描报告
• 持续更新：上游补丁发布后数小时内完成镜像更新，确保安全性
• 跨平台一致性：与 Bitnami 虚拟机、云镜像使用相同组件和配置，便于格式切换

使用场景和适用范围

适用场景

• 日志集中管理：企业级应用日志的统一收集、存储和查询
• 监控系统集成：与 Prometheus、Grafana 结合构建完整的可观测性平台
• 多租户环境：SaaS 服务提供商为不同客户隔离日志数据
• 开发/测试环境：快速部署日志聚合系统，支持应用调试和问题排查
• 生产环境部署：通过安全加固镜像和持久化存储，满足生产级稳定性和安全性要求

使用方法和配置说明

获取镜像

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

# 拉取最新版
docker pull bitnami/grafana-loki:latest

# 拉取特定版本（需替换 [TAG] 为具体版本号，如 2.9.0）
docker pull bitnami/grafana-loki:[TAG]

如需自行构建镜像，可克隆 Bitnami 容器仓库并执行构建命令：

git clone [***]
cd containers/bitnami/grafana-loki/[VERSION]/[操作系统]  # 替换为具体版本和操作系统
docker build -t bitnami/grafana-loki:latest .

快速启动

使用以下命令快速启动 Grafana Loki 容器（仅用于开发测试，生产环境需配置持久化和自定义参数）：

docker run --name grafana-loki bitnami/grafana-loki:latest

详细配置

运行自定义命令

通过容器执行 Grafana Loki 命令（如查看版本）：

docker run --rm --name grafana-loki bitnami/grafana-loki:latest -- --version

挂载自定义配置文件

Grafana Loki 的核心配置通过 loki.yaml 文件定义，需将自定义配置挂载到容器内 /bitnami/grafana-loki/conf/ 目录：

docker run --rm --name grafana-loki \
  -v /本地路径/loki.yaml:/bitnami/grafana-loki/conf/loki.yaml \
  bitnami/grafana-loki:latest

配置文件详情请参考 Grafana Loki 官方文档。

持久化数据

为避免容器重启导致数据丢失，需挂载持久化卷存储日志数据和配置：

docker run --rm --name grafana-loki \
  -v /本地路径/data:/bitnami/grafana-loki/data \
  -v /本地路径/conf:/bitnami/grafana-loki/conf \
  bitnami/grafana-loki:latest

重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级公共镜像目录，推出基于安全加固的 Bitnami Secure Images 计划。主要变更如下：

• 社区用户首次可访问安全优化镜像：提供针对流行容器的安全加固版本。
• 非加固镜像逐步弃用：免费 tier 将逐步停止支持非加固的 Debian 基础镜像，仅保留少量加固镜像的 latest 标签（用于开发目的）。
• 旧标签迁移：所有现有容器镜像（包括历史版本标签，如 2.50.0、10.6）将在两周内从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再更新。
• 生产环境建议：生产 workload 和长期支持需采用 Bitnami Secure Images，包含加固容器、最小攻击面、CVE 透明性（VEX/KEV）、SBOM 和企业支持。

更多详情请参见 Bitnami Secure Images 公告。

支持的标签和 Dockerfile 链接

Bitnami 镜像标签遵循滚动标签和不可变标签策略，详情参见 Bitnami 标签政策文档。

各标签对应关系可通过分支目录下的 tags-info.yaml 文件查看（如 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）。

建议通过关注 bitnami/containers GitHub 仓库 获取项目更新。

非 root 容器说明

非 root 容器通过非特权用户运行，增强生产环境安全性，但可能限制特权操作。详情参见 非 root 容器文档。

显著变更

2024 年 1 月 16 日起

• 移除 docker-compose.yaml 文件，该文件仅用于内部测试。

贡献

欢迎通过 GitHub Issues 提出功能需求，或提交 Pull Request 参与贡献。

问题反馈

如运行容器时遇到问题，请通过 GitHub Issues 提交，建议填写完整的问题模板以获得更好支持。

许可证

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本软件基于 Apache License 2.0 许可证授权：

您可以在符合许可证的前提下使用本软件。
您可以在 [***] 获取许可证副本。

除非法律要求或书面同意，软件按"原样"分发，
不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。
许可证具体条款参见上述链接。