relaticle是基于php和laravel的开源crm，可通过mcp与rest api供智能体访问。自托管时先区分docker部署和源码开发：前者使用官方容器组合，后者需要自行准备php、数据库及前端构建环境。
核对环境与部署文件
当前源码要求PHP 8.5及以上、PostgreSQL 17及以上、Composer 2与Node.js 22及以上。官方Docker方案包含应用、队列、调度、WebSocket、PostgreSQL和Redis六类容器，不能只运行一个PHP进程就认为整个服务就绪。
Relaticle官方CRM界面示例，非本站部署截图
配置密钥、数据库与访问地址
下载官方compose.yml，在.env中设置APP_KEY、DB_PASSWORD和APP_URL。按官方随机生成方式准备应用密钥，数据库密码填写自己生成的值，不保留示例内容。
应用密钥可用openssl rand -base64 32生成，再按官方要求加上base64:前缀填入APP_KEY。下载Compose文件的命令为：
curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml
docker compose up -d docker compose exec app php artisan make:filament-user
启动后执行第二条命令创建管理员，再访问APP_URL对应的/app入口。域名、HTTPS和运行配置应与实际部署地址一致。
立即学习“PHP免费学习笔记（深入）”；
区分界面与业务授权
上线前检查持久化、备份与更新配置，再连接真实CRM数据。主仓库目前提供英文界面，具备国际化扩展能力不等于已内置中文。接入智能体前应单独设置工作区和权限，容器启动成功并不代表业务授权已经完成。
