EspoCRM 部署指南30分钟从零上线你的开源CRM系统【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrmEspoCRM 部署指南面向中小团队与开发者的开源客户关系管理系统帮你把线索、客户、商机、市场活动统一到一个平台。本指南按环境预检、部署实操、避坑排查、生产优化四步走约30分钟完成部署。项目档案EspoCRM 是什么、由什么构成这一节用30秒帮你建立对项目的整体认知后面所有操作都建立在这个技术底子上。技术栈语言与运行时PHP 8.3 ~ 8.5后端基于 Slim 4 框架构建 REST 接口数据库MySQL 8.0/MariaDB 10.6/PostgreSQL 15三选一Web 服务器Apache 或 Nginx需要支持 URL 重写前端单页应用SPA自定义框架 Backbone核心部分使用 TypeScript许可证AGPL-3.0架构特点前后端分离前端是 SPA后端提供完整的REST API方便与外部系统对接模块化标准实体定义在 application/Espo/Modules/你自己的扩展全部落在custom/目录如 custom/Espo/Modules/升级不冲突元数据驱动字段、布局、权限等大量配置以 JSON 元数据描述改行为往往只需改配置核心价值你得到的是一个可以随意定制的业务应用平台——不只是管客户还能自建实体、字段、按钮和工作流界面保持简洁上手成本低。环境预检部署前的自检清单先花2分钟确认服务器底子能省掉后面80%的排查时间。组件与最低/推荐配置组件最低配置推荐配置说明PHP8.3.08.3 ~ 8.5高于 8.5 不被支持数据库MySQL 8.0 / MariaDB 10.6 / PostgreSQL 15同左三种任选其一装前别混装Web 服务器Apache 2.4 或 Nginx 1.18同左必须启用 URL 重写内存512 MB1 GBPHP 端建议 memory_limit 256M磁盘200 MB1 GB含数据库、附件与日志PHP 扩展要求来自 composer.json 的系统要求必需pdo、json、openssl、mbstring、zip、gd、iconv、xml、dom、curl推荐exif、ctype、bcmath数据库驱动MySQL/MariaDB 用pdo_mysqlPostgreSQL 用pdo_pgsql一键自检脚本在仓库根目录直接运行#!/bin/bash # 1. PHP 版本 echo PHP 版本 php -v | head -1 # 2. 必需扩展逐个检查 echo 扩展检查 for ext in pdo pdo_mysql json openssl mbstring zip gd iconv xml dom curl; do php -m | grep -qi ^$ext$ echo OK $ext || echo MISS $ext done # 3. 可写目录检查安装向导会往这些目录写文件 echo 目录可写性 for d in data custom client/custom; do touch $d/.write_test 2/dev/null rm -f $d/.write_test echo OK $d || echo FAIL $d 需要写入权限 done⚠ 只要出现任何一个MISS或FAIL先补齐再往下走装扩展用系统包管理器如apt install php8.3-xml php8.3-zip目录权限问题看部署阶段的权限命令。部署实操三个阶段完成安装整个安装就是三件事拿代码、配 Web 入口、跑安装向导。逐个来。阶段一拉取代码并赋权git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm # 统一基础权限 chmod -R 755 . # 这三个目录必须可写安装配置、缓存、日志都落在 data/ chmod -R 775 data custom client/custom关键前提data/、custom/、client/custom/的属主必须是 Web 服务器运行用户Apache 下通常是www-dataNginxPHP-FPM 下是www-data或nginx。属主不对安装向导会在权限检查这一步直接报Bad init Permission并中止。阶段二配置 Web 入口重定向到 public/EspoCRM 的文档根目录必须指向public/目录而不是仓库根目录。根目录的.htaccess和web.config会做重定向兜底但直接配好最干净。Apache虚拟主机配置VirtualHost *:80 DocumentRoot /var/www/espocrm/public Directory /var/www/espocrm/public AllowOverride All Require all granted /Directory /VirtualHost别忘了先a2enmod rewrite并重启 Apache。Nginxserver块内location / { try_files $uri $uri/ /index.php?$query_string; } client_max_body_size 50M;root同样指向/var/www/espocrm/publiclocation ~ \.php$交给fastcgi_pass转发 PHP-FPM。阶段三运行安装向导浏览器访问你的域名例如http://crm.example.com安装向导会自动启动按页面顺序推进同意许可证AGPL-3.0 协议选择语言与主题填写数据库平台MySQL/MariaDB/PostgreSQL、主机可带端口如127.0.0.1:3306、库名、用户名、密码保存偏好设置创建管理员账户向导随后自动建库、建表、写data/config.php克隆代码 → 赋权 data/custom → 配置 Web 根目录指向 public/ ↓ ↓ ↓ git clone chmod 775 Apache: AllowOverride All ↓ Nginx: try_files /index.php 浏览器访问域名 → 同意协议 → 选语言主题 → 填数据库 → 建管理员 → 建库建表 → 完成验证与上线怎么确认装成功了装完别急着用按下面5个检查点逐项过一遍全部通过才算真正上线。首次登录用向导创建的管理员账号登录能看到仪表盘含商机阶段图表即主流程正常基础 CRUD 点验新建一个 Contact再建一个 Opportunity 并关联该客户保存后刷新确认数据仍在REST API 探活未带凭据请求接口应返回鉴权拦截说明 API 路由已生效curl -i http://crm.example.com/api/v1 # 预期401/403 一类的鉴权响应而不是 404配置落盘检查ls -l data/config.php # 应存在 mysql -uuser -p -e show databases # 应能看到你建的库定时任务就绪EspoCRM 的后台作业邮件同步、计划任务等依赖 cron 每分钟触发cron.php上线前就配好* * * * * php /var/www/espocrm/cron.php /dev/null 21高频坑问答四个最典型的故障现场按出现频率排了序每个都给你能直接执行的排查动作。坑一访问空白页或 500 错误症状描述浏览器打开域名白屏、500或者提示 PHP 版本不满足要求。原因分析最常见是 PHP 版本不在 8.3~8.5 区间、必需扩展缺失或 Web 用户无权读文件。解决方案php -v确认版本在 8.3~8.5 内跑上面环境预检的扩展检查补齐所有MISS项看 PHP 错误日志定位具体报错tail -50 /var/log/php*-error.log路径随发行版略有差异确认 Web 服务器能读到代码sudo -u www-data cat /var/www/espocrm/public/index.php | head -3无权限报错即正常修完扩展或权限后systemctl restart apache2或systemctl restart php8.3-fpm再刷新坑二数据库连接失败症状描述向导填完数据库信息后报连接失败卡在数据库步骤无法前进。原因分析凭证/主机/端口写错、数据库用户无建表权限或 PHP 装的是pdo_mysql而你填的是 PostgreSQL驱动不匹配。解决方案用命令行按向导里填的同一套参数验证mysql -h host -u user -p能登进来才说明凭证没问题建库建用户并授权CREATE DATABASE espocrm CHARACTER SET utf8mb4; CREATE USER espo% IDENTIFIED BY password; GRANT ALL PRIVILEGES ON espocrm.* TO espo%;若用 PostgreSQL确认php -m | grep -i pdo_pgsql有输出没有就安装后再试检查防火墙/安全组是否放行 3306或 5432端口ss -lntp | grep 3306坑三URL 重写不生效404 或 URL 里带 index.php症状描述站内跳转大量 404或地址栏出现index.php?entryPoint...这类原始路径。原因分析重写模块未启用或 Nginx 缺少指向index.php的兜底规则。解决方案Apachea2enmod rewrite systemctl restart apache2并确认对应 Directory 段里有AllowOverride AllNginx确认location /里有try_files $uri $uri/ /index.php?$query_string;改完nginx -t systemctl reload nginx验证重写链路curl -I http://localhost/login应返回 200 而不是 404若站点部署在子目录检查 Web 根是否仍正确指向public/而非误配到仓库根目录坑四上传附件失败或大文件传不上去症状描述小文件正常超过几 MB 的附件上传报 413 或截断错误。原因分析upload_max_filesize、post_max_size或 Nginx 的client_max_body_size限制过小。解决方案php -i | grep -E upload_max_filesize|post_max_size看当前值修改 php.ini官方推荐参数为 20M 起步upload_max_filesize 20M post_max_size 20M memory_limit 256M max_execution_time 180Nginx 侧同步调大client_max_body_size 50M;重启 PHP-FPM 与 Nginx 后用curl -i -F fbigfile.zip http://crm.example.com/这类方式复测生产级优化性能、安全与监控三件套上线稳定后把这三块补齐才算生产级。性能调优-- MySQL / MariaDB缓冲池给到可用内存的 50%~70% SET GLOBAL innodb_buffer_pool_size 512M; -- PostgreSQL 对应项 ALTER SYSTEM SET shared_buffers 256MB; ALTER SYSTEM SET effective_cache_size 512MB;缓存在data/config.php中配置把文件缓存切换为 Redis 对并发收益明显redis驱动参数含host、portPHP 端memory_limit 256M是官方推荐值长任务如批量导入可适当上调。安全加固强制 HTTPS申请证书并配置重定向避免登录凭据明文传输备份双轨制数据库 文件系统都要备mysqldump -u espo -p espocrm backup_$(date %Y%m%d).sql tar -czf espocrm_fs_$(date %Y%m%d).tar.gz /var/www/espocrm/data /var/www/espocrm/custom⚠ 别漏了data/配置、缓存、附件和custom/你的全部自定义扩展版本更新关注官方发布节奏升级前先备份、先在测试环境验证最小权限数据库账号只授予业务库权限data/config.php含密钥确保 Web 用户之外的账号读不到它监控维护清单每天检查一次data/logs/下的应用日志关注 PHP 与数据库错误定期清理过期日志与临时缓存防止磁盘占满观察计划任务队列若作业长期堆积先确认 cron 是否真的在跑crontab -l扩展与社区把平台用出深度部署只是起点EspoCRM 真正的价值在能改。可扩展方向自定义实体在custom/Espo/Modules/下新建模块添加自己的数据模型、字段与关系工作流与自动化基于钩子Hooks和记录生命周期事件做业务规则如状态变更自动通知API 集成所有功能都走 REST API对接内部系统、BI 或移动端都从这一层入手API 行为可参考 application/Espo/Core/Api/主题与界面定制内置多个主题Espo、Glass、Light 等布局以 JSON 元数据描述改布局不用改代码社区资源使用问题、功能建议官方社区论坛README 中的 Community Support 入口开发文档官方 docs 站点的 Development 板块后端强调依赖注入与静态类型前端基于嵌套视图与自定义框架翻译通过 README 指向的 POEditor 项目参与多语言维护落地最佳实践先小范围试点一个销售团队→ 培训核心用户 → 用导入功能分批迁移历史数据 → 按使用反馈迭代字段和布局比一次上全量稳得多。收尾行动清单接下来做这5件事部署完成不是终点。按顺序勾掉下面5项你的 CRM 才算真正跑起来配好每日 cronphp cron.php每分钟触发保证后台作业正常流转建立备份任务数据库 data//custom/文件双轨备份并恢复演练一次上线 HTTPS确认 HTTP 自动 301 跳转建一个非管理员测试账号验证角色权限隔离是否符合预期导入一批真实客户/商机数据让团队在真实数据上开始试用系统已经就绪剩下的事很简单把第一个客户、第一单商机录进去。30分钟的部署投入接下来交给你的业务流程——有任何卡点先查本指南的问答区再去看应用日志基本都能自助解决。EspoCRM 安装完成后的商机管理界面按阶段统计销售机会底部是商机卡片列表【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/20 10:45:35 · 阅读 1.2k EspoCRM 部署指南：30分钟从零上线你的开源CRM系统
EspoCRM 部署指南30分钟从零上线你的开源CRM系统【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrmEspoCRM 部署指南面向中小团队与开发者的开源客户关系管理系统帮你把线索、客户、商机、市场活动统一到一个平台。本指南按环境预检、部署实操、避坑排查、生产优化四步走约30分钟完成部署。项目档案EspoCRM 是什么、由什么构成这一节用30秒帮你建立对项目的整体认知后面所有操作都建立在这个技术底子上。技术栈语言与运行时PHP 8.3 ~ 8.5后端基于 Slim 4 框架构建 REST 接口数据库MySQL 8.0/MariaDB 10.6/PostgreSQL 15三选一Web 服务器Apache 或 Nginx需要支持 URL 重写前端单页应用SPA自定义框架 Backbone核心部分使用 TypeScript许可证AGPL-3.0架构特点前后端分离前端是 SPA后端提供完整的REST API方便与外部系统对接模块化标准实体定义在 application/Espo/Modules/你自己的扩展全部落在custom/目录如 custom/Espo/Modules/升级不冲突元数据驱动字段、布局、权限等大量配置以 JSON 元数据描述改行为往往只需改配置核心价值你得到的是一个可以随意定制的业务应用平台——不只是管客户还能自建实体、字段、按钮和工作流界面保持简洁上手成本低。环境预检部署前的自检清单先花2分钟确认服务器底子能省掉后面80%的排查时间。组件与最低/推荐配置组件最低配置推荐配置说明PHP8.3.08.3 ~ 8.5高于 8.5 不被支持数据库MySQL 8.0 / MariaDB 10.6 / PostgreSQL 15同左三种任选其一装前别混装Web 服务器Apache 2.4 或 Nginx 1.18同左必须启用 URL 重写内存512 MB1 GBPHP 端建议 memory_limit 256M磁盘200 MB1 GB含数据库、附件与日志PHP 扩展要求来自 composer.json 的系统要求必需pdo、json、openssl、mbstring、zip、gd、iconv、xml、dom、curl推荐exif、ctype、bcmath数据库驱动MySQL/MariaDB 用pdo_mysqlPostgreSQL 用pdo_pgsql一键自检脚本在仓库根目录直接运行#!/bin/bash # 1. PHP 版本 echo PHP 版本 php -v | head -1 # 2. 必需扩展逐个检查 echo 扩展检查 for ext in pdo pdo_mysql json openssl mbstring zip gd iconv xml dom curl; do php -m | grep -qi ^$ext$ echo OK $ext || echo MISS $ext done # 3. 可写目录检查安装向导会往这些目录写文件 echo 目录可写性 for d in data custom client/custom; do touch $d/.write_test 2/dev/null rm -f $d/.write_test echo OK $d || echo FAIL $d 需要写入权限 done⚠ 只要出现任何一个MISS或FAIL先补齐再往下走装扩展用系统包管理器如apt install php8.3-xml php8.3-zip目录权限问题看部署阶段的权限命令。部署实操三个阶段完成安装整个安装就是三件事拿代码、配 Web 入口、跑安装向导。逐个来。阶段一拉取代码并赋权git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm # 统一基础权限 chmod -R 755 . # 这三个目录必须可写安装配置、缓存、日志都落在 data/ chmod -R 775 data custom client/custom关键前提data/、custom/、client/custom/的属主必须是 Web 服务器运行用户Apache 下通常是www-dataNginxPHP-FPM 下是www-data或nginx。属主不对安装向导会在权限检查这一步直接报Bad init Permission并中止。阶段二配置 Web 入口重定向到 public/EspoCRM 的文档根目录必须指向public/目录而不是仓库根目录。根目录的.htaccess和web.config会做重定向兜底但直接配好最干净。Apache虚拟主机配置VirtualHost *:80 DocumentRoot /var/www/espocrm/public Directory /var/www/espocrm/public AllowOverride All Require all granted /Directory /VirtualHost别忘了先a2enmod rewrite并重启 Apache。Nginxserver块内location / { try_files $uri $uri/ /index.php?$query_string; } client_max_body_size 50M;root同样指向/var/www/espocrm/publiclocation ~ \.php$交给fastcgi_pass转发 PHP-FPM。阶段三运行安装向导浏览器访问你的域名例如http://crm.example.com安装向导会自动启动按页面顺序推进同意许可证AGPL-3.0 协议选择语言与主题填写数据库平台MySQL/MariaDB/PostgreSQL、主机可带端口如127.0.0.1:3306、库名、用户名、密码保存偏好设置创建管理员账户向导随后自动建库、建表、写data/config.php克隆代码 → 赋权 data/custom → 配置 Web 根目录指向 public/ ↓ ↓ ↓ git clone chmod 775 Apache: AllowOverride All ↓ Nginx: try_files /index.php 浏览器访问域名 → 同意协议 → 选语言主题 → 填数据库 → 建管理员 → 建库建表 → 完成验证与上线怎么确认装成功了装完别急着用按下面5个检查点逐项过一遍全部通过才算真正上线。首次登录用向导创建的管理员账号登录能看到仪表盘含商机阶段图表即主流程正常基础 CRUD 点验新建一个 Contact再建一个 Opportunity 并关联该客户保存后刷新确认数据仍在REST API 探活未带凭据请求接口应返回鉴权拦截说明 API 路由已生效curl -i http://crm.example.com/api/v1 # 预期401/403 一类的鉴权响应而不是 404配置落盘检查ls -l data/config.php # 应存在 mysql -uuser -p -e show databases # 应能看到你建的库定时任务就绪EspoCRM 的后台作业邮件同步、计划任务等依赖 cron 每分钟触发cron.php上线前就配好* * * * * php /var/www/espocrm/cron.php /dev/null 21高频坑问答四个最典型的故障现场按出现频率排了序每个都给你能直接执行的排查动作。坑一访问空白页或 500 错误症状描述浏览器打开域名白屏、500或者提示 PHP 版本不满足要求。原因分析最常见是 PHP 版本不在 8.3~8.5 区间、必需扩展缺失或 Web 用户无权读文件。解决方案php -v确认版本在 8.3~8.5 内跑上面环境预检的扩展检查补齐所有MISS项看 PHP 错误日志定位具体报错tail -50 /var/log/php*-error.log路径随发行版略有差异确认 Web 服务器能读到代码sudo -u www-data cat /var/www/espocrm/public/index.php | head -3无权限报错即正常修完扩展或权限后systemctl restart apache2或systemctl restart php8.3-fpm再刷新坑二数据库连接失败症状描述向导填完数据库信息后报连接失败卡在数据库步骤无法前进。原因分析凭证/主机/端口写错、数据库用户无建表权限或 PHP 装的是pdo_mysql而你填的是 PostgreSQL驱动不匹配。解决方案用命令行按向导里填的同一套参数验证mysql -h host -u user -p能登进来才说明凭证没问题建库建用户并授权CREATE DATABASE espocrm CHARACTER SET utf8mb4; CREATE USER espo% IDENTIFIED BY password; GRANT ALL PRIVILEGES ON espocrm.* TO espo%;若用 PostgreSQL确认php -m | grep -i pdo_pgsql有输出没有就安装后再试检查防火墙/安全组是否放行 3306或 5432端口ss -lntp | grep 3306坑三URL 重写不生效404 或 URL 里带 index.php症状描述站内跳转大量 404或地址栏出现index.php?entryPoint...这类原始路径。原因分析重写模块未启用或 Nginx 缺少指向index.php的兜底规则。解决方案Apachea2enmod rewrite systemctl restart apache2并确认对应 Directory 段里有AllowOverride AllNginx确认location /里有try_files $uri $uri/ /index.php?$query_string;改完nginx -t systemctl reload nginx验证重写链路curl -I http://localhost/login应返回 200 而不是 404若站点部署在子目录检查 Web 根是否仍正确指向public/而非误配到仓库根目录坑四上传附件失败或大文件传不上去症状描述小文件正常超过几 MB 的附件上传报 413 或截断错误。原因分析upload_max_filesize、post_max_size或 Nginx 的client_max_body_size限制过小。解决方案php -i | grep -E upload_max_filesize|post_max_size看当前值修改 php.ini官方推荐参数为 20M 起步upload_max_filesize 20M post_max_size 20M memory_limit 256M max_execution_time 180Nginx 侧同步调大client_max_body_size 50M;重启 PHP-FPM 与 Nginx 后用curl -i -F fbigfile.zip http://crm.example.com/这类方式复测生产级优化性能、安全与监控三件套上线稳定后把这三块补齐才算生产级。性能调优-- MySQL / MariaDB缓冲池给到可用内存的 50%~70% SET GLOBAL innodb_buffer_pool_size 512M; -- PostgreSQL 对应项 ALTER SYSTEM SET shared_buffers 256MB; ALTER SYSTEM SET effective_cache_size 512MB;缓存在data/config.php中配置把文件缓存切换为 Redis 对并发收益明显redis驱动参数含host、portPHP 端memory_limit 256M是官方推荐值长任务如批量导入可适当上调。安全加固强制 HTTPS申请证书并配置重定向避免登录凭据明文传输备份双轨制数据库 文件系统都要备mysqldump -u espo -p espocrm backup_$(date %Y%m%d).sql tar -czf espocrm_fs_$(date %Y%m%d).tar.gz /var/www/espocrm/data /var/www/espocrm/custom⚠ 别漏了data/配置、缓存、附件和custom/你的全部自定义扩展版本更新关注官方发布节奏升级前先备份、先在测试环境验证最小权限数据库账号只授予业务库权限data/config.php含密钥确保 Web 用户之外的账号读不到它监控维护清单每天检查一次data/logs/下的应用日志关注 PHP 与数据库错误定期清理过期日志与临时缓存防止磁盘占满观察计划任务队列若作业长期堆积先确认 cron 是否真的在跑crontab -l扩展与社区把平台用出深度部署只是起点EspoCRM 真正的价值在能改。可扩展方向自定义实体在custom/Espo/Modules/下新建模块添加自己的数据模型、字段与关系工作流与自动化基于钩子Hooks和记录生命周期事件做业务规则如状态变更自动通知API 集成所有功能都走 REST API对接内部系统、BI 或移动端都从这一层入手API 行为可参考 application/Espo/Core/Api/主题与界面定制内置多个主题Espo、Glass、Light 等布局以 JSON 元数据描述改布局不用改代码社区资源使用问题、功能建议官方社区论坛README 中的 Community Support 入口开发文档官方 docs 站点的 Development 板块后端强调依赖注入与静态类型前端基于嵌套视图与自定义框架翻译通过 README 指向的 POEditor 项目参与多语言维护落地最佳实践先小范围试点一个销售团队→ 培训核心用户 → 用导入功能分批迁移历史数据 → 按使用反馈迭代字段和布局比一次上全量稳得多。收尾行动清单接下来做这5件事部署完成不是终点。按顺序勾掉下面5项你的 CRM 才算真正跑起来配好每日 cronphp cron.php每分钟触发保证后台作业正常流转建立备份任务数据库 data//custom/文件双轨备份并恢复演练一次上线 HTTPS确认 HTTP 自动 301 跳转建一个非管理员测试账号验证角色权限隔离是否符合预期导入一批真实客户/商机数据让团队在真实数据上开始试用系统已经就绪剩下的事很简单把第一个客户、第一单商机录进去。30分钟的部署投入接下来交给你的业务流程——有任何卡点先查本指南的问答区再去看应用日志基本都能自助解决。EspoCRM 安装完成后的商机管理界面按阶段统计销售机会底部是商机卡片列表【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考