Cách cài đặt FreeScout Help Desk trên Debian 12

[theanh]

FreeScout là một helpdesk mã nguồn mở và hộp thư chung được viết bằng PHP và dựa trên nền tảng Laravel. Nó được xây dựng như một giải pháp thay thế cho Zendesk/Help Scout. Đây là một phần mềm helpdesk nhẹ và mạnh mẽ có thể cài đặt ở bất kỳ đâu. FreeScout là một phần mềm helpdesk thân thiện 100% với thiết bị di động và hỗ trợ xác thực Microsoft Exchange hiện đại và đa ngôn ngữ.

Hướng dẫn này sẽ hướng dẫn bạn từng bước cài đặt FreeScout Help Desk trên máy chủ Debian 12. Bạn sẽ cài đặt FreeScout với LEMP Stack (Nginx, MariaDB và PHP-FPM) trên máy chủ Debian và bảo mật cài đặt của bạn bằng chứng chỉ SSL/TLS từ Letsencrypt.

Điều kiện tiên quyết​

Trước khi tiếp tục, hãy xác nhận rằng bạn đã thu thập:

• Máy chủ Debian 12.
• Người dùng không phải root có quyền quản trị viên sudo.
• Tên miền trỏ đến địa chỉ IP của máy chủ.

Cài đặt Dependencies​

FreeScout Help Desk là ứng dụng mã nguồn mở được viết bằng PHP, hỗ trợ cơ sở dữ liệu MySQL/MariaDB hoặc PostgreSQL và có thể chạy với máy chủ web Nginx, Apache và IIS. Bạn sẽ cài đặt FreeScout với LEMP Stack (Nginx, MariaDB và PHP-FPM) trong hướng dẫn này.

Thực hiện lệnh sau để cập nhật và làm mới chỉ mục gói Debian của bạn.

sudo apt update

Sau khi kho lưu trữ được cập nhật, hãy chạy lệnh sau để cài đặt các phụ thuộc cho FreeScout Help Desk, bao gồm LEMP Stack (Nginx, MariaDB, PHP-FPM) với các tiện ích mở rộng PHP bổ sung và git.

sudo apt install nginx mariadb-server libmariadb-dev git php-fpm php-mysql php-mbstring php-xml php-imap php-zip php-gd php-curl php-intl

Nhập y để tiếp tục cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22122%22%3E%3C/svg%3E


Bây giờ với các phụ thuộc đã cài đặt, hãy xác minh từng phụ thuộc bằng cách thực hiện lệnh sau lệnh.

Xác minh dịch vụ Nginx để đảm bảo rằng dịch vụ đang chạy và được bật.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Đầu ra bên dưới cho biết Nginx đang chạy và được bật.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22240%22%3E%3C/svg%3E


Sau đó, xác minh dịch vụ MariaDB bằng lệnh bên dưới.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Bạn sẽ thấy một đầu ra tương tự được bật cho biết MariaDB đã được bật và hoạt động (đang chạy).


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22274%22%3E%3C/svg%3E


Bây giờ hãy thực hiện lệnh sau để xác minh PHP-FPM dịch vụ.

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

Đầu ra sau đây cho bạn thấy dịch vụ PHP-FPM đang chạy và được bật.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22321%22%3E%3C/svg%3E


Cuối cùng, hãy kiểm tra phiên bản PHP-FPM và danh sách các tiện ích mở rộng được bật bằng cách sử dụng lệnh sau lệnh.

php -v
php -m

Bạn sẽ thấy PHP-FPM 8.2 được cài đặt với một số tiện ích mở rộng được bật.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22607%22%20height=%22380%22%3E%3C/svg%3E

Cấu hình PHP-FPM​

Sau khi cài đặt các phần phụ thuộc, bạn sẽ cấu hình cài đặt PHP-FPM của mình bằng cách sửa đổi Tệp php.ini.

Mở cấu hình php.ini cho PHP-FPM /etc/php/8.2/fpm/php.ini bằng lệnh trình chỉnh sửa nano sau.

sudo nano /etc/php/8.2/fpm/php.ini

