So installierst du FossBilling mit Nginx auf Rocky Linux 9

FOSSBilling ist eine kostenlose und quelloffene Abrechnungslösung, die für Kunden und Verkäufer einfach zu bedienen ist. FOSSBilling ist ein Fork von BoxBilling. Mit seiner intuitiven Benutzeroberfläche und der Unterstützung mehrerer Zahlungsgateways bietet es ein hervorragendes Erlebnis für Kunden. FOSSBilling ist für eine Vielzahl von Unternehmen geeignet, von kleinen über mittlere bis hin zu großen Unternehmen. FOSSBilling kann dir dabei helfen, deine Rechnungsstellung, Zahlungseingänge, Kundenverwaltung und -kommunikation zu automatisieren.

In dieser Anleitung werde ich FOSSBilling auf einem Rocky Linux 9 Server installieren. Diese Anleitung beinhaltet die Installation des Nginx Webservers, des MariaDB Datenbankservers, von PHP-FPM 8.2 und des Certbot Tools zur Erstellung von SSL/TSL Zertifikaten. Am Ende hast du eine Abrechnungs- und Kundenverwaltungslösung, die du für dein tägliches Geschäft nutzen kannst.

Voraussetzungen

Um diesen Leitfaden fertigzustellen, brauchst du die folgenden Voraussetzungen:

• Einen Server mit installiertem Rocky Linux 9 – In diesem Beispiel wird ein Rocky Linux mit dem Hostnamen‚fossbilling-rocky‚ verwendet.
• Einen Nicht-Root-Benutzer mit sudo/root-Administrator-Rechten.
• SELinux läuft im permissiven Modus.
• Ein Domainname, der auf die IP-Adresse deines Servers zeigt – In diesem Beispiel wird eine Subdomain„fossbilling.hwdomain.io“ verwendet.

Wenn diese Voraussetzungen erfüllt sind, kannst du die Installation von FOSSBilling abschließen.

Installation des Nginx Webservers

FOSSBilling kann mit den Webservern Nginx und Lighttpd betrieben werden. In dieser Anleitung wird Nginx als Webserver verwendet. In diesem Schritt installierst du Nginx aus dem offiziellen Rocky Linux AppStream Repository.

Stelle zunächst sicher, dass das EPEL-Repository zu deinem System hinzugefügt wurde. Du kannst es auch mit dem unten stehenden dnf-Befehl installieren.

sudo dnf install epel-release

Als nächstes installierst du den Nginx-Webserver mit dem unten stehenden dnf-Befehl. Wenn du dazu aufgefordert wirst, gibst du zur Bestätigung y ein und drückst ENTER, um fortzufahren.

sudo dnf install nginx

Ausgabe:

Sobald Nginx installiert ist, führe den folgenden systemctl-Befehl aus, um den Nginx-Dienst zu starten und zu aktivieren. Dadurch wird Nginx auf dem Standard-HTTP-Port 80 gestartet und ausgeführt und Nginx wird beim Systemstart automatisch gestartet.

sudo systemctl start nginx
sudo systemctl enable nginx

Überprüfe nun den Status des Nginx-Dienstes mit dem unten stehenden systemctl-Befehl. Du solltest eine Ausgabe erhalten, dass der Nginx-Dienst läuft und aktiviert ist.

sudo systemctl status nginx

Ausgabe:

Der Nginx-Dienst läuft jetzt, du musst sowohl das HTTP- als auch das HTTPS-Protokoll in der Firewalld öffnen. Um dies zu erreichen, kannst du den folgenden Befehl firewall-cmd ausführen.

sudo firewall-cmd --add-service={http,https} --permanent

Sobald die HTTP- und HTTPS-Protokolle zu firewalld hinzugefügt wurden, führe den folgenden Befehl aus, um firewalld neu zu laden und die Änderungen zu übernehmen. Überprüfe dann die Liste der aktivierten Dienste in der Firewalld.

Du solltest sehen, dass HTTP- und HTTPS-Protokolle zur Firewalld hinzugefügt wurden.

sudo firewall-cmd --reload
sudo firewall-cmd --list-all

Ausgabe:

