本页目录

  • 先决条件
  • 安装软件包依赖
  • 设置新用户 librenms
  • 设置系统和 PHP 的时区
  • 设置 MariaDB 并创建数据库
  • 创建新的 PHP-FPM 池
  • 下载 LibreNMS
  • 安装 LibreNMS 的 PHP 依赖
  • 为 LibreNMS 配置 Nginx
  • 开始安装 LibreNMS - 修复数据库时区 - 修复系统错误
  • 结论
  • - 修复数据库时区
  • - 修复系统错误

LibreNMS 是一个基于 PHP 的开源网络监控系统,支持自动发现。它是监控软件 Observium 的社区分支,采用 GPLv3 许可证发布。使用 LibreNMS 可以监控 Linux、Windows 和 BSD 等操作系统,它还支持来自 Aruba、Cisco、Dell、D-Link、HP、Mikrotik 等多个厂商的广泛网络硬件。

作为一个功能齐全的监控系统,LibreNMS 提供丰富的功能,具有多种集成和多种协议的数据收集能力。

以下是 LibreNMS 的一些显著特性:

  • 使用 CDP、BGP、SNMP、OSPF 和 ARP 等多种协议自动发现您的整个网络。
  • 多种告警方式,使用 email、slacks、IRC、Rocket.chat、Telegram 等。
  • 丰富的 API,用于管理、绘制图表以及从监控系统检索数据。
  • 支持计费系统,可根据网络使用量或流量生成带宽账单。
  • 支持多种身份验证方式,如 MySQL、Radius、LDAP、HTTP 和 Active Directory。
  • 支持双重身份验证
  • 与第三方应用程序多种集成,如 Graylog、NfSen、Nagios Plugins、Oxidized、RANCID。
  • 广泛支持硬件厂商,请在此查看您的厂商。
  • 用户友好且可自定义的仪表盘。
  • 通过自动更新支持使您的 LibreNMS 软件保持最新。
  • 提供核心功能的 Android 和 iOS 原生应用程序。

在本指南中,您将学习如何在 Debian 11 Bullseye 上安装和配置 LibreNMS 监控工具。

先决条件

要完成本指南,请确保您已具备以下要求:

  • 操作系统:Debian 11 Bullseye
  • Root 权限

现在让我们开始安装。

安装软件包依赖

在这一步中,您将安装 LibreNMS 所需的基本和必要软件包。您将安装 LEMP Stack、Python 软件包、snmpd,以及 curl、fping、git 和 imagemagick 等附加系统工具。

1. 使用以下命令刷新并更新 Debian 软件仓库。

sudo apt update

2. 现在执行以下命令以安装软件包依赖。

sudo apt install acl curl composer fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php7.4-cli php7.4-curl php7.4-fpm php7.4-gd php7.4-gmp php7.4-json php7.4-mbstring php7.4-mysql php7.4-snmp php7.4-xml php7.4-zip python3-dotenv python3-pymysql python3-redis python3-setuptools python3-pip python3-systemd rrdtool snmp snmpd whois

输入 'y' 确认安装,然后按 'Enter' 继续。

3. 软件包依赖安装完成后,执行以下命令以启动并启用 Nginx、MariaDB、PHP-FPM 和 snmpd 等服务。

sudo systemctl enable --now nginx
sudo systemctl enable --now mariadb
sudo systemctl enable --now php7.4-fpm
sudo systemctl enable --now snmpd.service

现在您已经完成了 LibreNMS 软件包依赖的安装。

设置新用户 librenms

在这一步中,您将创建一个新的系统用户 'librenms'。您的 LibreNMS 监控工具将以 'librenms' 用户身份运行。

1. 执行以下命令以创建新的 'librenms' 用户。

useradd librenms -d /opt/librenms -M -r -s "$(which bash)"

您必须了解的选项:

  • -d /opt/librenms:将用户 'librenms' 的默认主目录设置为 '/opt/librenms'。
  • -M:不为用户 'librenms' 创建主目录。
  • -r:将此用户 'librenms' 设为系统用户。
  • -s "$(which bash)":为用户 'librenms' 设置默认 shell。该 shell 将是命令 'which bash' 的输出。

