xetusoss/naemon

Docker Naemon镜像

镜像概述

本镜像提供了一个开箱即用的Naemon监控系统容器，适用于大多数部署场景。它简化了Naemon的安装配置流程，支持多种扩展功能，帮助用户快速搭建可靠的IT基础设施监控环境。

核心功能

1. 通过/data卷实现Naemon配置的外部化管理，便于容器替换和配置持久化；
2. 内置丰富的默认检查工具，同时支持Python、Ruby和Perl语言的自定义检查脚本；
3. 可选的LDAP认证支持（用于Thruk Web UI）；
4. 可选的SMTP邮件通知支持（基于ssmtp）；
5. 可选的Jabber消息通知支持（基于sendxmpp）。

使用场景

• 企业IT基础设施监控（服务器、网络设备、应用服务等）；
• 开发/测试环境的实时状态监控；
• 需要LDAP统一认证的监控系统部署；
• 多渠道通知（邮件、Jabber）的监控需求场景。

配置说明

环境变量

SMTP邮件通知配置

• SMTP_HOST：SMTP服务器地址（必填）；
• SMTP_PORT：SMTP端口，默认25；
• SMTP_LOGIN：SMTP认证用户名（可选）；
• SMTP_PASS：SMTP认证密码（可选）；
• SMTP_USE_TLS：是否启用TLS，默认非25端口时为true；
• NOTIFICATION_FROM：通知邮件发件人地址，默认naemon@$HOSTNAME。

LDAP认证配置

• WEB_LDAP_AUTH_ENABLED：是否启用LDAP认证，默认在WEB_LDAP_HOST定义时为true；
• WEB_LDAP_HOST：LDAP服务器地址（必填）；
• WEB_LDAP_SSL：是否启用LDAP SSL，默认false；
• WEB_LDAP_BIND_DN：LDAP绑定DN（必填）；
• WEB_LDAP_BIND_PASS：LDAP绑定密码（必填）；
• WEB_LDAP_BASE_DN：LDAP搜索基准DN（必填）；
• WEB_LDAP_FILTER：用户过滤条件（可选）。

Jabber通知配置

• JABBER_USER：Jabber用户名（必填）；
• JABBER_PASS：Jabber密码（必填）；
• JABBER_HOST：Jabber服务器地址，默认从用户名提取；
• JABBER_PORT：Jabber端口，默认5222。

Thruk Web UI配置

• WEB_ADMIN_PASSWORD：thrukadmin用户密码，默认随机生成；
• WEB_USERS_FULL_ACCESS：是否允许所有认证用户全屏访问，默认false。

数据卷

• /data：存储Naemon配置文件和自定义脚本，建议持久化挂载。

部署示例

快速启动（带SMTP通知）

bash
docker run --name naemon -h naemon -d -p 80:80 \
  -e SMTP_HOST="smtp.example.com" \
  -e SMTP_PORT=25 \
  -e SMTP_USER=naemonbot@example.com \
  -e SMTP_PASS=naemonbotpass \
  -e NOTIFICATION_FROM="naemon@example.com" \
  -v /somepath/naemon_mnt:/data xetusoss/naemon:TAG

LDAP认证配置示例

bash
docker run --name naemon -h naemon -d -p 80:80 \
  -e SMTP_HOST="smtp.example.com" \
  -e SMTP_PORT=25 \
  -e SMTP_USER=naemonbot@example.com \
  -e SMTP_PASS=naemonbotpass \
  -e WEB_LDAP_HOST=ldap.example.com \
  -e WEB_LDAP_BIND_DN="uid=naemonuser,dc=example,dc=com" \
  -e WEB_LDAP_BIND_PASS=pass \
  -e WEB_LDAP_BASE_DN="dc=example,dc=com" \
  -e WEB_USERS_FULL_ACCESS=true \
  -e WEB_LDAP_FILTER="(memberof=cn=naemonusers,cn=groups,dc=example,dc=com)" \
  -e NOTIFICATION_FROM="naemon@example.com" \
  -v /somepath/naemon_mnt:/data xetusoss/naemon:TAG

Jabber通知配置示例

bash
docker run --name naemon -h naemon -d -p 80:80 \
  -e JABBER_USER=myuser@im.example.com \
  -e JABBER_PASS='secret' \
  -e JABBER_PORT=5223 \
  -v /somepath/naemon_mnt:/data xetusoss/naemon:TAG

配置管理

Naemon配置文件位于/data/etc/naemon/，可通过文件系统或Thruk UI管理。自定义检查脚本建议放在/data/卷下，确保容器替换时不丢失。

Jabber通知使用

启用Jabber环境变量后，镜像会生成notify_jabber_commands.cfg配置文件，包含多种Jabber通知命令。需在Naemon联系人配置中引用这些命令，例如：

define contact {
  contact_name                    sysadmins
  alias                           系统管理员
  use                             generic-contact
  email                           systemssupport@corp.com
  address1                        naemon-notifications@conference.im.corp.com
  host_notification_commands      notify-host-by-jabber-chatroom-ssl
  service_notification_commands   notify-service-by-jabber-chatroom-ssl
}

注意事项

• 避免使用latest标签（建议使用具体版本号），因Naemon更新可能包含不可逆配置变更；
• 若需Web UI SSL保护，建议使用HAProxy或NGINX等反向代理。