30 分钟部署 EspoCRM：免费开源 CRM 系统的完整落地指南

30 分钟部署 EspoCRM：免费开源 CRM 系统的完整落地指南

【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm

EspoCRM 是一款免费开源的客户关系管理系统：联系人、销售机会、营销活动、支持工单集中在一处，单页前端加 REST API 后端。团队想在私有环境里建一套能深度定制的 CRM，它是对口的选择。

一分钟看懂 EspoCRM

开工前环境自检

📋 对照表先过一遍：

必装扩展：pdo_mysql、gd、zip、intl、mbstring、openssl、json、xml、curl；建议再带上exif、dom、ctype。两条命令快速验证：

php -v php -m | grep -E "pdo_mysql|gd|zip|intl|mbstring|openssl|curl"

一条命令流装完

先取代码：

git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm

再统一处理权限：整树chmod -R 755 .，其中data/、custom/、client/custom/三个可写目录用chmod -R 775 data/ custom/ client/custom/。浏览器打开域名会自动跳进安装向导：填数据库连接信息、建管理员账号，表结构自动生成，装完直接登录。

Web 服务器按你的技术栈二选一：

Apache 配置要点

执行sudo a2enmod rewrite开启重写模块，虚拟主机里放行重写：

<Directory /path/to/espocrm> AllowOverride All </Directory>

Nginx 配置要点

核心就是一个 location 加一行上传上限：

location / { try_files $uri $uri/ /index.php?$query_string; } client_max_body_size 50M;

改完配置记得重启服务生效。

装完先做三件事

跑起来只是开始用。首次登录后建议按顺序做：

1. 建第一条数据：加一个联系人，再建一个销售机会并推进阶段，回仪表盘确认漏斗图跟着变——权限、写入、展示的核心链路就都验证过了。
2. 设角色与权限：给团队成员建角色，按模块和字段授权，管理员账号收回最小权限。
3. 验证 URL 重写：随便打开一条记录详情页，地址栏是不带index.php的干净 URL，说明重写规则已生效。

常见报错速查表

⚠️ 每条都是「报错信号 → 一句话根因 → 修复命令」。

数据库连接失败

报错信号：安装向导提示连不上数据库根因：连接信息填错，或用户缺建表权限修复：本地用mysql -u username -p -h localhost测通连接，给该用户授权建表，再确认防火墙放行

空白页或 500 错误

报错信号：安装页面一片空白，或返回 HTTP 500根因：PHP 扩展缺失，或目录权限配置不当修复：tail -f /var/log/php/error.log定位报错；权限用chmod -R 755 .与chmod -R 775 data/ custom/修正

URL 重写不生效

报错信号：页面 404，URL 里挂着index.php根因：重写模块没启用或配置不匹配修复：Apache 确认.htaccess存在且AllowOverride All；Nginx 核对 location 配置；重启 Web 服务器

大文件上传被拦

报错信号：附件传不上去根因：PHP 上传大小受限修复：php.ini 里设upload_max_filesize = 20M、post_max_size = 20M、memory_limit = 256M、max_execution_time = 300

进阶：调优与扩展

缓存

在data/config.php里加缓存配置，type支持redis、memcached、file，指向本机 redis（127.0.0.1:6379）后响应速度提升明显。

备份

数据库和文件各留一条兜底命令：

mysqldump -u username -p database_name > backup_$(date +%Y%m%d).sql tar -czf espocrm_$(date +%Y%m%d).tar.gz /path/to/espocrm

安全与日志

用 SSL 证书强制 HTTPS，跟随官方安全更新；定期翻data/logs/下的日志，顺手清理临时文件。数据库侧，MySQL 可调innodb_buffer_pool_size（如 256M），PostgreSQL 调shared_buffers（256MB）与effective_cache_size（512MB）。

扩展开发

自定义模块放 custom/Espo/Modules/ 目录；REST API 后端在 application/Espo/Core/Api/，对接外部系统从这里入手。

部署跑通后，把第一条真实客户数据填进去，按团队流程把角色和权限调顺。EspoCRM 的源码是开源的——不满足的地方，改它就行。

【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm