11notes/loki

LOKI

以无root权限和无发行版方式运行Loki

简介 📢

https://github.com/grafana/loki（由https://github.com/grafana/创建）是一个受Prometheus启发的水平可扩展、高可用、多租户日志聚合系统。它设计为极具成本效益且易于操作，不索引日志内容，而是为每个日志流建立一组标签。

概述 📖

此镜像能做什么？ 该镜像以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md和https://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md方式运行Loki，以实现最高安全性和性能。

核心价值 💶

为什么选择此镜像而非其他现有镜像？ 因为：

• 以https://github.com/11notes/RTFM/blob/main/linux/container/image/rootless.md方式运行，用户ID/组ID为1000:1000
• 基于https://github.com/11notes/RTFM/blob/main/linux/container/image/distroless.md构建，不含shell
• 通过CI/CD自动更新至最新版本
• 包含健康检查
• 以只读方式运行
• 发布前后自动扫描CVE漏洞
• 通过安全且固定的CI/CD流程创建
• 体积极小
• 支持https://github.com/11notes/RTFM/blob/master/linux/container/image/11notes/inline-config.md

如果您重视安全性、简洁性和极致优化，此镜像可能适合您。

对比 🏁

以下是此镜像与最常用或原始镜像的对比：

默认配置 📑

yaml
auth_enabled: false

server:
  http_listen_port: 3100

common:
  instance_addr: 127.0.0.1
  path_prefix: /loki/var
  storage:
    filesystem:
      chunks_directory: /loki/var/chunks
      rules_directory: /loki/var/rules
  replication_factor: 1
  ring:
    kvstore:
      store: inmemory

schema_config:
  configs:
    - from: 2020-10-24
      store: tsdb
      object_store: filesystem
      schema: v13
      index:
        prefix: index_
        period: 24h

ruler:
  alertmanager_url: http://localhost:9093
analytics:
  reporting_enabled: false

卷 📁

• /loki/etc - 配置文件目录
• /loki/var - 所有动态数据和数据库目录

Docker Compose 配置 ✂️

yaml
name: "monitoring"

x-lockdown: &lockdown
  # 防止对镜像本身的写访问
  read_only: true
  # 防止容器内任何进程获取更多权限
  security_opt:
    - "no-new-privileges=true"

services:
  loki:
    image: "docker.xuanyuan.run/11notes/loki:3.7.2"
    <<: *lockdown
    environment:
      TZ: "Europe/Zurich"
    volumes:
      - "loki.etc:/loki/etc"
      - "loki.var:/loki/var"
    ports:
      - "3000:3100/tcp"
    networks:
      frontend:
    restart: "always"

volumes:
  loki.etc:
  loki.var:

networks:
  frontend:

如需更改此容器镜像的默认UID/GID，请参考https://github.com/11notes/RTFM/blob/main/linux/container/image/11notes/how-to.changeUIDGID.md#change-uidgid-the-correct-way。

默认设置 🗃️

环境变量 📝

主要标签 🏷️

以下是镜像的主要标签。每个提交及其简短sha256值也有对应的标签。

• https://hub.docker.com/r/11notes/loki/tags?name=3.7.2
• https://hub.docker.com/r/11notes/loki/tags?name=3.7.2-unraid
• https://hub.docker.com/r/11notes/loki/tags?name=3.7.2-nobody

没有latest标签怎么办？

我认为:latest标签是个坏习惯，不应使用。许多开发者在新版本中引入破坏性变更，这会给使用:latest的用户带来麻烦。如果不想将标签更改为最新https://semver.org/，可使用语义化版本的短版本。例如，不使用`:3.7.2`，可使用`:3`或`:3.7`。这些标签会在每个新版本中更新为软件的最新版本，使用它们类似于使用`:latest`，但至少固定在主版本或次版本，理论上不会引入破坏性变更。

如果仍坚持使用应用的最新版本，可使用:rolling标签，但请注意！这将立即获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库 ☁️

docker pull docker.xuanyuan.run/11notes/loki:3.7.2
docker pull ***-ghcr.xuanyuan.run/11notes/loki:3.7.2
docker pull ***-quay.xuanyuan.run/11notes/loki:3.7.2

Unraid版本 🟠

此镜像默认支持Unraid。只需在任何标签后添加**-unraid**，镜像将以99:100而非1000:1000运行。

Nobody版本 👻

此镜像默认支持nobody用户。只需在任何标签后添加**-nobody**，镜像将以65534:65534而非1000:1000运行。

源码 💾

• https://github.com/11notes/docker-loki

基础镜像 🏛️

此镜像不基于其他镜像，而是以https://hub.docker.com/_/scratch为基础层。包含以下无发行版层：

• https://github.com/11notes/docker-distroless/blob/master/arch.dockerfile - 包含用户、时区和根CA证书，无其他内容
• https://github.com/11notes/docker-distroless/blob/master/localhealth.dockerfile - 仅在127.0.0.1上执行HTTP请求的应用

构建工具 🧰

• https://github.com/grafana/loki

通用提示 📌

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
• 使用Let’s Encrypt DNS-01挑战获取服务的有效SSL证书

ElevenNotes™️

此镜像仅供您自行承担风险使用。更新镜像版本前请务必备份。查看https://github.com/11notes/docker-loki/releases了解破坏性变更。如使用此镜像遇到问题，请提交https://github.com/11notes/docker-loki/issues。如有问题或建议，请创建新https://github.com/11notes/docker-loki/discussions而非issue。我的所有其他仓库可在https://github.com/11notes?tab=repositories找到。

创建于2026年5月14日 09:48:12 (CET)