Damit hast du den Nginx-Webserver installiert und die Firewalld so konfiguriert, dass sie HTTP- und HTTPS-Protokolle öffnet. Im nächsten Schritt beginnst du mit der Installation des MariaDB Datenbankservers.

Installation des MariaDB-Servers

FOSSBilling verwendet MySQL/MariaDB, um die Daten der Nutzer zu speichern. Es wird mindestens MySQL 8 oder MariaDB Server 10.x benötigt. In diesem Schritt installierst du den MariaDB Server aus dem offiziellen Rocky Linux Repository, der mit der neuesten Version von FOSSBilling kompatibel ist.

Installiere den MariaDB-Datenbankserver mit dem unten stehenden dnf-Befehl auf deinem Rocky Linux-System. Gib y ein, wenn du dazu aufgefordert wirst und drücke ENTER, um fortzufahren.

sudo install mariadb-server

Ausgabe:

Sobald MariaDB installiert ist, führe den folgenden systemctl-Befehl aus, um den MariaDB-Dienst zu starten und zu aktivieren.

sudo systemctl start mariadb
sudo systemctl enable mariadb

Als Nächstes führst du den folgenden systemctl-Befehl aus, um den MariaDB-Dienst zu überprüfen und sicherzustellen, dass der Dienst läuft. Die Ausgabe„active (running)“ bestätigt, dass der MariaDB-Server läuft. Und die Ausgabe„loaded (../mariadb.service; enabled;)“ bestätigt, dass der MariaDB-Dienst aktiviert ist und beim Systemstart automatisch ausgeführt wird.

sudo systemctl status mariadb

Ausgabe:

Wenn der MariaDB-Server läuft, kannst du MariaDB mit dem Befehl „mariadb-secure-installation“ sichern. Dazu gehört das Einrichten eines Root-Passworts für MariaDB, das Deaktivieren des Remote-Logins für den MariaDB-Root-Benutzer usw.

Führe den unten stehenden Befehl„mariadb-secure-installation“ aus, um die MariaDB-Installation zu sichern.

sudo mariadb-secure-installation

Im Folgenden wirst du nach einigen MariaDB-Konfigurationen gefragt:

• Lokale Authentifizierung auf unix_socket umstellen? Gib n für nein ein.
• MariaDB Root-Passwort einrichten? Gib y ein, gib dann das neue MariaDB Root-Passwort ein und wiederhole den Vorgang.
• Den anonymen Standardbenutzer entfernen? Gib zur Bestätigung y ein.
• Fernanmeldung für den Root-Benutzer deaktivieren? Gib zur Bestätigung y ein.
• Den Standard-Datenbanktest entfernen? Gib zur Bestätigung y ein.
• Tabellenberechtigungen neu laden und Änderungen übernehmen? Bestätige mit y.

Wenn der MariaDB-Server installiert ist und läuft, erstellst du als Nächstes eine neue MariaDB-Datenbank und einen Benutzer, die für die Installation von FOSSBilling verwendet werden.

Datenbank und Benutzer anlegen

In diesem Schritt erstellst du eine neue MariaDB-Datenbank und einen neuen Benutzer, die für die FOSSBilling-Installation verwendet werden.

Führe den unten stehenden Befehl„mariadb“ aus, um dich mit dem Root-Benutzer bei MariaDB anzumelden. Wenn du nach einem Passwort gefragt wirst, gibst du dein MariaDB-Root-Passwort ein und drückst ENTER.

sudo mariadb -u root -p

Nachdem du dich in der MariaDB-Shell angemeldet hast, führe die folgenden Abfragen aus, um eine neue MariaDB-Datenbank und einen neuen Benutzer zu erstellen. In diesem Beispiel erstellst du eine neue Datenbank fossbillingdb mit dem Benutzer„fossbilling„. Ändere auch das Standardpasswort in der folgenden Abfrage.

CREATE DATABASE fossbillingdb;
CREATE USER fossbilling@localhost IDENTIFIED BY 'password';
GRANT ALL ON fossbillingdb.* TO fossbilling@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

Ausgabe:

