Cómo instalar osTicket con Nginx en Debian 11

osTicket es un sistema de tickets de soporte gratuito y de código abierto utilizado para escalar y optimizar su servicio al cliente y mejorar su experiencia. Ofrece una interfaz basada en la web para gestionar, organizar y rastrear todos los tickets de soporte. Está escrito en PHP y soporta varias bases de datos como MySQL y PostgreSQL.

Características

Informes del panel de control
Tema de ayuda configurable
Acuerdos de nivel de servicio
Filtros de tickets
Portal de soporte al cliente
Respuesta automática

Este tutorial le mostrará cómo instalar osTicket en Debian 11.

Requisitos previos

Un servidor que ejecute Debian 11.
Un nombre de dominio válido apuntado a la IP de su servidor.
Una contraseña de root configurada en el servidor.

Comenzando

Primero, actualice y mejore todos los paquetes del sistema a la última versión utilizando el siguiente comando.

apt update -y  
apt upgrade -y

Una vez que todos los paquetes estén actualizados, puede instalar otros paquetes requeridos con el siguiente comando:

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

Una vez que todos los paquetes requeridos estén instalados, puede proceder al siguiente paso.

Instalar Nginx y PHP

Primero, instale el paquete del servidor web Nginx utilizando el siguiente comando.

apt install nginx -y

A continuación, agregue el repositorio de PHP utilizando el siguiente comando.

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

A continuación, instale la última versión de PHP y otras dependencias de PHP requeridas utilizando el siguiente comando.

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

Después de la instalación, edite el archivo de configuración de PHP.

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

Cambie la siguiente línea.

cgi.fix_pathinfo=0

Guarde y cierre el archivo, luego reinicie el servicio PHP-FPM para aplicar los cambios.

systemctl restart php8.1-fpm

Instalar y configurar MariaDB

Primero, instale el servidor de base de datos MariaDB utilizando el siguiente comando.

apt install mariadb-server -y

A continuación, asegure la instalación de MariaDB con el siguiente comando.

mysql_secure_installation

Responda todas las preguntas a continuación:

¿Establecer contraseña de root? [Y/n] Y
Nueva contraseña:
Reingrese la nueva contraseña:
¿Eliminar usuarios anónimos? [Y/n] Y
¿Deshabilitar el inicio de sesión remoto de root? [Y/n] Y
¿Eliminar la base de datos de prueba y el acceso a ella? [Y/n] Y
¿Recargar las tablas de privilegios ahora? [Y/n] Y

A continuación, inicie sesión en el shell de MariaDB como usuario root.

mysql -u root -p

A continuación, cree una base de datos y un usuario para osTicket.

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

A continuación, limpie los privilegios y salga del shell de MariaDB con el siguiente comando.

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

Instalar osTicket

Primero, descargue la última versión de osTicket desde la página de descargas de GitHub.

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

Una vez que la descarga esté completa, cree un directorio para osTicket y extraiga el archivo descargado dentro de ese directorio.

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

A continuación, establezca la propiedad y los permisos en el directorio osticket.

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

A continuación, renombre el archivo de configuración de muestra de osTicket.

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

Una vez que haya terminado, puede proceder al siguiente paso.

Configurar Nginx para osTicket

A continuación, necesitará crear un archivo de configuración de host virtual de Nginx para osTicket. Puede crearlo con el siguiente comando.

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

Agregue la siguiente configuración.

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;


# Habilitar gzip
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;
}
}

Guarde y cierre el archivo, luego verifique la configuración de Nginx con el siguiente comando.

ginx -t

Obtendrá la siguiente salida.

nginx: el archivo de configuración /etc/nginx/nginx.conf tiene una sintaxis correcta
ginx: la prueba del archivo de configuración /etc/nginx/nginx.conf fue exitosa

A continuación, reinicie el servicio Nginx para aplicar los cambios.

systemctl restart nginx

También puede verificar el estado de Nginx utilizando el siguiente comando.

systemctl status nginx

Debería ver el estado de Nginx en la siguiente salida.

