Wie man osTicket mit Nginx auf Debian 11 installiert

osTicket ist ein kostenloses und Open-Source-Support-Ticketsystem, das verwendet wird, um Ihren Kundenservice zu skalieren und zu optimieren sowie Ihre Kundenerfahrung zu verbessern. Es bietet eine webbasierte Schnittstelle zur Verwaltung, Organisation und Verfolgung aller Support-Tickets. Es ist in PHP geschrieben und unterstützt verschiedene Datenbanken wie MySQL und PostgreSQL.

Funktionen

Dashboard-Berichte
Konfigurierbares Hilfethema
Service Level Agreements
Ticketfilter
Kunden-Support-Portal
Auto-Responder

Dieses Tutorial zeigt Ihnen, wie Sie osTicket auf Debian 11 installieren.

Voraussetzungen

Ein Server, der Debian 11 ausführt.
Ein gültiger Domainname, der auf Ihre Server-IP zeigt.
Ein Root-Passwort, das auf dem Server konfiguriert ist.

Erste Schritte

Zuerst aktualisieren und upgraden Sie alle Systempakete auf die neueste Version mit dem folgenden Befehl.

apt update -y  
apt upgrade -y

Sobald alle Pakete aktualisiert sind, können Sie die anderen erforderlichen Pakete mit dem folgenden Befehl installieren:

apt install ca-certificates apt-transport-https software-properties-common wget curl

Sobald alle erforderlichen Pakete installiert sind, können Sie mit dem nächsten Schritt fortfahren.

Nginx und PHP installieren

Zuerst installieren Sie das Nginx-Webserver-Paket mit dem folgenden Befehl.

apt install nginx -y

Als nächstes fügen Sie das PHP-Repository mit dem folgenden Befehl hinzu.

curl -sSL https://packages.sury.org/php/README.txt | bash -x

Als nächstes installieren Sie die neueste Version von PHP und andere erforderliche PHP-Abhängigkeiten mit dem folgenden Befehl.

apt install php8.1 php8.1-mysql php8.1-cgi php8.1-fpm php8.1-cli php8.1-curl php8.1-gd php8.1-imap php8.1-mbstring php8.1-intl php8.1-apcu php8.1-common php8.1-gettext php8.1-bcmath php8.1-xml php8.1-dom -y

Nach der Installation bearbeiten Sie die PHP-Konfigurationsdatei.

nano /etc/php/8.1/fpm/php.ini

Ändern Sie die folgende Zeile.

cgi.fix_pathinfo=0

Speichern Sie die Datei und schließen Sie sie, und starten Sie dann den PHP-FPM-Dienst neu, um die Änderungen anzuwenden.

systemctl restart php8.1-fpm

MariaDB installieren und konfigurieren

Zuerst installieren Sie den MariaDB-Datenbankserver mit dem folgenden Befehl.

apt install mariadb-server -y

Als nächstes sichern Sie die MariaDB-Installation mit dem folgenden Befehl.

mysql_secure_installation

Beantworten Sie alle Fragen unten:

Set root password? [Y/n] Y
New password:
Re-enter new password:
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Als nächstes melden Sie sich in der MariaDB-Shell als Root-Benutzer an.

mysql -u root -p

Als nächstes erstellen Sie eine Datenbank und einen Benutzer für osTicket.

MariaDB [(none)]> create database osticketdb;  
MariaDB [(none)]> grant all privileges on osticketdb.* to osticketuser identified by 'secure-password';

Als nächstes flushen Sie die Berechtigungen und verlassen die MariaDB-Shell mit dem folgenden Befehl.

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

osTicket installieren

Zuerst laden Sie die neueste Version von osTicket von der GitHub-Downloadseite herunter.

wget https://github.com/osTicket/osTicket/releases/download/v1.17.2/osTicket-v1.17.2.zip

Sobald der Download abgeschlossen ist, erstellen Sie ein Verzeichnis für osTicket und extrahieren die heruntergeladene Datei in dieses Verzeichnis.

mkdir /var/www/html/osticket  
unzip osTicket-v1.17.2.zip -d /var/www/html/osticket

Als nächstes setzen Sie den Besitz und die Berechtigung für das osticket-Verzeichnis.

chown -R www-data:www-data /var/www/html/osticket  
chmod -R 755 /var/www/html/osticket

Als nächstes benennen Sie die osTicket-Beispielkonfigurationsdatei um.

mv /var/www/html/osticket/upload/include/ost-sampleconfig.php /var/www/html/osticket/upload/include/ost-config.php

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Nginx für osTicket konfigurieren

Als nächstes müssen Sie eine Nginx-virtuelle Hostkonfigurationsdatei für osTicket erstellen. Sie können sie mit dem folgenden Befehl erstellen.

nano /etc/nginx/conf.d/osticket.conf

Fügen Sie die folgende Konfiguration hinzu.

server {
listen 80;
server_name osticket.example.com;
root /var/www/html/osticket/upload;
index index.php index.html index.htm;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;


# Gzip aktivieren
gzip on;
gzip_min_length 1000;
gzip_types text/plain application/x-javascript text/xml text/css application/xml;

set $path_info "";

location ~ /include {
deny all;
return 403;
}

if ($request_uri ~ "^/api(/[^"]+)") {
set $path_info $1;
}

