ethnchao/nagios

docker-nagios

镜像概述和主要用途

Docker-Nagios提供在Docker容器中运行的Nagios服务及一系列Nagios解决方案：Adagios用于基于Web的Nagios配置，Grafana用于监控指标与仪表盘，Ndoutils用于将监控数据传输至MySQL数据库，NCPA和NRDP用于Nagios被动检查。该镜像集成了多种监控相关组件，为用户提供一站式的监控系统部署方案。

核心功能和特性

该镜像包含以下核心组件及版本信息：

• 基础镜像：phusion/baseimage:latest
• Nagios Core 4.3.4：社区版Nagios核心
• Nagios Plugins 2.2.1：Nagios插件集合
• Graphios 2.0.3：将Nagios缓冲数据发送至Graphite
• Graphite 1.1.3：Grafana的数据来源
• Grafana 5.1.3：用于指标分析和仪表盘的可视化工具，支持Graphite、InfluxDB、Prometheus等数据源
• NDOUtils 2.1.3：允许将所有监控数据保存至MySQL数据库
• PyNag 0.9.1-1：用于管理Nagios配置的命令行工具，提供插件开发框架
• Okconfig 1.3.2-1：提供模板化Nagios配置，Adagios可通过其快速配置Nagios
• MK-livestatus 1.2.8p20：作为Nagios的代理模块加载，用于获取Nagios状态信息，Adagios通过其获取状态数据
• Adagios 1.6.3-2：基于Web的Nagios配置界面，设计简洁直观，轻量级UI（基于mod_wsgi，与基于mod_python的Check_MK不兼容）
• NRDP 1.5.2：Nagios的数据传输机制和处理器，使用HTTP(S)和XML，可替代NSCA，与NCPA配合使用
• NCPA 2.1.3：跨平台Nagios代理，支持所有主流操作系统，内置Web GUI，用于被动检查

使用场景和适用范围

适用于需要快速部署监控系统的场景，包括：

• 系统、网络、应用程序的集中监控
• 监控数据的可视化与分析
• 监控配置的Web化管理
• 监控数据的持久化存储
• 跨平台设备的被动监控

适合DevOps工程师、系统管理员、运维团队使用，尤其适合需要快速搭建完整监控体系的环境。

使用方法和配置说明

拉取镜像

从DockerHub拉取nagios镜像：

shell
$ docker pull ethnchao/nagios

构建镜像

从GitHub源码构建Nagios镜像：

shell
$ docker build -t nagios .

基本运行

运行Nagios容器：

shell
$ docker run --name nagios -p 80:80 -p 3000:3000 -d ethnchao/nagios

访问地址

服务访问地址：

shell
# Nagios
http://127.0.0.1/

# Adagios
http://127.0.0.1/adagios

# NRDP
http://127.0.0.1/nrdp

# Grafana
http://127.0.0.1:3000/

# NCPA (客户端)
https://ncpa-agent-address:5693/

登录信息

Nagios Web登录：

用户名: nagiosadmin

密码: nagios

Grafana Web登录：

用户名: admin

密码: admin

自定义登录用户和密码

通过环境变量NAGIOSADMIN_USER和NAGIOSADMIN_PASS自定义登录信息：

shell
$ docker run --name nagios -p 9001:80 -p 3000:3000 \
  -e NAGIOSADMIN_USER=john \
  -e NAGIOSADMIN_PASS=secret_code \
  -d ethnchao/nagios

配置服务器地址

使用Adagios的Okconfig安装代理等功能时，需指定NRDP服务器地址。运行容器时通过--server-url参数传递：

shell
$ docker run --name nagios -p 9001:80 -p 3000:3000 -d ethnchao/nagios --server-url http://172.17.242.190:9001

挂载卷

可挂载额外的配置文件、插件、示例到容器：

shell
$ docker run --name nagios -p 80:80 -p 3000:3000 \
  -v /data/conf:/usr/local/nagios/etc/mount \
  -v /data/plugin:/data/plugin \
  -v /data/example:/data/example \
  -d ethnchao/nagios

启用Ndoutils（MySQL数据存储）

需启用Ndoutils将监控数据存储到MySQL数据库，分两种情况：

1. 已初始化Ndoutils数据库：使用--enable-ndo选项

shell
$ docker run --name nagios -p 80:80 -p 3000:3000 \
  -e MYSQL_USER=nagios -e MYSQL_PASSWORD=nagios \
  -e MYSQL_ADDRESS=172.17.242.178 -e MYSQL_DATABASE=nagios \
  -d ethnchao/nagios --enable-ndo

2. 未初始化Ndoutils数据库：使用--enable-ndo --create-db选项自动初始化

shell
$ docker run --name nagios -p 80:80 -p 3000:3000 \
  -e MYSQL_USER=nagios -e MYSQL_PASSWORD=nagios \
  -e MYSQL_ADDRESS=172.17.242.178 -e MYSQL_DATABASE=nagios \
  -d ethnchao/nagios --enable-ndo --create-db

推荐使用docker-compose

建议使用docker-compose与MySQL容器一起运行Nagios，参考https://github.com/ethnchao/docker-nagios/blob/master/docker-compose.yml%E3%80%82

配置文件位置

依赖包说明

为减小镜像体积，通过apt和pip在同一RUN指令中安装了大量依赖包。以下是各软件所需的主要依赖：

Nagios Core依赖

apache2 \
apache2-utils \
autoconf \
bc \
build-essential \
dc \
gawk \
gettext \
gperf \
libapache2-mod-php \
libgd2-xpm-dev \
libmcrypt-dev \
libssl-dev \
unzip

Nagios邮件通知依赖

bsd-mailx

Nagios插件编译依赖

m4 \
gettext \
automake \
autoconf

Nagios插件运行依赖

iputils-ping \
fping \
postfix \
libnet-snmp-perl \
smbclient \
snmp \
snmpd \
snmp-mibs-downloader \
netcat

软件安装相关依赖

python-pip、git、python-dev

系统服务依赖

runit、sudo、parallel

Graphite安装依赖

apache2 \
apache2-utils \
build-essential \
libcairo2-dev \
libffi-dev \
libapache2-mod-wsgi

Graphios安装依赖

sudo

Ndoutils安装依赖

mysql-client \
libmysql++-dev \
libmysqlclient-dev

NRPE安装依赖

build-essential

NRDP运行依赖

php7.0-xml