binfalse/nrpe-server

Docker化NRPE服务器

本镜像包含Nagios-NRPE-Server，可用于远程执行监控插件。NRPE服务器配置文档可参考Nagios官方网站，也可查看https://github.com/NagiosEnterprises/nrpe%E3%80%82

核心功能和特性

• 通过环境变量实现快速配置
• 通过Docker输出日志（容器标准输出）
• 支持SSL加密通信

版本/标签

镜像提供两种版本：

• binfalse/nrpe-server:plain：基础NRPE服务器，仅包含Nagios NRPE服务器及基本配置。如需其他插件，需自行提供。

• binfalse/nrpe-server:full：完整NRPE服务器，在/usr/lib/nagios/目录中包含大量监控插件。查看包含的插件可运行以下命令：

  bash
  docker run -it --rm --entrypoint find binfalse/nrpe-server:full /usr/lib/nagios
  

下文以binfalse/nrpe-server:full为例进行说明，大部分内容同样适用于plain版本。

使用场景和适用范围

适用于需要通过Nagios或其他监控系统远程执行监控插件的场景，可快速部署NRPE服务，支持自定义监控命令和插件扩展。

使用方法和配置说明

基本运行

运行NRPE服务器并监听主机5666端口：

bash
$ docker run -d -p 5666 binfalse/nrpe-server:full
NRPE v3.0.1

从安装了NRPE插件的主机（如localhost）可与该服务器通信：

bash
./check_nrpe -H localhost -n

卷挂载

镜像包含三个卷：

• /etc/nagios/nrpe.d/：挂载自定义配置文件（含监控命令等），所有.cfg结尾的文件会被NRPE服务器加载。
• /etc/nagios/certs/：启用SSL时，需在此目录挂载以下文件：
  • chain.txt：CA证书及所有链证书
  • cert.cer：SSL证书
  • key.pem：SSL密钥
• /usr/lib/nagios/extra/：可选，用于添加自定义监控插件

环境变量

NRPE服务器的部分配置可通过环境变量设置：

• ALLOWEDHOSTS：允许通信的IP地址列表（逗号分隔），默认允许所有主机。为增强安全性，建议设置此参数。示例：ALLOWEDHOSTS=1.2.3.4,192.168.0.1/24
• PORT：容器内监听端口，默认5666。示例：PORT=8008将使服务器在容器内监听8008端口。
• SSL：布尔值，设置为yes时启用加密通信，需同时配置证书（见SSL部分）。

示例命令：

bash
docker run -it --rm -p 4444:1234 -e PORT=1234 -e ALLOWEDHOSTS=172.17.0.1 -e SSL=no binfalse/nrpe-server:full

此命令允许172.17.0.1通过主机4444端口与容器内1234端口进行非加密通信。

配置监控

需将监控配置文件挂载到/etc/nagios/nrpe.d/。例如，创建监控binfalse.de web服务器的配置文件/PATH/binfalse.cfg：

ini
command[check_binfalse]=/usr/lib/nagios/plugins/check_http -H binfalse.de

（check_http工具仅nrpe-server:full版本包含）

挂载配置文件并运行容器：

bash
docker run -it --rm -p 5666 -v /PATH/binfalse.cfg:/etc/nagios/nrpe.d/binfalse.cfg binfalse/nrpe-server:full

通过check_nrpe执行监控命令：

bash
$ ./check_nrpe -H localhost -n -c check_binfalse
HTTP OK: HTTP/1.1 301 Moved Permanently - 375 bytes in 0.044 second response time |time=0.043561s;;;0.000000;10.000000 size=375B;;;0

添加自定义监控插件

如需添加镜像中未包含的插件，可挂载到/usr/lib/nagios/extra/目录。例如，创建自定义插件脚本/PATH/scripts/check_something，并创建配置文件/PATH/conf/mymonitor.cfg：

ini
command[check_something]=/usr/lib/nagios/extra/check_something -ARG1 -argument2 -x Arg3 ...

挂载插件和配置文件：

bash
docker run -it --rm -p 5666 -v /PATH/scripts/:/usr/lib/nagios/extra/ -v /PATH/conf/:/etc/nagios/nrpe.d/ binfalse/nrpe-server:full

通过check_nrpe -c check_something执行自定义插件。

SSL

默认不启用SSL加密，建议为安全启用。需准备包含以下文件的证书目录/PATH/certs：

• chain.txt：CA证书及链证书
• cert.cer：SSL证书
• key.pem：SSL密钥

挂载证书目录并设置SSL=yes：

bash
docker run -it --rm -p 5666 -v /PATH/certs/:/etc/nagios/certs/ -e SSL=yes binfalse/nrpe-server:full

之后即可使用加密通信。

Docker Compose配置

以下是Docker Compose配置示例：

yaml
version: '2'
services:
  nrpe-server:
    restart: always
    image: binfalse/nrpe-server:full
    container_name: nrpe-server
    ports:
      - "5667:5666"
    volumes:
      - /PATH/certs/:/etc/nagios/certs/:ro
      - /PATH/cfg/:/etc/nagios/nrpe.d/:ro
      - /PATH/plugins/:/usr/lib/nagios/extra/:ro
    environment:
      SSL: "yes"
      PORT: 5666
      ALLOWEDHOSTS: "1.2.3.4"
    logging:
      driver: syslog
      options:
        tag: docker/nrpe-server

构建镜像

可自行构建镜像而非使用Docker Hub上的预构建版本。所有版本均使用src/nrpe-runner工具，需将仓库根目录作为构建上下文，并通过-f指定Dockerfile。构建plain版本示例：

bash
docker build -t nrpe-server:plain -f nrpe-plain/Dockerfile .

许可证

docker-nrpe-server - Docker化的Nagios NRPE服务器
Copyright (C) 2017 Martin Scharm <[***]>

本程序是自由软件：您可以根据GNU通用公共许可证（第三版或更高版本）的条款重新分发和/或修改它。

本程序的分发旨在希望它有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详细信息，请参见GNU通用公共许可证。

您应该已收到GNU通用公共许可证的副本。如果没有，请参见<[***]>。