So installieren Sie NetBox IRM (Infrastructure Resource Modelling Tool) auf Ubuntu 24.04 Server

NetBox ist ein Infrastructure Resource Modelling (IRM), das für die Netzwerkautomatisierung und Infrastrukturtechnik entwickelt wurde. Ursprünglich wurde es vom DigitalOcean-Team erstellt und ist jetzt ein Open-Source-Projekt, das unter der Apache 2 Lizenz veröffentlicht wurde.

NetBox wurde im Python Django Web-Framework mit PostgreSQL als Standarddatenbank erstellt, und die Installation von NetBox ist ziemlich ähnlich wie bei anderen Python Django-Webanwendungen.

Dieses Tutorial zeigt Ihnen, wie Sie Netbox IRM auf dem Ubuntu 24.04-Server mit PostgreSQL als Datenbank und Apache als Reverse-Proxy installieren. Sie werden Netbox auch mit HTTPS über Certbot und Letsencrypt sichern.

Voraussetzungen

Bevor Sie fortfahren, stellen Sie sicher, dass Sie Folgendes haben:

Einen Ubuntu 24.04-Server
Einen Nicht-Root-Benutzer mit Administratorrechten
Einen Domainnamen, der auf die Server-IP-Adresse zeigt

Abhängigkeiten installieren

Um Netbox zu installieren, müssen Sie sicherstellen, dass die Abhängigkeiten auf Ihrem Ubuntu-Server installiert sind. Dazu gehören Python3, PostgreSQL-Server, Apache-Webserver, Redis und Systembibliotheken. In diesem Abschnitt installieren Sie diese Pakete mit dem APT-Paketmanager.

Zuerst führen Sie den folgenden Befehl aus, um Ihr Ubuntu-Paket-Index zu aktualisieren.

sudo apt update

Sobald das Update abgeschlossen ist, installieren Sie die Abhängigkeiten für Netbox mit dem folgenden Befehl. In diesem Beispiel installieren Sie PostgreSQL, Apache, Python, Redis, Certbot, Build-Abhängigkeiten und einige Bibliotheken.

sudo apt install apache2 postgresql postgresql-common libpq-dev redis-server git certbot python3 python3-pip python3-venv python3-dev build-essential libxml2-dev libxslt1-dev libffi-dev libssl-dev zlib1g-dev

Geben Sie ‘ Y ‘ ein, um die Installation zu bestätigen.

install deps

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden ‘systemctl’-Befehl aus, um den Status des Apache-Webservers zu überprüfen.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Im folgenden Output können Sie sehen, dass Apache läuft und aktiviert ist.

check apache2

Überprüfen Sie zuletzt den Status des PostgreSQL-Servers mit dem folgenden:

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Im folgenden Output können Sie sehen, dass PostgreSQL aktiviert und mit dem Status exited (systemd kann den Dienst nicht überwachen) läuft.

check service postgresql

PostgreSQL einrichten

Nachdem die Abhängigkeiten installiert sind, müssen Sie den PostgreSQL-Server einrichten, indem Sie einen neuen Benutzer und eine Datenbank erstellen, die Netbox verwenden wird.

Melden Sie sich mit dem folgenden Befehl beim PostgreSQL-Server an.

sudo -u postgres psql

Führen Sie nun die folgenden Abfragen aus, um einen neuen Benutzer ‘ netbox ‘ mit dem Passwort ‘ netboxpassword ‘ und die neue Datenbank ‘ netboxdb ‘ zu erstellen.

CREATE USER netbox LOGIN CREATEDB PASSWORD 'netboxpassword';  
CREATE DATABASE netboxdb OWNER netbox;

Sobald die Datenbank und der Benutzer erstellt sind, überprüfen Sie die Liste der Datenbanken und Benutzer in PostgreSQL mit dem folgenden Befehl.

\l  
\du

Sie können unten sehen, dass die Datenbank ‘ netboxdb ‘ und der Benutzer ‘ netbox ‘ erstellt wurden.

Geben Sie ‘ quit ‘ ein, um den PostgreSQL-Server zu verlassen.

list databases

list users

Netbox herunterladen und konfigurieren

Jetzt, da die PostgreSQL-Datenbank bereit ist, werden Sie Netbox auf Ihrem Ubuntu-Rechner herunterladen und installieren. Sie werden den Domainnamen, den geheimen Schlüssel und die Datenbank für Netbox einrichten.

Zuerst führen Sie den folgenden Befehl aus, um einen neuen Benutzer ‘netbox’ auf Ihrem Ubuntu-Rechner zu erstellen.

sudo useradd -r -d /opt/netbox -s /usr/sbin/nologin netbox