Zum Schluss führst du die folgende Abfrage aus, um den MariaDB-Benutzer fossbilling@localhost zu überprüfen und sicherzustellen, dass der Benutzer Zugriffsrechte auf die Datenbank„fossbiilingdb“ hat.

Die Ausgabe „GRANT ALL PRIVILEGES ON fossbillingdb.* to fossbilling@localhost“ bestätigt, dass der Benutzer fossbilling@localhost Zugriffsrechte auf die Datenbank„fossbillingdb“ hat.

Gib quit ein, um dich von der MariaDB-Shell abzumelden.

SHOW GRANTS FOR fossbilling@localhost;
quit

Ausgabe:

Jetzt hast du die MariaDB-Datenbank und den Benutzer für FOSSBilling erstellt. Im nächsten Schritt installierst du PHP und PHP-FPM auf deinem Rocky Linux Server.

PHP-FPM 8.2 installieren

Die neueste Version von FOSSBilling wird von PHP 8.x unterstützt. In diesem Schritt installierst du PHP und PHP-FPM 8.2 über das Remi-Repository. Zuerst richtest du also das Remi-Repository ein, installierst die PHP- und PHP-FPM-Pakete und richtest dann PHP-FPM mit dem Nginx-Webserver ein.

Füge das PHP-Remi-Repository mit dem unten stehenden dnf-Befehl hinzu. Mit diesem Befehl wird das Remi-Repository auf deinem Rocky-Linux-System installiert. Die RPM-Datei „remi-release-9.rpm“ bestätigt, dass diese für die RHEL 9 Distribution verwendet werden kann. Gib außerdem y ein, wenn du dazu aufgefordert wirst, und drücke ENTER, um fortzufahren.

sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm

Ausgabe:

Als nächstes führst du den folgenden dnf-Befehl aus, um das Repository-Modul für PHP zurückzusetzen. Überprüfe dann die Liste der PHP-Repository-Module, die auf deinem System verfügbar sind.

sudo dnf module reset php
sudo dnf module list php

Wenn du aufgefordert wirst, den GPG-Schlüssel für das Remi-Repository einzurichten, gib zur Bestätigung y ein und drücke ENTER.

Nachdem der Befehl „dnf module list php“ ausgeführt wurde, siehst du mehrere PHP-Versionen, die vom offiziellen Rocky Linux AppStream Repository und vom Remi Repository bereitgestellt werden.

Führe den folgenden Befehl aus, um das PHP-Repository für„remi-8.2“ zu aktivieren. Damit installierst du jedes Mal, wenn du PHP-Pakete installierst, die PHP 8.2-Pakete aus dem Remi-Repository.

Gib y ein, wenn du dazu aufgefordert wirst, und drücke ENTER, um es zu aktivieren.

sudo dnf module enable php:remi-8.2

Ausgabe:

Nachdem du das PHP Remi Repository konfiguriert hast, kannst du PHP-Pakete installieren.

Führe den folgenden dnf-Befehl aus, um die PHP- und PHP-FPM-Pakete auf deinem Rocky Linux-Server zu installieren. Gib y ein, wenn du dazu aufgefordert wirst, und drücke ENTER, um fortzufahren.

sudo dnf install php php-fpm php-mysql php-curl php-cli php-zip php-common php-mbstring php-xml

Ausgabe:

Du wirst auch aufgefordert, den GPG-Schlüssel für das Remi-Repository zu bestätigen. Gib zur Bestätigung y ein und drücke ENTER.

Nachdem PHP installiert ist, öffne die PHP-Konfigurationsdatei„/etc/php.ini“ mit dem unten stehenden nano-Editor-Befehl.

sudo nano /etc/php.ini

Ändere die Standard-PHP-Konfiguration mit den folgenden Zeilen.

upload_max_filesize = 16M 
post_max_size = 32M 
memory_limit = 256M 
max_execution_time = 600 
max_input_vars = 3000 
max_input_time = 1000

Speichere und beende die Datei„/etc/php.ini„, wenn du fertig bist.

Um PHP-FPM mit Nginx auf RHEL-basierten Distributionen auszuführen, musst du sicherstellen, dass PHP-FPM mit dem Standardbenutzer und der Standardgruppe„nginx“ ausgeführt wird.

