EspoCRM 部署教程：5 步把自托管 CRM 从零跑到可登录

EspoCRM 部署教程5 步把自托管 CRM 从零跑到可登录【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm客户线索散在 Excel 里跟进记录埋在邮件线程里报价单躺在共享文档里——人多了以后你需要一个系统把这些都装起来。这篇文章带你把 EspoCRM开源自托管 CRM部署到自己的服务器上从拉取源码到能登录仪表盘全程只走一条路径大约 20 分钟。跑之前先备齐这些项目要求备注PHP8.3 – 8.5主运行时php -v可查数据库MySQL 8.0 / MariaDB 10.6 / PostgreSQL 15任选其一安装向导里会填连接信息PHP 扩展openssl、json、zip、gd、mbstring、xml、dom、curl、exif、pdo、ctypephp -m输出里应全部出现Web 服务器Nginx 或 Apache 2.4必须支持 URL 重写内存 / 磁盘512 MB RAM、200 MB 磁盘起步生产环境建议 1 GB 内存缺扩展直接装就行例如 Debian 系apt install php-gd php-mbstring php-xml php-curl php-zip。⚙️ 最短路径5 步到登录页推荐路径是源码 Composer Nginx 浏览器安装向导。如果你不想自己维护服务器可以把整套东西装进 Docker 容器跑步骤类似本文不展开。第 1 步拿到代码并装依赖git clone https://gitcode.com/GitHub_Trending/es/espocrm espocrm cd espocrm composer install --no-dev预期结果命令正常跑完目录下出现vendor/没有 fatal 报错。第 2 步把 Web 服务器指到 public/ 目录注意根目录指向public/而不是项目根目录这是 EspoCRM 的访问入口约定。Nginx 最小配置server { root /var/www/espocrm/public; client_max_body_size 50M; location / { try_files $uri $uri/ /index.php?$query_string; } }生产环境还需要对data/、custom/、application/目录禁掉直接访问安装程序里内置了一份更完整的 Nginx/Apache 参考配置可以直接照抄见 install/core/config.php。预期结果浏览器访问域名出现安装向导页面。如果看到的是一张写着 You need to configure your webserver 的提示页说明重写规则没生效Apache 需a2enmod rewrite并允许AllowOverride All先解决它再往下走。第 3 步给 Web 用户写权限chown -R www-data:www-data /var/www/espocrm chmod -R urwX /var/www/espocrm/data /var/www/espocrm/custom预期结果data/和custom/属主是www-data安装向导的权限检查步骤不再标红。第 4 步走完浏览器里的安装向导访问域名按顺序过 5 个页面许可协议 → 环境检查 → 数据库连接主机、端口、库名、账号密码字符集选 utf8mb4→ 创建管理员账号 → 完成。页面每一步背后的逻辑在 install/core/ 目录里文件名和向导步骤一一对应卡在哪一步可以对照源码看。预期结果最后一步显示成功服务器上生成了data/config.php——这个文件记录了安装时的全部配置之后删掉安装目录也不会影响使用。✅ 确认它真的跑通了别急着配功能先花 1 分钟验证三件事用刚建的管理员账号登录能进仪表盘Opportunities by Stage 等组件正常渲染data/logs/application.log里没有新的 ERROR 行。data/config.php存在且内容非空。命令行执行curl -I https://你的域名/api/v1/返回401 Unauthorized而不是 404。401 说明 REST API 网关已经在工作只是拒绝匿名访问——路由与请求分发逻辑位于 application/Espo/Core/Api/。三条都满足部署才算真正完成。 把系统调成你的形状装好之后按业务动作来配而不是按系统菜单逐个点。让时间戳和界面说团队的语言。管理面板 → Preferences 里把时区设为Asia/Shanghai、界面语言设为简体中文。为什么活动流、通知时间全部依赖时区设错一天所有日志时间都错一天。把邮件接进来。管理面板 → Email Account填 SMTP发和 IMAP收信息。为什么跟进记录、报价往来一旦落到客户名下CRM 才有完整时间线而不只是孤立的销售数据。把团队请进来。管理面板 → User 建账号再分配 Role。为什么角色直接决定每个成员能看到哪些实体、能做增删改还是只读先给两个人配不同角色试一遍再批量建号。把老数据搬进来。列表页 → 导入上传 CSV。为什么没有历史数据的 CRM 无法验证流程导入一批真实客户后跑一遍建联系 → 建商机 → 关单才算完成验收。 报错对照表症状可能原因动作访问域名 403/500或页面空白Web 根目录没指向public/核对 Nginx 的root或 Apache 的DocumentRoot指向项目下的public/看到 You need to configure your webserver 提示页重写模块未启用或规则缺失Apachesudo a2enmod rewrite后重启并加AllowOverride AllNginx补全try_files那段 location安装向导权限检查标红data/、custom/不可被 Web 用户写入执行第 3 步的chown/chmod确认属主为www-data中文存进库后变成乱码数据库字符集不是 utf8mb4向导的数据库步骤里显式选择 utf8mb4已建库则用ALTER DATABASE ... CHARACTER SET utf8mb4修正下一步系统已经能用了剩下的事交给业务。建议第一件事接入一个真实邮箱并导入 20 个真实客户用一周时间让团队把日常跟进都记进去——数据流动起来之后值不值得继续投入答案自然会出来。【免费下载链接】espocrmEspoCRM – Open Source CRM Application项目地址: https://gitcode.com/GitHub_Trending/es/espocrm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考