EspoCRM 开源CRM部署：4步跑通客户管理系统安装
【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm
客户联系方式在Excel里，跟进记录在聊天软件里，报价单躺在邮件夹。人一换，线索就断。EspoCRM 是一款开源CRM，把联系人、商机、邮件、任务收进同一个客户管理系统。照下面4步走，10分钟跑通环境。
它凭什么：PHP 8.3 前后端分离的开源CRM
它解决的核心问题是：客户数据散落在各个工具里，没法汇总和跟进。适合想把销售流程线上化的小团队和中小企业。技术栈一句话：PHP 8.3 + MySQL，前端单页应用，后端提供 REST API，模块结构清晰，可以按业务改。部署上没有任何花哨依赖，普通 LAMP 或 LNMP 环境就能跑起来。
最短路径跑起来：环境要求与4步安装
想把 EspoCRM 装起来，先对照这张表看环境，缺哪项补哪项。
| 组件 | 版本 | 一句话备注 |
|---|---|---|
| PHP | 8.3 – 8.5 | 必须启用 json、openssl、mbstring、zip、gd、iconv |
| 数据库 | MySQL 8.0+ / MariaDB 10.3+ / PostgreSQL 15+ | 三选一 |
| Web服务器 | Apache 2.4+ 或 Nginx 1.18+ | 必须支持 URL 重写 |
| 内存 / 磁盘 | 512MB RAM / 200MB 磁盘 | 生产环境建议 1GB 内存 |
然后按4步装：
- 获取源代码：
git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm- 让数据目录可写，安装过程要往这里写配置和上传文件：
chmod -R 775 data/ custom/- 把域名站点根指向
public/目录，并开启重写：Apache 执行a2enmod rewrite并设置AllowOverride All；Nginx 在location /里用try_files $uri $uri/ /index.php?$query_string。 - 浏览器打开域名，安装向导自动出现：依次填数据库连接、语言与时区、创建管理员，点完成即可。
整条链路可以概括成一条流水线：
环境检查 → 数据库配置 → 管理员创建 → 数据表初始化 → 进入系统
装完先干这三件事：客户、商机、仪表盘
登录后先别乱点，做这三件事就能确认系统真正可用。
第一件：建第一个联系人。打开"联系人" → 点"创建" → 填姓名、公司、电话 → 保存。这条记录会立刻出现在列表里，你可以在详情页补备注、挂邮件。
第二件：建一条商机并推进阶段。打开"商机" → 创建新商机，填客户和金额 → 在泳道视图里把它从 Prospecting 一路拖到 Negotiation。每个阶段的价值和数量都会重新统计，销售进度不再靠口头汇报。
第三件：看首页仪表盘。回到主界面，"Opportunities by Stage" 图表按阶段汇总金额，你能直接回答"现在手上有多少在谈的生意"。
让它更顺手：三个收益最大的配置
1. 开启 Redis 缓存
- 做什么：把会话和元数据缓存从文件切到 Redis。
- 为什么：多人并发时页面响应会明显变快。
- 关键配置：编辑
data/config.php，加入：
'redis' => [ 'host' => '127.0.0.1', 'port' => 6379, ]2. 挂上定时任务
- 做什么：给系统加一条 cron，每分钟触发一次。
- 为什么：邮件提醒、数据清理、作业队列全靠它，没配的话管理后台会一直提示。
- 关键配置：
* * * * * php /path/to/espocrm/command.php
3. 放宽 PHP 上传与内存参数
- 做什么：调整 php.ini 里的上传与内存上限。
- 为什么：官方推荐值是上传 20M、内存 256M，偏小会导致附件传不上、大批量导入超时。
- 关键配置：
upload_max_filesize = 20M、memory_limit = 256M
卡住了怎么办：高频排错一览
排错不用翻日志大海捞针，四个高频场景先对一下。
| 现象 | 最常见原因 | 一句话解法 |
|---|---|---|
| 安装页空白或 500 | PHP 扩展缺了一个（json/openssl/mbstring/zip/gd/iconv） | 用php -m核对，缺哪个补哪个 |
| 数据库连接失败 | 用户没有建表权限，或 host 填错 | 先用mysql -u用户名 -p命令行测，再授权限 |
| URL 404 或带着 index.php | 重写模块没开 | Apache 执行a2enmod rewrite；Nginx 检查 try_files |
| 附件传不上去 | php.ini 上传限制太小 | post_max_size 和 upload_max_filesize 都设 20M |
从一个人用到一个团队：下一步清单
系统跑起来只是开始，接下来按顺序做四件事：
- 加自己的业务实体：自定义模块统一放
custom/Espo/Modules/，不用动核心代码，升级不冲突。 - 对接外部系统：REST API 入口在
public/api/v1/，用 token 鉴权，给 ERP、工单系统留好接口。 - 接入邮件：在系统内配置邮箱账户，收发邮件自动挂到对应联系人，减少手工录入。
- 写定时作业：继承
application/Espo/Core/Job/下的作业类，配合 cron 跑自动化流程，比如每天生成跟进提醒。
先让团队在真实数据上跑两周，再按反馈调字段和权限，比一上来堆功能更有效。
【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