? nginx.service - Un servidor web de alto rendimiento y un servidor proxy inverso
     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: proceso maestro /usr/sbin/nginx -g daemon on; master_process on;
             ??24703 nginx: proceso trabajador

Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Succeeded.
Dec 21 08:15:10 debian11 systemd[1]: Detenido Un servidor web de alto rendimiento y un servidor proxy inverso.
Dec 21 08:15:10 debian11 systemd[1]: Iniciando Un servidor web de alto rendimiento y un servidor proxy inverso...
Dec 21 08:15:10 debian11 systemd[1]: nginx.service: Error al analizar PID del archivo /run/nginx.pid: Argumento no válido
Dec 21 08:15:10 debian11 systemd[1]: Iniciado Un servidor web de alto rendimiento y un servidor proxy inverso.

En este punto, Nginx está instalado y configurado para osTicket. Ahora puede proceder a acceder a osTicket.

Acceder a la interfaz web de osTicket

Abra su navegador web y acceda a la página de instalación de osTicket utilizando la URL http://osticket.example.com. Debería ver la página de requisitos previos.

Haga clic en Continuar. Debería ver la página de instalación básica.

Defina su URL de mesa de ayuda, nombre, correo electrónico, nombre de la base de datos, nombre de usuario, contraseña, luego haga clic en el botón Instalar ahora para comenzar la instalación. Una vez que osTicket esté instalado, debería ver la siguiente página.

Para acceder al panel de control de osTicket, escriba la URL http://osticket.example.com/scp en su navegador web. Debería ver la página de inicio de sesión de osTicket.

Proporcione su nombre de usuario de administrador, contraseña y haga clic en el botón Iniciar sesión. Debería ver el panel de control de osTicket en la siguiente pantalla.

También puede acceder a la página del foro de osTicket utilizando la URL https://forum.osticket.com.

Habilitar SSL en osTicket

Para instalar el SSL de Let’s Encrypt en el sitio web de osTicket, necesitará instalar el paquete certbot en su servidor.

Primero, instale el administrador de paquetes Snap con el siguiente comando:

apt install snapd

A continuación, actualice el paquete Snap a la última versión:

snap install core  
snap refresh core

A continuación, instale el paquete certbot utilizando el siguiente comando:

snap install --classic certbot

A continuación, cree un enlace simbólico para el binario de Certbot en la ubicación del sistema:

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

A continuación, ejecute el siguiente comando para descargar e instalar los certificados SSL de Let’s Encrypt:

certbot --nginx -d osticket.example.com

Se le pedirá que proporcione su dirección de correo electrónico y acepte los términos del servicio:

Guardando el registro de depuración en /var/log/letsencrypt/letsencrypt.log
Ingrese la dirección de correo electrónico (utilizada para renovación urgente y avisos de seguridad)
 (Ingrese 'c' para cancelar): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Por favor, lea los Términos de Servicio en
https://letsencrypt.org/documents/LE-SA-v1.3-September-21-2022.pdf. Debe
estar de acuerdo para registrarse en el servidor ACME. ¿Está de acuerdo?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
¿Estaría dispuesto, una vez que su primer certificado se emita con éxito,
a compartir su dirección de correo electrónico con la Electronic Frontier Foundation, un socio fundador del proyecto Let's Encrypt y la organización sin fines de lucro que
desarrolla Certbot? Nos gustaría enviarle un correo electrónico sobre nuestro trabajo de cifrado de la web,
noticias de EFF, campañas y formas de apoyar la libertad digital.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y

Escriba Y y presione la tecla Enter para descargar e instalar los certificados SSL para su dominio:

Cuenta registrada.
Solicitando un certificado para osticket.example.com

Certificado recibido con éxito.
El certificado se guarda en: /etc/letsencrypt/live/osticket.example.com/fullchain.pem
La clave se guarda en:         /etc/letsencrypt/live/osticket.example.com/privkey.pem
Este certificado expira el 2023-03-22.
Estos archivos se actualizarán cuando el certificado se renueve.
Certbot ha configurado una tarea programada para renovar automáticamente este certificado en segundo plano.

Desplegando certificado
Certificado desplegado con éxito para osticket.example.com en /etc/nginx/conf.d/osticket.conf
¡Felicidades! Ha habilitado HTTPS en https://osticket.example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Si le gusta Certbot, considere apoyar nuestro trabajo:
 * Donando a ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donando a EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Conclusión

¡Felicidades! ha instalado con éxito osTicket con Nginx en Debian 11. Ahora puede implementar osTicket en su empresa y usarlo como un sistema de gestión de helpdesk. No dude en preguntarme si tiene alguna pregunta.