在Windows上使用Docker部署LibreNMS

LibreNMS是一套免費開源的網管軟體,使用Docker可以做到快速部署。

但是!LibreNMS的網路上教學以及官方文件都是基於Linux去撰寫。

Windows跟Linux在於檔案路徑上有很大的差異,以及LibreNMS的官網部署並不會帶入基本範例配置,所以導致LibreNMS無法順利按步驟啟動。

本文將會撰寫一篇初學者都能部署出來的步驟。

關鍵概念

  • Windows環境與Linux環境有差別,尤其是檔案系統,體現在檔案路徑上。
  • 官方文件教學步驟並未帶有基本配置文件,導致無法順利啟用。

以下將會使用官方教學步驟,加上一些調整,讓LibreNMS可以透過Docker在Windows OS下部署出來。

前置步驟

以下兩個前置步驟,只需要透過搜尋,下載安裝檔並且安裝,啟用就可以使用。

安裝Git

Git官方網站

安裝Docker Desktop

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並開始使用。

預設為8000 port,而筆者改成8001

完成部署

透過以上的部署步驟。

初始化登入LibreNMS後,也能順利添加設備,使用SNMP獲取遭遇想嗯。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *