本页内容
- 准备工作
- 配置软件仓库
- 安装软件包依赖
- 配置 Firewalld
- 下载 LibreNMS 源代码
- 安装 LibreNMS 的 PHP 依赖
- 配置 PHP-FPM
- 配置 MariaDB 服务器
- 配置 Nginx 服务器块
- 配置 SELinux
- 完成 LibreNMS 配置
- 访问 LibreNMS Web 安装界面
- 结语
LibreNMS 是一款支持通过多种协议(包括 SNMP、ARP、OSPF 和 BGP)自动发现的监控工具。要监控操作系统,你可以使用 SNMP 协议,该协议在大多数操作系统上都可用,包括 Linux、Windows 和 BSD。
SNMP 协议有三个版本,v1 和 v2 仅使用团体名密码进行保护,而 v3 协议支持用于身份验证和加密的密码。在生产环境中,建议使用 SNMP v3 协议,它比 v2 和 v1 更安全。
在本指南中,你将学习如何在 Rocky Linux 服务器上安装 LibreNMS 监控工具。本指南包括 LEMP 栈(Nginx、MariaDB 和 PHP-FPM)的安装以及 SNMP 服务的基本配置。
到本指南结束时,你将拥有可用于生产环境的 LibreNMS 监控解决方案,并且只需添加一台新的主机、服务器或设备即可由 LibreNMS 进行监控。
准备工作
要完成本指南,你需要满足以下要求:
- 一台 Rocky Linux 服务器——本示例使用 Rocky Linux 8。
- 一个具有 sudo root/管理员权限的非 root 用户。
- 用于本地部署的本地域名。
配置软件仓库
在开始安装软件包之前,你将在 Rocky Linux 系统上配置软件仓库。你需要添加 EPEL 仓库(Extra Packages for Enterprise Linux,企业版 Linux 附加软件包)和 PHP Remi 仓库。
运行以下 dnf 命令将 EPEL 仓库添加到你的系统。
sudo dnf install epel-release
当提示确认时输入 Y 并按 ENTER 继续。

接下来,运行以下 dnf 命令添加 PHP Remi 仓库。该仓库提供多个版本的 PHP,其中包含 LibreNMS 安装所需的 PHP 8.1 最新版本。
sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-8.rpm
现在输入 Y 并按 ENTER 继续。

添加 EPEL 和 Remi 仓库后,使用以下 dnf 命令进行验证。
sudo dnf repolist
你应该会看到 EPEL 和 Remi 仓库已添加并在你的 Rocky Linux 系统上可用。

安装软件包依赖
添加 EPEL 和 Remi 仓库后,你现在将开始为 LibreNMS 安装软件包依赖。这包括 LEMP 栈、SNMP 软件包以及一些基础的 Python 依赖。
在开始安装之前,运行以下命令启用 PHP 仓库模块 ' remi-8.1 '。最新版本的 LibreNMS 至少需要 PHP 8。
sudo dnf reset php
sudo dnf module enable php:remi-8.1
输入 y 确认并启用 PHP Remi 8.1 仓库。

接下来,运行以下 dnf 命令安装 LibreNMS 的软件包依赖。当提示确认安装时,输入 y 并按 ENTER 继续,安装将会开始。
sudo dnf install bash-completion cronie fping git ImageMagick mariadb-server mtr net-snmp net-snmp-utils nginx nmap php-fpm php-cli php-common php-curl php-gd php-gmp php-json php-mbstring php-process php-snmp php-xml php-zip php-mysqlnd python3 python3-PyMySQL python3-devel python3-redis python3-memcached python3-pip python3-systemd rrdtool unzip

依赖安装完成后,运行以下命令启动并启用一些服务,例如 Nginx、MariaDB、PHP-FPM 和 snmpd。
sudo systemctl enable nginx php-fpm mariadb snmpd
sudo systemctl start nginx php-fpm mariadb snmpd
此时,Nginx、MariaDB、PHP-FPM 和 snmpd 等一些基础服务将在系统启动时自动启动。并且所有这些服务都正在运行。

