imriz/logspout

logspout

镜像概述

Logspout是一款轻量级Docker容器日志路由器，运行在Docker内部，自动附加到主机上的所有容器，收集其标准输出（stdout）和错误输出（stderr）日志，并转发到指定的远程目的地。它基于Alpine Linux构建，镜像体积仅15.2MB，支持模块化扩展，适用于集中化日志管理场景。

核心功能

• 收集容器日志：捕获所有容器的stdout和stderr输出
• 多目的地转发：支持同时转发到多个远程端点（如syslog、TCP/UDP、Loggly等）
• 灵活过滤：通过环境变量/标签排除特定容器，或通过URI参数筛选指定容器
• 加密传输：支持TLS加密的syslog/TCP传输
• 实时日志查看：通过HTTP流或WebSocket实时查看聚合日志
• 自定义路由：通过API创建和管理日志路由规则
• 超时检测：自动重启 inactive 的Docker日志流
• 模块化扩展：支持第三方模块（如Kafka、Logstash等）

使用场景

1. 集中化日志存储：将所有容器日志转发到中央日志系统（如ELK Stack、Papertrail）
2. 实时监控：通过HTTP流实时查看容器运行状态与错误日志
3. 合规审计：将日志转发到符合合规要求的存储平台
4. 多环境日志管理：在开发/测试环境快速收集和分析容器日志

配置说明

拉取镜像

bash
docker pull gliderlabs/logspout:latest

基本使用：转发到远程syslog（TLS加密）

bash
docker run --name="logspout" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  gliderlabs/logspout \
  syslog+tls://logs.papertrailapp.com:55555

排除特定容器

通过环境变量排除：

bash
docker run -d -e 'LOGSPOUT=ignore' your-image

通过标签排除：

bash
docker run --name="logspout" \
  -e EXCLUDE_LABEL=logspout.exclude \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  gliderlabs/logspout
  
docker run -d --label logspout.exclude=true your-image

包含指定容器

bash
docker run \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  gliderlabs/logspout \
  raw://192.168.10.10:5000?filter.name=*_db

实时查看日志（HTTP流）

bash
docker run -d --name="logspout" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --publish=127.0.0.1:8000:80 \
  gliderlabs/logspout
  
curl http://127.0.0.1:8000/logs

TLS配置（自定义CA）

bash
docker run -d \
  --name logspout \
  -e "CA_PATH=/data/ca/" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --volume=/path/to/ca/dir/:/data/ca/ \
  gliderlabs/logspout \
  tls://logs.my.server.com

超时检测

bash
docker run --name="logspout" \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  -e INACTIVITY_TIMEOUT=1m \
  gliderlabs/logspout \
  syslog://your-syslog-server:514