Thay đổi các tùy chọn sau và đảm bảo điều chỉnh thông tin chi tiết về múi giờ và giới hạn bộ nhớ theo môi trường máy chủ của bạn.

memory_limit = 512M
date.timezone = Europe/Stockholm
upload_max_filesize = 16M
cgi.fix_pathinfo=0

Lưu và thoát khỏi tệp khi bạn hoàn tất.

Bây giờ hãy chạy lệnh systemctl bên dưới để khởi động lại dịch vụ PHP-FPM và áp dụng các thay đổi.

sudo systemctl restart php8.2-fpm

Cấu hình Máy chủ MariaDB​

Trong bước tiếp theo, bạn sẽ bảo mật cài đặt máy chủ MariaDB của mình thông qua tiện ích mariadb-secure-installation. Sau đó, bạn sẽ tạo một cơ sở dữ liệu và người dùng mới sẽ được FreeScout sử dụng.

Để bảo mật máy chủ MariaDB của bạn, hãy nhập lệnh sau.

sudo mariadb-secure-installation

Trong quá trình này, nhập Y để xác nhận cấu hình mới hoặc n để không và từ chối. Dưới đây là một số cấu hình máy chủ MariaDB mà bạn sẽ được yêu cầu:

• Chuyển xác thực cục bộ sang unix_socket? Nhập n để không.
• Thiết lập mật khẩu gốc MariaDB? Nhập y, sau đó nhập mật khẩu gốc MariaDB mới và lặp lại.
• Xóa người dùng ẩn danh mặc định? Nhập y để xác nhận.
• Vô hiệu hóa đăng nhập từ xa cho người dùng gốc? Nhập y để xác nhận.
• Xóa kiểm tra cơ sở dữ liệu mặc định? Nhập y để xác nhận.
• Tải lại đặc quyền bảng và áp dụng các thay đổi? Nhập y để xác nhận.

Sau khi bảo mật máy chủ MariaDB, bạn sẽ tạo cơ sở dữ liệu MariaDB và người dùng mới sẽ được FreeScout sử dụng. Điều này có thể được thực hiện bằng cách đăng nhập vào máy chủ MariaDB thông qua máy khách mariadb.

Thực hiện lệnh mariadb bên dưới để đăng nhập vào máy chủ MariaDB. Nhập mật khẩu gốc MariaDB của bạn khi được yêu cầu.

sudo mariadb -u root -p

Bây giờ hãy chạy các truy vấn sau để tạo cơ sở dữ liệu mới freescout và người dùng freescout. Hãy chắc chắn thay đổi mật khẩu trong truy vấn sau.

CREATE DATABASE freescout CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON freescout.* TO freescout@localhost IDENTIFIED BY "password";
FLUSH PRIVILEGES;

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22148%22%3E%3C/svg%3E


Tiếp theo, chạy truy vấn bên dưới để xác minh người dùng freescout và đảm bảo rằng người dùng có thể truy cập cơ sở dữ liệu freescout.

SHOW GRANTS FOR freescout@localhost;

Kết quả đầu ra sau đây xác nhận rằng người dùng freescout có thể truy cập cơ sở dữ liệu freescout.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22256%22%3E%3C/svg%3E


Bây giờ bạn có thể nhập quit để thoát khỏi máy chủ MariaDB.

Tải xuống mã nguồn FreeScout​

Bây giờ máy chủ PHP-FPM và MariaDB đã được cấu hình, bước tiếp theo là tải xuống mã nguồn FreeScout qua Git, sau đó thiết lập quyền và quyền sở hữu thích hợp cho mã nguồn FreeScout.

Thực hiện lệnh sau để tạo thư mục gốc web mới /var/www/freescout và di chuyển vào đó.

mkdir -p /var/www/freescout; cd /var/www/freescout

Tải xuống mã nguồn FreeScout từ GitHub qua lệnh git bên dưới.

git clone https://github.com/freescout-helpdesk/freescout .

Sau khi quá trình hoàn tất, hãy thực hiện lệnh bên dưới để thay đổi quyền sở hữu thư mục gốc web /var/www/freescout thành người dùng www-data. Điều này sẽ cho phép Nginx truy cập mã nguồn FreeScout.

