Customermates

采用 AGPL 许可的社区版、AI Agent、API、MCP 和可自托管的开放核心 CRM。

网站 | 演示 | 文档 | GitHub | 功能介绍

Customermates 是一款面向现代团队的 CRM，为联系人、组织、交易、服务和任务提供清晰的管理体系，无需经历常见的企业级繁琐配置。它将实用的 CRM 工作流与 API 访问、Webhooks、n8n 自动化、基于 MCP 的工具以及 AI Agent 工作流结合起来。

你可以使用托管云版本，也可以通过 Docker Compose 在自己的基础设施中运行 Customermates。

🚀 开始使用

有两种方式可以开始使用 Customermates：

选项	说明
云端	最快的入门方式，由 Customermates 托管。
自托管	使用 Docker Compose 和 PostgreSQL 在自己的服务上运行 Customermates。

文档入口：

• CRM 概览
• 自托管（安装、管理、云端与自托管的对比）
• 连接你的 AI（Claude）
• Webhooks

⭐ 主要功能

• 管理联系人、组织、交易、服务和任务的 CRM
• 提供 OpenAPI 文档的 API 访问
• Webhooks 和事件驱动集成
• 支持 n8n 工作流和自动化
• 支持 MCP，为 Agent 提供工具调用能力和结构化工具调用
• 电子邮件、LinkedIn、WhatsApp、Instagram 和 Telegram 的统一收件箱（云端版，Pro 套餐起提供）
• 审计日志
• Enterprise 套餐支持单点登录和白标功能（自托管 Enterprise 部署需另行协商）
• 面向团队的基于角色的访问控制
• 每个登录账号可使用多个相互隔离的工作区，各自拥有独立的数据模型、成员、账单、API 密钥和 MCP 连接
• 使用 Docker Compose 和 PostgreSQL 进行自托管部署
• 云端版按席位按月收费；请参阅当前套餐

📊 对比

Customermates 同时支持云端和自托管部署模式。

标准	云端	自托管
价格	按席位按月计费的套餐	核心功能免费 + 基础设施成本
设置时间	2 分钟	约 15 分钟
所需维护	无	Docker、Postgres、代理、TLS、备份
更新	自动	docker compose pull && docker compose up -d
在欧盟托管	✅	由你自行决定部署位置
备份	每日自动备份	由你配置
API 和集成	✅	✅
用户数量不限	✅	✅
记录数量不限	✅	✅
每个登录账号可使用多个工作区	✅（各工作区使用独立套餐）	✅
n8n 和自动化工作流	✅	✅
统一收件箱和日历同步	Pro 套餐起提供	❌（云端功能）
审计日志	已包含	已包含
Enterprise（单点登录、白标功能）	Enterprise 套餐	需另行协商

如需查看完整的决策指南，请参阅自托管文档。

🐳 自托管

自托管只需两个文件（docker-compose.yml 和 .env），然后运行 docker compose up -d。无需 git clone，也无需构建。每次启动时，已发布的镜像 ghcr.io/customermates/customermates:latest 都会应用待处理的迁移。

前提条件

• Docker 和 Docker Compose v2。
• 如果需要 TLS，则需要一个域名（本地使用时可选）。
• 每千条记录约需 2 GB RAM 和几 GB 磁盘空间。

设置

mkdir customermates && cd customermates
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/.env.selfhost.template -o .env
# edit .env with real values
docker compose up -d

必需的 .env 配置项：

• BETTER_AUTH_SECRET：较长的随机字符串（openssl rand -hex 32）。
• POSTGRES_PASSWORD：请修改默认值。
• BASE_URL：你的公开 URL（例如 https://crm.example.com）。
• RESEND_API_KEY 和 RESEND_OPERATOR_EMAIL：用于注册验证、密码重置和邀请邮件。

可选：取消 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET，或 AZURE_AD_CLIENT_ID 和 AZURE_AD_CLIENT_SECRET 前的注释，以提供 Google 或 Microsoft 登录。请参阅用户可以使用 Google 或 Microsoft 登录吗？。

设置 CRON_SECRET（openssl rand -hex 32），并每天携带该密钥调用 /api/cron/lifecycle，否则 Trash 在 30 天后也不会清空。请参阅我必须运行哪些定时任务？。

首次启动时，Prisma 应用迁移需要约 1 分钟。使用 docker compose logs -f app 查看日志，然后打开 <BASE_URL>/auth/signup。

日常使用

docker compose pull && docker compose up -d   # update
docker compose up -d                           # apply .env changes
docker compose logs -f app                     # logs

在应用前配置反向代理（Caddy、nginx、Traefik）以启用 TLS，并将 BASE_URL 设为公开的 https:// 地址。Customermates 会从 BASE_URL 获取链接的协议和主机，并在使用 https:// 时设置安全 Cookie，因此无需配置 X-Forwarded-Proto。代理必须传递原始的 Host 标头，因为应用会拒绝来源与其不匹配的表单提交，包括登录和注册。

更多文档：

• 自托管（安装和管理）
• 架构与安全

🛠️ 开发

创建隔离的工作树，并在本地运行 Customermates：

git fetch origin main
git worktree add ../customermates-my-change -b feat/my-change origin/main
cd ../customermates-my-change
nvm use
yarn db:provision
cp .env.cloud.template .env
# Paste the printed DATABASE_URL and DIRECT_URL into .env.
yarn install --frozen-lockfile
yarn db:reset
yarn dev

yarn db:provision 会创建一个 PostgreSQL 17 容器和一个由当前工作树拥有的命名卷。重复运行不会产生副作用。yarn db:reset 会应用迁移、填充数据库种子数据，并准备工作流架构。替换数据库卷会销毁数据，且只有运行 yarn db:provision --recreate 才会执行；工作树停用后，使用 yarn db:provision --destroy 移除其拥有的数据库。

常用脚本：

• yarn dev
• yarn build
• yarn lint
• yarn openapi:generate
• yarn db:provision
• yarn db:reset

如需了解可配置 CRM 架构审查、隔离数据库、生产构建版浏览器流程和 SSH 验证，请参阅浏览器验证指南。

📚 文档

文档涵盖：

• 产品概览和 CRM 对比
• 自托管和运维
• API 集成和 OpenAPI
• MCP 和 n8n
• 架构与安全

从这里开始：customermates.com/docs

📄 许可证

Customermates 采用开源核心许可模式。

社区版（ee/ 以外的所有第一方代码）根据 AGPL-3.0-only 授权。

ee/ 中的其他第一方文件可在源代码可用的 Customermates 商业许可证 下使用，并受其中 AGPL 客户端材料例外条款约束。在有限的社区构建许可范围之外将商业软件用于生产环境（包括使用任何企业功能），均须签订商业协议。

官方社区镜像 ghcr.io/customermates/customermates 基于共享代码库构建，并包含已编译的商业软件。有限的社区构建许可允许任何人在文档所述的 APP_MODE=self-hosted 运行方式必然会执行未修改的商业支持组件时运行这些组件；该许可不授权使用企业功能。

贡献者条款见 .github/CLA.md。

第三方数据仍遵循其自身许可证：Customermates 随附的 Google libaddressinput 地址格式，以及其从 GeoNames 下载的邮政编码，均根据 CC BY 4.0 授权，详见 THIRD_PARTY_NOTICES.md。