Unter RHEL wird der Nginx-Webserver standardmäßig unter dem Benutzer„nginx“ ausgeführt. Bei Debian-basierten Distributionen laufen sowohl der Nginx- als auch der Apache2-Webserver unter demselben Benutzer und derselben Gruppe„www-data„.

Öffne die PHP-FPM-Pool-Konfiguration„/etc/php-fpm.d/www.conf“ mit dem unten stehenden nano-Editor-Befehl.

sudo nano /etc/php-fpm.d/www.conf

Ändere die Standardparameter„user“ und„group“ in„nginx„.

user = nginx
group = nginx

Speichere und schließe die Datei, wenn du fertig bist.

Als Nächstes führst du den folgenden systemctl-Befehl aus, um den PHP-FPM-Dienst zu starten und zu aktivieren. Dadurch wird der PHP-FPM-Dienst mit der Standard-Sock-Datei „/run/php-fpm/www.sock“ gestartet und der PHP-FPM wird beim Systemstart automatisch gestartet.

Die Ausgabe ‚Created symlink ...‘ bestätigt, dass der PHP-FPM-Dienst aktiviert ist.

sudo systemctl start php-fpm
sudo systemctl enable php-fpm

Ausgabe:

Führe nun den folgenden systemctl-Befehl aus, um den Status des PHP-FPM-Dienstes zu überprüfen. Du solltest die Ausgabe erhalten, dass der PHP-FPM„active (running)“ ist, was bestätigt, dass der PHP-FPM läuft. Und die Ausgabe„Loaded …/…/; enabled;“ bestätigt, dass der PHP-FPM-Dienst aktiviert ist.

sudo systemctl status php-fpm

Ausgabe:

Führe abschließend den folgenden php-Befehl aus, um die auf deinem System installierte PHP-Version zu überprüfen. Überprüfe dann die Liste der aktivierten Erweiterungen auf deinem System.

Du erhältst die Meldung PHP 8.2 und die Liste der aktivierten PHP-Erweiterungen. Vergewissere dich, dass die Erweiterungen „curl“, „openssl“, „pdo_mysql“ und „zlib“ aktiviert sind.

php --version
php -m

Ausgabe:

Damit hast du PHP und PHP-FPM 8.2 auf dem Rocky Linux System installiert. Außerdem hast du PHP-FPM so konfiguriert, dass es zusammen mit dem Nginx-Webserver ausgeführt werden kann. Im nächsten Schritt startest du die Installation von FOSSBilling, indem du den Quellcode herunterlädst.

Herunterladen des FOSSBilling-Quellcodes

In diesem Schritt lädst du den FOSSBilling-Quellcode herunter und legst das FOSSBilling-Installationsverzeichnis unter „/var/www/fossbilling“ fest.

Bevor du loslegst, führe den folgenden dnf-Befehl aus, um das unzip-Paket auf deinem System zu installieren.

sudo dnf install unzip -y

Erstelle nun ein neues Verzeichnis„/var/www/fossbilling“ und verschiebe dein Arbeitsverzeichnis dorthin. Dann kannst du die neueste stabile Version von FOSSBilling mit dem folgenden curl-Befehl herunterladen.

mkdir -p /var/www/fossbilling; cd /var/www/fossbilling
curl https://fossbilling.org/downloads/stable -L --output FOSSBilling.zip

Ausgabe:

Wenn der FOSSBilling-Quellcode heruntergeladen ist, siehst du die Datei FOSSBilling.zip in deinem Arbeitsverzeichnis. Führe den unten stehenden unzip-Befehl aus, um die Datei „FOSSBilling.zip“ zu entpacken. Dann änderst du die Eigentumsrechte am FOSSBilling-Installationsverzeichnis„/var/www/fossbilling“ auf den Benutzer und die Gruppe„nginx„.

unzip FOSSBilling.zip
sudo chown -R nginx:nginx /var/www/fossbilling

Nachdem du den FOSSBilling-Quellcode heruntergeladen und das Installationsverzeichnis konfiguriert hast, richtest du als Nächstes den Nginx-Serverblock ein, auf dem die FOSSBilling-Webanwendung laufen wird.

