企业官网建设流程全解析

EspoCRM部署指南：30分钟从零到可登录的开源CRM

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

本文是开源CRM系统EspoCRM的部署指南：在PHP加MySQL环境下，带你把这套可管理客户、线索与销售机会的系统装到自己的服务器上。按下面的步骤照做，大约30分钟就能完成自建CRM搭建，从拉代码到管理员登录全部走一遍。

🧭 它是什么、适合谁

一句话定位：PHP 8.3~8.5 写的后端加单页应用前端，对外提供 REST API，数据库可选 MySQL 8.0+、MariaDB 10.3+ 或 PostgreSQL 15+。

核心能力：

• 线索、联系人、销售机会、营销活动、支持工单全在一个系统里
• 字段、实体、关系可按业务自定义，改完不用等官方版本
• 自带 REST API，方便和外呼系统、订单系统等对接
• 内置角色权限体系，按部门分配数据可见范围

适合你：中小企业想快速自建一套客户管理系统；数据敏感、要求系统完整跑在自己服务器上的团队；想基于开源代码二次开发的研发团队。

不适合你：只想要 SaaS 服务、不愿碰服务器的；期待开箱即得复杂电商或进销存功能的。

🔍 部署前环境自检

先对照这张表确认服务器达标，再跑自检命令。

另外需要这些 PHP 扩展：pdo、mbstring、gd、zip、intl、openssl、json、xml、curl。跑两条命令自检：

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

touch data/.write-test && echo "目录可写"

两条都通过，才进入安装。注意 Web 端 PHP-FPM 或 Apache 模块版本要和命令行一致，只过了 CLI 不算数。

📦 三步装完

第 1 步：获取代码

操作：

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

也可以下载 release 压缩包放到 Web 目录解压，效果相同。

结果验证：目录里应能看到application、data、public、custom四个目录，且composer.json中 PHP 要求为 8.3+。缺目录说明拉取不完整，重拉。

第 2 步：配置 Web 服务器

操作（Nginx 示例，站点主配置）：

server { listen 80; root /var/www/espocrm; index index.php; client_max_body_size 50M; location / { try_files $uri /index.php?$query_string; } }

要点：root 指项目根目录（入口是根下index.php，不是public/）；try_files保证前端路由和 REST 请求都能落到 PHP；client_max_body_size决定上传上限。Apache 用户改为一行AllowOverride All并启用 mod_rewrite。改完重载 Nginx。

结果验证：

curl -s -o /dev/null -w "%{http_code}" http://localhost/install/

返回 200 即路由通了；返回 404 说明 rewrite 没生效。

第 3 步：跑安装向导

操作：先放开写入权限，再打开浏览器：

chmod -R 775 data custom client/custom

浏览器访问http://你的域名，会自动进入安装向导，按顺序填数据库连接信息、创建管理员账号、选择语言。

结果验证：表单里能看到数据库主机、端口、账号、库名等输入项且连接检查通过；点完最后一步出现进度提示，随后跳转到登录页。停在中间不动，先看data/logs/下的错误日志。

✅ 装完先做这三件事

装完不等于会用，先做三件事把系统"跑热"：

1. 登录验证：用刚建的管理员账号登录，能进入首页、菜单可切换即正常。
2. 建一条测试数据：新建一个联系人，填名称和邮箱，保存后回列表确认可见。这一步能顺带验证表单、权限和数据库写入。
3. 记住日志位置：应用日志在data/logs/，上传文件在data/upload/，缓存和会话在data/cache/、data/sessions/。以后排查问题先翻日志。

⚠️ 高频坑位速查

• 现象：页面空白或 500。原因：缺 PHP 扩展或版本低于 8.3。解法：php -m核对扩展清单，按前面表格升 PHP。

• 现象：安装时数据库连接失败。原因：账号无建表权限，或库没建。解法：用具备 CREATE、INSERT 权限的账号；先手动建好空库再填向导。

• 现象：URL 里一直带index.php。原因：重写规则没生效。解法：Nginx 检查try_files，Apache 确认 mod_rewrite 已启用且 AllowOverride 为 All，改完重载服务。

• 现象：附件上传报超限。原因：PHP 的upload_max_filesize、post_max_size偏小。解法：调到 20M 以上，重启 PHP-FPM 或 Apache。

🌱 装好之后怎么养

• 性能：先用默认文件缓存，数据量上来后在data/config.php把缓存切到 Redis 或 Memcached。
• 备份：每天mysqldump导出数据库，再打包data/目录（日志和临时文件可排除），至少留 7 份。
• 安全：上 HTTPS；Web 根目录别暴露data/、application/、custom/；按角色最小化权限；定期跟官方稳定版更新。
• 扩展：自定义模块放custom/Espo/Modules/，对外集成走 REST API，接口写法可参考application/Espo/Core/Api/下的源码。

下一步

30 分钟的部署换回一套完全在自己服务器上的开源 CRM，后续加字段、接系统都不受授权和版本限制。现在就登录后台，建一条测试联系人，让这套系统从"装好了"变成"可用了"。

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