配置 Firewalld
在本示例中,我们使用的是已启用 firewalld 的 Rocky Linux。现在你将把 HTTP 和 HTTPS 协议都添加到 firewalld。
运行以下 firewall-cmd 命令将 HTTP 和 HTTPS 服务添加到 firewalld。你应该会收到 ' success ' 的输出消息,表示新规则已添加。
sudo firewall-cmd --permanent --zone public --add-service http
sudo firewall-cmd --permanent --zone public --add-service https
接下来,重新加载 firewalld 以应用新的更改。然后,使用以下命令验证 firewalld 状态。
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
你将看到 HTTP 和 HTTPS 协议都已添加到 firewalld 的输出。

下载 LibreNMS 源代码
在此步骤中,你将通过 GitHub 下载 LibreNMS 源代码。但在此之前,你还需要创建一个专用的新用户 ' librenms ',该用户将用于运行 LibreNMS 应用。
运行以下命令创建新的系统用户 'librenms'。该用户将用于运行 LibreNMS 应用。
sudo useradd librenms -d /opt/librenms -M -r -s "$(which bash)"
现在将你的工作目录切换到 '/opt',并通过以下 git 命令下载 LibreNMS 源代码。你现在应该会得到一个新目录 ' /opt/librenms ',它将作为 LibreNMS 的安装目录。
cd /opt
git clone https://github.com/librenms/librenms.git

更改 LibreNMS 安装目录 ' /opt/librenms ' 的所有者和权限。安装目录的所有者应为 'librenms' 用户,并且权限 771 将允许用户对该目录进行读取、写入和执行。
sudo chown -R librenms:librenms /opt/librenms
sudo chmod 771 /opt/librenms
最后,运行以下命令为部分 LibreNMS 目录设置访问控制列表(ACL)。这将授予 ' librenms ' 组对某些特定 LibreNMS 目录进行读取、写入和执行。
sudo setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
sudo setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

安装 LibreNMS 的 PHP 依赖
下载 LibreNMS 源代码并配置正确权限后,你现在将为 LibreNMS 安装 PHP 依赖。
使用以下命令以 'librenms' 用户身份登录。
su - librenms
现在,通过以下安装脚本安装 PHP 依赖。
./scripts/composer_wrapper.php install --no-dev
你现在将看到 LibreNMS 所需 PHP 依赖的安装。你还将看到 LibreNMS 的 Python 软件包的安装。

PHP 依赖安装完成后,你现在可以按 'Ctrl+d ' 退出 ' librenms ' 用户,或者输入 ' exit ' 命令。
配置 PHP-FPM
在此步骤中,你将针对 LibreNMS 配置你的 PHP-FPM 安装。你将修改默认配置 ' /etc/php.ini',并为 LibreNMS 设置一个专用的 PHP-FPM 进程池。
运行以下命令为你的 Rocky Linux 系统设置正确的时区。
sudo timedatectl set-timezone Europe/Stockholm
现在使用以下 nano 编辑器编辑 PHP 配置 ' /etc/php.ini '。
sudo nano /etc/php.ini
取消注释 'date.timezone' 选项,并将其值改为你当前服务器的时区。
date.timezone = Europe/Stockholm
完成后保存文件并关闭编辑器。
接下来,将默认的 PHP-FPM 进程池配置 ' www.conf ' 复制为 ' librenms.conf '。在本示例中,你将针对 LibreNMS 监控工具设置专用的 PHP-FPM 进程池。
cp /etc/php-fpm.d/www.conf /etc/php-fpm.d/librenms.conf
现在使用以下 nano 编辑器编辑 PHP-FPM 进程池配置 ' /etc/php-fpm.d/librenms.conf'。
sudo nano /etc/php-fpm.d/librenms.conf
将默认进程池名称从 ' [www]' 改为 ' [librenms] '。
[librenms]
将默认的用户和组改为 ' librenms '。这将使 PHP-FPM 进程以 ' librenms ' 用户和组身份运行。
user = librenms group = librenms
最后,将 listen 选项改为 '/run/php-fpm-librenms.sock' 。这将指定 PHP-FPM librenms 进程池使用的 sock 文件。
listen = /run/php-fpm-librenms.sock
完成后保存文件并退出编辑器。
现在运行以下 systemctl 命令重启 PHP-FPM 服务并应用新的更改。
sudo systemctl restart php-fpm

