拓冰网站定制 
想在一台全新的 Ubuntu 24.04 服务器上把 LibreNMS 从零搭起来并且能稳定跑起来接设备这件事我前后折腾过好几轮。网上有不少教程但很多是拿 CentOS 或者旧版本 Ubuntu 写的照抄到 24.04 上经常会在 PHP 扩展、数据库认证、Nginx 配置这些地方卡住。这篇文章把我实际部署过程中踩过的坑、验证过的步骤和调整过的参数都整理出来照着做基本能一步到位。这套环境不挑设备只要网络设备支持 SNMP不管是交换机、路由器、防火墙还是服务器都能接入 LibreNMS 统一监控。对于网络工程师、运维人员或者正在搭建实验室环境学习网络监控的人来说这份指南可以直接帮你省掉反复试错的时间。1. 方案选型与整体设计思路1.1 为什么选 LibreNMS 而不是其他监控系统监控网络设备这件事市面上的选择其实不少。Zabbix 功能强但配置偏重Prometheus 生态好可对网络设备的原生支持不够直接而 LibreNMS 最核心的优势就是“自动发现”。只要给设备配上 SNMP community它就能自动识别设备类型、接口、CPU、内存、温度、流量等指标基本不用手动建模。对于网络设备这种“型号杂、数量多、指标标准”的场景这种自动化的效率提升是实打实的。另一个原因是它基于 PHP 和 MySQL部署门槛相对低整个系统的依赖链简单不像某些监控系统需要一堆中间件。而且 LibreNMS 的 Web 界面做得比较直观告警规则、图像报表、API 接口都有日常使用足够。加上它是 Observium 的开源分支社区活跃更新频率高Ubuntu 24.04 这种较新的系统上跑起来也没什么兼容性问题。1.2 Ubuntu 24.04 环境特点与组件选型Ubuntu 24.04 默认的软件源里PHP 版本是 8.3MariaDB 版本是 10.11这两个版本都在 LibreNMS 的支持范围内。相比旧版 Ubuntu 自带 PHP 7.4 的时代现在部署反而省事不需要额外添加第三方源来装新版 PHP。在 Web 服务器选型上我选择 Nginx 而不是 Apache。原因很简单LibreNMS 官方文档推荐 Nginx而且 Nginx 处理 PHP 请求的性能更好配置也清晰。PHP-FPM 是必须的Nginx 本身不处理 PHP需要把请求转发给 PHP-FPM 解析。数据库方面Ubuntu 24.04 默认 MariaDB 就够用没必要单独装 MySQLMariaDB 与 MySQL 完全兼容LibreNMS 官方也明确支持。2. 基础环境准备2.1 系统更新与基础软件包安装拿到一台全新的 Ubuntu 24.04 服务器第一件事就是把软件源索引更新到最新避免装到旧版本的包。这一步在任何教程里都是标配但我还是想提醒一句更新之后最好重启一下系统让内核也切换到最新状态尤其是刚装完系统的情况。sudo apt update sudo apt upgrade -y接着安装一些基础工具包括 Git用于拉取 LibreNMS 源码、curl测试 Web 接口、SNMP 相关的软件包。这里先把需要的东西统一装好后面就不会频繁切回终端补装软件。sudo apt install -y git curl wget snmp snmpd mib-downloader python3 python3-pip需要注意Ubuntu 24.04 安装 mib-downloader 后还需要手动启用标准 MIB 库否则 SNMP Walk 的时候会提示找不到 MIB 文件。后面的 SNMP 配置章节会详细说明。2.2 安装 PHP 8.3 及扩展组件LibreNMS 是基于 PHP 的所以 PHP 环境是整个系统正常运行的基础。Ubuntu 24.04 的默认软件源里已经有 PHP 8.3直接用 apt 安装即可。光装 PHP 本体不够LibreNMS 依赖一堆扩展包括数据库驱动、SNMP 支持、图像处理、XML 解析等。我建议一次性装完sudo apt install -y php8.3-cli php8.3-fpm php8.3-mysql php8.3-gd php8.3-snmp php8.3-curl php8.3-xml php8.3-mbstring php8.3-zip php8.3-intl这里有一个容易踩的坑网上很多教程会写php8.3-json但 PHP 8.0 之后 JSON 扩展已经是内置的不需要单独安装。装了反而可能报冲突或者根本找不到这个包。另外有些教程推荐安装php8.3-apcu做缓存生产环境确实建议安装可以显著提升性能sudo apt install -y php8.3-apcu装完后检查一下 PHP 版本和已加载的扩展确保没有遗漏。php -v php -m | grep -E snmp|mysql|gd|curl|xml|mbstring|zip2.3 安装配置 MariaDB 数据库数据库这边Ubuntu 24.04 默认源里的 MariaDB 版本是 10.11LibreNMS 要求 10.5 以上所以直接用系统的默认版本即可。sudo apt install -y mariadb-server安装完成后MariaDB 服务会自动启动。在 Ubuntu 上MariaDB 的 root 用户默认使用 unix_socket 认证也就是系统 root 用户直接登录数据库不需要密码。这个机制对于本地管理来说挺方便但配置 LibreNMS 时我们需要单独创建一个专用数据库用户。执行数据库安全配置脚本这一步建议做sudo mysql_secure_installation这个脚本会引导你设置 root 密码、删除匿名用户、禁止 root 远程登录等。需要注意的是在 Ubuntu 24.04 上执行时如果之前 root 是 socket 认证选择设置密码后可能需要调整认证方式否则可能出现“root 密码设了但无法登录”的情况。我的建议是安全脚本执行完先测试一下 root 能否正常登录sudo mysql -u root如果登录不了再用sudo mysqlsocket 认证进去修改认证方式。这个细节在生产环境很容易让人抓狂后面排查章节会再提到。2.4 配置 Nginx Web 服务器Nginx 的安装很简单重点是后面要给它安排一个虚拟主机配置把 LibreNMS 的域名解析到正确的目录并且把 PHP 请求转发给 PHP-FPM。sudo apt install -y nginx安装完先启动服务确认默认页面能访问再进行后续配置sudo systemctl start nginx sudo systemctl enable nginx理论上到这里基础环境已经就绪PHP 8.3 MariaDB 10.11 Nginx一个标准的 LNMP 环境。但先别急着配置虚拟主机我们要先把 LibreNMS 的程序文件部署到位再根据实际目录来写 Nginx 配置。3. LibreNMS 核心部署与初始化配置3.1 创建系统用户并下载源码LibreNMS 官方推荐的做法是安装在/opt/librenms目录下并创建一个独立的系统用户来运行 poller 和 discovery 等定时任务。这样做的好处是权限隔离即使某个 PHP 脚本被攻破攻击者拿到的也只是这个受限用户的权限而不是 root 权限。sudo useradd -r -M -d /opt/librenms -s /bin/bash librenms这条命令的参数含义-r创建系统用户UID 范围在系统区-M不自动创建家目录我们指定为 /opt/librenms-d指定家目录-s指定登录 shell。注意要让这个用户能执行 PHP 脚本必须给它一个可用的 shell/bin/false会导致后续 cron 任务异常。接着拉取源码cd /opt sudo git clone https://github.com/librenms/librenms.git sudo chown -R librenms:librenms /opt/librenmsGit 拉取可能需要一些时间服务器网络状况好的话一般一两分钟就完成了。拉完之后把目录属主改成 librenms 用户这一步不能省否则后面 PHP-FPM 执行脚本时会因为权限不足报错。3.2 安装 PHP 依赖与配置 config.phpLibreNMS 使用 Composer 管理 PHP 依赖包。我们不需要单独安装 ComposerLibreNMS 自带了一个封装脚本自动处理 Composer 的下载和升级cd /opt/librenms sudo -u librenms ./scripts/composer_wrapper.php install --no-dev这个过程会下载很多依赖包耗时取决于服务器和网络情况一般 3 到 10 分钟。执行完后检查一下 vendor 目录是否生成ls -la /opt/librenms/vendor如果有autoload.php文件说明依赖安装成功。接着创建 LibreNMS 的配置文件。新版 LibreNMS 支持在 Web 界面中完成安装引导但也可以在命令行先手动创建config.php这样 Web 安装时会直接读取少走一步流程sudo cp /opt/librenms/config.php.default /opt/librenms/config.php sudo chown librenms:librenms /opt/librenms/config.php3.3 创建数据库与专用账号回到 MariaDB 命令行为 LibreNMS 创建数据库和用户。这里建议给用户设置一个强度足够的密码避免被轻易破解sudo mysql -u root进入 MariaDB 命令行后依次执行CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER librenmslocalhost IDENTIFIED BY 你的强密码; GRANT ALL PRIVILEGES ON librenms.* TO librenmslocalhost; FLUSH PRIVILEGES; EXIT;这里有一个很关键的细节数据库字符集必须使用utf8mb4因为 LibreNMS 存储设备描述等文本时可能包含特殊字符utf8mb4对 emoji 和生僻字的支持更好。采用utf8mb4_unicode_ci排序规则也是官方文档推荐的做法。接着把数据库连接信息写入 LibreNMS 的配置文件。编辑/opt/librenms/config.php在文件末尾加上$config[db_host] localhost; $config[db_user] librenms; $config[db_pass] 你的强密码; $config[db_name] librenms;保存后顺手设置一下 PHP 的时区避免后续监控数据的时间戳全部偏移。编辑/etc/php/8.3/fpm/php.ini和/etc/php/8.3/cli/php.ini找到date.timezone取消注释并设置date.timezone Asia/Shanghai改完记得重启 PHP-FPM 让它生效这一步可以先等 Nginx 配置完成后再一起重启反正后面还有改动。4. Web 服务器与 PHP-FPM 核心配置4.1 Nginx 虚拟主机配置LibreNMS 官方文档提供了一份可直接套用的 Nginx 配置里面把缓存、伪静态、PHP 转发都处理好了。我建议直接基于这份配置修改不要自己从零写否则容易漏掉一些安全相关的 location 规则。在/etc/nginx/sites-available/下创建虚拟主机配置文件推荐命名为librenms.confserver { listen 80; server_name librenms.example.com; # 改成你的实际域名或IP root /opt/librenms/html; index index.php; charset utf-8; gzip on; gzip_types text/css application/javascript text/javascript application/x-javascript image/svgxml text/plain application/xml application/json; location / { try_files $uri $uri/ librenms; } location ~ ^/(build/|poller/|includes/|tests/|docs/|vendor/|routes/|misc/) { deny all; } location ~ \.php(?:$|/) { fastcgi_split_path_info ^(.\.php)(/.)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass unix:/run/php/php8.3-fpm.sock; fastcgi_index index.php; } }这份配置里有几个关键的 location 块。第一个location /配合try_files实现前端路由的重写LibreNMS 的页面跳转依赖这个。第二个location是安全屏蔽规则把 build、poller、includes、vendor 这些目录屏蔽掉防止外部直接访问源码文件。第三个是 PHP 解析把.php请求交给 PHP-FPM注意fastcgi_pass指向的 socket 路径必须和 PHP-FPM 的监听地址一致。启用站点并重载 Nginxsudo ln -s /etc/nginx/sites-available/librenms.conf /etc/nginx/sites-enabled/librenms.conf sudo nginx -t sudo systemctl reload nginx如果nginx -t报错说明配置语法有问题根据提示修改即可。最常见的问题是 server_name 里带了特殊字符或者少了分号。4.2 PHP-FPM 池配置PHP-FPM 默认的 www.conf 在 LibreNMS 场景下需要做一些调整。最关键的一点是librenms 用户要有权限执行 PHP 脚本所以 PHP-FPM 进程的用户需要改成 librenms或者把 socket 的属主设为 www-data 让 Nginx 能访问。我的做法是给 LibreNMS 单独建一个 PHP-FPM 池。在/etc/php/8.3/fpm/pool.d/下新建librenms.conf[librenms] user librenms group librenms listen /run/php/php8.3-fpm-librenms.sock listen.owner www-data listen.group www-data listen.mode 0660 pm dynamic pm.max_children 50 pm.start_servers 5 pm.min_spare_servers 5 pm.max_spare_servers 20 pm.max_requests 500pm.max_children 50这个参数要根据服务器内存调整。每个 PHP-FPM 进程大约占用 30 到 80MB 内存如果服务器只有 2GB 内存建议改成 204GB 以上再开到 50。pm.max_requests 500是让每个 worker 处理 500 个请求后自动重启避免内存泄漏累积。随后把默认的 www.conf 停掉不然两个池同时监听可能冲突sudo mv /etc/php/8.3/fpm/pool.d/www.conf /etc/php/8.3/fpm/pool.d/www.conf.bak sudo systemctl restart php8.3-fpm同时Nginx 配置中的fastcgi_pass要改成新池的 socketfastcgi_pass unix:/run/php/php8.3-fpm-librenms.sock;改完重新nginx -t并 reload。4.3 SNMP 服务配置与 MIB 库启用LibreNMS 被称为网络监控工具SNMP 就是它的“眼睛”。监控设备时LibreNMS 作为 SNMP 客户端去请求设备上的 MIB 信息所以服务器本身的 snmpd 服务其实不是必须的但安装 snmp 命令行工具是必须的因为 LibreNMS 的 poller 会调用snmpget、snmpwalk这些命令。不过为了统一管理我一般还是把 snmpd 装好并启动它可以让这台服务器本身也作为网络设备被其他监控系统管理或者用于本机调试。重点在于启用标准 MIB 库编辑/etc/snmp/snmp.conf把下面这行注释掉或删除# mibs :默认情况下这个文件写了一行mibs :导致 snmp 工具不会加载系统 MIB 库执行 snmpwalk 时经常报“Unknown Object Identifier”。删掉这行后MIB 库才能正常加载。启动 snmpdsudo systemctl restart snmpd sudo systemctl enable snmpd5. 定时任务与日志轮转配置5.1 配置调度任务LibreNMS 的轮询poller发现discovery机制完全依赖 cron 定时任务驱动。poller 负责定时抓取设备的监控数据discovery 负责定期扫描网络发现新设备。这两个任务如果没配好监控数据就是断断续续的甚至完全没数据。官方推荐的最小配置如下*/5 * * * * librenms /opt/librenms/cronic /opt/librenms/poller.php /dev/null 21 */5 * * * * librenms /opt/librenms/cronic /opt/librenms/discovery.php /dev/null 21这里的cronic是 LibreNMS 自带的一个 shell 脚本作用是“只在命令真正出错时才输出日志”。这样做的好处是避免正常执行的轮询任务每次都往 cron 的邮件里刷日志出问题时又能及时暴露。把这两行写入系统的 crontabsudo crontab -u librenms -e第一次执行会让你选择编辑器我习惯选 nano 或 vim。粘贴上面的配置后保存退出。还有一个每日任务LibreNMS 用它来更新数据库结构、清理旧数据、更新地理信息等。官方提供了一段每日调度的脚本sudo cp /opt/librenms/misc/librenms.cron /etc/cron.d/librenms这个文件里已经写好了每日任务的配置包含daily.sh的调用。复制到/etc/cron.d/后 cron 会自动读取。注意检查一下文件里有没有0 0 * * *这种时间配置确保 daily 任务使用的是非高峰时段我习惯把时间改到凌晨 3 点以后避免影响白天的工作。5.2 日志轮转LibreNMS 运行一段时间后日志文件可能会很大。poller 日志、告警日志、还有 PHP 的错误日志如果不做轮转迟早占满磁盘。官方提供的 logrotate 配置可以直接复制使用sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms查看一下这个文件的内容确认日志路径是否和实际一致。默认情况下日志存放在/opt/librenms/logs/下如果目录不存在要先创建并设置权限sudo mkdir -p /opt/librenms/logs sudo chown -R librenms:librenms /opt/librenms/logs完成这一步整个程序的自动化框架就搭建好了接下来通过 Web 界面完成最后的初始化。6. Web 界面安装引导与设备接入6.1 首次访问与安装向导浏览器打开你配置的域名或 IP例如http://librenms.example.com。如果 Nginx、PHP-FPM、权限都配置正确你会看到 LibreNMS 的安装引导页面。第一步是检查环境。LibreNMS 会对 PHP 的扩展、目录权限、Composer 依赖做一系列自检。如果这里出现红色的“失败”项目最常见的原因是某些 PHP 扩展缺失或目录权限不正确。我见过最多的情况是/opt/librenms/logs和/opt/librenms/storage的属主不是 librenms导致写入失败。解决方法是回到终端重新执行sudo chown -R librenms:librenms /opt/librenms第二步是填写数据库信息。主机填localhost用户名和密码就是 3.3 节里创建的那个。填完点击检查连接看到绿色提示就说明数据库配置没问题。第三步是创建管理员账号。填一个邮箱和密码这个账号就是之后登录 LibreNMS 的超级管理员。建议邮箱填真实可用的因为 LibreNMS 告警通知和密码找回都用它。完成这三步后点击安装按钮系统会自动建表并写入初始配置。安装完成后会自动跳转到登录页面用刚创建的管理员账号登录进去就能看到 LibreNMS 的主界面了。6.2 添加第一台监控设备设备接入的方式有两种手动添加或者用自动发现。手动添加比较直接在顶部菜单点“设备”选择“添加设备”填写设备的主机名或 IP、SNMP 版本、团体名community string。如果设备支持 SNMP v2c团体名一般默认是public但生产环境强烈建议改成自定义字符串避免被外部扫描器探测到。填写完点“添加设备”LibreNMS 会立即发起一次 SNMP 探查。如果设备本身有响应它会在弹出的页面里显示出识别到的设备名称、型号、系统信息等。紧接着系统会自动触发发现任务把设备的所有接口、传感器、CPU 内存数据抓取进来。这个过程通常需要几分钟可以在“设备 - 所有设备”的列表里看到每条设备旁边有一个刷新旋转图标这是系统正在执行发现任务。等图标静止点进设备详情页就能看到完整的接口列表和流量图表了。自动发现功能更强大适合批量接入。在“自动发现”配置里设置好一个网段然后配置发现协议LibreNMS 支持 CDP、LLDP、OSPF、BGP 等协议的设备邻居关系发现系统就会定期扫描网段自动纳管新设备。这个功能在大型园区网络里很实用配好之后基本是“零干预”的。6.3 告警配置入门LibreNMS 的告警系统值得单独写一节但这里先做一个最基础的配置让你能收到第一条告警通知。在“告警 - 告警规则”里点击“创建告警规则”。常用的规则是监控设备状态规则条件devices.status 00 表示设备不可达告警名称设备离线严重级别紧急然后配置告警传输方式Alert Transport。LibreNMS 支持邮件、Slack、Webhook、Telegram 等。我用得最多的是邮件在“告警 - 告警传输”里添加一个邮件传输填好 SMTP 服务器、端口、认证信息、发件人和收件人。最后把告警规则和传输方式关联起来并设置“一秒内重复告警”等参数。注意 LibreNMS 默认启用告警抑制Alert Suppression比如维护窗口期间不发送告警这个功能需要花点时间研究。7. 常见问题与排查实录7.1 常见问题速查表以下问题都是在实际部署中高频出现的我整理成表格供你快速对照。现象可能原因解决措施安装向导环境检查失败目录权限错误sudo chown -R librenms:librenms /opt/librenms数据库连接失败数据库密码错误或用户权限不足重新执行 3.3 节的授权语句Nginx 页面 502 Bad GatewayPHP-FPM 未启动或 socket 路径不对检查php8.3-fpm状态核对 Nginx 中 fastcgi_pass 路径SNMP Walk 报 Unknown Object IdentifierMIB 库未启用编辑/etc/snmp/snmp.conf注释掉mibs :设备添加后无数据poller 定时任务未执行检查 librenms 用户 crontab 是否配置正确页面显示权限错误某些子目录属主不对执行sudo chown -R librenms:librenms /opt/librenms数据图表为空poller 运行报错查看/opt/librenms/logs/librenms.log和 poller 日志redis 相关报错部分高级功能需要 Redis按需安装redis-server并配置 config.php7.2 易踩的坑与避坑技巧第一个坑是 PHP-FPM 的 socket 权限。我在配置单独 PHP-FPM 池时经常遇到 Nginx 报 502排查了半天发现是 socket 文件的监听权限不对。Nginx 的 worker 进程以 www-data 用户运行而 PHP-FPM 创建的 socket 属主如果不包含 www-dataNginx 就无法连接。解决办法就是在 pool 配置文件里显式设置listen.owner www-data和listen.group www-data。第二个坑是 MariaDB 的 root 认证方式。Ubuntu 24.04 默认 root 走 unix_socket 认证用mysql -u root -p加密码登录会失败。网上不少教程写“执行 mysql_secure_installation 设置 root 密码”但没说明之后需要用sudo mysql登录。如果你设置了密码后无法登录直接用sudo mysql进去后执行ALTER USER rootlocalhost IDENTIFIED VIA mysql_native_password USING PASSWORD(你的新密码); FLUSH PRIVILEGES;这样 root 就同时支持 socket 认证和密码认证了。不过实际使用中LibreNMS 用的是独立账号root 认证方式不影响主流程。第三个坑是 LibreNMS 的目录权限问题反复出现。原因在于 LibrenMS 安装完成后后续通过 Web 界面安装应用、升级依赖时部分文件可能会被写入到 www-data 属主的临时目录。如果发现页面某些功能报“permission denied”优先检查/opt/librenms/storage下的缓存目录权限。最稳妥的做法是把采集相关的定时任务都用 librenms 用户执行且每次升级后重新执行一次chown -R librenms:librenms /opt/librenms。第四个经验是系统防火墙。Ubuntu 24.04 默认可能启用了 UFW 防火墙如果你发现 Web 页面打不开、设备 SNMP 请求不通先检查防火墙规则放行 80HTTP、443HTTPS、161/UDPSNMP端口sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 161/udp这里有个细节如果你要在监控服务器上安装 SNMP 客户端去轮询设备必须放行 161/UDP 的出方向但 UFW 默认出站是放行的所以实际只需要确认入站端口即可。第五个坑是 PHP 的内存限制。默认的memory_limit是 128M如果网络规模较大、设备数量很多poller 在执行过程中可能因为内存不足直接崩掉。建议把 PHP-FPM 和 CLI 的memory_limit提高到 512Mmemory_limit 512M同时别忘了改/etc/php/8.3/cli/php.ini里的同样参数因为 cron 任务走的是 CLI 模式不是 FPM 模式。7.3 排查思路实录以“添加设备后没有数据”为例我说一下完整的排查思路。第一步先确认 SNMP 是否真的能通。在服务器上手动执行 snmpwalk 测试注意要删除/etc/snmp/snmp.conf里 MIB 限制那一行后再跑snmpwalk -v2c -c public -On -t 5 192.168.1.1 system如果这条命令返回了系统信息说明网络层面和 SNMP 配置都没问题。如果超时检查设备那边的 SNMP 服务是否开启、团体名是否正确、防火墙是否放行。如果返回Timeout: No Response from继续排查路由和防火墙。第二步确认 poller 有没有被正常执行。可以手动跑一次sudo -u librenms /opt/librenms/poller.php -h 设备ID这里的设备 ID 是在设备列表页的 URL 里看到的数字。观察输出中有没有报错信息。如果提示 PHP 类找不到说明 Composer 依赖没装好重新执行composer_wrapper.php install --no-dev。第三步如果手动执行正常但定时任务没有生效检查 cron 服务是否在运行以及 crontab 的配置格式是否正确systemctl status cron crontab -u librenms -l我见过一个情况是/etc/cron.d/librenms里的 daily 任务覆盖了用户 crontab 的执行权限导致 poller 任务始终无法运行。解决办法是确保两个文件里的任务不冲突且 daily.sh 的执行时间避开 poller 的高峰。8. 性能优化与安全加固8.1 基础性能调优LibreNMS 默认配置在小型环境下没有问题但当设备数量超过 100 台时建议开启分布式轮询和 Redis 缓存。使用 Redis 作为缓存后端可以显著减少数据库的压力同时支持告警状态的实时缓存。安装并启动 Redissudo apt install -y redis-server sudo systemctl enable redis-server sudo systemctl start redis-server然后在/opt/librenms/config.php中加入$config[redis][enabled] true; $config[redis][host] 127.0.0.1; $config[redis][port] 6379; $config[redis][database] 0;同时建议开启“RRD 缓存”。LibreNMS 把监控数据用 RRDtool 存储如果设备数量大RRD 文件的写入会成为瓶颈。启用 rrdcached 可以显著提升性能但配置过程需要单独规划我建议先跑起来等确实遇到性能瓶颈再做这一步。另一个简单又有效的优化是把 poller 的执行间隔从 5 分钟改成 1 分钟。在 crontab 里把*/5改成*/1同时确保 Nginx 和 PHP-FPM 的并发处理能力足够。不过设备数量多的情况下1 分钟一轮重负载任务可能反而拖垮服务器务必根据实际压测来决定。8.2 安全加固四点建议第一务必启用 HTTPS。LibreNMS 默认走 HTTP登录凭据是明文传输的。建议用 certbot 配置 Lets Encrypt 证书或者在有域名的情况下直接开启自动续期sudo apt install -y certbot python3-certbot-nginx sudo certbot --nginx -d librenms.example.com第二禁用默认的admin账号展示。创建管理员账号时不要用admin这种名称也不要与其他系统共用密码。第三限制数据库连接来源。LibreNMS 数据库账号只允许 localhost 连接不要给远程访问权限。如果确实需要远程管理数据库通过 SSH 隧道访问更安全。第四关注官方安全公告。LibreNMS 社区会定期发布安全更新确保通过 Git 拉取的代码处于最新版本cd /opt/librenms sudo -u librenms git pull sudo -u librenms ./scripts/composer_wrapper.php install --no-dev sudo -u librenms php artisan migrate --force升级前记得备份数据库和配置文件我在升级时遇到过版本跨度大导致的数据库结构不兼容问题备份能让你随时回滚。9. 个人经验补充与扩展方向这次在 Ubuntu 24.04 上部署 LibreNMS 的过程中我最深的体会是官方文档永远比多数博客靠谱。虽然本文尽量覆盖了各种细节但不同环境下总会有出入。遇到问题优先查看/opt/librenms/logs/librenms.log和应用日志大部分线索都在日志里比盲目搜索强得多。如果你不只是想简单地监控设备在线状态建议研究一下 LibreNMS 的 API 接口配合 Grafana 仪表盘可以做出很漂亮的监控展示大屏。另外 LibreNMS 内置了非常丰富的应用检测模板比如可以自动发现 Cisco、Huawei、H3C 设备的端口流量、PoE 供电、光模块状态等指标这些能力都需要在实际接入设备之后慢慢挖掘但回报相当可观。最后再分享一个运维习惯把服务器的备份策略落在实处。LibreNMS 的数据库备份很简单定期 mysqldump 一份即可但很多人配好之后就忘了这回事。等哪天真出了故障你会发现一份可靠的备份比任何调优技巧都更有价值。 Ubuntu 24.04 部署 LibreNMS 网络监控平台完整指南
想在一台全新的 Ubuntu 24.04 服务器上把 LibreNMS 从零搭起来并且能稳定跑起来接设备这件事我前后折腾过好几轮。网上有不少教程但很多是拿 CentOS 或者旧版本 Ubuntu 写的照抄到 24.04 上经常会在 PHP 扩展、数据库认证、Nginx 配置这些地方卡住。这篇文章把我实际部署过程中踩过的坑、验证过的步骤和调整过的参数都整理出来照着做基本能一步到位。这套环境不挑设备只要网络设备支持 SNMP不管是交换机、路由器、防火墙还是服务器都能接入 LibreNMS 统一监控。对于网络工程师、运维人员或者正在搭建实验室环境学习网络监控的人来说这份指南可以直接帮你省掉反复试错的时间。1. 方案选型与整体设计思路1.1 为什么选 LibreNMS 而不是其他监控系统监控网络设备这件事市面上的选择其实不少。Zabbix 功能强但配置偏重Prometheus 生态好可对网络设备的原生支持不够直接而 LibreNMS 最核心的优势就是“自动发现”。只要给设备配上 SNMP community它就能自动识别设备类型、接口、CPU、内存、温度、流量等指标基本不用手动建模。对于网络设备这种“型号杂、数量多、指标标准”的场景这种自动化的效率提升是实打实的。另一个原因是它基于 PHP 和 MySQL部署门槛相对低整个系统的依赖链简单不像某些监控系统需要一堆中间件。而且 LibreNMS 的 Web 界面做得比较直观告警规则、图像报表、API 接口都有日常使用足够。加上它是 Observium 的开源分支社区活跃更新频率高Ubuntu 24.04 这种较新的系统上跑起来也没什么兼容性问题。1.2 Ubuntu 24.04 环境特点与组件选型Ubuntu 24.04 默认的软件源里PHP 版本是 8.3MariaDB 版本是 10.11这两个版本都在 LibreNMS 的支持范围内。相比旧版 Ubuntu 自带 PHP 7.4 的时代现在部署反而省事不需要额外添加第三方源来装新版 PHP。在 Web 服务器选型上我选择 Nginx 而不是 Apache。原因很简单LibreNMS 官方文档推荐 Nginx而且 Nginx 处理 PHP 请求的性能更好配置也清晰。PHP-FPM 是必须的Nginx 本身不处理 PHP需要把请求转发给 PHP-FPM 解析。数据库方面Ubuntu 24.04 默认 MariaDB 就够用没必要单独装 MySQLMariaDB 与 MySQL 完全兼容LibreNMS 官方也明确支持。2. 基础环境准备2.1 系统更新与基础软件包安装拿到一台全新的 Ubuntu 24.04 服务器第一件事就是把软件源索引更新到最新避免装到旧版本的包。这一步在任何教程里都是标配但我还是想提醒一句更新之后最好重启一下系统让内核也切换到最新状态尤其是刚装完系统的情况。sudo apt update sudo apt upgrade -y接着安装一些基础工具包括 Git用于拉取 LibreNMS 源码、curl测试 Web 接口、SNMP 相关的软件包。这里先把需要的东西统一装好后面就不会频繁切回终端补装软件。sudo apt install -y git curl wget snmp snmpd mib-downloader python3 python3-pip需要注意Ubuntu 24.04 安装 mib-downloader 后还需要手动启用标准 MIB 库否则 SNMP Walk 的时候会提示找不到 MIB 文件。后面的 SNMP 配置章节会详细说明。2.2 安装 PHP 8.3 及扩展组件LibreNMS 是基于 PHP 的所以 PHP 环境是整个系统正常运行的基础。Ubuntu 24.04 的默认软件源里已经有 PHP 8.3直接用 apt 安装即可。光装 PHP 本体不够LibreNMS 依赖一堆扩展包括数据库驱动、SNMP 支持、图像处理、XML 解析等。我建议一次性装完sudo apt install -y php8.3-cli php8.3-fpm php8.3-mysql php8.3-gd php8.3-snmp php8.3-curl php8.3-xml php8.3-mbstring php8.3-zip php8.3-intl这里有一个容易踩的坑网上很多教程会写php8.3-json但 PHP 8.0 之后 JSON 扩展已经是内置的不需要单独安装。装了反而可能报冲突或者根本找不到这个包。另外有些教程推荐安装php8.3-apcu做缓存生产环境确实建议安装可以显著提升性能sudo apt install -y php8.3-apcu装完后检查一下 PHP 版本和已加载的扩展确保没有遗漏。php -v php -m | grep -E snmp|mysql|gd|curl|xml|mbstring|zip2.3 安装配置 MariaDB 数据库数据库这边Ubuntu 24.04 默认源里的 MariaDB 版本是 10.11LibreNMS 要求 10.5 以上所以直接用系统的默认版本即可。sudo apt install -y mariadb-server安装完成后MariaDB 服务会自动启动。在 Ubuntu 上MariaDB 的 root 用户默认使用 unix_socket 认证也就是系统 root 用户直接登录数据库不需要密码。这个机制对于本地管理来说挺方便但配置 LibreNMS 时我们需要单独创建一个专用数据库用户。执行数据库安全配置脚本这一步建议做sudo mysql_secure_installation这个脚本会引导你设置 root 密码、删除匿名用户、禁止 root 远程登录等。需要注意的是在 Ubuntu 24.04 上执行时如果之前 root 是 socket 认证选择设置密码后可能需要调整认证方式否则可能出现“root 密码设了但无法登录”的情况。我的建议是安全脚本执行完先测试一下 root 能否正常登录sudo mysql -u root如果登录不了再用sudo mysqlsocket 认证进去修改认证方式。这个细节在生产环境很容易让人抓狂后面排查章节会再提到。2.4 配置 Nginx Web 服务器Nginx 的安装很简单重点是后面要给它安排一个虚拟主机配置把 LibreNMS 的域名解析到正确的目录并且把 PHP 请求转发给 PHP-FPM。sudo apt install -y nginx安装完先启动服务确认默认页面能访问再进行后续配置sudo systemctl start nginx sudo systemctl enable nginx理论上到这里基础环境已经就绪PHP 8.3 MariaDB 10.11 Nginx一个标准的 LNMP 环境。但先别急着配置虚拟主机我们要先把 LibreNMS 的程序文件部署到位再根据实际目录来写 Nginx 配置。3. LibreNMS 核心部署与初始化配置3.1 创建系统用户并下载源码LibreNMS 官方推荐的做法是安装在/opt/librenms目录下并创建一个独立的系统用户来运行 poller 和 discovery 等定时任务。这样做的好处是权限隔离即使某个 PHP 脚本被攻破攻击者拿到的也只是这个受限用户的权限而不是 root 权限。sudo useradd -r -M -d /opt/librenms -s /bin/bash librenms这条命令的参数含义-r创建系统用户UID 范围在系统区-M不自动创建家目录我们指定为 /opt/librenms-d指定家目录-s指定登录 shell。注意要让这个用户能执行 PHP 脚本必须给它一个可用的 shell/bin/false会导致后续 cron 任务异常。接着拉取源码cd /opt sudo git clone https://github.com/librenms/librenms.git sudo chown -R librenms:librenms /opt/librenmsGit 拉取可能需要一些时间服务器网络状况好的话一般一两分钟就完成了。拉完之后把目录属主改成 librenms 用户这一步不能省否则后面 PHP-FPM 执行脚本时会因为权限不足报错。3.2 安装 PHP 依赖与配置 config.phpLibreNMS 使用 Composer 管理 PHP 依赖包。我们不需要单独安装 ComposerLibreNMS 自带了一个封装脚本自动处理 Composer 的下载和升级cd /opt/librenms sudo -u librenms ./scripts/composer_wrapper.php install --no-dev这个过程会下载很多依赖包耗时取决于服务器和网络情况一般 3 到 10 分钟。执行完后检查一下 vendor 目录是否生成ls -la /opt/librenms/vendor如果有autoload.php文件说明依赖安装成功。接着创建 LibreNMS 的配置文件。新版 LibreNMS 支持在 Web 界面中完成安装引导但也可以在命令行先手动创建config.php这样 Web 安装时会直接读取少走一步流程sudo cp /opt/librenms/config.php.default /opt/librenms/config.php sudo chown librenms:librenms /opt/librenms/config.php3.3 创建数据库与专用账号回到 MariaDB 命令行为 LibreNMS 创建数据库和用户。这里建议给用户设置一个强度足够的密码避免被轻易破解sudo mysql -u root进入 MariaDB 命令行后依次执行CREATE DATABASE librenms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER librenmslocalhost IDENTIFIED BY 你的强密码; GRANT ALL PRIVILEGES ON librenms.* TO librenmslocalhost; FLUSH PRIVILEGES; EXIT;这里有一个很关键的细节数据库字符集必须使用utf8mb4因为 LibreNMS 存储设备描述等文本时可能包含特殊字符utf8mb4对 emoji 和生僻字的支持更好。采用utf8mb4_unicode_ci排序规则也是官方文档推荐的做法。接着把数据库连接信息写入 LibreNMS 的配置文件。编辑/opt/librenms/config.php在文件末尾加上$config[db_host] localhost; $config[db_user] librenms; $config[db_pass] 你的强密码; $config[db_name] librenms;保存后顺手设置一下 PHP 的时区避免后续监控数据的时间戳全部偏移。编辑/etc/php/8.3/fpm/php.ini和/etc/php/8.3/cli/php.ini找到date.timezone取消注释并设置date.timezone Asia/Shanghai改完记得重启 PHP-FPM 让它生效这一步可以先等 Nginx 配置完成后再一起重启反正后面还有改动。4. Web 服务器与 PHP-FPM 核心配置4.1 Nginx 虚拟主机配置LibreNMS 官方文档提供了一份可直接套用的 Nginx 配置里面把缓存、伪静态、PHP 转发都处理好了。我建议直接基于这份配置修改不要自己从零写否则容易漏掉一些安全相关的 location 规则。在/etc/nginx/sites-available/下创建虚拟主机配置文件推荐命名为librenms.confserver { listen 80; server_name librenms.example.com; # 改成你的实际域名或IP root /opt/librenms/html; index index.php; charset utf-8; gzip on; gzip_types text/css application/javascript text/javascript application/x-javascript image/svgxml text/plain application/xml application/json; location / { try_files $uri $uri/ librenms; } location ~ ^/(build/|poller/|includes/|tests/|docs/|vendor/|routes/|misc/) { deny all; } location ~ \.php(?:$|/) { fastcgi_split_path_info ^(.\.php)(/.)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass unix:/run/php/php8.3-fpm.sock; fastcgi_index index.php; } }这份配置里有几个关键的 location 块。第一个location /配合try_files实现前端路由的重写LibreNMS 的页面跳转依赖这个。第二个location是安全屏蔽规则把 build、poller、includes、vendor 这些目录屏蔽掉防止外部直接访问源码文件。第三个是 PHP 解析把.php请求交给 PHP-FPM注意fastcgi_pass指向的 socket 路径必须和 PHP-FPM 的监听地址一致。启用站点并重载 Nginxsudo ln -s /etc/nginx/sites-available/librenms.conf /etc/nginx/sites-enabled/librenms.conf sudo nginx -t sudo systemctl reload nginx如果nginx -t报错说明配置语法有问题根据提示修改即可。最常见的问题是 server_name 里带了特殊字符或者少了分号。4.2 PHP-FPM 池配置PHP-FPM 默认的 www.conf 在 LibreNMS 场景下需要做一些调整。最关键的一点是librenms 用户要有权限执行 PHP 脚本所以 PHP-FPM 进程的用户需要改成 librenms或者把 socket 的属主设为 www-data 让 Nginx 能访问。我的做法是给 LibreNMS 单独建一个 PHP-FPM 池。在/etc/php/8.3/fpm/pool.d/下新建librenms.conf[librenms] user librenms group librenms listen /run/php/php8.3-fpm-librenms.sock listen.owner www-data listen.group www-data listen.mode 0660 pm dynamic pm.max_children 50 pm.start_servers 5 pm.min_spare_servers 5 pm.max_spare_servers 20 pm.max_requests 500pm.max_children 50这个参数要根据服务器内存调整。每个 PHP-FPM 进程大约占用 30 到 80MB 内存如果服务器只有 2GB 内存建议改成 204GB 以上再开到 50。pm.max_requests 500是让每个 worker 处理 500 个请求后自动重启避免内存泄漏累积。随后把默认的 www.conf 停掉不然两个池同时监听可能冲突sudo mv /etc/php/8.3/fpm/pool.d/www.conf /etc/php/8.3/fpm/pool.d/www.conf.bak sudo systemctl restart php8.3-fpm同时Nginx 配置中的fastcgi_pass要改成新池的 socketfastcgi_pass unix:/run/php/php8.3-fpm-librenms.sock;改完重新nginx -t并 reload。4.3 SNMP 服务配置与 MIB 库启用LibreNMS 被称为网络监控工具SNMP 就是它的“眼睛”。监控设备时LibreNMS 作为 SNMP 客户端去请求设备上的 MIB 信息所以服务器本身的 snmpd 服务其实不是必须的但安装 snmp 命令行工具是必须的因为 LibreNMS 的 poller 会调用snmpget、snmpwalk这些命令。不过为了统一管理我一般还是把 snmpd 装好并启动它可以让这台服务器本身也作为网络设备被其他监控系统管理或者用于本机调试。重点在于启用标准 MIB 库编辑/etc/snmp/snmp.conf把下面这行注释掉或删除# mibs :默认情况下这个文件写了一行mibs :导致 snmp 工具不会加载系统 MIB 库执行 snmpwalk 时经常报“Unknown Object Identifier”。删掉这行后MIB 库才能正常加载。启动 snmpdsudo systemctl restart snmpd sudo systemctl enable snmpd5. 定时任务与日志轮转配置5.1 配置调度任务LibreNMS 的轮询poller发现discovery机制完全依赖 cron 定时任务驱动。poller 负责定时抓取设备的监控数据discovery 负责定期扫描网络发现新设备。这两个任务如果没配好监控数据就是断断续续的甚至完全没数据。官方推荐的最小配置如下*/5 * * * * librenms /opt/librenms/cronic /opt/librenms/poller.php /dev/null 21 */5 * * * * librenms /opt/librenms/cronic /opt/librenms/discovery.php /dev/null 21这里的cronic是 LibreNMS 自带的一个 shell 脚本作用是“只在命令真正出错时才输出日志”。这样做的好处是避免正常执行的轮询任务每次都往 cron 的邮件里刷日志出问题时又能及时暴露。把这两行写入系统的 crontabsudo crontab -u librenms -e第一次执行会让你选择编辑器我习惯选 nano 或 vim。粘贴上面的配置后保存退出。还有一个每日任务LibreNMS 用它来更新数据库结构、清理旧数据、更新地理信息等。官方提供了一段每日调度的脚本sudo cp /opt/librenms/misc/librenms.cron /etc/cron.d/librenms这个文件里已经写好了每日任务的配置包含daily.sh的调用。复制到/etc/cron.d/后 cron 会自动读取。注意检查一下文件里有没有0 0 * * *这种时间配置确保 daily 任务使用的是非高峰时段我习惯把时间改到凌晨 3 点以后避免影响白天的工作。5.2 日志轮转LibreNMS 运行一段时间后日志文件可能会很大。poller 日志、告警日志、还有 PHP 的错误日志如果不做轮转迟早占满磁盘。官方提供的 logrotate 配置可以直接复制使用sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms查看一下这个文件的内容确认日志路径是否和实际一致。默认情况下日志存放在/opt/librenms/logs/下如果目录不存在要先创建并设置权限sudo mkdir -p /opt/librenms/logs sudo chown -R librenms:librenms /opt/librenms/logs完成这一步整个程序的自动化框架就搭建好了接下来通过 Web 界面完成最后的初始化。6. Web 界面安装引导与设备接入6.1 首次访问与安装向导浏览器打开你配置的域名或 IP例如http://librenms.example.com。如果 Nginx、PHP-FPM、权限都配置正确你会看到 LibreNMS 的安装引导页面。第一步是检查环境。LibreNMS 会对 PHP 的扩展、目录权限、Composer 依赖做一系列自检。如果这里出现红色的“失败”项目最常见的原因是某些 PHP 扩展缺失或目录权限不正确。我见过最多的情况是/opt/librenms/logs和/opt/librenms/storage的属主不是 librenms导致写入失败。解决方法是回到终端重新执行sudo chown -R librenms:librenms /opt/librenms第二步是填写数据库信息。主机填localhost用户名和密码就是 3.3 节里创建的那个。填完点击检查连接看到绿色提示就说明数据库配置没问题。第三步是创建管理员账号。填一个邮箱和密码这个账号就是之后登录 LibreNMS 的超级管理员。建议邮箱填真实可用的因为 LibreNMS 告警通知和密码找回都用它。完成这三步后点击安装按钮系统会自动建表并写入初始配置。安装完成后会自动跳转到登录页面用刚创建的管理员账号登录进去就能看到 LibreNMS 的主界面了。6.2 添加第一台监控设备设备接入的方式有两种手动添加或者用自动发现。手动添加比较直接在顶部菜单点“设备”选择“添加设备”填写设备的主机名或 IP、SNMP 版本、团体名community string。如果设备支持 SNMP v2c团体名一般默认是public但生产环境强烈建议改成自定义字符串避免被外部扫描器探测到。填写完点“添加设备”LibreNMS 会立即发起一次 SNMP 探查。如果设备本身有响应它会在弹出的页面里显示出识别到的设备名称、型号、系统信息等。紧接着系统会自动触发发现任务把设备的所有接口、传感器、CPU 内存数据抓取进来。这个过程通常需要几分钟可以在“设备 - 所有设备”的列表里看到每条设备旁边有一个刷新旋转图标这是系统正在执行发现任务。等图标静止点进设备详情页就能看到完整的接口列表和流量图表了。自动发现功能更强大适合批量接入。在“自动发现”配置里设置好一个网段然后配置发现协议LibreNMS 支持 CDP、LLDP、OSPF、BGP 等协议的设备邻居关系发现系统就会定期扫描网段自动纳管新设备。这个功能在大型园区网络里很实用配好之后基本是“零干预”的。6.3 告警配置入门LibreNMS 的告警系统值得单独写一节但这里先做一个最基础的配置让你能收到第一条告警通知。在“告警 - 告警规则”里点击“创建告警规则”。常用的规则是监控设备状态规则条件devices.status 00 表示设备不可达告警名称设备离线严重级别紧急然后配置告警传输方式Alert Transport。LibreNMS 支持邮件、Slack、Webhook、Telegram 等。我用得最多的是邮件在“告警 - 告警传输”里添加一个邮件传输填好 SMTP 服务器、端口、认证信息、发件人和收件人。最后把告警规则和传输方式关联起来并设置“一秒内重复告警”等参数。注意 LibreNMS 默认启用告警抑制Alert Suppression比如维护窗口期间不发送告警这个功能需要花点时间研究。7. 常见问题与排查实录7.1 常见问题速查表以下问题都是在实际部署中高频出现的我整理成表格供你快速对照。现象可能原因解决措施安装向导环境检查失败目录权限错误sudo chown -R librenms:librenms /opt/librenms数据库连接失败数据库密码错误或用户权限不足重新执行 3.3 节的授权语句Nginx 页面 502 Bad GatewayPHP-FPM 未启动或 socket 路径不对检查php8.3-fpm状态核对 Nginx 中 fastcgi_pass 路径SNMP Walk 报 Unknown Object IdentifierMIB 库未启用编辑/etc/snmp/snmp.conf注释掉mibs :设备添加后无数据poller 定时任务未执行检查 librenms 用户 crontab 是否配置正确页面显示权限错误某些子目录属主不对执行sudo chown -R librenms:librenms /opt/librenms数据图表为空poller 运行报错查看/opt/librenms/logs/librenms.log和 poller 日志redis 相关报错部分高级功能需要 Redis按需安装redis-server并配置 config.php7.2 易踩的坑与避坑技巧第一个坑是 PHP-FPM 的 socket 权限。我在配置单独 PHP-FPM 池时经常遇到 Nginx 报 502排查了半天发现是 socket 文件的监听权限不对。Nginx 的 worker 进程以 www-data 用户运行而 PHP-FPM 创建的 socket 属主如果不包含 www-dataNginx 就无法连接。解决办法就是在 pool 配置文件里显式设置listen.owner www-data和listen.group www-data。第二个坑是 MariaDB 的 root 认证方式。Ubuntu 24.04 默认 root 走 unix_socket 认证用mysql -u root -p加密码登录会失败。网上不少教程写“执行 mysql_secure_installation 设置 root 密码”但没说明之后需要用sudo mysql登录。如果你设置了密码后无法登录直接用sudo mysql进去后执行ALTER USER rootlocalhost IDENTIFIED VIA mysql_native_password USING PASSWORD(你的新密码); FLUSH PRIVILEGES;这样 root 就同时支持 socket 认证和密码认证了。不过实际使用中LibreNMS 用的是独立账号root 认证方式不影响主流程。第三个坑是 LibreNMS 的目录权限问题反复出现。原因在于 LibrenMS 安装完成后后续通过 Web 界面安装应用、升级依赖时部分文件可能会被写入到 www-data 属主的临时目录。如果发现页面某些功能报“permission denied”优先检查/opt/librenms/storage下的缓存目录权限。最稳妥的做法是把采集相关的定时任务都用 librenms 用户执行且每次升级后重新执行一次chown -R librenms:librenms /opt/librenms。第四个经验是系统防火墙。Ubuntu 24.04 默认可能启用了 UFW 防火墙如果你发现 Web 页面打不开、设备 SNMP 请求不通先检查防火墙规则放行 80HTTP、443HTTPS、161/UDPSNMP端口sudo ufw allow 80/tcp sudo ufw allow 443/tcp sudo ufw allow 161/udp这里有个细节如果你要在监控服务器上安装 SNMP 客户端去轮询设备必须放行 161/UDP 的出方向但 UFW 默认出站是放行的所以实际只需要确认入站端口即可。第五个坑是 PHP 的内存限制。默认的memory_limit是 128M如果网络规模较大、设备数量很多poller 在执行过程中可能因为内存不足直接崩掉。建议把 PHP-FPM 和 CLI 的memory_limit提高到 512Mmemory_limit 512M同时别忘了改/etc/php/8.3/cli/php.ini里的同样参数因为 cron 任务走的是 CLI 模式不是 FPM 模式。7.3 排查思路实录以“添加设备后没有数据”为例我说一下完整的排查思路。第一步先确认 SNMP 是否真的能通。在服务器上手动执行 snmpwalk 测试注意要删除/etc/snmp/snmp.conf里 MIB 限制那一行后再跑snmpwalk -v2c -c public -On -t 5 192.168.1.1 system如果这条命令返回了系统信息说明网络层面和 SNMP 配置都没问题。如果超时检查设备那边的 SNMP 服务是否开启、团体名是否正确、防火墙是否放行。如果返回Timeout: No Response from继续排查路由和防火墙。第二步确认 poller 有没有被正常执行。可以手动跑一次sudo -u librenms /opt/librenms/poller.php -h 设备ID这里的设备 ID 是在设备列表页的 URL 里看到的数字。观察输出中有没有报错信息。如果提示 PHP 类找不到说明 Composer 依赖没装好重新执行composer_wrapper.php install --no-dev。第三步如果手动执行正常但定时任务没有生效检查 cron 服务是否在运行以及 crontab 的配置格式是否正确systemctl status cron crontab -u librenms -l我见过一个情况是/etc/cron.d/librenms里的 daily 任务覆盖了用户 crontab 的执行权限导致 poller 任务始终无法运行。解决办法是确保两个文件里的任务不冲突且 daily.sh 的执行时间避开 poller 的高峰。8. 性能优化与安全加固8.1 基础性能调优LibreNMS 默认配置在小型环境下没有问题但当设备数量超过 100 台时建议开启分布式轮询和 Redis 缓存。使用 Redis 作为缓存后端可以显著减少数据库的压力同时支持告警状态的实时缓存。安装并启动 Redissudo apt install -y redis-server sudo systemctl enable redis-server sudo systemctl start redis-server然后在/opt/librenms/config.php中加入$config[redis][enabled] true; $config[redis][host] 127.0.0.1; $config[redis][port] 6379; $config[redis][database] 0;同时建议开启“RRD 缓存”。LibreNMS 把监控数据用 RRDtool 存储如果设备数量大RRD 文件的写入会成为瓶颈。启用 rrdcached 可以显著提升性能但配置过程需要单独规划我建议先跑起来等确实遇到性能瓶颈再做这一步。另一个简单又有效的优化是把 poller 的执行间隔从 5 分钟改成 1 分钟。在 crontab 里把*/5改成*/1同时确保 Nginx 和 PHP-FPM 的并发处理能力足够。不过设备数量多的情况下1 分钟一轮重负载任务可能反而拖垮服务器务必根据实际压测来决定。8.2 安全加固四点建议第一务必启用 HTTPS。LibreNMS 默认走 HTTP登录凭据是明文传输的。建议用 certbot 配置 Lets Encrypt 证书或者在有域名的情况下直接开启自动续期sudo apt install -y certbot python3-certbot-nginx sudo certbot --nginx -d librenms.example.com第二禁用默认的admin账号展示。创建管理员账号时不要用admin这种名称也不要与其他系统共用密码。第三限制数据库连接来源。LibreNMS 数据库账号只允许 localhost 连接不要给远程访问权限。如果确实需要远程管理数据库通过 SSH 隧道访问更安全。第四关注官方安全公告。LibreNMS 社区会定期发布安全更新确保通过 Git 拉取的代码处于最新版本cd /opt/librenms sudo -u librenms git pull sudo -u librenms ./scripts/composer_wrapper.php install --no-dev sudo -u librenms php artisan migrate --force升级前记得备份数据库和配置文件我在升级时遇到过版本跨度大导致的数据库结构不兼容问题备份能让你随时回滚。9. 个人经验补充与扩展方向这次在 Ubuntu 24.04 上部署 LibreNMS 的过程中我最深的体会是官方文档永远比多数博客靠谱。虽然本文尽量覆盖了各种细节但不同环境下总会有出入。遇到问题优先查看/opt/librenms/logs/librenms.log和应用日志大部分线索都在日志里比盲目搜索强得多。如果你不只是想简单地监控设备在线状态建议研究一下 LibreNMS 的 API 接口配合 Grafana 仪表盘可以做出很漂亮的监控展示大屏。另外 LibreNMS 内置了非常丰富的应用检测模板比如可以自动发现 Cisco、Huawei、H3C 设备的端口流量、PoE 供电、光模块状态等指标这些能力都需要在实际接入设备之后慢慢挖掘但回报相当可观。最后再分享一个运维习惯把服务器的备份策略落在实处。LibreNMS 的数据库备份很简单定期 mysqldump 一份即可但很多人配好之后就忘了这回事。等哪天真出了故障你会发现一份可靠的备份比任何调优技巧都更有价值。