EspoCRM 安装部署完整指南如何从零搭建自己的开源 CRM【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrmEspoCRM 是一款免费开源的 CRM 系统帮中小团队不花订阅费就把客户、商机、销售流程管起来。这篇 EspoCRM 安装部署指南会带你走完全部流程1 分钟环境自检、部署步骤、装完验证与首次登录、常见坑和上线前配置——读完全文你能装出一套直接能用的系统。 为什么值得试它适合谁免费开源可自托管AGPLv3 许可数据全部落在自己的服务器没有按席位收的订阅费客户隐私敏感的团队尤其合适。开箱即用的 CRM 功能客户、联系人、商机、活动、邮件、管道看板、报表一应俱全装完就能跑日常销售流程。轻量好维护一套 PHP 数据库即可运行不需要微服务栈一台普通 VPS 就能承载。可扩展自定义实体、字段、模块和 REST API业务长大后不用换系统。不适合的场景只需要纯待办/工单管理、或要求 SaaS 免运维的极小团队——那种情况用现成 SaaS 更省事。✅ 动手前的 1 分钟自检对照下表花 1 分钟确认环境能省掉后面 90% 的排错时间项目要求说明PHP8.3 – 8.5版本范围见 composer.json数据库MySQL 8.0 / MariaDB 10.3 / PostgreSQL 15三选一Web 服务器Apache 2.4 或 NginxApache 需开启 mod_rewrite内存 / 磁盘≥ 512MB RAM / ≥ 200MB 磁盘生产环境建议 1GB 以上必备 PHP 扩展pdo_mysql 或 pdo_pgsql、gd、zip、mbstring、openssl、xml、curl、intl用php -m核对快速核对扩展是否齐全php -m预期输出里能看到pdo_mysql或pdo_pgsql、gd、zip、mbstring、openssl、curl等扩展名缺哪个装哪个Debian/Ubuntu 一般是sudo apt install php-gd php-xml php-mbstring php-curl php-zip php-mysql。 最省事的部署路线EspoCRM 官方提供手动安装、脚本安装、Docker 三种方式。最通用、可控性最高的是Web 服务器 图形化安装向导本文走这条路线你只负责把代码放到 Web 服务器下剩下的建库、建表、初始化都由向导完成。第 1 步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm composer install预期看到vendor/目录生成——运行库依赖都在这里这一步不能省。第 2 步配置 Web 服务器把站点指向仓库根目录关键是开启 URL 重写。Nginx 核心配置大段配置只需保留这两处其余用默认值location / { # 所有请求兜底交给入口文件这是 EspoCRM 路由能工作的前提 try_files $uri $uri/ /index.php?$query_string; }Apache 则是开启重写模块并允许.htaccess覆盖sudo a2enmod rewrite sudo service apache2 restart第 3 步给运行用户写权限安装向导和日常运行都要往data/写配置和上传文件custom/放二次开发代码sudo chown -R www-data:www-data data custom client/custom预期执行无报错即可www-data按你的 Web 运行用户调整。第 4 步跑安装向导浏览器打开你的域名会自动进入安装向导入口代码在 public/install/。五个页面按顺序走完许可协议 → 接受 AGPLv3系统检查 → 看到 PHP 版本、扩展、可写目录全部打勾数据库 → 填主机、库名、账号、密码向导自动建库建表建议字符集 utf8mb4管理员 → 设置首个管理员账号完成 → 提示进入系统 装完第一件事验证与首次登录别急着调优先确认它真的活着访问首页并登录用刚建的管理员账号登录能看到仪表板即代表 PHP、数据库、会话全链路正常。检查配置已落盘data/config.php应已由向导生成——这是整套系统的核心配置后续备份它最重要。跑一次定时任务入口php cron.php预期无报错输出它驱动通知、计划任务等后台逻辑之后要挂进 crontab。️ 最常踩的三个坑坑 1首页能开点任何子页面 404原因URL 重写没生效。Apache 检查 mod_rewrite 是否开启、目录是否AllowOverride AllNginx 检查是否配了上面那条try_files兜底规则。坑 2安装向导报“目录不可写”或装完无法保存配置原因Web 进程对data/没有写权限。执行sudo chown -R www-data:www-data data custom client/custom后重进向导即可。坑 3安装中途报某个类不存在 /composer install失败原因PHP 扩展缺失或版本不在 8.3–8.5 区间。先php -v确认版本再php -m对照上一节的扩展清单补齐。️ 让它真正好用起来生产环境真正需要的配置其实不多按这个顺序做事项做什么为什么时区与语言管理员界面里设成Asia/Shanghai和简体中文时间和界面语言是所有功能的地基邮件设置里配 SMTP收件和发信地址通知、邮件功能都依赖它角色与团队建角色、分配权限再创建团队成员避免所有人都用管理员账号HTTPS申请证书并强制跳转CRM 存客户敏感数据明文传输不可接受定时任务crontab 加*/5 * * * * php /path/to/espocrm/cron.php /dev/null 21通知、队列、计划任务全靠它备份每天mysqldump备份数据库 打包data/和custom/数据库可丢data/config.php丢了就得重装备份可以就是一条 cron0 2 * * * mysqldump -u user -p espocrm /backup/espocrm_$(date \%F).sql tar -czf /backup/espocrm_files_$(date \%F).tar.gz -C /path/to/espocrm data custom预期每天凌晨生成一份 SQL 加一份文件包。 收尾与下一步到这里你的 EspoCRM 已经装完、验证过、配好了生产底线。接下来三件最有价值的事导入数据用内置导入功能把现有客户名单CSV/Excel灌进去系统立刻有真实内容可看。试试 REST API实现参考 application/Espo/Core/Api/给上下游系统留个集成入口。规划自定义模块有业务特殊字段时往 custom/Espo/Modules/ 下扩展而不是改核心代码。部署只是开始——把字段和流程往你的真实业务上靠才是 CRM 真正产生价值的时候。动手装一套吧半小时内你就能在自己的域名上点开第一个仪表板。【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考