配置 MariaDB 服务器
配置完 PHP-FPM 后,你现在将设置 MariaDB 数据库服务器,并为 LibreNMS 创建新的数据库和用户。
LibreNMS 需要启用了 InnoDB 的 MariaDB 数据库服务器。所以现在你需要启用它。然后,你将为 LibreNMS 创建新的数据库和用户。
使用以下 nano 编辑器编辑 MariaDB 服务器配置 '/etc/my.cnf.d/mariadb-server.cnf'。
sudo nano /etc/my.cnf.d/mariadb-server.cnf
将以下配置放在 ' [mysqld]' 小节下。
[mysqld] .... innodb_file_per_table=1 lower_case_table_names=0
完成后保存文件并退出编辑器。
现在运行以下 systemctl 命令重启 MariaDB 服务并应用新的更改。MariaDB 服务器现已在启用了 InnoDB 数据库引擎的情况下运行。
sudo systemctl restart mariadb
接下来,通过以下 mysql 命令登录到 MariaDB shell。当提示输入密码时,你只需按 ENTER,或输入 MariaDB 的 root 密码。
sudo mysql -u root -p
运行以下查询为 LibreNMS 创建新的数据库和用户。在本示例中,你将创建新的数据库和用户 ' librenms ',并请务必将数据库密码替换为你自己的密码。
CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;

接下来,运行以下查询验证数据库用户 ' librenms@localhost' 的权限。
SHOW GRANTS FOR librenms@localhost;
你应该会看到用户 ' librenms'@localhost' 对数据库 ' librenms ' 拥有权限。

现在输入 ' exit ' 退出 MariaDB shell。
配置 Nginx 服务器块
配置完 MariaDB 服务器并创建好数据库和用户后,你现在将为 LibreNMS 创建一个新的 Nginx 服务器块配置。
在开始之前,请确保你已经确定了用于 LibreNMS 的本地域名。在本示例中,LibreNMS 应运行在域名 ' librenms.example.local ' 上。
使用以下 nano 编辑器创建新的 Nginx 服务器块配置 ' /etc/nginx/conf.d/librenms.conf '。
sudo nano /etc/nginx/conf.d/librenms.conf
将以下配置添加到该文件中,并务必将域名替换为你自己的域名。
server {
listen 80;
server_name librenms.example.local;
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;
}
}
完成后保存文件并退出编辑器。
接下来,运行以下命令验证 Nginx 配置,确保配置正确。
sudo nginx -t
如果你的 Nginx 配置正确,你将看到诸如 ' test successful - Syntax OK ' 这样的输出消息。
现在重启 Nginx 服务以应用新的服务器块配置。
sudo systemctl restart nginx

至此,你已完成 LibreNMS 的 LEMP 栈(Nginx、MariaDB 数据库和 PHP-FPM)配置。并且 LibreNMS 现在应该已运行在你的 Rocky Linux 系统上。
配置 SELinux
在本指南中,你将在 SELinux 处于强制(enforcing)模式的情况下运行 LibreNMS。所以你现在将为 LibreNMS 设置 SELinux 规则。
首先,运行以下 dnf 命令将软件包 ' policycoreutils-python-utils ' 安装到你的 Rocky Linux 系统。该软件包提供了多个用于管理 SELinux 的命令行工具。
sudo dnf install policycoreutils-python-utils
当提示时,输入 y 确认并按 ENTER 继续。

接下来,运行以下命令为 LibreNMS 源代码设置标签。
semanage fcontext -a -t httpd_sys_content_t '/opt/librenms/html(/.*)?'
semanage fcontext -a -t httpd_sys_rw_content_t '/opt/librenms/(rrd|storage)(/.*)?'
semanage fcontext -a -t httpd_log_t "/opt/librenms/logs(/.*)?"
semanage fcontext -a -t bin_t '/opt/librenms/librenms-service.py'
restorecon -RFvv /opt/librenms
chcon -t httpd_sys_rw_content_t /opt/librenms/.env

运行以下命令允许 Nginx Web 服务器访问某些服务。
setsebool -P httpd_can_sendmail=1
setsebool -P httpd_execmem 1
现在,使用以下 nano 编辑器创建一个新文件 'http_fping.tt'。
nano http_fping.tt
将以下配置添加到该文件中。
module http_fping 1.0;
require {
type httpd_t;
class capability net_raw;
class rawip_socket { getopt create setopt write read };
}
#============= httpd_t ==============
allow httpd_t self:capability net_raw;
allow httpd_t self:rawip_socket { getopt create setopt write read };
完成后保存文件并退出编辑器。
接下来,运行以下命令将 ' http_fping.tt ' 转换为 SELinux 所需的格式。然后,将新编译的规则添加到 SELinux。
checkmodule -M -m -o http_fping.mod http_fping.tt
semodule_package -o http_fping.pp -m http_fping.mod
semodule -i http_fping.pp

