Wie man OctoberCMS auf Debian 12 installiert

October CMS ist eine Webanwendung, die im Laravel-Webframework geschrieben ist. Es unterstützt eine Vielzahl von Datenbanken, wie MySQL/MariaDB, PostgreSQL und SQLite. Es kann unter Apache, Nginx, Lighthttpd und Microsoft IIS betrieben werden.

Dieser Leitfaden führt Sie durch den Installationsprozess von October CMS auf Debian 12 mit dem LEMP-Stack (Nginx, MySQL/MariaDB und PHP-FPM), UFW und Certbot.

Voraussetzungen

Um mit diesem Leitfaden fortzufahren, sammeln Sie Folgendes:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit Administratorrechten.
• Einen Domainnamen, der auf die IP-Adresse des Servers verweist.

Abhängigkeiten installieren

In diesem Beispiel installieren Sie October CMS auf dem Debian-Server mit dem LEMP-Stack (Nginx, MySQL/MariaDB und PHP-FPM). Daher ist die erste Aufgabe, die Sie erledigen werden, die Installation des LAMP-Stacks mit zusätzlichen Abhängigkeiten wie UFW (Uncomplicated Firewall) und Certbot.

Starten Sie diesen Leitfaden, indem Sie Ihr Debian-Repository mit dem folgenden Befehl aktualisieren.

sudo apt update

Installieren Sie dann die Pakete des LAMP-Stacks, UFW und Certbot mit dem folgenden Befehl.

sudo apt install nginx mariadb-server php composer php-cli php-common php-imap php-redis php-snmp php-xml php-zip php-mbstring php-curl php-mysqli php-intl php-bcmath php-gd php-fpm ufw certbot python3-certbot-nginx

Geben Sie Y ein und drücken Sie ENTER, um die Installation zu bestätigen.

Sobald die Installation abgeschlossen ist, überprüfen Sie die LEMP-Stack-Dienste, um sicherzustellen, dass jeder Dienst auf Ihrem Debian-Server läuft und aktiviert ist.

Wenn der Dienst läuft, sollten Sie eine Ausgabe wie active (running) sehen. Wenn der Dienst aktiviert ist, bestätigt dies, dass der Dienst beim Booten automatisch gestartet wird.

Überprüfen Sie den Nginx-Dienst mit dem folgenden Befehl.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Überprüfen Sie den PHP-FPM-Dienst mit dem folgenden Befehl. In diesem Fall haben Sie PHP-FPM 8.2 aus dem Debian-Repository installiert.

sudo systemctl is-enabled php8.2-fpm  
sudo systemctl status php8.2-fpm

Überprüfen Sie schließlich den MariaDB-Server mit dem folgenden Befehl.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

UFW einrichten

In diesem Leitfaden sichern Sie Ihren Debian-Server mit UFW (Uncomplicated Firewall). In diesem Fall müssen Sie die Ports für die Protokolle SSH, HTTP und HTTPS öffnen.

Führen Sie den folgenden Befehl aus, um die Profile OpenSSH und Nginx Full in UFW zu aktivieren. Das OpenSSH-Profil öffnet den Standard-SSH-Port 22, während das Profil ‘Nginx Full’ die Ports 80 und 443 für die Protokolle HTTP und HTTPS öffnet.

sudo ufw allow OpenSSH  
sudo ufw allow 'Nginx Full'

Führen Sie nun den folgenden Befehl aus, um UFW zu starten und zu aktivieren. Geben Sie y ein und drücken Sie ENTER, um fortzufahren.

sudo ufw enable

Sobald UFW läuft, sollten Sie eine Ausgabe wie Firewall is active and enabled on system startup erhalten.

Führen Sie nun den folgenden Befehl aus, um die aktivierten Profile in UFW zu überprüfen.

sudo ufw status

Stellen Sie sicher, dass sowohl die Profile OpenSSH als auch ‘Nginx Full’ aktiviert sind.

MariaDB-Server konfigurieren

Nachdem Sie UFW konfiguriert haben, richten Sie nun den MariaDB-Server über das Dienstprogramm mariadb-secure-installation ein, dann erstellen Sie eine neue Datenbank und einen Benutzer für October CMS über den mariadb-Client.

Sichern Sie Ihre MariaDB-Serverinstallation, indem Sie den folgenden Befehl ausführen.

sudo mariadb-secure-installation

Während des Prozesses werden Sie mit einigen Sicherheitsempfehlungen für den MariaDB-Server konfrontiert. Geben Sie Y ein, um die Empfehlung anzuwenden, oder n für Nein, um sie abzulehnen.

