用 Freescout 搭建免费客服工单系统：开源帮助台部署与常用配置

用 Freescout 搭建免费客服工单系统：开源帮助台部署与常用配置

【免费下载链接】freescoutFreeScout — Free self-hosted help desk & shared mailbox (Zendesk / Help Scout alternative)项目地址: https://gitcode.com/GitHub_Trending/fre/freescout

Freescout 是一款免费的开源帮助台与共享收件箱，能把邮件、网页聊天等多渠道的客户咨询自动转成工单，让客服团队在同一个后台接手、回复、跟进。如果你想在自己的服务器上搭一套不依赖 Zendesk 的客服工单系统，这篇教程会讲清楚部署步骤、常用配置方法和几条容易踩的坑。

先想清楚：客户邮件别再散落在各人邮箱里

典型的场景是这样的：客户给销售邮箱发了封问题邮件，没人跟进；或者两个客服各自回复了一封，内容还互相矛盾。FreeScout 解决的就是这件事：

📥 客户邮件发到共享邮箱后，系统自动把它变成一张工单；客服在后台回复，邮件线程保持连续同步；客户再回信，会自动落回同一张工单里，不会变成新单。另外它还有碰撞检测——两个客服同时打开同一张工单时会互相提示，避免重复处理。工单支持内部备注、自动回复、转交和合并，团队人数不设上限。

部署前检查：服务器要求并不高

FreeScout 是纯 PHP + MySQL 应用，一台最普通的服务器甚至虚拟主机都能跑：

• PHP 7.1 ~ 8.x
• MySQL 5.0+ / MariaDB 5.0+ / PostgreSQL
• Nginx、Apache 或 IIS 均可
• 对 CPU 和内存没有硬性要求

许可证是 AGPL-3.0，完全免费，功能上不设客服数、工单数限制。

Freescout 安装部署三步走

第一步，把代码克隆到服务器：

git clone https://gitcode.com/gh_mirrors/fre/freescout

Ubuntu 环境下也可以直接用项目自带的 安装脚本，一条命令交互式装好。

第二步，把网站根目录指向public/。入口文件是 public/index.php，Web 服务器只暴露这个目录就行，不要直接指向项目根目录，否则别人能翻到你的配置文件。

第三步，打开浏览器跑 Web 安装器。访问你的站点地址，会自动进入安装向导，依次填域名、数据库账号密码、管理员账号，它自己完成建表和数据库连接。这里有个反直觉的点：千万别提前手动创建.env文件，只要根目录存在.env，Web 安装器就拒绝运行。

配置方法：真正要动的只有两个文件

.env：域名、密钥和数据库连接

.env.example 是环境变量模板，装好后生成的.env里只需要关心这几处：

• APP_URL：你的站点域名，填错会导致页面链接跳转异常
• APP_KEY：应用加密密钥，用php artisan key:generate生成，不生成页面会直接报错
• DB_HOST/DB_DATABASE/DB_USERNAME/DB_PASSWORD：数据库连接四件套

改完.env后记得执行php artisan freescout:clear-cache让配置生效，这一步最容易漏。

config/ 目录：一般用不上，想深挖再去

时区、IMAP 拉信行为、邮件发送细节都在核心配置目录里，普通使用基本不用碰。第三方扩展则放在 Modules 扩展目录，装模块后功能自动生效。

装好后先做这三件事

1. 建共享邮箱：在后台新建 mailbox，填入 IMAP/SMTP 账号，系统会定时拉取新邮件并自动开工单，这是整个系统的核心动作。
2. 添加团队成员：邀请客服账号，按需要分配工单处理权限。
3. 打开自动回复和通知：客户来信即收到提醒，减少人工盯邮箱的时间。

两条真实的避坑提醒

• 部署前先确认 PHP 和 MySQL 版本是否达标（PHP 7.1 以上），环境过旧时安装过程会报各种奇怪的错，排查起来比装新环境更花时间。
• 改过.env后如果站点"突然不正常"，先清缓存再怀疑别的原因，十有八九是配置没生效，而不是代码出了问题。

【免费下载链接】freescoutFreeScout — Free self-hosted help desk & shared mailbox (Zendesk / Help Scout alternative)项目地址: https://gitcode.com/GitHub_Trending/fre/freescout