Führen Sie nun den folgenden Befehl aus, um den Quellcode von Netbox mit dem ‘ git ‘ Befehl herunterzuladen und den Besitz auf den ‘ netbox ‘ Benutzer zu ändern.

sudo git clone -b master --depth 1 https://github.com/netbox-community/netbox.git /opt/netbox  
sudo chown -R netbox:netbox /opt/netbox

Wechseln Sie in das ‘ /opt/netbox/netbox/netbox ‘ Verzeichnis und führen Sie die Datei ‘ generate_secret_key.py ‘ aus. Kopieren Sie den geheimen Schlüssel in Ihre Notizen.

cd /opt/netbox/netbox/netbox  
sudo -u netbox python3 ../generate_secret_key.py

Kopieren Sie als Nächstes die Datei ‘ configuration.py ‘ und ändern Sie sie mit dem ‘ nano ‘ Editor.

sudo -u netbox cp configuration_example.py configuration.py  
sudo -u netbox nano configuration.py

Fügen Sie Ihre lokale IP-Adresse und den Domainnamen zu den ‘ ALLOWED_HOSTS ‘ hinzu.

ALLOWED_HOSTS = ['netbox.howtoforge.local', '192.168.10.60']

Geben Sie in der ‘ DATABASE ‘ Sektion Ihren PostgreSQL-Datenbanknamen, Benutzer und Passwort ein.

# Datenbankkonfiguration  
DATABASE = {  
'NAME': 'netboxdb', # Datenbankname  
'USER': 'netbox', # PostgreSQL-Benutzername  
'PASSWORD': 'netboxpassword', # PostgreSQL-Passwort  
'HOST': 'localhost', # Datenbankserver  
'PORT': '', # Datenbankport (leer lassen für Standard)  
'CONN_MAX_AGE': 300, # Maximales Alter der Datenbankverbindung (Sekunden)  
}

Fügen Sie Ihren geheimen Schlüssel in den Abschnitt ‘ SECRET_KEY ‘ ein.

SECRET_KEY = '98%D9uh8S%)T0QhQ@Z3zYf%Hik^CqWJ)Uwz%0J7TZUztmNiitG'

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Netbox migrieren und Administrator einrichten

Jetzt, da Sie Netbox mit dem PostgreSQL-Server konfiguriert haben, sind Sie bereit, die Datenbank zu migrieren und einen Administratorbenutzer für die Netbox-Installation zu erstellen.

Führen Sie das ‘ upgrade.sh ‘ Skript mit dem folgenden Befehl aus. Dies wird eine Python-Umgebung erstellen, Abhängigkeiten für Netbox installieren, die Netbox-Datenbank migrieren, sich mit Redis verbinden und dann statische Dateien generieren.

sudo -u netbox /opt/netbox/upgrade.sh

netbox configure

Unten sehen Sie die Datenbankmigration für Netbox.

migrate

Und unten, wenn ‘ manage.py ‘ statische Dateien generiert.

Nachdem der Prozess abgeschlossen ist, müssen Sie einen neuen Administratorbenutzer für Netbox über das ‘ manage.py ‘ Skript erstellen.

static files

Führen Sie den folgenden Befehl aus, um die Netbox-virtuelle Umgebung zu aktivieren. Sobald sie aktiviert ist, wird Ihre Shell so aussehen: ‘ (venv) user@hostname ‘.

source /opt/netbox/venv/bin/activate

Gehen Sie in das ‘ /opt/netbox/netbox ‘ Verzeichnis und führen Sie das ‘ manage.py ‘ Skript wie folgt aus:

cd /opt/netbox/netbox  
python3 manage.py createsuperuser

Geben Sie Ihren Benutzernamen, Ihre E-Mail-Adresse und Ihr Passwort für den Netbox-Administrator ein.

create admin

Sobald dies abgeschlossen ist, führen Sie den Befehl ‘ deactivate ‘ aus, um die Netbox-virtuelle Umgebung zu verlassen.

Netbox als Dienst ausführen

In diesem Abschnitt kopieren Sie die Netbox-Konfigurationen, die verwendet werden, um Netbox als systemd-Dienst auszuführen. Sie müssen sicherstellen, dass Netbox unter Gunicorn läuft, und dann die Netbox-Dienstdateien in das ‘ /etc/systemd/system ‘ Verzeichnis kopieren.

Zuerst kopieren Sie das ‘ gunicorn.py ‘ Skript in das ‘ /opt/netbox ‘ Verzeichnis. Dieses Skript enthält die Konfiguration für Netbox, um unter dem Python WSGI-Server zu laufen.

sudo -u netbox cp /opt/netbox/contrib/gunicorn.py /opt/netbox/gunicorn.py