• Die Standardinstallation von MariaDB kommt ohne Passwort, drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
• Geben Sie jetzt Y ein, um das MariaDB-Root-Passwort festzulegen. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
• Geben Sie Y ein, um den anonymen Benutzer aus Ihrer MariaDB-Installation zu entfernen.
• Geben Sie erneut Y ein, wenn Sie gefragt werden, ob Sie den Remote-Login für den MariaDB-Root-Benutzer deaktivieren möchten.
• Geben Sie Y ein, um die Standarddatenbank test aus Ihrer MariaDB zu entfernen.
• Geben Sie schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Jetzt, da Sie den MariaDB-Server konfiguriert haben, geben Sie den folgenden Befehl ein, um sich beim MariaDB-Server anzumelden und eine neue Datenbank und einen Benutzer für October CMS zu erstellen. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie die folgenden Abfragen aus, um einen neuen Benutzer und eine neue Datenbank octobercms mit dem Passwort ‘password‘ zu erstellen. Stellen Sie sicher, dass Sie das Passwort durch ein neues starkes Passwort ersetzen.

CREATE USER 'octobercms'@'localhost' IDENTIFIED BY 'password';  
CREATE DATABASE octobercms;  
GRANT ALL PRIVILEGES ON octobercms.* TO 'octobercms'@'localhost';  
FLUSH PRIVILEGES;

Führen Sie als Nächstes die folgende Abfrage aus, um die Berechtigungen für den Benutzer octobercms zu überprüfen.

SHOW GRANTS FOR 'octobercms'@'localhost';

Stellen Sie sicher, dass der Benutzer octobercms auf die Datenbank octobercms zugreifen kann, wie folgt.

Geben Sie nun quit ein, um den MariaDB-Server zu verlassen.

Quellcode von OctoberCMS installieren

October CMS kann auf viele Arten installiert werden, entweder über zip oder über Composer. In diesem Beispiel installieren Sie October CMS über Composer.

Gehen Sie zum Verzeichnis /var/www/ und laden Sie den Quellcode von October CMS mit dem folgenden wget-Befehl herunter. Nach dem Herunterladen sehen Sie die Datei v3.5.0.zip.

cd /var/www/  
wget https://github.com/octobercms/october/archive/refs/tags/v3.5.0.zip

Entpacken Sie die v3.5.0.zip-Datei mit unzip in das Verzeichnis octobercms. Das bedeutet, dass Ihr Webstammverzeichnis von October CMS unter /var/www/octobercms liegt.

unzip v3.5.0.zip  
sudo mv october-* octobercms

Führen Sie als Nächstes den folgenden Befehl aus, um den Besitz von /var/www/octobercms auf den Benutzer www-data und die Gruppe www-data zu ändern. Setzen Sie auch die Berechtigungen für Verzeichnisse auf 0755 und für Dateien auf 0644.

sudo chown -R www-data:www-data octobercms  
find /var/www/octobercms -type d -exec chmod 755 {} \;  
find /var/www/octobercms -type f -exec chmod 644 {} \;

Führen Sie nun den folgenden Composer-Befehl aus, um die PHP-Abhängigkeiten für October CMS zu installieren.

sudo -u www-data composer install

Starten Sie die Installation von October CMS mit dem folgenden Befehl.

sudo -u www-data php artisan october:install

Während des Prozesses werden Sie mit Folgendem gefragt:

• Wählen Sie die Standardsprache als en oder Englisch.
• Geben Sie den Domainnamen Ihrer October CMS-Installation ein. Zum Beispiel http://howtoforge.local/
• Geben Sie die Backend-URL oder den Admin-Pfad für October CMS ein. In diesem Fall verwenden wir octoberadmin.
• Geben Sie die Nummer 1 ein, um die Datenbank-Engine auf MySQL auszuwählen.
• Geben Sie Ihre Datenbankdetails ein.
• Geben Sie ja ein, um Demodaten und ein Thema zu installieren.
• Geben Sie den kostenlosen Lizenzschlüssel von October CMS ein, um fortzufahren.

Unten sehen Sie den Screenshot der Installation von October CMS.

Site-Konfigurationen für October CMS.

Ausgabe während der Installation von October CMS.

Sobald die Installation von October CMS abgeschlossen ist, sehen Sie die folgende Ausgabe.

Führen Sie schließlich den folgenden Befehl aus, um die Datenbank zu migrieren.

sudo -u www-data php artisan october:migrate

Nginx-Serverblock konfigurieren

Nachdem Sie October CMS heruntergeladen und das Webstammverzeichnis konfiguriert haben, erstellen Sie eine neue Nginx-Serverblockkonfiguration, die verwendet wird, um October CMS auszuführen. Stellen Sie sicher, dass Sie Ihren Domainnamen bereit haben.

Führen Sie den folgenden Befehl im nano-Editor aus, um eine neue Datei /etc/nginx/sites-available/octobercms.conf zu erstellen.

sudo nano /etc/nginx/sites-available/octobercms.conf

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den Domainnamen howtoforge.local durch Ihre Domain ersetzen.

