源码系统概览
文章正文
FreeScout 是一套基于 PHP 与 Laravel 框架开发的开源客服工单系统，支持自托管部署，官方定位为 Zendesk 与 Help Scout 的免费替代方案。
原版代码托管在 GitHub 的 freescout-helpdesk/freescout 仓库，采用 AGPL-3.0 开源协议，本文分析的源码包版本为 1.8.233。
本文由奥森免费源码网基于官方仓库整理，功能、架构、部署三个部分，想了解哪块直接看对应小节。
源码简介
FreeScout 把多个邮箱的往来邮件聚合到共享收件箱，客服人员在同一个后台里统一处理邮件、在线聊天等多种渠道的咨询。
源码包内置工单管理、客户管理、自动回复、多语言界面与模块化扩展机制，部署后数据完全由自己掌控，用户数、工单数与邮箱数量均无限制。
当前版本为 1.8.233，自带 Web 安装向导，既能跑在云服务器上，也适用于共享虚拟主机环境。
项目自带在线更新机制与完善文档，GitHub 仓库维护活跃，1.8.x 版本线仍在持续更新。
适用场景
这套源码适合需要自建客户服务体系的团队与中小企业，如电商卖家、SaaS 产品团队、外贸公司及个人站长。
如果想整合多个客服邮箱到统一后台回复，或不想为商业客服软件付费，FreeScout 很合适。
教育机构、社区组织或开发团队也可用它搭建内部工单流转与反馈平台。
功能亮点
共享收件箱：多个邮箱聚合管理，支持 IMAP 收取与 SMTP 发送，邮件自动转成工单。
工单处理：支持创建、合并、转发、加星标与跨邮箱移动，提供多人同时编辑的碰撞检测。
客户管理：自动建立客户档案，支持搜索、合并重复客户与查看完整沟通历史。
自动化能力：内置自动回复，可配置自动应答规则，会话列表支持定时刷新。
多语言界面：内置 29 种以上语言，含简体中文与繁体中文。
模块化扩展：基于 Laravel 模块机制，可扩展更多渠道与集成能力。
部署自由：完全自托管，支持 Docker、Softaculous、Cloudron 一键部署。
技术架构与部署指南
技术栈与运行环境
前端：采用 Blade 模板引擎渲染服务端页面，配合 jQuery 与 Bootstrap 构建交互界面，前端资源通过 Laravel Mix 打包。
后端：基于 PHP 开发，核心框架为 Laravel 5.5，应用版本为 1.8.233，整体采用模块化与事件驱动架构。
数据库：支持 MySQL 5.0 及以上、MariaDB 与 PostgreSQL，默认使用 MySQL，通过 Laravel 迁移机制管理数据表。
运行环境：需要 Nginx、Apache 或 IIS 等 Web 服务器，PHP 版本要求 7.1 至 8.x，并开启 OpenSSL、PDO、IMAP、GD、cURL 等扩展。
其他依赖：使用 webklex/php-imap 处理邮件收取，SwiftMailer 负责邮件发送，Laravel Queue 处理异步任务，并集成 laravel-installer 安装向导。
安装与部署提示
源码包内置 Web 安装向导，访问 /install 即可完成环境检查、权限设置与数据库配置。
建议先配置 .env 中的数据库与站点地址，再安装依赖并执行数据表迁移。
邮件收发依赖 IMAP 与 SMTP 参数，安装后进入邮箱设置页填写服务器、端口与账号密码。
定时与队列任务需配合计划任务运行，系统会在后台抓取新邮件并发送邮件。
生产环境建议开启 HTTPS，并设置上传目录权限与备份策略。
截图与演示说明
源码包未附带截图，以下界面描述均可在源码中核对。
登录页对应 /login 路由，登录后跳转到仪表盘，模板为 secure/dashboard.blade.php。
工单列表页由 conversations_table.blade.php 渲染，支持文件夹筛选、分页与搜索，对应 /mailbox/{id}。
工单详情页由 conversations/view.blade.php 渲染，包含回复编辑器与附件上传，路径为 /conversation/{id}。
邮箱设置页 connection_incoming.blade.php 用于填写 IMAP 参数，auto_reply.blade.php 配置自动回复。
常见问题
问：FreeScout 是什么？
答：FreeScout 是一套开源自托管的客服工单与共享收件箱系统，把多个邮箱统一到一个后台处理咨询，官方定位为 Zendesk 与 Help Scout 的免费替代方案。
问：这套源码怎么使用？
答：部署到支持 PHP 7.1 至 8.x 的服务器，访问 /install 完成安装向导，再添加邮箱账号即可处理工单。
问：它和 Zendesk、Help Scout 有什么区别？
答：Zendesk、Help Scout 是付费云客服，FreeScout 免费开源且可自托管，数据由自己掌控，而同样开源的 Zammad 功能偏重、OSTicket 界面偏传统，FreeScout 走轻量共享收件箱的路线。
问：FreeScout 是免费的吗？
答：是的，FreeScout 完全免费开源，采用 AGPL-3.0 协议，用户数、工单数和邮箱数均无限制。
| 对比项 | FreeScout | Zammad | OSTicket |
| 开发语言 | PHP（Laravel） | Ruby（Rails） | PHP |
| 开源协议 | AGPL-3.0 | AGPL-3.0 | GPL-2.0 |
| 部署方式 | 自托管 | 自托管或云服务 | 自托管 |
| 功能定位 | 轻量级共享收件箱 | 功能全面的工单平台 | 经典工单系统 |
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
本次扫描覆盖核心业务代码目录，未发现加密后门或可疑代码执行特征，shell_exec 与 base64_decode 均为官方运维与业务功能。
下载说明
本页面提供的源码包仅用于学习与二次开发参考，请通过可靠渠道获取原始源码。
部署上线前请仔细阅读项目授权协议，并自行完成安全审计与环境加固。
因软件使用产生的数据安全与合规问题，由使用者自行评估与承担。
GitHub项目开源地址：https://github.com/freescout-helpdesk/freescout
最后更新：2026-08-18