LibreNMS是一套免費開源的網管軟體,使用Docker可以做到快速部署。
但是!LibreNMS的網路上教學以及官方文件都是基於Linux去撰寫。
Windows跟Linux在於檔案路徑上有很大的差異,以及LibreNMS的官網部署並不會帶入基本範例配置,所以導致LibreNMS無法順利按步驟啟動。
本文將會撰寫一篇初學者都能部署出來的步驟。
關鍵概念
- Windows環境與Linux環境有差別,尤其是檔案系統,體現在檔案路徑上。
- 官方文件教學步驟並未帶有基本配置文件,導致無法順利啟用。
以下將會使用官方教學步驟,加上一些調整,讓LibreNMS可以透過Docker在Windows OS下部署出來。
前置步驟
以下兩個前置步驟,只需要透過搜尋,下載安裝檔並且安裝,啟用就可以使用。
安裝Git
安裝Docker Desktop
步驟一:下載LiberNMS檔案
# 使用Git複製LibreNMS檔案
git clone https://github.com/librenms/docker.git docker-librenms
cd docker-librenms
# Build image and output to docker (default)
docker buildx bake
# Build multi-platform image
docker buildx bake image-all
步驟二:下載範例配置檔案
https://github.com/librenms/docker/tree/master/examples/compose
從以上的連結,也就是官方Github項目中的範例配置。
下載四個檔案,並且放入docker-librenms的資料夾中。 ※注意.env下載後,可能需要手動改回檔名。
這檔案是docker建立compose時會讀取的檔案,因此使用字元提示命令時,需要在先切到docker-librenms的資料夾。


步驟三:調整docker-compose.yml
在docker-compose.yml中,將「–lower-case-table-names=0」改成如圖「–lower-case-table-names=1」。
因為Windows檔案系統的路徑問題,會使得mariadb依照範例配置會無法啟動,然後導致LibreNMS無法順利運作。

步驟四:Docker創建並啟動容器
字元提示命令(CMD)路徑仍在docker-librenms資料夾中,輸入以下指令:
docker compose up -d
docker compose up -d 指令主要用途為:
• 啟動服務:根據 docker-compose.yml 配置檔建立、啟動與連結所有定義的容器服務。
• 背景執行:-d 參數(detached mode)使得容器在背景運行,不會佔用當前命令行介面。
過一陣子,就能從Docker Desktop中看到LibreNMS啟動,展開librenms,如果其下所有container都順利運行,就能透過瀏覽器並在網址列輸入「localhost:8000」或是「<ipaddr>:8000」連到LiberNMS並開始使用。

完成部署
透過以上的部署步驟。
初始化登入LibreNMS後,也能順利添加設備,使用SNMP獲取遭遇想嗯。
