这次我们来看一个基于 Docker 的 AI-CRM 系统部署项目。对于需要将客户关系管理与 AI 能力结合的团队来说，本地化部署一个可控、可定制的系统是刚需。Wukong AICRM 项目提供了一个通过 Docker 容器化部署的解决方案，旨在降低环境配置的复杂度，实现快速启动和集成。
本文将带你完成从零开始的完整 Docker 部署流程。核心在于理解其容器架构、服务启动顺序以及如何验证各项功能是否正常运行。整个过程不涉及复杂的 AI 模型训练或调参，重点在于工程化部署和基础功能验证，适合运维、开发以及对私有化 AI 应用部署感兴趣的读者。
1. 核心能力速览
在深入部署细节前，我们先通过下表快速了解 Wukong AICRM 的核心特性和部署要求，这有助于判断它是否适合你的环境。
| 能力项 | 说明 |
|---|---|
| 项目类型 | 容器化的 AI 客户关系管理系统 |
| 核心功能 | 客户管理、销售流程自动化、集成 AI 能力（如智能跟进、数据分析） |
| 部署方式 | Docker & Docker Compose 一键部署 |
| 硬件门槛 | 最低要求 4GB 内存，推荐 8GB 或以上以保证流畅运行多个容器服务 |
| 显存需求 | 取决于集成的具体 AI 模型。基础 CRM 功能无需 GPU；若包含视觉或 NLP 模型，则需按模型要求配置。 |
| 支持平台 | 支持 Windows（需 Docker Desktop）、Linux（主流发行版）、macOS |
| 启动方式 | 通过docker-compose up -d命令一键启动所有服务 |
| 服务访问 | 通过 Web 浏览器访问宿主机指定端口（如 80、8080）的 WebUI |
| 是否支持 API | 通常此类系统会提供 RESTful API 供二次开发集成，具体需查看项目文档 |
| 是否支持批量任务 | CRM 系统通常支持客户数据批量导入/导出，AI 批量处理能力取决于集成模块 |
| 数据持久化 | 通过 Docker 卷（Volume）实现数据库、上传文件等数据的持久化存储 |
| 适合场景 | 中小企业本地化私有部署、开发测试环境搭建、AI 与业务系统集成研究 |
2. 适用场景与使用边界
Wukong AICRM 的 Docker 化部署方案主要面向以下几类用户和场景：
适用场景：
- 本地开发与测试：开发者在本地快速搭建一套完整的 CRM 环境，用于功能开发、接口调试或插件测试。
- 中小企业私有化部署：对数据安全有要求，不希望使用 SaaS 服务的团队，可以通过此方案在自有服务器上部署。
- AI 能力集成探索：希望研究如何将 AI（如智能问答、线索评分、自动生成报告）与传统 CRM 业务逻辑结合的技术人员。
- 教育演示与学习：用于学习 Docker Compose 多服务编排、微服务架构以及现代 Web 应用部署的实践案例。
使用边界与注意事项：
- 非生产就绪：本文演示的 Docker 部署流程主要用于学习和测试。生产环境部署需要考虑高可用、负载均衡、安全加固（如 HTTPS、防火墙）、备份策略和监控告警。
- AI 功能限制：项目集成的 AI 能力可能是基础版本或需要额外配置模型。其效果、响应速度和并发能力可能与专业的 AI 云服务有差距。
- 数据合规性：作为 CRM 系统，会处理客户姓名、电话等敏感信息。在部署和使用时，必须严格遵守《个人信息保护法》等相关法律法规，确保数据存储、访问和使用的合规性。
- 版权与授权：确保部署使用的 Docker 镜像、源代码拥有合法的使用授权。若集成了第三方 AI 模型，需遵守对应模型的开源协议或商业许可。
- 性能瓶颈：在资源有限的机器上运行多个容器（如 Web 服务器、数据库、AI 推理服务），可能遇到性能瓶颈，需要根据实际业务量进行资源规划和扩容。
3. 环境准备与前置条件
开始安装前，请确保你的计算机满足以下基础条件。一个准备充分的环境能避免大部分后续问题。
3.1 操作系统要求
- Windows 10/11 专业版/企业版/教育版 (64位)：建议使用 WSL 2 后端以获得更好体验。
- Linux：Ubuntu 20.04/22.04 LTS, CentOS 7/8, Debian 10/11 等主流发行版。
- macOS：10.15 (Catalina) 或更高版本，基于 Intel 或 Apple Silicon 芯片。
3.2 硬件与资源要求
- 内存：最低 4GB，这是项目明确要求的基础。若要流畅运行所有服务（尤其是包含 AI 推理服务时），推荐 8GB 或以上。
- CPU：现代双核处理器或以上。
- 磁盘空间：至少预留 10GB 可用空间，用于存放 Docker 镜像、应用代码和数据库。
- 网络：需要稳定的网络连接以下载 Docker 镜像和可能的依赖包。
3.3 软件依赖安装核心依赖是Docker和Docker Compose。