location ~ ^/api/(?:tickets|tasks).*$ {
try_files $uri $uri/ /api/http.php?$query_string;
}

if ($request_uri ~ "^/scp/.*\.php(/[^"]+)") {
set $path_info $1;
}

location ~ ^/scp/ajax.php/.*$ {
try_files $uri $uri/ /scp/ajax.php?$query_string;
}

location / {
try_files $uri $uri/ index.php;
}

location ~ \.php$ {
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}
}

Speichern Sie die Datei und schließen Sie sie, und überprüfen Sie dann die Nginx-Konfiguration mit dem folgenden Befehl.

ginx -t

Sie erhalten die folgende Ausgabe.

nginx: die Konfigurationsdatei /etc/nginx/nginx.conf Syntax ist ok
nginx: Konfigurationsdatei /etc/nginx/nginx.conf Test war erfolgreich

Als nächstes starten Sie den Nginx-Dienst neu, um die Änderungen anzuwenden.

systemctl restart nginx

Sie können auch den Nginx-Status mit dem folgenden Befehl überprüfen.

systemctl status nginx

Sie sollten den Nginx-Status in der folgenden Ausgabe sehen.

? nginx.service - Ein Hochleistungs-Webserver und ein Reverse-Proxy-Server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-12-21 08:15:10 UTC; 4s ago
       Docs: man:nginx(8)
    Process: 24700 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 24701 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 24702 (nginx)
      Tasks: 2 (limit: 2339)
     Memory: 3.1M
        CPU: 25ms
     CGroup: /system.slice/nginx.service
             ??24702 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??24703 nginx: worker process

Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Succeeded.
Dec 21 08:15:10 debian11 systemd[1]: Stopped Ein Hochleistungs-Webserver und ein Reverse-Proxy-Server.
Dec 21 08:15:10 debian11 systemd[1]: Starting Ein Hochleistungs-Webserver und ein Reverse-Proxy-Server...
Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Dec 21 08:15:10 debian11 systemd[1]: Started Ein Hochleistungs-Webserver und ein Reverse-Proxy-Server.

An diesem Punkt ist Nginx installiert und für osTicket konfiguriert. Sie können jetzt auf osTicket zugreifen.

Greifen Sie auf die osTicket-Weboberfläche zu

Öffnen Sie Ihren Webbrowser und greifen Sie auf die osTicket-Installationsseite über die URL http://osticket.example.com zu. Sie sollten die Voraussetzungen-Seite sehen.

Klicken Sie auf Weiter. Sie sollten die grundlegende Installationsseite sehen.

Definieren Sie Ihre Helpdesk-URL, Name, E-Mail, Datenbankname, Benutzername, Passwort und klicken Sie dann auf die Schaltfläche Jetzt installieren, um mit der Installation zu beginnen. Sobald osTicket installiert ist, sollten Sie die folgende Seite sehen.

Um auf das osTicket-Kontrollfeld zuzugreifen, geben Sie die URL http://osticket.example.com/scp in Ihren Webbrowser ein. Sie sollten die osTicket-Login-Seite sehen.

Geben Sie Ihren Admin-Benutzernamen, Ihr Passwort ein und klicken Sie auf die Schaltfläche Anmelden. Sie sollten das osTicket-Dashboard auf dem folgenden Bildschirm sehen.

Sie können auch auf die osTicket-Forumseite über die URL https://forum.osticket.com zugreifen.

SSL für osTicket aktivieren

Um das Let’s Encrypt SSL auf der osTicket-Website zu installieren, müssen Sie das certbot-Paket auf Ihrem Server installieren.

Zuerst installieren Sie den Snap-Paketmanager mit dem folgenden Befehl:

apt install snapd

Als nächstes aktualisieren Sie das Snap-Paket auf die neueste Version:

snap install core  
snap refresh core

Als nächstes installieren Sie das certbot-Paket mit dem folgenden Befehl:

snap install --classic certbot

Als nächstes erstellen Sie einen symbolischen Link für die Certbot-Binärdatei an dem Systemstandort:

ln -s /snap/bin/certbot /usr/bin/certbot

Als nächstes führen Sie den folgenden Befehl aus, um Let’s Encrypt SSL-Zertifikate herunterzuladen und zu installieren:

certbot --nginx -d osticket.example.com

Sie werden aufgefordert, Ihre E-Mail-Adresse anzugeben und den Nutzungsbedingungen zuzustimmen:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.3-September-21-2022.pdf. You must
agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

Geben Sie Y ein und drücken Sie die Eingabetaste, um die SSL-Zertifikate für Ihre Domain herunterzuladen und zu installieren:

Account registered.
Requesting a certificate for osticket.example.com

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/osticket.example.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/osticket.example.com/privkey.pem
This certificate expires on 2023-03-22.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for osticket.example.com to /etc/nginx/conf.d/osticket.conf
Congratulations! You have successfully enabled HTTPS on https://osticket.example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Fazit

Herzlichen Glückwunsch! Sie haben osTicket erfolgreich mit Nginx auf Debian 11 installiert. Sie können osTicket jetzt in Ihrem Unternehmen implementieren und als Helpdesk-Management-System verwenden. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.