====== 在 K3s 環境透過 Rancher 建立 LibreNMS ====== * 採用 K3s 環境已經定義好的 * ingress + tls Exp. [[https://www.ichiayi.com/tech/k3s#%E5%A6%82%E4%BD%95%E5%BB%BA%E7%AB%8B%E7%B5%A6%E5%85%B6%E4%BB%96%E6%9C%8D%E5%8B%99%E9%80%9A%E7%94%A8%E7%9A%84_ssl_%E6%86%91%E8%AD%89|nms.k3s.ichiayi.com]] * nfs storage Exp. [[https://www.ichiayi.com/tech/k3s#storage_%E8%A8%AD%E5%AE%9A|nfs-client]] * 使用[[https://github.com/librenms/helm-charts|官方提供的 helm chart]] 進行安裝配置 ===== 安裝程序 ===== - 加入 helm repo helm repo add librenms https://www.librenms.org/helm-charts helm repo update - 產生 namespace 與所需要的帳號密碼, 可下載這 script 執行後自動產生 {{repo>https://raw.githubusercontent.com/tryweb/k3s/refs/heads/main/charts/librenms/scripts/create-secrets.sh}} - 設定配置檔, 可下載這 values-custom.yaml 來修改成自己需要的內容 {{repo>https://raw.githubusercontent.com/tryweb/k3s/refs/heads/main/charts/librenms/values-custom.yaml}} - 執行安裝 helm install librenms -f values-custom.yaml librenms/librenms -n librenms * 如果安裝後要調整參數(修改 values-custom.yaml), 需要修改後執行 helm upgrade helm upgrade librenms -f values-custom.yaml librenms/librenms -n librenms - 進入 Librenms 網頁 Exp. https://nms.k3s.ichiayi.com * 第一次進入網頁會轉到 install 設定頁面, 建立管理者帳號與密碼 ===== FAQ ===== ==== 1. 如果無法使用預設帳號密碼登入 ==== - 找到 frontend 的 pod（或任意一個 librenms pod 都可以） - 在容器內部執行建立帳號指令 php /opt/librenms/artisan user:add admin \ --password=librenms \ --email=admin@example.com \ --role=admin * {{:tech:k3s:螢幕擷取畫面_2025-11-27_182245.png|}} ==== 2. 啟用 Auto Discovery 功能出現 Error: lnms must not run as root. 狀況 ==== 已經在 [[https://github.com/librenms/helm-charts/releases/tag/librenms-6.1.0|heml chart librenms-6.1.0 版]]解決這問題 * 透過修改 librenms-values.yaml 內加入 librenms: : snmp_scanner: enabled: true # 啟用此項 cron: "*/15 * * * *" # 每 15 分鐘執行 resources: requests: cpu: 200m memory: 256Mi securityContext: runAsUser: 1000 runAsGroup: 1000 fsGroup: 1000 : 執行 helm upgrade 讓修改生效 helm upgrade librenms -f values-custom.yaml librenms/librenms -n librenms ==== 3. 列出目前所有的 librenms helm chart 版本 ==== * helm search repo librenms/librenms -l * ++看目前列出結果| jonathan@k3s-master-171:~$ helm search repo librenms/librenms -l NAME CHART VERSION APP VERSION DESCRIPTION librenms/librenms 7.0.1 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 7.0.0 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 6.1.0 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 6.0.1 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 6.0.0 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.2.0 25.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.1.1 25.9.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.1.0 25.9.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.13 25.9.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.12 25.9.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.11 25.8.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.10 25.8.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.9 25.7.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.8 25.7.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.7 25.7.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.6 25.7.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.5 25.6.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.4 25.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.3 25.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.2 25.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.1 25.4.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 5.0.0 25.4.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 4.0.3 25.4.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 4.0.2 25.3.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 4.0.1 25.3.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 4.0.0 25.3.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.19.0 25.2.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.18.0 24.12.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.17.0 24.11.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.16.0 24.10.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.15.0 24.8.1 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.14.0 24.6.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.13.1 24.6.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.12.0 24.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.11.1 24.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.10.0 24.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.9.0 24.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... librenms/librenms 3.8.0 24.5.0 LibreNMS is an autodiscovering PHP/MySQL-based ... ++ ===== 參考網址 ===== * https://github.com/tryweb/k3s/blob/main/charts/librenms/README.md {{tag>librenms k3s}}