Nginx Server-Block konfigurieren

In diesem Schritt richtest du eine neue Konfiguration des Nginx-Serverblocks ein, auf dem die FOSSBilling-Webanwendung laufen wird. Bevor du beginnst, stelle sicher, dass dein Domainname auf die IP-Adresse des Servers zeigt.

Erstelle eine neue Nginx-Serverblock-Konfigurationsdatei„/etc/nginx/conf.d/fossbilling.conf“ mit dem unten stehenden nano-Editor-Befehl.

sudo nano /etc/nginx/conf.d/fossbilling.conf

Füge die folgenden Zeilen in die Datei ein. Achte darauf, dass du den Namen der Ziel-Installationsdomäne„fossbilling.hwdomain.io“ änderst.

server {
    listen 80;
set $root_path '/var/www/fossbilling';
server_name fossbilling.hwdomain.io;

index index.html index.htm index.php;
root $root_path;
try_files $uri $uri/ @rewrite;
sendfile off;

include /etc/nginx/mime.types;

# Block access to sensitive files and return 404 to make it indistinguishable from a missing file
location ~* .(ini|sh|inc|bak|twig|sql)$ {
return 404;
}

# Block access to hidden files except for .well-known
location ~ /\.(?!well-known\/) {
return 404;
}

# Disable PHP execution in /uploads
location ~* /uploads/.*\.php$ {
return 404;
}

# Deny access to /data
location ~* /data/ {
return 404;
}

location @rewrite {
rewrite ^/page/(.*)$ /index.php?_url=/custompages/$1;
rewrite ^/(.*)$ /index.php?_url=/$1;
}

location ~ \.php {
fastcgi_split_path_info ^(.+\.php)(/.+)$;

# fastcgi_pass need to be changed according your server setup:
# phpx.x is your server setup
# examples: /var/run/phpx.x-fpm.sock, /var/run/php/phpx.x-fpm.sock or /run/php/phpx.x-fpm.sock are all valid options
# Or even localhost:port (Default 9000 will work fine)
# Please check your server setup

fastcgi_pass unix:/run/php-fpm/www.sock;

fastcgi_param PATH_INFO       $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_intercept_errors on;

include fastcgi_params;
}

location ~* ^/(css|img|js|flv|swf|download)/(.+)$ {
root $root_path;
expires off;
}
}

Speichere und beende die Datei, wenn du fertig bist.

Führe anschließend den folgenden Befehl aus, um die Nginx-Konfiguration zu überprüfen. Starte dann den Nginx-Dienst neu, um die Änderungen zu übernehmen. Wenn der Test der Nginx-Konfiguration erfolgreich ist, solltest du eine Ausgabe wie„Test erfolgreich – Syntax ok“ erhalten.

sudo nginx -t
sudo systemctl restart nginx

Ausgabe:

Jetzt läuft FOSSBilling mit dem Nginx-Webserver. Aber die HTTP-Verbindung ist immer noch unsicher. Im nächsten Schritt wirst du FOSSBiling mit SSL/TLS-Zertifikaten über Certbot und Letsencrypt absichern.

FOSSBilling mit SSL/TLS Letsencrypt absichern

Nachdem du die Konfiguration des Nginx-Serverblocks erstellt hast, musst du als Nächstes die FOSSBilling-Installation mit SSL/TLS-Zertifikaten sichern. Dazu kannst du das Tool Certbot und kostenlose SSL-Zertifikate von Letsencrypt verwenden.

Bevor du beginnst, stelle sicher, dass dein Domainname auf die IP-Adresse des Servers zeigt und dass du eine E-Mail-Adresse hast, mit der du dich bei Letsencrypt registrieren kannst.

Führe nun den folgenden dnf-Befehl aus, um Certbot und das Certbot Nginx Plugin zu installieren. Gib y ein, wenn du dazu aufgefordert wirst, und drücke ENTER, um fortzufahren.

sudo dnf install certbot python3-certbot-nginx

Ausgabe:

