moonbuggy2000/syslog-ng-alpine

Docker syslog-ng on Alpine Linux

镜像概述

基于Alpine Linux的轻量级容器，运行syslog-ng日志管理工具，支持将日志输出到本地文件（/var/log/messages）、SQL数据库或远程syslog服务器。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多目标支持：可将日志输出到本地文件、SQL数据库或远程syslog服务器
• 灵活配置：通过环境变量控制日志目标的启用/禁用及相关参数
• 持久化支持：可挂载卷实现日志数据和配置的持久化存储
• 时区设置：支持通过环境变量配置时区

使用场景和适用范围

• 日志集中收集与转发
• 本地日志存储与管理
• 日志数据持久化到SQL数据库
• 日志转发至远程syslog服务器
• 轻量级日志管理解决方案部署

使用方法和配置说明

基本用法

以下是使用本地目标的基本示例：

shell
docker run -d --name syslog-ng \
  -p 514:514/udp \
  -p 601:601/tcp \
  -p 6514:6514/tcp \
  -e 'ENABLE_LOCAL=true' \
  moonbuggy2000/syslog-ng-alpine

可通过-e参数指定环境变量来启用或禁用不同的日志目标。

环境变量

当设置任何SQL_*和/或SYSLOG_*环境变量时，SQL和syslog目标会自动启用，否则默认禁用。

数据持久化

如果使用本地目标，可将/var/log/挂载为卷（例如在运行命令中添加-v syslog-ng_messages:/var/log/）。本地目标会创建两个日志文件：/var/log/messages（RFC3164格式）和/var/log/messages-kv.log（包含所有键值对的RFC5424格式）。

目标配置文件位于/etc/syslog-ng/conf.d/，其中d_sql.conf、d_local.conf和options.conf文件会在容器启动时根据环境变量动态创建/删除。如需持久修改这些文件，需修改/etc/syslog-ng/templates/中的模板文件。可直接在/etc/syslog-ng/conf.d/中添加新的配置文件。

源配置位于/etc/syslog-ng/syslog-ng.conf，该文件在容器启动时不会被修改，如需持久化修改，可将其作为卷的一部分挂载。

相关链接

• GitHub：https://github.com/moonbuggy/docker-syslog-ng-alpine
• Docker Hub：https://hub.docker.com/r/moonbuggy2000/syslog-ng-alpine