karlvr/logspout-gelf

Logspout + GELF

基于官方Logspout Docker镜像构建，集成Logspout和GELF模块的Docker镜像。GELF模块支持UDP、TCP传输协议，默认使用UDP，同时支持TLS加密以保障网络传输安全。

核心功能与特性

• 多传输协议支持：兼容UDP、TCP及TLS加密传输，满足不同网络环境需求
• Docker日志收集：通过挂载Docker socket，自动收集容器日志并转换为GELF格式
• TLS安全传输：支持服务器证书验证及客户端证书认证，适用于公网等不安全网络环境
• 轻量集成：基于官方Logspout镜像，最小化镜像体积，易于部署

使用场景与适用范围

• Docker容器集群日志集中管理
• 与GELF兼容的日志分析平台（如Graylog、Elasticsearch）集成
• 需要安全传输日志的生产环境（通过TLS加密）
• 容器化应用的日志实时采集与转发

使用方法与配置说明

构建镜像

bash
docker build .

基本运行方式

UDP传输（默认）

bash
docker run \
    -v /var/run/docker.sock:/var/run/docker.sock \
    karlvr/logspout-gelf:latest \
    gelf://<graylog_host>:12201

TCP传输

bash
docker run \
    -v /var/run/docker.sock:/var/run/docker.sock \
    karlvr/logspout-gelf:latest \
    gelf+tcp://<graylog_host>:12201

TLS加密配置

生成自签名证书

服务器证书

创建server.cnf配置文件，修改[dn]和[alt_names]部分：

ini
[req]
default_bits = 4096
prompt = no
default_md = sha256
x509_extensions = v3_req
distinguished_name = dn

[dn]
C = US
ST = CA
L = San Francisco
O = Example Organisation
CN = example.com

[v3_req]
subjectAltName = @alt_names

[alt_names]
DNS.1 = example.com
DNS.2 = *.example.com
IP.1 = 10.1.1.1

生成自签名服务器证书：

bash
openssl req -new -x509 -config server.cnf -nodes -keyout server-key.pem -out server-cert.pem -days 35600

查看证书内容：

bash
openssl x509 -in server-cert.pem -noout -text

客户端证书

创建clients目录存放客户端证书，创建<clientname>.cnf配置文件：

ini
[req]
default_bits = 4096
prompt = no
default_md = sha256
x509_extensions = v3_req
distinguished_name = dn

[dn]
C = US
ST = CA
L = San Francisco
O = Example Organisation
CN = client.example.com

[v3_req]
subjectAltName = @alt_names

[alt_names]
DNS.1 = client.example.com
DNS.2 = 10.1.1.2

生成自签名客户端证书：

bash
openssl req -new -x509 -config <clientname>.cnf -nodes -keyout <clientname>-key.pem -out <clientname>-cert.pem -days 35600

TLS运行示例

仅服务器证书验证

bash
docker run \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /opt/logspout-gelf:/opt/logspout-gelf \
    -e LOGSPOUT_TLS_CA_CERTS=/opt/logspout-gelf/server-cert.pem \
    karlvr/logspout-gelf:latest \
    gelf+tls://<graylog_host>:12201

客户端证书认证

bash
docker run \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /opt/logspout-gelf:/tls \
    -e LOGSPOUT_TLS_CA_CERTS=/tls/server-cert.pem \
    -e LOGSPOUT_TLS_CLIENT_CERT=/tls/client-cert.pem \
    -e LOGSPOUT_TLS_CLIENT_KEY=/tls/client-key.pem \
    karlvr/logspout-gelf:latest \
    gelf+tls://<graylog_host>:12201

更多信息

• Logspout基本使用：https://github.com/gliderlabs/logspout
• GELF参数转换逻辑：https://github.com/micahhausler/logspout-gelf
• TLS配置详情：https://github.com/gliderlabs/logspout#tls-settings