开源CRM系统实战指南：从部署到客户线索管理的全流程解析

准备阶段：选择适合你的部署方案

3分钟启动服务：两种部署方案对比

在开始使用开源CRM系统前，选择合适的部署方式是关键一步。以下两种方案各有优势，可根据实际需求选择：

方案一：容器化部署（适合个人学习）

容器化部署（通过Docker打包完整运行环境）是新手快速上手的最佳选择，无需担心环境配置问题。操作步骤如下：

# 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/co/CordysCRM
cd CordysCRM

# 构建并启动容器（包含OpenJDK 21、MySQL、Redis等依赖）
docker build -t cordys-crm -f installer/Dockerfile .
docker run -d -p 8080:8080 --name cordys-crm cordys-crm

方案二：手动部署（适合开发调试）

如果你需要对系统进行二次开发或自定义配置，推荐手动部署方式：

# 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/co/CordysCRM
cd CordysCRM

# 启动所有依赖服务（MySQL、Redis和主服务）
cd installer/shells
chmod +x *.sh  # 赋予执行权限
./start-all.sh  # 启动脚本会显示详细的服务状态

决策指南：如何选择部署方式

使用场景	推荐方案	优势	注意事项
个人学习	容器化部署	一键启动，环境隔离	需提前安装Docker
企业部署	手动部署	可定制化高，便于维护	需要Linux基础
开发调试	手动部署	支持热更新，调试方便	需配置开发环境

⚠️ 风险提示：容器化部署时，确保Docker服务已启动且端口8080未被占用，否则会导致启动失败。

实施阶段：从登录到创建客户线索

5步掌握客户线索管理：从数据录入到转化跟踪

成功部署后，我们来完成从系统登录到创建第一条客户线索的全过程。

步骤1：访问系统并登录

服务启动后，打开浏览器访问 http://localhost:8080，将看到登录界面。使用默认管理员账号登录：

• 用户名：admin
• 密码：admin123

步骤2：进入线索管理模块

登录成功后，在左侧导航栏中找到"线索管理"菜单，点击进入线索列表页面。这里可以查看所有现有线索并进行管理操作。

步骤3：创建新线索

在线索列表页面，点击右上角的"新建线索"按钮（按钮标签为"newClue"），弹出线索创建表单。

步骤4：填写线索信息

在表单中填写必要的客户信息，包括：

• 客户姓名（必填）
• 联系电话（必填）
• 公司名称（必填）
• 线索来源（如：网站咨询、线下活动等）
• 预计成交金额（选填）
• 备注信息（选填）

填写完成后，点击"保存"按钮提交。

步骤5：线索管理与跟进

创建成功后，你可以在线索列表中看到新添加的线索记录。系统提供了以下管理功能：

• 线索状态跟踪（新建、跟进中、已转化等）
• 线索分配（分配给不同销售人员）
• 线索转化（转为正式客户）
• 跟进记录（添加沟通记录）

进阶阶段：问题解决与扩展学习

常见问题解决库

在使用过程中，可能会遇到以下问题，这里提供解决方案：

部署相关问题

• 问题：启动容器后无法访问系统
  解决：检查端口是否被占用，使用 docker ps 查看容器状态，确保8080端口映射正确。

• 问题：手动启动服务时MySQL连接失败
  解决：检查installer/conf/mysql/my.cnf配置文件，确保数据库用户名密码正确。

功能使用问题

• 问题：无法创建线索，表单提交无反应
  解决：检查必填字段是否都已填写，特别是客户姓名和联系电话。

• 问题：线索列表不显示新创建的线索
  解决：尝试刷新页面或检查筛选条件是否正确。

扩展学习路径

根据你的学习目标，推荐以下官方资源：

入门级（了解基础功能）

• 官方文档：BUILD.md - 包含详细的构建和部署指南

进阶级（深入系统功能）

• 前端源码：frontend/ - 学习系统前端架构和UI组件
• 后端源码：backend/ - 了解业务逻辑和数据处理流程

专家级（二次开发）

• 框架模块：backend/framework/ - 系统核心框架代码
• API接口：frontend/packages/lib-shared/api/ - 前端API调用实现

通过本指南，你已经掌握了开源CRM系统的部署方法和客户线索管理的基本操作。随着使用深入，你可以探索更多高级功能，如客户管理、合同管理、销售机会跟踪等，充分发挥系统的强大能力。