本页目录
- 先决条件
- 安装软件包依赖
- 设置新用户 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。

现在您已经为 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 依赖。

安装 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 了。

开始安装 LibreNMS
要开始安装 LibreNMS,请打开 Web 浏览器,在地址栏中输入 LibreNMS 的域名。
https://librenms.example.io
1. 您将看到 LibreNMS 的 'Pre-Install Checks'。确保所有检查状态都标记为绿色,然后单击数据库图标以继续。

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

这将对您的 MariaDB 数据库和用户进行检查。如果成功,您将在 ' Database Credentials ' 上看到绿色标记。
3. 现在单击 ' Build Database ' 按钮,为您的 LibreNMS 导入数据库架构。

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

4. 现在单击 ' Key ' 图标以继续。
输入新用户、密码和电子邮件地址以创建 LibreNMS 管理员用户。

单击 ' Add User ' 按钮。
如果管理员用户创建成功,您将在页面上看到如下的管理员用户。

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

要完成 LibreNMS 安装,请打开如下的 LibreNMS 验证页面。
https://librenms.example.io/validate
6. 然后您将被重定向到 LibreNMS 登录页面。

输入您的管理员用户和密码,然后单击 ' Login ' 按钮
7. 在 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 '。

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

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