2. 接下来,使用以下命令为用户 'librenms' 创建新密码。

passwd librenms

输入一个新的强密码并重复输入。

继续下一步,为安装 LibreNMS 配置您的系统。

设置系统和 PHP 的时区

时间是监控的重要组成部分。在这一步中,您将设置 PHP 的默认时区和系统时区,请确保两者(PHP 和系统)时区同步并使用相同的时区。

1. 使用以下命令编辑 PHP-FPM 和 CLI 的配置文件 'php.ini'。

sudo nano /etc/php/7.4/fpm/php.ini
sudo nano /etc/php/7.4/cli/php.ini

取消注释 'date.timezone' 选项,并在其后填入您的时区。在本示例中,我们使用时区 ' Europe/Paris' 。

date.timezone = Europe/Paris

保存两处配置并退出。

2. 现在使用以下命令重启 PHP-FPM 以应用新配置。

sudo systemctl restart php7.4-fpm

3. 之后,执行下面的 timedatectl 命令,将系统默认时区设置为 ' Europe/Paris '。

sudo timedatectl set-timezone Europe/Paris

您已经完成了 PHP 和系统的时区配置。

设置 MariaDB 并创建数据库

在这一步中,您将按照 LibreNMS 的要求添加 MariaDB 配置,然后为 LibreNMS 安装创建一个新的 MariaDB 数据库和用户。

1. 使用 nano 编辑器编辑 MariaDB 服务器配置 ' /etc/mysql/mariadb.conf.d/50-server.cnf '。

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

在 '[mysqld]' 部分下添加以下配置。

[mysqld]
.....
....
innodb_file_per_table=1
lower_case_table_names=0

保存配置并退出。

2. 要应用新的 MariaDB 配置,请使用下面的 systemctl 命令重启服务。

sudo systemctl restart mariadb

现在您已经为 MariaDB 服务器添加了额外的配置。

3. 接下来,如下所示使用命令 'mysql' 以用户 'root' 身份登录 MariaDB/MySQL shell。

mysql -u root -p

输入您的密码或按 'Enter' 登录。

4. 现在执行以下 MariaDB 查询以创建新的数据库和用户 ' librenms '。请确保将密码 ' LibreNMSPassword ' 更改为您的强密码。

CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'LibreNMSPassword';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;

输入 'exit' 并按 'Enter' 退出 MariaDB shell。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

现在您已经为 LibreNMS 安装创建了数据库和用户。

创建新的 PHP-FPM 池

FastCGI Process Manager (FPM) 或 PHP-FPM 允许您为 PHP 应用程序自定义池。默认情况下,PHP-FPM 运行 'www' 池,配置文件为 ' /etc/php/7.4/fpm/pool.d/www.conf' 。

在这一步中,您将为 LibreNMS 创建一个新的自定义 PHP-FPM 池。您将创建一个配置为 '/etc/php/7.4/fpm/pool.d/librenms.conf ' 的新 PHP-FPM 池 ' librenms ',它将以用户 ' librenms ' 身份运行。

1. 首先,使用以下命令将默认池配置 ' www.conf ' 复制为 ' librenms.conf '。

cp /etc/php/7.4/fpm/pool.d/www.conf /etc/php/7.4/fpm/pool.d/librenms.conf

2. 使用 nano 编辑器编辑自定义的 'librenms.conf' 池配置。

sudo nano /etc/php/7.4/fpm/pool.d/librenms.conf

在首行,将默认用户从 '[www]' 更改为 ' [librenms]' 。

[librenms]

将默认用户和组更改为 ' librenms '。

user = librenms
group = librenms

将默认 PHP-FPM sock 文件更改为 '/ run/php-fpm-librenms.sock '。

listen = /run/php-fpm-librenms.sock

保存配置并退出。

3. 接下来,重启 PHP-FPM 服务以应用新配置。

sudo systemctl restart php7.4-fpm

现在 PHP-FPM 将生成新的池 'librenms',其 sock 文件为 '/run/php/php-fpm-librenms.sock' 。

