如何在 Debian 12 上安装 FreeScout Help Desk
FreeScout 是一个用 PHP 编写并基于 Laravel 框架的开源帮助台和共享收件箱。它是作为 Zendesk/Help Scout 的替代品而构建的。它是一款轻量级且功能强大的帮助台软件,可以安装在任何地方。 FreeScout 是一款 100% 移动友好的帮助台软件,支持多语言和现代 Microsoft Exchange 身份验证。
本指南将引导您在 Debian 12 服务器上逐步安装 FreeScout Help Desk。您将在 Debian 服务器上安装带有 LEMP Stack(Nginx、MariaDB 和 PHP-FPM)的 FreeScout,并使用 Letsencrypt 的 SSL/TLS 证书保护您的安装。
先决条件
在继续之前,请确认您已收集:
- Debian 12 服务器。
- 具有 sudo 管理员权限的非 root 用户。
- 域名指向服务器IP地址。
安装依赖项
FreeScout Help Desk 是一个用 PHP 编写的开源应用程序,支持 MySQL/MariaDB 或 PostgreSQL 数据库,并且可以与 Nginx、Apache 和 IIS Web 服务器一起运行。在本指南中,您将使用 LEMP Stack(Nginx、MariaDB 和 PHP-FPM)安装 FreeScout。
执行以下命令来更新和刷新您的 Debian 软件包索引。
sudo apt update
更新存储库后,运行以下命令来安装 FreeScout Help Desk 的依赖项,包括 LEMP Stack(Nginx、MariaDB、PHP-FPM)以及其他 PHP 扩展和 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输入 y 继续安装。
现在安装了依赖项,通过执行以下命令验证每个依赖项。
验证 Nginx 服务以确保该服务正在运行并启用。
sudo systemctl is-enabled nginx
sudo systemctl status nginx下面的输出表明 Nginx 正在运行并启用。
然后,使用以下命令验证 MariaDB 服务。
sudo systemctl is-enabled mariadb
sudo systemctl status mariadb您应该看到类似的输出已启用,这表明 MariaDB 已启用且处于活动状态(正在运行)。
现在执行以下命令来验证 PHP-FPM 服务。
sudo systemctl is-enabled php8.2-fpm
sudo systemctl status php8.2-fpm以下输出显示 PHP-FPM 服务正在运行并已启用。
最后,使用以下命令检查 PHP-FPM 版本和启用的扩展列表。
php -v
php -m您应该看到 PHP-FPM 8.2 已安装并带有一些启用的扩展。
配置 PHP-FPM
安装依赖项后,您将通过修改 php.ini 文件来配置 PHP-FPM 安装。
使用以下 nano 编辑器命令打开 PHP-FPM /etc/php/8.2/fpm/php.ini 的 php.ini 配置。
sudo nano /etc/php/8.2/fpm/php.ini更改以下选项,并确保根据您的服务器环境调整时区和内存限制的详细信息。
memory_limit = 512M
date.timezone = Europe/Stockholm
upload_max_filesize = 16M
cgi.fix_pathinfo=0完成后保存并退出文件。
现在运行下面的 systemctl 命令来重新启动 PHP-FPM 服务并应用更改。
sudo systemctl restart php8.2-fpm配置 MariaDB 服务器
在接下来的步骤中,您将通过mariadb-secure-installation实用程序保护您的MariaDB服务器安装。然后,您将创建 FreeScout 将使用的新数据库和用户。
要保护您的 MariaDB 服务器,请输入以下命令。
sudo mariadb-secure-installation在此过程中,输入 Y 确认新配置,或输入 n 表示否并拒绝。下面是您需要提供的一些 MariaDB 服务器配置:
- 将本地身份验证切换到 unix_socket?输入 n 表示编号。
- 设置 MariaDB root 密码?输入 y,然后输入新的 MariaDB root 密码并重复。
- 删除默认的匿名用户?输入 y 确认。
- 禁用 root 用户远程登录?输入 y 确认。
- 删除默认数据库测试?输入 y 确认。
- 重新加载表权限并应用更改?输入 y 确认。
确保 MariaDB 服务器安全后,您将创建一个新的 MariaDB 数据库和用户,供 FreeScout 使用。这可以通过 mariadb 客户端登录 MariaDB 服务器来完成。
执行下面的mariadb命令登录MariaDB服务器。当询问时输入您的 MariaDB root 密码。
sudo mariadb -u root -p现在运行以下查询来创建新数据库 freescout 和用户 freescout。请务必在以下查询中更改密码。
CREATE DATABASE freescout CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON freescout.* TO freescout@localhost IDENTIFIED BY "password";
FLUSH PRIVILEGES;接下来,运行以下查询来验证用户 freescout 并确保用户可以访问数据库 freescout。
SHOW GRANTS FOR freescout@localhost;以下输出确认用户 freescout 可以访问数据库 freescout。
您现在可以输入 quit 退出 MariaDB 服务器。
下载 FreeScout 源代码
现在 PHP-FPM 和 MariaDB 服务器已配置完毕,下一步是通过 Git 下载 FreeScout 源代码,然后设置 FreeScout 源代码的适当权限和所有权。
执行以下命令创建一个新的 Web 根目录 /var/www/freescout 并移入其中。
mkdir -p /var/www/freescout; cd /var/www/freescout通过下面的 git 命令从 GitHub 下载 FreeScout 源代码。
git clone https://github.com/freescout-helpdesk/freescout .该过程完成后,执行以下命令将 Web 根目录 /var/www/freescout 的所有权更改为用户 www-data。这将允许 Nginx 访问 FreeScout 源代码。
sudo chown -R www-data:www-data /var/www/freescout最后,您还可以通过执行以下命令来确保每个目录和文件都有适当的权限。
find /var/www/freescout -type f -exec chmod 664 {} \;
find /var/www/freescout -type d -exec chmod 775 {} \;此时,您已将 FreeScout 源代码下载到 Web 根目录 /var/www/freescout。在下一步中,您将创建一个新的 Nginx 服务器块配置,用于运行 FreeScout 安装。
配置 Nginx 服务器块
下载 FreeScout 源代码后,您将创建一个新的 Nginx 服务器块,用于运行 FreeScout 安装。在继续之前,请确保您的域名指向您的服务器 IP 地址。
使用以下 nano 编辑器命令创建新的 Nginx 服务器块配置 /etc/nginx/sites-available/freescout。
sudo nano /etc/nginx/sites-available/freescout插入以下配置,一定要更改域名
server {
listen 80;
server_name hwdomain.io;
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;
}
}完成后保存文件并退出编辑器。
接下来,运行以下命令激活服务器块文件 /etc/nginx/sites-available/freescout 并验证您的 Nginx 语法。
sudo ln -s /etc/nginx/sites-available/freescout /etc/nginx/sites-enabled/
sudo nginx -t如果您的语法正确,您应该得到一个输出测试成功 - 语法正常。
现在运行以下命令来重新启动 Nginx 服务并应用您所做的更改。
sudo systemctl restart nginx在下一步中,您将并且必须通过 Certbot 和 Certbot Nginx 插件从 LetsEncrypt 生成 SSL/TLS 证书。
使用 SSL/TLS 证书保护 FreeScout
要安装 FreeScout Help Desk,您必须在 Web 服务器上启用 HTTPS。在接下来的步骤中,您将通过 Certbot 和 Certbot Nginx 插件从 Letsencrypt 生成 SSL/TLS 证书。
使用以下 apt 命令安装 Certbot 和 Certbot Nginx 插件。输入 y 继续安装。
sudo apt install certbot python3-certbot-nginx接下来,运行下面的 certbot 命令为您的域名生成新的 SSL/TLS 证书。请务必使用您的信息更改您的电子邮件地址和域名的详细信息。
sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email -d help.example.io该过程完成后,您的 SSL/TLS 证书将在 /etc/letsencrypt/live/domain.com/ 目录中可用。此外,您的 Nginx 服务器块文件 /etc/nginx/sites-available/freescout 将自动配置 HTTPS,这是由 Certbot Nginx 插件完成的。
通过 Web 安装程序安装 FreeScount
启动 Web 浏览器并访问 FreeScount 安装的域名,例如 http://glpi.hwdomain.io/。您将被重定向到安全的 HTTPS 连接和 FreeScount 安装页面。
单击检查要求以确保安装了所需的每个 PHP 扩展。
如果安装了所需的 PHP 扩展,请单击检查权限继续。
现在确保 FreeScout 目录的权限是可写的。然后,单击配置环境。
在应用程序 URL 设置中输入您的域名,然后单击设置数据库
选择默认数据库MySQL并输入详细信息数据库名称、用户和密码。然后,单击“设置应用程序”以继续。
选择应用程序语言和时区,然后单击设置管理。
现在为您的 FreeScount 安装创建一个新的管理员用户。输入您的电子邮件地址、新用户和密码,然后单击安装继续安装 FreeScout。
安装成功后,您应该看到以下确认信息。此外,您还可以看到需要为 FreeScout 创建一个新的 cron 作业。
返回终端服务器并运行以下命令为 FreeScout 创建一个新的 cron 作业。
crontab -u www-data -e输入下面的配置。
* * * * * php /var/www/freescout/artisan schedule:run >> /dev/null 2>&1完成后保存并关闭文件。
接下来,返回您的网络浏览器,单击登录,然后您将看到 FreeScout 登录页面。输入您的管理员电子邮件地址和密码,然后点击登录。
如果安装成功,您应该看到如下所示的 FreeScout 仪表板:
结论
总而言之,您现在已经通过 LEMP Stack(Nginx、MariaDB 和 PHP-FPM)在 Debian 12 服务器上成功安装了 FreeScout Help Desk。您还使用 SSL/TLS 证书保护您的 FreeScout 安装,这些证书是从 LetsEncrypt 生成的。现在,您可以实施并使用 FreeScout 作为本地/内部组织的帮助台平台。

















