最省事方式是直接用docker-compose启动，只需修改三处配置：loki的volumes映射路径、promtail的日志目录权限、grafana的GF_SECURITY_ADMIN_PASSWORD；同时确保loki配置中端口、存储路径和限速参数正确，promtail的labels与pipeline_stages完整，Grafana数据源填http://loki:3100。
直接用 docker-compose 起一套最省事
如果你只是想快速验证或小规模试用，别折腾二进制或源码——docker-compose 是当前最稳、最易维护的方式。官方维护的 docker-compose.yaml 已覆盖基础网络、卷挂载和启动参数，你只需要改三处就能跑通：
-
loki服务的volumes映射必须指向你本地存在的配置文件路径，比如./loki-config/config.yaml:/etc/loki/local-config.yaml，否则容器会因找不到配置退出 -
promtail的日志目录映射要真实存在且有读权限，例如/var/log:/var/log或更精确的/opt/myapp/logs:/var/log/myapp；如果路径不存在或权限不对，promtail启动后会静默失败，docker logs promtail里只显示failed to tail file -
grafana的GF_SECURITY_ADMIN_PASSWORD必须显式设置，否则首次登录会卡在初始化界面，且无法通过 UI 修改（v10+ 默认禁用未设密码的 admin 登录）
loki-local-config.yaml 里最关键的三个配置项
很多人配完启动不了，问题常出在 loki-local-config.yaml 的基础结构上。它不是“越全越好”，而是三处不填准挂：
-
server.http_listen_port：默认是3100，但如果你宿主机该端口被占用（比如另一个 Loki 实例或 Nginx），必须同步改docker-compose.yml中的ports映射，否则 Grafana 连不上 -
storage_config.filesystem.directory：必须是容器内可写的绝对路径，如/tmp/loki/chunks；若指向/opt/loki/chunks却没做volumes挂载，Loki 启动时会报permission denied并退出 -
limits_config.ingestion_rate_mb和ingestion_burst_size_mb：默认值太低（4MB / 6MB），高日志量服务（如 Nginx access log）几秒就触发限速，表现为 Promtail 日志里反复出现rate limited，此时需按实际流量上调，比如设为30和15
promtail-config.yaml 中 labels 和 pipeline_stages 容易漏掉
promtail 不是“装上就收日志”，它靠 scrape_configs 里的 static_configs + labels 建立日志流标识，靠 pipeline_stages 解析内容。漏掉任一环节，Grafana 里就查不到或查不准：
-
labels至少得有job和host，比如{job="nginx", host="web01"}；否则所有日志混在一个流里，{job=~".+"}这种宽泛查询会拖慢响应 -
pipeline_stages如果没加docker或cri解析器，容器日志时间戳和级别会丢失；如果是普通文本日志，至少得加regex提取level和msg，不然 Grafana 里全是原始行，没法按 ERROR 过滤 -
__path__的 glob 模式要小心：写成/var/log/nginx/*.log只匹配一级目录，/var/log/nginx/**/*.log才递归匹配子目录，但后者在某些旧版 Promtail（v2.4 之前）不支持，会静默跳过
Grafana 添加 Loki 数据源时端口和服务名别写错
在 Grafana Web 界面填 Loki 地址，不是填宿主机 IP:3100，也不是填 localhost:3100——这是最常见的连不上原因：
- 在
docker-compose环境下，Grafana 容器和 Loki 容器同属一个 network，应填http://loki:3100（服务名即docker-compose.yml里定义的services.loki名称） - 如果用了反向代理（如 Nginx），Grafana 页面里填的是代理地址（如
https://logs.example.com），但必须在代理配置中透传X-Scope-OrgID头，否则 Loki 返回 401 - 测试连接成功后，别急着查日志：先去 Explore 面板选 Loki 数据源，手动输一个最简查询，比如
{job="nginx"}，看是否有返回；如果返回空，再检查 Promtail 是否真在推送（curl http://localhost:3101/metrics | grep promtail_target_active应大于 0）
真正卡住人的地方往往不在安装步骤，而在配置项之间的耦合关系：Promtail 的 __path__、Loki 的 storage_config 目录、Docker 的 volumes 映射、Grafana 数据源 URL —— 四者路径/端口/服务名必须严丝合缝，差一个斜杠或字母大小写，整个链路就断了。