server {  
    listen 80;  
    server_name howtoforge.local;  
    index index.php index.html;  
    root /var/www/octobercms;  
   
    location / {  
        # Lassen Sie October CMS standardmäßig alles bearbeiten.  
        # Der Pfad, der nicht vom Router von October CMS aufgelöst wird, gibt die 404-Seite von October CMS zurück.  
        # Alles, was nicht mit der unten stehenden Erlaubenliste übereinstimmt, fällt hier hinein.  
        rewrite ^/.*$ /index.php last;  
    }  
   
    location ~ \.php$ {  
        include snippets/fastcgi-php.conf;  
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;  
        fastcgi_read_timeout 120s;  
    }  
   
   
    # Erlaubenliste  
    location ~ ^/favicon\.ico { try_files $uri /index.php; }  
    location ~ ^/sitemap\.xml { try_files $uri /index.php; }  
    location ~ ^/robots\.txt { try_files $uri /index.php; }  
    location ~ ^/humans\.txt { try_files $uri /index.php; }  
   
    # Blockieren Sie alle .dotfiles außer gut bekannten  
    location ~ /\.(?!well-known).* { deny all; }  
   
    ## Lassen Sie nginx 404 zurückgeben, wenn die statische Datei nicht existiert  
    location ~ ^/storage/app/uploads/public { try_files $uri 404; }  
    location ~ ^/storage/app/media { try_files $uri 404; }  
    location ~ ^/storage/app/resources { try_files $uri 404; }  
    location ~ ^/storage/temp/public { try_files $uri 404; }  
   
    location ~ ^/modules/.*/assets { try_files $uri 404; }  
    location ~ ^/modules/.*/resources { try_files $uri 404; }  
    location ~ ^/modules/.*/behaviors/.*/assets { try_files $uri 404; }  
    location ~ ^/modules/.*/behaviors/.*/resources { try_files $uri 404; }  
    location ~ ^/modules/.*/widgets/.*/assets { try_files $uri 404; }  
    location ~ ^/modules/.*/widgets/.*/resources { try_files $uri 404; }  
    location ~ ^/modules/.*/formwidgets/.*/assets { try_files $uri 404; }  
    location ~ ^/modules/.*/formwidgets/.*/resources { try_files $uri 404; }  
    location ~ ^/modules/.*/reportwidgets/.*/assets { try_files $uri 404; }  
    location ~ ^/modules/.*/reportwidgets/.*/resources { try_files $uri 404; }  
   
    location ~ ^/plugins/.*/.*/assets { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/resources { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/behaviors/.*/assets { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/behaviors/.*/resources { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/reportwidgets/.*/assets { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/reportwidgets/.*/resources { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/formwidgets/.*/assets { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/formwidgets/.*/resources { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/widgets/.*/assets { try_files $uri 404; }  
    location ~ ^/plugins/.*/.*/widgets/.*/resources { try_files $uri 404; }  
   
    location ~ ^/themes/.*/assets { try_files $uri 404; }  
    location ~ ^/themes/.*/resources { try_files $uri 404; }  
   
}

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Befehl aus, um die Serverblockdatei octobercms.conf zu aktivieren und die Nginx-Syntax zu überprüfen.

sudo ln -s /etc/nginx/sites-available/octobercms.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Wenn Sie eine korrekte Syntax haben, sollten Sie eine Ausgabe wie ‘syntax is ok - test is successful’ erhalten.

Wenden Sie schließlich Ihre Änderungen auf Nginx an, indem Sie den Nginx-Dienst mit dem folgenden Befehl neu starten.

sudo systemctl restart nginx

OctoberCMS mit SSL/TLS-Zertifikaten sichern

An diesem Punkt läuft Ihr October CMS und ist zugänglich. Um sicherzustellen, dass Ihre Installation sicher ist, implementieren Sie HTTPS, indem Sie SSL/TLS-Zertifikate von letsencrypt generieren.

Führen Sie den folgenden Befehl aus, um SSL/TLS-Zertifikate für Ihre October CMS-Installation zu generieren. Stellen Sie sicher, dass Sie die E-Mail-Adresse und den Domainnamen mit Ihren Informationen ändern.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Sobald der Prozess abgeschlossen ist, wird Ihr Domainname automatisch mit HTTPS konfiguriert. Und Ihre SSL/TLS-Zertifikate sind im Verzeichnis /etc/letsencrypt/live/yourdomain.com verfügbar.

Zugriff auf OctoberCMS

Besuchen Sie den Domainnamen Ihrer October CMS-Installation, zum Beispiel https://howtoforge.local/ mit Ihrem bevorzugten Webbrowser.

Wenn Ihre Installation erfolgreich ist, sollten Sie die Standard-Homepage von OctoberCMS wie folgt erhalten.

Klicken Sie auf die Schaltfläche ‘Backend-Bereich‘, um auf die Admin-Seite von October CMS zuzugreifen.

Geben Sie die Daten des neuen Administrators ein, Name, E-Mail-Adresse und Passwort. Klicken Sie auf Konto erstellen, um zu bestätigen.

Wenn Sie fertig sind, sollten Sie das Administrator-Dashboard von October CMS wie folgt erhalten.

Fazit

Herzlichen Glückwunsch! Sie haben jetzt die Installation von October CMS auf dem Debian 12-Server abgeschlossen. Sie haben October CMS mit dem LEMP-Stack (Nginx, MariaDB und PHP-FPM) installiert. Sie haben auch Ihre Installation mit UFW (Uncomplicated Firewall) und SSL/TLS über Letsencrypt gesichert.