twenty开源CRM完整实用指南：自托管部署、数据模型定制与应用扩展

twenty开源CRM完整实用指南自托管部署、数据模型定制与应用扩展【免费下载链接】twentyThe open alternative to Salesforce, designed for AI.项目地址: https://gitcode.com/GitHub_Trending/tw/twenty本文写给准备自建客户管理系统的开发和运维同学10 分钟内部署一套自托管的 twenty 开源 CRM并按跑通 → 适配业务 → 接入自动化与扩展应用三步把对象、字段、工作流改成贴合你业务的形态。 阶段一 · 快速上手两条路径跑通 twenty结论先行生产环境装 Docker 即可开发场景才需要拉源码。一键自托管部署一个脚本拉起全套服务官方 1-click 脚本会先检查 Docker、docker compose v2 和 curl然后拉取 compose 文件与.env模板一次性启动 server、worker、PostgreSQL、Redis 共 4 个服务。git clone https://gitcode.com/GitHub_Trending/tw/twenty bash twenty/packages/twenty-docker/scripts/1-click.sh第一行克隆仓库第二行执行部署脚本。想锁定版本时加前缀即可例如VERSIONv0.32.4 bash ...指定 0.32.4。compose 定义在 packages/twenty-docker/需要自定义镜像或网络时直接改这里。本地开发环境yarn 安装后一条命令起前端twenty 是 Nx 管理的多包 monorepo前端、后端、共享 UI 都在同一仓库里。装完依赖后用 Nx 单独起前端即可yarn install npx nx serve twenty-front前端业务模块集中在 packages/twenty-front/src/modules/后端引擎在 packages/twenty-server/src/engine/。只改服务端时跑npx nx worker twenty-server即可不必全量启动。 阶段二 · 适配业务数据模型与视图怎么改twenty 的核心思路是把 CRM 当代码做对象、字段、视图都能用 TypeScript 声明随 Git 走版本管理。自定义对象与字段一个文件声明一个业务对象场景销售团队需要一个Deal对象含金额和关单日期。用 twenty-sdk 的defineObject在单个文件里写清对象单复数名和字段类型文本、货币、日期时间等发布后对象即刻出现在工作区。字段类型全集和命名约定参考 官方文档 的 apps 章节视图配置则落在前端 views 模块支持表格、看板、日历切换。权限与角色按对象和字段收放访问系统预置管理员、标准用户、只读等角色模板你在设置页按对象级和字段级两档粒度调整。字段级权限适合普通成员可见客户名、不可见回款金额这类场景无需改一行代码。⚡ 阶段三 · 自动化与扩展Webhook 和自研应用当内置能力不够时twenty 给你两条路事件外推或发布自己的 App。Webhook 与 API把 twenty 接进现有系统以新建公司记录即触发外部通知为例在设置里开启 Advanced创建一个 webhook填上接收端 URL过滤条件选 Companies 的 Created 事件worker 就会把每次写入 POST 出去。配合 GraphQL/REST API你可以用脚本批量读写记录把 twenty 当数据中台用。应用开发从脚手架到发布 4 条命令npx create-twenty-app my-app脚手架来自 create-twenty-app 包生成标准目录和示例代码开发完执行npx twenty app:publish --private发布到工作区。仓库里的 twenty-apps 目录 有 call-recorder、Slack、Linear 等开源示例可直接抄。下面这种带模板视图的 App 就是文档生成器的实际效果 运维与排障高频问题清单装完无法登录在 server 容器里跑npx nx database:reset --configurationno-seed后重建容器会清库仅限全新环境改密码后认证失败PG_DATABASE_PASSWORD会固化在数据库卷里改.env需连同卷一起重建邮件收不到多半是 worker 没跑补一条npx nx worker twenty-server工作流报 Logic function 被禁用生产环境默认关闭将LOGIC_FUNCTION_TYPE设为 LOCAL 或 LAMBDAAI 对话需刷新才见回复反向代理缺流式配置关掉proxy_buffering和 gzip存量数据迁移前端内置电子表格批量导入模块CSV 清洗后直接导入完整排查手册见 troubleshooting 文档社区与贡献遇到问题先翻仓库 issue再进 Twenty 官方 Discord 社区提问。翻译可在 Crowdin 上认领语言包代码贡献直接提 PR遵循仓库根目录的贡献指南即可。【免费下载链接】twentyThe open alternative to Salesforce, designed for AI.项目地址: https://gitcode.com/GitHub_Trending/tw/twenty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考