sanzcarlos/syslog-ng

syslog-ng-docker 镜像文档

镜像概述和主要用途

syslog-ng-docker是syslog-ng的Docker镜像，syslog-ng是一款功能强大的日志管理工具，支持日志收集、过滤、转换和转发。本镜像通过deb包安装了完整的syslog-ng及其所有模块，提供便捷的容器化部署方式，适用于各类日志集中管理场景。

核心功能和特性

• 完整模块支持：包含syslog-ng的所有模块，提供全面的日志处理能力
• deb包安装：基于官方deb包安装，确保版本稳定性和兼容性
• 容器化部署：简化安装流程，可快速在不同环境中部署和迁移
• 环境隔离：与主机系统隔离，避免依赖冲突和配置干扰

使用场景和适用范围

• 服务器日志集中收集与管理
• 应用程序日志的过滤、格式化与转发
• 日志数据转发至ELK Stack、Splunk等分析平台
• 开发测试环境中的日志处理配置验证
• 多环境统一日志采集架构搭建

使用方法和配置说明

基本运行命令

使用默认配置启动syslog-ng容器：

bash
docker run -d --name syslog-ng balabit/syslog-ng

自定义配置

挂载本地配置文件覆盖默认配置：

bash
docker run -d --name syslog-ng \
  -v /path/to/local/syslog-ng.conf:/etc/syslog-ng/syslog-ng.conf \
  balabit/syslog-ng

端口映射

映射常用日志接收端口（如UDP 514）：

bash
docker run -d --name syslog-ng \
  -p 514:514/udp \
  -v /path/to/local/syslog-ng.conf:/etc/syslog-ng/syslog-ng.conf \
  balabit/syslog-ng

日志持久化

挂载日志存储目录以持久化日志数据：

bash
docker run -d --name syslog-ng \
  -v /path/to/local/logs:/var/log \
  -v /path/to/local/syslog-ng.conf:/etc/syslog-ng/syslog-ng.conf \
  balabit/syslog-ng

查看容器日志

bash
docker logs syslog-ng

配置示例

以下是一个简单的syslog-ng配置文件示例（syslog-ng.conf）：

@version: 3.35
@include "scl.conf"

source s_network {
  udp(ip(0.0.0.0) port(514));
};

destination d_file {
  file("/var/log/syslog-ng.log");
};

log {
  source(s_network);
  destination(d_file);
};

注意事项

• 自定义配置文件需遵循syslog-ng配置语***范
• 根据实际需求调整端口映射和数据卷挂载
• 生产环境建议使用容器编排工具（如Docker Compose、Kubernetes）进行管理
• 定期备份配置文件和日志数据以防止数据丢失