Docker Loki容器未使用外部Volume存储配置与数据的问题排查

我是Docker新手，对其工作机制不太了解。部署Loki容器后，发现配置的外部volumedocker_data未被使用，容器内生成了空的docker_data/loki_data和docker_data/loki_config目录，无法将容器内/loki和/etc/loki的内容持久化到外部存储，避免容器删除后丢失日志。

当前配置 #

docker-compose.yml片段 #

loki:
  image: grafana/loki:latest
  ports:
    - "3100:3100"
  volumes:
    - /loki:/docker_data/loki_data
    - /etc/loki:/docker_data/loki_config
  networks:
    - monitoring
  (...)
networks:
  monitoring:

volumes:
  docker_data:
    external: true

外部volume检查结果 #

$ docker volume inspect docker_data
[
    {
        "CreatedAt": "2023-12-08T15:26:05Z",
        "Driver": "local",
        "Labels": null,
        "Mountpoint": "/var/lib/docker/volumes/docker_data/_data",
        "Name": "docker_data",
        "Options": null,
        "Scope": "local"
    }
]

尝试操作后的报错 #

尝试将外部目录反向挂载到容器内时，出现报错：failed parsing config: /etc/loki/local-config.yaml does not exist, set config.file for custom config path。我理解这需要预先准备配置文件才能启动，但我的需求是把容器内的配置和数据备份到外部存储，而非用外部配置启动容器。

问题根源 #

1. 挂载方向完全搞反：当前volumes配置/loki:/docker_data/loki_data是把宿主机的/loki目录挂载到容器内的/docker_data/loki_data，而非将容器内的目标目录映射到外部volume。而且你定义了docker_data外部volume，但根本没在loki服务的volumes配置里引用它。
2. 容器内空目录生成原因：因为宿主机的/loki目录不存在（或为空），Docker会自动创建这个空目录并挂载到容器内的对应路径，所以容器内该目录始终为空。

正确实现方式 #

1. 使用外部volume持久化Loki数据和配置 #

步骤1：修改docker-compose.yml配置

将docker_datavolume挂载到容器内的对应目录，同时拆分数据和配置的存储路径：

loki:
  image: grafana/loki:latest
  ports:
    - "3100:3100"
  volumes:
    # 将外部volume挂载到容器内的数据存储目录
    - docker_data:/loki
    # 将volume的子目录挂载到容器内的配置目录
    - docker_data/config:/etc/loki
  networks:
    - monitoring
  (...)
networks:
  monitoring:

volumes:
  docker_data:
    external: true

步骤2：复制容器默认配置到volume

直接挂载空volume到/etc/loki会导致配置缺失，需先启动临时容器复制默认配置：

# 启动临时容器，将Loki默认配置复制到docker_data volume的config子目录
docker run --rm -v docker_data:/tmp/loki grafana/loki:latest sh -c "cp -r /etc/loki/* /tmp/loki/config/"

完成后启动正式Loki容器，就不会再出现配置文件缺失的报错。

2. 宿主机目录挂载方案（替代Docker Volume） #

如果不想用Docker Volume，也可以直接挂载宿主机目录，同样需要先复制默认配置：

# 在宿主机创建存储目录
mkdir -p /opt/loki/data /opt/loki/config
# 复制容器内默认配置到宿主机目录
docker run --rm -v /opt/loki/config:/tmp/config grafana/loki:latest sh -c "cp -r /etc/loki/* /tmp/config/"

修改docker-compose.yml：

loki:
  image: grafana/loki:latest
  ports:
    - "3100:3100"
  volumes:
    - /opt/loki/data:/loki
    - /opt/loki/config:/etc/loki
  networks:
    - monitoring

3. 日志备份方案（核心需求落地） #

除了持久化存储，还可以通过以下方式备份Loki日志：

• 定期备份volume/宿主机目录：编写定时脚本打包存储目录，保留指定时长的备份：

#!/bin/bash
BACKUP_DIR=/opt/loki_backups
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR
# 备份Docker Volume的实际存储路径
tar -czf $BACKUP_DIR/loki_backup_$DATE.tar.gz /var/lib/docker/volumes/docker_data/_data
# 保留最近7天的备份，自动删除旧备份
find $BACKUP_DIR -name "loki_backup_*.tar.gz" -mtime +7 -delete

• Loki内置备份功能：通过Loki API导出日志，或配置对象存储（如S3、本地MinIO），使用loki-backup工具将日志远程备份到外部存储。

内容的提问来源于stack exchange，提问作者damlit