sales-crm

自托管销售 CRM，客户商机跟进一站管

sales-crm 是一个基于 TypeScript 构建的开源销售 CRM 系统，面向中小团队和独立销售场景，目标是替代昂贵的商业 CRM 工具。它把客户、商机、销售流程和跟进记录集中到一个可自托管的 Web 应用中，解决销售数据分散在表格、聊天记录里难以沉淀和协作的问题。核心能力包括客户与联系人管理、销售管道（Pipeline）可视化、商机阶段推进、任务与提醒跟踪，以及基础的团队协作和权限控制。项目采用现代前端技术栈，界面交互流畅，部署相对轻量，适合希望掌控数据、按需二次开发的团队。由于是成长中项目，功能覆盖度还在扩展，但基础销售流程已经可用，社区也在持续贡献。

开源 free 行业应用

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1628

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类行业应用

开发团队kargulstudio

所属国家

官网地址

GitHubhttps://github.com/kargulstudio/sales-crm

定价模式free

价格说明开源项目，免费使用

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 1628

30天Star增速

HF 下载量

上线时间2026-10-04 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-08

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

已安装 Node.js 及 npm（项目为 Next.js 16 + React 19 技术栈）
可访问 npm 源的网络环境
本地磁盘可克隆 GitHub 仓库 https://github.com/kargulstudio/sales-crm
终端可用（bash 或同类 shell）

安装与启动步骤

1克隆项目源码

把仓库拉到本地并进入项目根目录，后续命令都在这个目录执行。
```
git clone https://github.com/kargulstudio/sales-crm.git
cd sales-crm
```
2安装依赖

在项目根目录执行，安装 package.json 里声明的全部依赖，耗时取决于网速。
```
npm install
```
3启动开发服务

启动开发服务器，默认监听 3000 端口，改动代码会自动热更新，适合本地调试。
```
npm run dev
```
4浏览器访问验证

打开 http://localhost:3000 查看页面是否正常渲染，终端应无报错信息。
5生产构建

生成生产环境可用的构建产物，上线前必须先执行，构建失败会直接报错。
```
npm run build
```
6启动生产服务

在已成功 build 的前提下启动生产模式服务，用于正式环境预览或部署。
```
npm run start
```
7代码检查

运行 ESLint 检查代码规范，提交前建议执行，可提前发现常见写法问题。
```
npm run lint
```

关键配置

配置项	必填	说明	示例
`NEXT_PUBLIC_SITE_URL`	否	按部署环境覆盖站点 URL，供 SEO 相关文件与页面元数据使用	`https://your-domain.com`
`SITE_NAME`	否	lib/seo.ts 中定义站点名称，robots、sitemap 与页面 metadata 由此派生	`Sales CRM`
`SITE_URL`	否	lib/seo.ts 中定义默认站点地址，环境变量可覆盖	`http://localhost:3000`
`SITE_DESCRIPTION`	否	lib/seo.ts 中定义站点描述，用于各页面元信息	`开源自托管销售 CRM 系统`
`SITE_ROUTES`	否	lib/seo.ts 中声明站点路由集合，影响 sitemap 与 llms.txt 生成	`['/', '/pipeline']`

如何确认成功

终端 npm run dev 无报错后，浏览器打开 http://localhost:3000 能正常显示页面，即启动成功。

常见问题

Q：3000 端口被占用怎么办？

A：README 未给出改端口的方法，可先关闭占用 3000 端口的其他进程，再重新执行 npm run dev。

Q：npm install 安装依赖失败怎么办？

A：先确认 Node.js 与 npm 已正确安装且网络可访问 npm 源，必要时更换镜像源后重试。

Q：怎么以生产模式运行？

A：先执行 npm run build 完成构建，再执行 npm run start 启动生产构建产物。

Q：上线前必须改哪些配置？

A：建议先在 lib/seo.ts 里设置 SITE_NAME、SITE_URL、SITE_DESCRIPTION、SITE_ROUTES，并通过环境变量 NEXT_PUBLIC_SITE_URL 覆盖部署地址。

Q：写页面或组件前要注意什么？

A：README 明确要求写任何 component、section、page 之前先阅读 CONVENTIONS.md，它是该仓库的构建规范。

注意事项

README 节选实际是 Kargul Starter（Next.js 16 + React 19 + Tailwind CSS 4）脚手架说明，未包含 CRM 业务模块的专用安装与配置步骤。
README 未提供 Docker、docker-compose 或云平台部署说明，本教程仅覆盖 npm 本地运行方式。
除 npm install、npm run dev 外的 npm 脚本还有 build、start、lint、to:avif、extract:avif、frame:rive，后三个为图片/动画资源处理工具。
项目处于持续成长阶段，功能覆盖度仍在扩展，实际部署前建议先看 GitHub 仓库当前状态。

核心亮点

基于 TypeScript 全栈开发，类型安全，便于二次开发和维护
提供销售管道可视化，商机阶段推进直观，适合中小团队日常跟进
支持自托管部署，数据自主可控，避免商业 CRM 的订阅费用和锁定

不足之处

功能深度相比成熟商业 CRM 仍有差距，高级报表和自动化能力有限
生态和插件体系尚在早期，第三方集成较少

适用场景

中小型销售团队管理客户线索和商机跟进
独立销售或顾问自建客户档案与成交记录
需要数据私有化、不想用 SaaS CRM 的公司内部部署

替代项目

Twenty、NocoBase

项目介绍

sales-crm 是行业应用领域的开源项目，由 kargulstudio 开发，是 2026 年新上线的项目。

在全站 13,916 个收录项目中，它的 GitHub 星标数（1,628）位列前 30%，在行业应用分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-06。免费使用。

它主要面向的使用场景是：中小型销售团队管理客户线索和商机跟进。同类可对比的替代方案包括 Twenty、NocoBase。

上一篇：sec-gemini

下一篇：没有了！