4. 使用以下命令验证 ' librenms ' sock 文件。

ss -anl | grep librenms

您将看到类似下面的输出。

u_str LISTEN 0      511                /run/php/php-fpm-librenms.sock 69199                  * 0     users:(("php-fpm7.4",pid=26105,fd=10),("php-fpm7.4",pid=26104,fd=10),("php-fpm7.4",pid=26103,fd=7))

现在您可以下载并安装 LibreNMS 监控工具了。

下载 LibreNMS

在这一步中,您将下载 LibreNMS 源代码,并为其设置权限和访问控制。

1. 将工作目录切换到 '/opt',并使用下面的 git 命令下载 LibreNMS 源代码。

cd /opt/
git clone https://github.com/librenms/librenms.git

您的 LibreNMS 安装目录为 ' /opt/librenms '。

2. 使用以下命令更改 LibreNMS 安装目录的所有权和权限。

chown -R librenms:librenms /opt/librenms
chmod 771 /opt/librenms

3. 接下来,为 LibreNMS 安装目录设置访问控制列表 (ACL)。使用以下 setfacl 命令允许组对下面的每个目录拥有读写执行权限。

setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

继续下一步,为 LibreNMS 安装 PHP 依赖。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

安装 LibreNMS 的 PHP 依赖

要安装 LibreNMS 的 PHP 依赖,您必须以用户 'librenms' 身份登录,并使用 LibreNMS 源代码中包含的 composer_wrapper。

1. 使用以下命令以用户 'librenms' 身份登录。

su - librenms

2. 执行 PHP 脚本 ' composer_wrapper.php ' 以安装 LibreNMS 的 PHP 软件包依赖。

./scripts/composer_wrapper.php install --no-dev

3. 所有下载过程完成后,输入 ' exit ' 并按 ' Enter ' 退出用户 ' librenms '。

现在您已经完成了 LibreNMS 的 PHP 依赖安装。

为 LibreNMS 配置 Nginx

在这一步中,您将为 LibreNMS 监控工具创建一个新的 Nginx 服务器块。本示例将使用域名 'librenms.example.io'。

1. 使用 nano 编辑器创建一个新的 Nginx 服务器块配置 ' librenms '。

sudo nano /etc/nginx/sites-available/librenms

复制并粘贴以下配置。请确保将域名更改为您的域名。

server {
 listen      80;
 server_name librenms.example.io;
 root        /opt/librenms/html;
 index       index.php;
 charset utf-8;
 gzip on;
 gzip_types text/css application/javascript text/javascript application/x-javascript image/svg+xml text/plain text/xsd text/xsl text/xml image/x-icon;
 location / {
  try_files $uri $uri/ /index.php?$query_string;
 }
 location ~ [^/]\.php(/|$) {
  fastcgi_pass unix:/run/php-fpm-librenms.sock;
  fastcgi_split_path_info ^(.+\.php)(/.+)$;
  include fastcgi.conf;
 }
 location ~ /\.(?!well-known).* {
  deny all;
 }
}

对于安全的 HTTPS LibreNMS 安装,请使用以下配置。请确保更改域名和 SSL 证书的路径。

server {
    listen      80;
    server_name librenms.example.io;
    rewrite     ^   https://$server_name$request_uri? permanent;
}
server {
 server_name librenms.example.io;
 root        /opt/librenms/html;
 index       index.php;
   listen 443 ssl http2;
    server_name example.io;
    ssl_certificate           /etc/letsencrypt/live/librenms.example.io/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/librenms.example.io/privkey.pem;
    ssl_session_cache  builtin:1000  shared:SSL:10m;
    ssl_protocols TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;
 charset utf-8;
 gzip on;
 gzip_types text/css application/javascript text/javascript application/x-javascript image/svg+xml text/plain text/xsd text/xsl text/xml image/x-icon;
 location / {
  try_files $uri $uri/ /index.php?$query_string;
 }
 location ~ [^/]\.php(/|$) {
  fastcgi_pass unix:/run/php/php-fpm-librenms.sock;
  fastcgi_split_path_info ^(.+\.php)(/.+)$;
  include fastcgi.conf;
 }
 location ~ /\.(?!well-known).* {
  deny all;
 }
}