Nachdem Certbot installiert ist, führe den folgenden Befehl aus, um SSL/TLS-Zertifikate für deinen Domainnamen zu erzeugen. Achte auch darauf, den Domainnamen und die E-Mail-Adresse im folgenden Befehl zu ändern.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email alice@hwdomain.io -d fossbilling.hwdomain.io

Mit diesem Befehl werden die neuen SSL/TLS-Zertifikate für deinen Domainnamen erstellt. Außerdem wird dadurch automatisch HTTPS auf deinem Nginx-Serverblock eingerichtet und eine automatische Umleitung von HTTP zu HTTPS eingerichtet. Deine SSL/TLS-Zertifikate werden im Verzeichnis „/etc/elstencrypt/live/fossbilling.hwdomain.io/“ erstellt.

Starten der FOSSBilling-Installation

Öffne deinen Webbrowser und rufe den Domainnamen deiner FossBilling-Installation auf (z.B.: https://fossbilling.hwdomain.io/).

Das FOSSBilling-Installationsprogramm sollte nun deine Systemdaten prüfen und verifizieren. Vergewissere dich, dass die Anforderungen den Status„Ok“ mit grüner Farbe erhalten. Klicke auf Weiter, um fortzufahren.

Gib nun die Details der MariaDB-Datenbank und des Benutzers ein, die du erstellt hast, und klicke erneut auf Weiter.

Als nächstes gibst du die neuen Administratorendaten für FOSSBilling ein. Gib deinen Benutzernamen, deine E-Mail-Adresse, dein Passwort und die Standardwährung ein. Klicke dann auf Weiter, um fortzufahren.

Wenn die Installation von FOSSBilling erfolgreich war, solltest du die Meldung„Glückwunsch! FOSSBilling wurde erfolgreich installiert.‘.

Außerdem siehst du einige Anweisungen, um die Installation von FOSSBilling abzuschließen.

Gehe zurück zu deinem Rocky Linux Server Terminal und führe die folgenden Befehle aus, um die Installation von FOSSBilling abzuschließen.

Entferne das FOSSBilling-Verzeichnis„install„.

sudo rm -rf /var/www/fossbilling/install

Ändere die Berechtigung der FOssBilling-Konfigurationsdatei„config.php“ auf 0644. Damit wird dieSchreibberechtigung für andere und Gruppen entfernt.

sudo chmod 0644 /var/www/fossbilling/config.php

Erstelle einen neuen Cron für FOSSBilling mit dem unten stehenden Befehl.

crontab -u nginx -e

Wähle den Code-Editor, den du verwenden möchtest. Gib dann die folgenden Zeilen in die Datei ein.

*/5 * * * * php /var/www/fossbilling/cron.php

Speichere die Datei und beende den Editor, wenn du fertig bist.

Gehe nun zurück zum Webbrowser und klicke auf Fertig stellen.

Du erhältst nun die folgende Seite.

Wenn du auf die Schaltfläche„Kundenbereich“ klickst, wirst du auf die Startseite von FOSSBilling weitergeleitet.

Wenn du auf die Schaltfläche„Adminbereich“ klickst, wirst du zur Login-Seite für Administratoren weitergeleitet.

Melde dich mit deiner E-Mail-Adresse und deinem Passwort an und klicke dann auf„Anmelden„.

Wenn du erfolgreich warst, solltest du das FOSSBilling-Verwaltungs-Dashboard sehen.

Damit hast du die Installation von FOSSBilling abgeschlossen und mit SSL/TLS-Zertifikaten über Certbot und Letsencrypt gesichert.

Fazit

In dieser Anleitung hast du die Open-Source-Abrechnungs- und Benutzerverwaltung FOSSBilling auf einem Rocky Linux 9 Server installiert. Außerdem hast du den LEMP Stack (Nginx Webserver, MariaDB Datenbank und PHP-FPM) auf einem Rocky Linux System konfiguriert. Außerdem hast du die FOSSBilling-Installation mit SSL/TLS-Zertifikaten abgesichert, die du mit Certbot und Letsencrypt erstellt hast.

Von hier aus kannst du FOSSBilling nun für dein Unternehmen nutzen. Du kannst weitere Benutzer hinzufügen, einen SMTP-Server einrichten und vieles mehr.