现在你已经完成了 LibreNMS 的 SELinux 配置。接下来,你将设置 LibreNMS 的一些额外配置。
完成 LibreNMS 配置
为了完成 LibreNMS 配置,你现在将设置 ' lnms ' 命令行,并复制 LibreNMS 的部分默认配置,包括 cron 和 logrotate 的配置。同时,你还将为 LibreNMS 设置 SNMP 服务。
运行以下命令启用 ' lnms ' 命令行,并复制 ' lnms ' 命令的 bash 自动补全。
ln -s /opt/librenms/lnms /usr/bin/lnms
cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/
将 LibreNMS 的 cron 示例配置复制到 ' /etc/cron.d/librenms '。
sudo cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms
将 LibreNMS 默认的 logrotate 配置复制到 '/etc/logrotate.d/librenms '。
sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

现在将默认的 snmpd 服务配置复制到 '/etc/snmp/snmpd.conf' 。然后,使用 nano 编辑器编辑新文件 '/etc/snmp/snmpd.conf'。
sudo cp /opt/librenms/snmpd.conf.example /etc/snmp/snmpd.conf
sudo nano /etc/snmp/snmpd.conf
将 snmpd 服务的默认团体名密码 ' RANDOMSTRINGGOESHERE ' 改为你自己的密码。
# Change RANDOMSTRINGGOESHERE to your preferred SNMP community string com2sec readonly default RANDOMSTRINGGOESHERE
完成后保存文件并退出编辑器。
接下来,下载 LibreNMS 用于自动检测每个目标主机操作系统的二进制文件。然后,通过更改默认权限使其可执行。
curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro
chmod +x /usr/bin/distro

最后,重启 snmpd 服务以应用新的更改和配置。
systemctl restart snmpd
现在所有基本配置已完成。接下来,你将通过 Web 浏览器启动 LibreNMS 安装。
访问 LibreNMS Web 安装界面
在你的本地机器上,编辑 '/etc/hosts' 文件并定义你的 LibreNMS 安装的本地域名。同时,务必将 IP 地址替换为你服务器的 IP 地址。
192.168.5.100 librenms.example.local
现在打开 Web 浏览器并访问你的 LibreNMS 安装域名(即:http://librenms.example.local/ )。
首先,LibreNMS 安装程序会检查安装环境。请确保所有要求都标记为绿色,表示系统已为 LibreNMS 安装做好准备。
点击数据库图标继续。

现在输入你的 LibreNMS 数据库和用户的详细信息,然后点击 ' Check Credentials '(检查凭据)。如果你的数据库凭据正确,该部分将被标记为绿色。

现在点击 ' Build Database '(构建数据库)开始 LibreNMS 的数据库迁移。

数据库迁移完成后,你将看到 ' Build Database ' 部分标记为绿色。
点击钥匙图标开始配置 LibreNMS 的管理员用户。

现在输入你的 LibreNMS 安装的新管理员用户、密码和电子邮件地址,然后点击 ' Add User '(添加用户)。

现在安装已完成,你将看到如下页面。你可以看到安装已完成,配置已写入 ' .env ' 文件。

现在点击 ' validate your install '(验证你的安装)链接来验证 LibreNMS 安装。
你现在应该会被重定向到 LibreNMS 登录页面。输入你的管理员用户和密码,然后点击 ' Login '(登录)。

现在请确保所有配置都标记为 ' OK ',表示配置没有错误。
你也可以按照 LibreNMS 建议的说明修复所有错误或警告。

你现在可以添加一个新的目标主机、虚拟机或网络设备,由 LibreNMS 监控解决方案进行监控。
结语
恭喜!你已在 Rocky Linux 服务器上安装了 LibreNMS 监控解决方案。你还学习了 Rocky Linux 上 LEMP 栈(Nginx、MariaDB 和 PHP-FPM)的基本配置。
在此基础上,你可以继续添加要监控的主机或目标机器、设置 LibreNMS Agent、配置告警或通知、设置与 Graylog 的第三方集成,以及执行其他任务。