seti/librenms

LibreNMS镜像说明

镜像概述

LibreNMS是一款全功能的网络监控系统，本镜像基于Phusion Baseimage构建，集成了PHP7 FPM、nginx、rrdcached等组件，支持动态配置与自动更新，适用于各类网络环境的监控需求。

核心功能

• 全面的网络设备监控能力
• 支持LDAP认证与组权限管理
• 分布式轮询节点部署
• Ceph存储服务监控支持
• Weathermap插件集成（需手动启用）
• 自定义监控插件扩展
• 基于环境变量的动态配置

使用场景

• 企业级网络设备（交换机、路由器等）状态监控
• 分布式网络环境的集中化监控
• Ceph存储集群运行状态跟踪
• 自定义业务指标监控（通过插件扩展）

配置说明

部署前准备

需在主机上创建以下目录：

• data：用于存储镜像数据
• mysql：用于存储数据库数据

部署示例

Docker Compose部署

bash
docker-compose up -d

Docker Compose + LDAP部署

bash
docker-compose -f docker-compose-ldap.yml up -d

Docker Compose + 分布式轮询部署

bash
docker-compose -f docker-compose-distributed-poller.yml up -d

Docker Compose + Ceph支持部署

bash
docker-compose -f docker-compose-ceph.yml up -d

独立部署（使用MariaDB数据库）

首先启动MariaDB容器：

bash
docker run -d -m 1g \
    -v $PWD/mysql:/var/lib/mysql \
    -v $PWD/50-server.cnf:/etc/mysql/mariadb.conf.d/50-server.cnf:ro \
    -e MYSQL_ROOT_PASSWORD=pwd4librenms \
    -e TZ=Europe/Vienna \
    --name librenms-db \
    mariadb:latest

然后启动LibreNMS容器：

bash
docker run -d \
    -v $PWD/data:/data \
    -p 80:80 \
    -e TZ=Europe/Vienna \
    --link librenms-db:mysql \
    -e POLLER=24 \
    -e DB_TYPE=mysql \
    -e DB_HOST=mysql \
    -e DB_NAME=librenms \
    -e DB_USER=root \
    -e DB_PASS=pwd4librenms \
    -e LDAP_ENABLED=0 \
    -e LDAP_VERSION=3 \
    -e LDAP_SERVER=ldap.example.com \
    -e LDAP_PORT=389 \
    -e LDAP_PREFIX=uid= \
    -e LDAP_SUFFIX=,ou=People,dc=example,dc=com \
    -e LDAP_GROUP=cn=groupname,ou=groups,dc=example,dc=com \
    -e LDAP_GROUP_BASE=ou=group,dc=example,dc=com \
    -e LDAP_GROUP_MEMBER_ATTR=uid \
    -e LDAP_GROUP_MEMBER_TYPE= \
    --name librenms \
    seti/librenms

访问信息

• 访问地址：http://localhost（或主机IP）
• 默认用户名：librenms
• 默认密码：librenms

环境变量

• POLLER：设置轮询器数量，建议值为CPU核心数×4，默认16
• TZ：设置时区，默认UTC
• WEATHERMAP：设置为1时启用Weathermap插件（需前端手动开启）
• UPDATE_CHANNEL：选择更新通道，可选release或master，默认master

插件使用

Weathermap插件

1. 进入主机的data目录
2. 创建plugins文件夹（若不存在）
3. 克隆插件代码：

bash
cd plugins
git clone https://github.com/laf/Weathermap-for-Observium.git weathermap

4. 在LibreNMS前端启用插件

监控插件

• 将自定义监控插件放置于主机的/data/monitoring-plugins目录
• 重启容器生效

致谢

• 本镜像基于Phusion Baseimage构建
• LibreNMS团队：[***]