sudo chown -R www-data:www-data /var/www/freescout

Cuối cùng, bạn cũng có thể đảm bảo rằng mỗi thư mục và tệp có quyền thích hợp bằng cách thực hiện lệnh sau.

find /var/www/freescout -type f -exec chmod 664 {} \; 
find /var/www/freescout -type d -exec chmod 775 {} \;

Lúc này, bạn đã tải mã nguồn FreeScout xuống thư mục gốc của web /var/www/freescout. Ở bước tiếp theo, bạn sẽ tạo cấu hình khối máy chủ Nginx mới sẽ được sử dụng để chạy cài đặt FreeScout của bạn.

Cấu hình khối máy chủ Nginx​

Sau khi tải xuống mã nguồn FreeScout, bạn sẽ tạo khối máy chủ Nginx mới sẽ được sử dụng để chạy cài đặt FreeScout của bạn. Trước khi tiếp tục, hãy đảm bảo bạn đã trỏ tên miền đến địa chỉ IP máy chủ của mình.

Tạo cấu hình khối máy chủ Nginx mới /etc/nginx/sites-available/freescout bằng lệnh nano editor sau.

sudo nano /etc/nginx/sites-available/freescout

Chèn cấu hình sau và đảm bảo thay đổi tên miền

server {
 listen 80;

 server_name howtoforge.local;
 root /var/www/freescout/public;
 index index.php index.html index.htm;

 error_log /var/www/freescout/storage/logs/web-server.log;

 location / {
 try_files $uri $uri/ /index.php?$query_string;
 }
 location ~ \.php$ {
 fastcgi_split_path_info ^(.+\.php)(/.+)$;
 fastcgi_pass unix:/run/php/php8.2-fpm.sock;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
 # Uncomment this location if you want to improve attachments downloading speed.
 # Also make sure to set APP_DOWNLOAD_ATTACHMENTS_VIA=nginx in the .env file.
 #location ^~ /storage/app/attachment/ {
 # internal;
 # alias /var/www/freescout/storage/app/attachment/;
 #}
 location ~* ^/storage/attachment/ {
 expires 1M;
 access_log off;
 try_files $uri $uri/ /index.php?$query_string;
 }
 location ~* ^/(?:css|js)/.*\.(?:css|js)$ {
 expires 2d;
 access_log off;
 add_header Cache-Control "public, must-revalidate";
 }
 location ~* ^/(?:css|fonts|img|installer|js|modules|[^\\\]+\..*)$ {
 expires 1M;
 access_log off;
 add_header Cache-Control "public";
 }
 location ~ /\. {
 deny all;
 }
}

Lưu tệp và thoát khỏi trình chỉnh sửa khi hoàn tất.

Tiếp theo, chạy lệnh sau để kích hoạt tệp khối máy chủ /etc/nginx/sites-available/freescout và xác minh cú pháp Nginx của bạn.

sudo ln -s /etc/nginx/sites-available/freescout /etc/nginx/sites-enabled/
sudo nginx -t

Nếu bạn có cú pháp phù hợp, bạn sẽ nhận được đầu ra test is successful - syntax là được.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22198%22%3E%3C/svg%3E


Bây giờ hãy chạy lệnh sau để khởi động lại dịch vụ Nginx và áp dụng các thay đổi bạn đã thực hiện.

sudo systemctl restart nginx

Trong bước tiếp theo, bạn sẽ và phải tạo chứng chỉ SSL/TLS từ letsencrypt thông qua Certbot và Plugin Certbot Nginx.

Bảo mật FreeScout bằng Chứng chỉ SSL/TLS​

Để cài đặt FreeScout Help Desk, bạn phải bật HTTPS trên máy chủ web của mình. Trong bước tiếp theo, bạn sẽ tạo chứng chỉ SSL/TLS từ Letsencrypt thông qua plugin Certbot và Certbot Nginx.

Cài đặt plugin Certbot và Certbot Nginx bằng lệnh apt sau. Nhập y để tiếp tục cài đặt.

sudo apt install certbot python3-certbot-nginx

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22644%22%20height=%22374%22%3E%3C/svg%3E


Tiếp theo, chạy lệnh certbot bên dưới để tạo chứng chỉ SSL/TLS mới cho tên miền của bạn. Hãy đảm bảo thay đổi thông tin chi tiết về địa chỉ email và tên miền bằng thông tin của bạn.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [emailprotected] -d help.example.io

Sau khi quá trình hoàn tất, chứng chỉ SSL/TLS của bạn sẽ có tại thư mục /etc/letsencrypt/live/domain.com/. Ngoài ra, tệp khối máy chủ Nginx của bạn /etc/nginx/sites-available/freescout sẽ tự động được cấu hình bằng HTTPS, được thực hiện bởi plugin Certbot Nginx.

Cài đặt FreeScount thông qua Trình cài đặt web​

Khởi chạy trình duyệt web của bạn và truy cập tên miền cài đặt FreeScount của bạn, chẳng hạn như http://glpi.howtoforge.local/. Bạn sẽ được chuyển hướng đến kết nối HTTPS an toàn và trang cài đặt FreeScount.

Nhấp vào Kiểm tra yêu cầu để đảm bảo rằng mọi tiện ích mở rộng PHP cần thiết đã được cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22708%22%20height=%22434%22%3E%3C/svg%3E


Nếu các tiện ích mở rộng PHP cần thiết đã được cài đặt, hãy nhấp vào Kiểm tra quyền để tiếp tục.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22436%22%20height=%22750%22%3E%3C/svg%3E


Bây giờ hãy đảm bảo rằng quyền cho thư mục FreeScout là có thể ghi được. Sau đó, nhấp vào Cấu hình môi trường.



Nhập tên miền của bạn vào phần cài đặt URL ứng dụng và nhấp vào Thiết lập cơ sở dữ liệu


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22563%22%20height=%22460%22%3E%3C/svg%3E


Chọn cơ sở dữ liệu mặc định là MySQL và nhập thông tin chi tiết về tên cơ sở dữ liệu, người dùng và mật khẩu. Sau đó, nhấp vào Thiết lập ứng dụng để tiếp tục.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22466%22%20height=%22750%22%3E%3C/svg%3E


Chọn ngôn ngữ và múi giờ của ứng dụng rồi nhấp vào Thiết lập quản trị.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22544%22%20height=%22524%22%3E%3C/svg%3E


Bây giờ hãy tạo một người dùng quản trị mới cho cài đặt FreeScount của bạn. Nhập địa chỉ email, tên người dùng mới và mật khẩu, sau đó nhấp vào Cài đặt để tiếp tục cài đặt FreeScout.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22548%22%20height=%22683%22%3E%3C/svg%3E


Sau khi cài đặt thành công, bạn sẽ thấy thông báo xác nhận sau. Ngoài ra, bạn có thể thấy rằng bạn cần tạo một công việc cron mới cho FreeScout.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22541%22%20height=%22697%22%3E%3C/svg%3E


Quay lại máy chủ đầu cuối của bạn và chạy lệnh sau để tạo một công việc cron mới cho FreeScout.

crontab -u www-data -e

Nhập cấu hình bên dưới.

* * * * * php /var/www/freescout/artisan schedule:run >> /dev/null 2>&1

Lưu và đóng tệp khi hoàn tất.

Tiếp theo, quay lại trình duyệt web của bạn, nhấp vào Đăng nhập, sau đó bạn sẽ thấy trang đăng nhập FreeScout. Nhập địa chỉ email quản trị và mật khẩu của bạn, sau đó nhấp vào Đăng nhập.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22324%22%3E%3C/svg%3E


Nếu cài đặt thành công, bạn sẽ thấy bảng điều khiển FreeScout như sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22328%22%3E%3C/svg%3E

Kết luận​

Để kết luận, bạn đã cài đặt thành công FreeScout Help Desk trên máy chủ Debian 12 với LEMP Stack (Nginx, MariaDB và PHP-FPM). Bạn cũng đã bảo mật cài đặt FreeScout của mình bằng chứng chỉ SSL/TLS, được tạo từ letsencrypt. Bây giờ bạn có thể triển khai và sử dụng FreeScout làm nền tảng Help Desk cho tổ chức cục bộ/nội bộ của mình.