Führen Sie nun den folgenden Befehl aus, um die Dienstdateien für Netbox in das ‘ /etc/systemd/system ‘ Verzeichnis zu kopieren und den systemd-Manager neu zu laden.

sudo cp -v /opt/netbox/contrib/*.service /etc/systemd/system/  
sudo systemctl daemon-reload

Sobald systemd neu geladen ist, führen Sie den ‘ systemctl ‘ Befehl unten aus, um die Netbox-Dienste zu starten und zu aktivieren.

sudo systemctl enable --now netbox netbox-rq netbox-housekeeping

Überprüfen Sie zuletzt die Netbox-Dienste, um sicherzustellen, dass sie mit dem folgenden Befehl laufen.

sudo systemctl status netbox netbox-rq netbox-housekeeping

Im folgenden Output können Sie sehen, dass der ‘ netbox ‘ Dienst läuft und aktiviert ist.

netbox

Für den ‘ netbox-rq ‘ Dienst sollten Sie eine Ausgabe wie diese erhalten:

netbox-rq

Zuletzt hat der ‘ netbox-housekeeping ‘ Dienst den Status ‘ dead ‘, da er als Timer ausgeführt wird.

netbox-housekeeping

Apache als Reverse-Proxy konfigurieren

An diesem Punkt läuft Netbox im Hintergrund als Dienst unter dem Python WSGI-Server. Um es von außen zugänglich zu machen, müssen Sie Apache als Reverse-Proxy konfigurieren. Zuvor müssen Sie auch SSL-Zertifikate generieren, um die Netbox-Installation zu sichern.

Zuerst führen Sie den folgenden Befehl aus, um den ‘ apache2 ‘ Dienst zu stoppen.

sudo systemctl stop apache2

Jetzt generieren Sie SSL-Zertifikate von Letsencrypt mit dem ‘ certbot ‘ Befehl unten. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse mit Ihren Informationen ändern.

sudo certbot certonly --standalone --preferred-challenges http -d netbox.howtoforge.local

Nachdem der Prozess abgeschlossen ist, sind Ihre SSL-Zertifikate im Verzeichnis ‘ /etc/letsencrypt/live/domain.com ‘ verfügbar.

Kopieren Sie als Nächstes die Apache-Konfiguration für Netbox in die Datei ‘ /etc/apache2/sites-available/netbox.conf ‘ und ändern Sie sie mit dem ‘ nano ‘ Editor.

sudo cp /opt/netbox/contrib/apache.conf /etc/apache2/sites-available/netbox.conf  
sudo nano /etc/apache2/sites-available/netbox.conf

Ersetzen Sie den Domainnamen innerhalb der ‘ ServerName ‘ Option und ändern Sie den Pfad Ihrer SSL-Zertifikate.

  
# ÄNDERN SIE DIES ZU DEM NAMEN IHRES SERVERS  
ServerName netbox.howtoforge.local  
  
...  
  
  
  
ProxyPreserveHost On  
  
# ÄNDERN SIE DIES ZU DEM NAMEN IHRES SERVERS  
ServerName netbox.howtoforge.local  
  
SSLEngine on  
SSLCertificateFile /etc/letsencrypt/live/netbox.howtoforge.local/fullchain.pem  
SSLCertificateKeyFile /etc/letsencrypt/live/netbox.howtoforge.local/privkey.pem  
...

Speichern Sie die Datei und beenden Sie den Editor, wenn Sie fertig sind.

Führen Sie nun den folgenden Befehl aus, um die Apache-Module und die virtuelle Hostdatei ‘ netbox.conf ‘ zu aktivieren.

sudo a2enmod ssl proxy proxy_http headers rewrite  
sudo a2ensite netbox.conf

Nachdem der virtuelle Host aktiviert ist, führen Sie den folgenden Befehl aus, um Apache neu zu starten und Ihre Änderungen anzuwenden. Damit sollte Ihre Netbox-Installation unter dem Apache-Reverse-Proxy mit aktiviertem HTTPS laufen.

sudo systemctl restart apache2

Besuchen Sie zuletzt https://netbox.howtoforge.local/ mit Ihrem Webbrowser, und Sie werden zur Anmeldeseite von Netbox weitergeleitet. Geben Sie Ihren Admin-Benutzernamen und Ihr Passwort ein und klicken Sie auf Anmelden.

Sie sehen das folgende Netbox-Dashboard, wenn Sie die richtigen Admin-Anmeldeinformationen haben.

dashboard

Klicken Sie auf das Menü Admin > System, um Informationen zu Ihrer Netbox-Installation zu sehen. Im folgenden Output können Sie sehen, dass Netbox v4.1.7 mit der PostgreSQL-Datenbank installiert ist.