Twenty 部署说明（全新实例 :3100）
本目录不需要源码：使用官方镜像 twentycrm/twenty:v2.30.1，由顶层 docker-compose.yml 编排。
与旧实例的区别
| 旧实例（crm-ai-demo） | 新实例（crm-new） | |
|---|---|---|
| 端口 | 3000 | 3100 |
| 数据库 | crm-postgres / twenty |
crmnew-postgres:5440 / twenty |
| Redis | crm-redis db1 | crmnew-redis db1 |
| 镜像 | twentycrm/twenty:flywheel（定制前端） |
twentycrm/twenty:v2.30.1（官方） |
| 数据 | 旧数据保留 | 全新，无旧数据 |
首次使用
- 浏览器打开
http://localhost:3100 - 注册第一个 workspace（邮箱 + 密码），工作区名建议
Yehwang - 进入 Settings → Developers → API Keys 创建 API key（JWT 形式）
- 把 API key 和 workspace id 写入顶层
.env：
TWENTY_WORKSPACE_ID=<workspace uuid>
TWENTY_API_KEY=<jwt>
- 重建 bridge 让配置生效：
cd /home/dev/code/crm-new
docker compose up -d --force-recreate bridge
- 验证工具：
bash scripts/smoke.sh
curl -s http://localhost:4100/healthz
数据存储
- 业务数据：
crmnew-postgres的twenty库 - 文件：Docker volume
crm-new_twenty-data（容器内.local-storage）
注意
ENCRYPTION_KEY/APP_SECRET首次生成后不要随意更换，否则已加密数据（API key、连接配置）会失效。- Twenty 首次启动会跑数据库迁移，约 1–3 分钟；
bootstrap.sh已内置等待。 - 如果需要旧项目的“数据飞轮”定制页，需要另做前端构建，本新栈暂不包含。