lsiodev/syslog-ng
lsiodev
linuxserver/syslog-ng是一个Docker镜像，提供syslog-ng日志管理工具，支持灵活收集、解析、分类、重写和关联来自基础设施的日志，并将其存储或路由到日志分析工具，由LinuxServer.io团队维护，确保定期更新和安全支持。
下载次数: 0状态：社区镜像维护者：lsiodev仓库类型：镜像最近更新：7 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
linuxserver/syslog-ng
syslog-ng 允许您灵活地收集、解析、分类、重写和关联来自整个基础设施的日志，并将其存储或路由到日志分析工具。LinuxServer.io团队提供的此容器具有定期应用更新、简单的用户映射（PGID、PUID）、基于s6 overlay的自定义基础镜像、每周基础OS更新以及定期安全更新等特点。
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/syslog-ng-logo.png
支持的架构
我们利用Docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/syslog-ng:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。支持的架构如下：
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| armhf | ❌ |
应用设置
编辑 /config/syslog-ng.conf 配置日志源和目标。注意：由于应用不以root用户运行，因此无法监听1024以下的端口。
应用的pid、控制文件等均保存在 /config 中，因此使用 syslog-ng-ctl 等工具时需指定路径，例如 syslog-ng-ctl reload -c /config/syslog-ng.ctl。
更多信息请访问 syslog-ng官方文档。
使用方法
以下是帮助您创建容器的示例代码片段。
docker-compose（推荐，https://docs.linuxserver.io/general/docker-compose%EF%BC%89
yaml--- version: "2.1" services: syslog-ng: image: docker.xuanyuan.run/linuxserver/syslog-ng:latest container_name: syslog-ng environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/config:/config - /path/to/log:/var/log #可选 ports: - 514:5514/udp - 601:6601/tcp - 6514:6514/tcp restart: unless-stopped
docker cli（https://docs.docker.com/engine/reference/commandline/cli/%EF%BC%89
bashdocker run -d \ --name=syslog-ng \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 514:5514/udp \ -p 601:6601/tcp \ -p 6514:6514/tcp \ -v /path/to/config:/config \ -v /path/to/log:/var/log `#可选` \ --restart unless-stopped \ lscr.io/linuxserver/syslog-ng:latest
参数
容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数以冒号分隔，表示 <外部>:<内部>。例如，-p 8080:80 会将容器内的端口 80 暴露到主机IP的端口 8080 上。
| 参数 | 功能 |
|---|---|
-p 5514/udp | Syslog UDP端口 |
-p 6601/tcp | Syslog TCP端口 |
-p 6514/tcp | Syslog TLS端口 |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Etc/UTC | 指定时区，详见时区列表 |
-v /config | 存储配置和应用文件 |
-v /var/log | 存储syslog-ng服务收集的日志 |
来自文件的环境变量（Docker secrets）
您可以通过使用特殊前缀 FILE__ 从文件设置任何环境变量。例如：
bash-e FILE__PASSWORD=/run/secrets/mysecretpassword
这会根据 /run/secrets/mysecretpassword 文件的内容设置环境变量 PASSWORD。
应用运行的Umask
对于所有镜像，我们提供通过可选的 -e UMASK=022 设置来覆盖容器内服务的默认umask。请注意，umask不是chmod，它基于其值减去权限而非添加。请在寻求支持前阅读umask相关说明。
用户/组标识符
使用卷（-v 标志）时，主机OS和容器之间可能会出现权限问题。我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。
确保主机上的任何卷目录都归您指定的同一用户所有，权限问题将迎刃而解。
在此示例中 PUID=1000 和 PGID=1000，可通过 id user 命令查找您的ID：
bash$ id username uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
Docker Mods
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=syslog-ng&query=%24.mods%5B%27syslog-ng%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=syslog-ng "查看此容器的可用mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=universal "查看可用的通用mods")
我们发布了各种 https://github.com/linuxserver/docker-mods 以启用容器内的额外功能。上述动态徽章可访问此镜像的可用Mods（如有）以及可应用于我们任何镜像的通用Mods。
支持信息
- 容器运行时的Shell访问：
docker exec -it syslog-ng /bin/bash - 实时监控容器日志：
docker logs -f syslog-ng - 容器版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' syslog-ng - 镜像版本号：
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/syslog-ng:latest
更新信息
我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部应用。除部分例外（如nextcloud、plex），我们不建议或支持在容器内更新应用。请查阅上述应用设置部分，了解是否推荐对此镜像进行应用更新。
以下是更新容器的说明：
通过Docker Compose
- 更新所有镜像：
docker-compose pull- 或更新单个镜像：
docker-compose pull syslog-ng
- 或更新单个镜像：
- 让Compose按需更新所有容器：
docker-compose up -d- 或更新单个容器：
docker-compose up -d syslog-ng
- 或更新单个容器：
- 还可删除旧的悬空镜像：
docker image prune
通过Docker Run
- 更新镜像：
docker pull docker.xuanyuan.run/linuxserver/syslog-ng:latest - 停止运行中的容器：
docker stop syslog-ng - 删除容器：
docker rm syslog-ng - 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的
/config文件夹和设置将被保留） - 还可删除旧的悬空镜像：
docker image prune
通过Watchtower自动更新器（仅在忘记原始参数时使用）
-
拉取最新标签镜像并使用相同环境变量替换：
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ docker.xuanyuan.run/containrrr/watchtower \ --run-once syslog-ng -
还可删除旧的悬空镜像：
docker image prune
注意： 我们不认可将Watchtower用作现有Docker容器自动更新的解决方案。事实上，我们通常不鼓励自动更新。但是，对于您忘记原始参数的容器，这是一个有用的一次性手动更新工具。长期来看，我们强烈建议使用 https://docs.linuxserver.io/general/docker-compose%E3%80%82
镜像更新通知 - Diun（Docker镜像更新通知器）
- 我们推荐 https://crazymax.dev/diun/ 用于更新通知。不推荐或支持其他自动更新容器的工具。
本地构建
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑：
bashgit clone https://github.com/linuxserver/docker-syslog-ng.git cd docker-syslog-ng docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/syslog-ng:latest .
ARM变体可使用 multiarch/qemu-user-static 在x86_64硬件上构建：
bashdocker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset
注册后，可使用 -f Dockerfile.aarch64 指定要使用的dockerfile。
版本历史
- 11.06.23: - 基于Alpine 3.18重建，弃用armhf。
- 10.01.23: - 添加paho-mqtt-c库，syslog-ng文档要求。
- 30.12.22: - 基于Alpine 3.17重建，添加libdbi-drivers以支持SQL。
- 01.10.22: - 基于Alpine 3.16重建，迁移到s6v3。
- 18.12.21: - 基于Alpine 3.15重建。
- 01.07.21: - 基于Alpine 3.14重建。
- 26.05.21: - 初始发布。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 syslog-ng 镜像标签
docker pull docker.xuanyuan.run/lsiodev/syslog-ng:<标签>
DockerHub 原生拉取命令
docker pull lsiodev/syslog-ng:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"