现在保存配置并退出。

2. 接下来,激活新的虚拟主机 ' librenms ',并使用以下命令验证 nginx 配置。

sudo ln -s /etc/nginx/sites-available/librenms /etc/nginx/sites-enabled/
sudo nginx -t

如果您的配置正确,您将看到类似 'test is successful' 的输出消息。

3. 最后,重启 nginx 服务以应用新配置。

sudo systemctl restart nginx

现在您已经完成了 LibreNMS 的 Nginx 服务器块配置。您可以开始安装 LibreNMS 了。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

开始安装 LibreNMS

要开始安装 LibreNMS,请打开 Web 浏览器,在地址栏中输入 LibreNMS 的域名。

https://librenms.example.io

1. 您将看到 LibreNMS 的 'Pre-Install Checks'。确保所有检查状态都标记为绿色,然后单击数据库图标以继续。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

2. 输入您的数据库、用户和密码。然后单击 ' Check Credentials ' 按钮。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

这将对您的 MariaDB 数据库和用户进行检查。如果成功,您将在 ' Database Credentials ' 上看到绿色标记。

3. 现在单击 ' Build Database ' 按钮,为您的 LibreNMS 导入数据库架构。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

数据库配置完成后,确保 ' Database Credentials ' 和 ' Build Database ' 两个部分都标记为绿色。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

4. 现在单击 ' Key ' 图标以继续。

输入新用户、密码和电子邮件地址以创建 LibreNMS 管理员用户。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

单击 ' Add User ' 按钮。

如果管理员用户创建成功,您将在页面上看到如下的管理员用户。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

5. 单击标记图标以完成安装。您将得到如下输出。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

要完成 LibreNMS 安装,请打开如下的 LibreNMS 验证页面。

https://librenms.example.io/validate

6. 然后您将被重定向到 LibreNMS 登录页面。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

输入您的管理员用户和密码,然后单击 ' Login ' 按钮

7. 在 LibreNMS 验证页面上,您将看到如下一些错误。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

您可能会遇到不同的错误,但 LibreNMS 验证页面为您的错误提供了解决方案。

8. 以下是我们安装过程中出现的一些错误及其修复方法。

- 修复数据库时区

使用 root 用户登录 MariaDB shell。

mysql -u root -p

将当前数据库切换为 'librenms'。

use librenms;

现在执行以下查询以修复数据库时区错误。

SET TIME_ZONE='+00:00';
ALTER TABLE `notifications` CHANGE `datetime` `datetime` timestamp NOT NULL DEFAULT '1970-01-02 00:00:00' ;
ALTER TABLE `users` CHANGE `created_at` `created_at` timestamp NOT NULL DEFAULT '1970-01-02 00:00:01' ;

- 修复系统错误

使用以下命令将 LibreNMS 的二进制命令 'lnms' 添加到 ' /usr/bin ' 目录。

sudo ln -s /opt/librenms/lnms /usr/bin/lnms

为命令 'lnms' 启用 bash 补全。

sudo cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/

最后,将 LibreNMS 的 logrotate 配置复制到目录 '/etc/logrotate.d/'。

sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

9. 修复 LibreNMS 错误后,返回 LibreNMS 验证页面并重新加载该页面。

现在确保所有状态均为 ' OK '。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

10. 单击 ' Overview ' 菜单以显示仪表盘。

如何在 Debian 11 上安装和配置 LibreNMS 网络监控系统

现在您已经完成了在 Debian 11 Bullseye 上的 LibreNMS 安装。

结论

恭喜!您已在最新的 Debian 11 Bullseye 上成功安装了 LibreNMS 监控工具,包括 Nginx、PHP-FPM 和 MariaDB 数据库。此外,您还学习了如何创建自定义 PHP-FPM 池以及修复 LibreNMS 安装中的一些错误。

下一步,您将学习如何向 LibreNMS 监控工具添加要监控的主机。