
EspoCRM 安装部署避坑上手从环境检查到上线只需四步【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrmEspoCRM 是一款开源 CRM 系统用 PHP 编写前端是单页应用后端对外提供 REST API。它把客户联系、销售机会、营销活动、客服工单放进同一个后台管理适合不想被 SaaS 订阅费绑定、又希望数据留在自己服务器上的团队。在一台干净的机器上从拉代码到建好管理员账号通常半小时左右就能走完剩下的时间主要花在权限和 Web 服务器的细节上。先把 PHP、数据库和目录权限这三关过掉部署前最值得花时间的不是装软件而是确认三样东西。第一PHP。版本要求是 8.3 到 8.58.6 以下低于 8.3 装不动高于 8.5 可能跑起来报错。扩展方面pdo、gd、zip、intl、mbstring、openssl、json、xml、curl这几项缺一个都会在安装向导的环境检查里被打回exif、dom、ctype也建议一并装上。用php -v看版本、php -m列扩展缺什么补什么。第二数据库。MySQL 8.0 及以上、MariaDB 10.3 及以上都可以PostgreSQL 15 也能用。准备一个有建库建表权限的账号连接地址先在本机localhost上测通再说。第三资源与权限。内存 512MB 能跑生产环境建议 1GB 以上磁盘预留 1GB。目录权限有讲究data/和custom/必须对 Web 进程可写否则安装向导走到一半会卡住常见处理是chmod -R 775 data/ custom/。拉取源码并核对文件是否完整获取代码用下面这条命令即可git clone https://gitcode.com/GitHub_Trending/es/espocrm cd espocrm如果拿的是压缩包解压到 Web 根目录同样的效果。拉完先确认目录结构正常application/是全部后端代码client/是前端静态资源data/放运行时配置和日志custom/是留给二次开发的目录public/index.php是站点入口。确认data/和custom/可写、整体目录属主是 Web 运行用户这一步做对了后面九成的 500 错误都不会出现。给 Web 服务器加两条重写规则EspoCRM 的所有页面都走index.php统一入口所以重写规则是必选项不是可选项。Apache 用户先确认mod_rewrite已启用然后在虚拟主机里对站点目录放开AllowOverride All让随代码提供的.htaccess生效。Nginx 用户没有.htaccess得自己写两条try_files $uri $uri/ /index.php?$query_string;处理页面路由再加一行client_max_body_size 50M;给附件上传留余量。改完务必重启服务再验证否则你以为在测新配置其实还在跑旧规则。打开浏览器走安装向导五步建库建账号在浏览器访问你的域名未安装时会自动跳到安装向导流程大致是环境检查 → 填数据库连接 → 填站点偏好 → 建管理员账号 → 完成初始化。数据库一步填主机、端口、库名、用户名、密码向导会实际连一次并建表连不通会当场给出原因不用装完再猜。管理员账号建议在这一步就起一个强密码装完再改要多走一轮流程。看到完成页并成功登录后台安装就算结束此时data/config.php已生成数据库连接等核心配置之后改配置都从它入手。装不动的时候按现象对号入座安装页空白或直接 500先查 PHP 错误日志通常在data/logs/或系统日志目录九成是扩展缺失或data/、custom/不可写补扩展、修属主和权限后重试。数据库连接失败在命令行用同一账号手动连一次排除网络、白名单、密码问题再确认该账号有建库建表权限。URL 里带着 index.php、刷新就 404重写没生效。Apache 查mod_rewrite和AllowOverrideNginx 查try_files改完记得重启服务。附件传不上去改php.ini里的upload_max_filesize和post_max_size例如各 20M顺带把memory_limit调到 256M 以上然后重启 PHP 服务。上线后值得做的五件事给data/config.php加上 Redis 缓存配置比默认文件缓存快不少配好 HTTPS 并强制跳转数据库密码只留在配置里别进代码建定时备份mysqldump出库 打包data/与custom/两个文件都要每周扫一遍data/logs/下的错误日志清理过期附件和临时文件按最小权限给每个角色开数据范围别图省事全员管理员后台登录进去之后先建一条客户和一条销售机会走完整流程比看文档更快熟悉界面需要自定义实体或模块时代码往custom/Espo/Modules/里放即可。【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考