Docker容器化部署Wukong AICRM：从原理到实践的一站式指南
在实际企业级应用部署中，将复杂的多组件系统（如一个包含前后端、数据库、缓存和AI服务的CRM）快速、一致地部署到不同环境，是每个开发者和运维人员都会面临的挑战。手动配置环境、解决依赖冲突、处理端口占用等问题不仅耗时，而且极易出错，导致“在我机器上能跑”的尴尬局面。Docker容器化技术正是为了解决这类问题而生，它通过将应用及其所有依赖打包成一个标准化的单元，实现了“一次构建，处处运行”的承诺。
Wukong AICRM作为一个基于Java + Vue生态的智能对话式客户关系管理系统，其技术栈涵盖了Spring Boot后端、Vue前端、MySQL数据库、Redis缓存以及可能的大模型接口服务。使用Docker进行部署，可以将这些组件的安装、配置和启动流程固化下来，形成一套可重复、可版本化的部署方案。无论你是想在个人电脑上快速体验Wukong AICRM的功能，还是在测试服务器上搭建演示环境，Docker都能提供最便捷的路径。
本文将带你完成Wukong AICRM的完整Docker安装流程。我们将从Docker环境的准备开始，逐步拉取或构建项目镜像，配置必要的环境变量，最后通过Docker Compose一键启动所有服务。整个过程将详细解释每个步骤的目的、关键配置项的含义以及可能遇到的坑点。完成部署后，你将拥有一个完全独立、可随时启停的Wukong AICRM运行环境。
1. 理解Docker部署Wukong AICRM的核心优势与架构
在动手安装之前，我们需要先理解为什么Docker是部署此类复杂应用的首选方案，以及Wukong AICRM在Docker环境下的典型运行架构。这有助于你在后续步骤中做出正确的配置决策，并在出现问题时能快速定位。
1.1 为什么选择Docker而非传统安装方式？
传统部署一个像Wukong AICRM这样的全栈项目，通常需要经历以下繁琐步骤：
- 在服务器上安装Java运行环境（JRE或JDK），并配置
JAVA_HOME。 - 安装Node.js和npm/yarn，用于构建前端Vue项目。
- 安装MySQL数据库，创建数据库、用户并导入初始SQL脚本。
- 安装Redis服务器，并配置密码和持久化策略。
- 分别启动后端Spring Boot Jar包和前端静态资源服务。
- 配置Nginx进行反向代理，解决前后端跨域和静态资源服务问题。
每一步都可能因为操作系统版本、依赖库版本、文件权限、端口冲突等问题而失败。Docker通过容器化技术，将上述每一步都封装在一个独立的、轻量级的“容器”中。每个容器都包含了运行特定服务所需的一切：代码、运行时、系统工具、系统库和设置。对于Wukong AICRM，这意味着：
- 环境隔离：Java、Node.js、MySQL、Redis各自运行在独立的容器中，互不干扰，不会产生依赖冲突。
- 一键部署：使用
docker-compose up -d一条命令即可启动所有服务。 - 版本控制：Docker镜像有明确的标签（Tag），可以轻松回滚到任意历史版本。
- 资源可控：可以方便地限制每个容器使用的CPU和内存资源。
- 易于迁移：将整个
docker-compose.yml文件和相关的环境配置文件打包，即可在任何安装了Docker的机器上复现完全相同的环境。
1.2 Wukong AICRM的Docker化运行架构
一个典型的Wukong AICRM Docker部署会包含以下几个服务，它们通过Docker网络进行通信：
+-----------------------------------------------------------------------+ | Docker Host (你的电脑或服务器) | | | | +-------------+ +-------------+ +-------------+ | | | Nginx | | Spring Boot| | Vue | | | | 容器 |<-->| 后端容器 |<-->| 前端容器 | | | | (端口:80) | | (端口:8080) | | (构建产物) | | | +-------------+ +-------------+ +-------------+ | | | | | | | | | | | | +-------------+ +-------------+ +-------------+ | | | MySQL | | Redis | | ... | | | | 容器 | | 容器 | | (其他服务) | | | | (端口:3306) | | (端口:6379) | | | | | +-------------+ +-------------+ +-------------+ | | | +-----------------------------------------------------------------------+- 后端容器：运行Wukong AICRM的Spring Boot应用，处理业务逻辑和API请求。
- 前端容器：通常不直接运行Node.js开发服务器，而是将Vue项目构建成静态文件（HTML, JS, CSS），由Nginx提供服务。也可以使用一个轻量级HTTP服务器（如nginx）容器来托管这些静态文件。
- 数据库容器：运行MySQL，存储所有业务数据。
- 缓存容器：运行Redis，用于会话存储、缓存等。
- Nginx容器（可选但推荐）：作为反向代理和静态文件服务器。它将外部对
80或443端口的请求，根据路径转发到后端API或前端静态资源。同时解决跨域问题。
这些容器通过Docker Compose定义的“自定义网络”连接在一起，在容器内部，它们可以使用在docker-compose.yml中定义的服务名（如mysql，redis）作为主机名直接访问对方，无需关心IP地址。
2. 部署前的环境准备与Docker安装
在开始部署Wukong AICRM之前，必须确保你的宿主机（无论是Windows， macOS还是Linux）已经正确安装了Docker引擎和Docker Compose。这是所有后续操作的基础。
2.1 宿主机系统要求与Docker选型
- 操作系统：支持主流Linux发行版（Ubuntu， CentOS， Debian）， Windows 10/11（专业版、企业版或教育版）， 以及macOS。
- 内存：建议至少4GB， 8GB或以上更佳，因为需要同时运行多个容器。
- 磁盘空间：至少10GB可用空间，用于存储Docker镜像和容器数据。
对于Windows和macOS用户，强烈推荐安装Docker Desktop。它是一个集成了Docker引擎、Docker Compose、可视化界面和Kubernetes的官方桌面应用，极大简化了在非Linux系统上使用Docker的复杂度。
对于Linux服务器用户，通常直接安装Docker Engine和Docker Compose插件。
2.2 在Windows/macOS上安装Docker Desktop
- 访问官网下载：前往Docker官方网站的下载页面，选择对应你操作系统的Docker Desktop安装包。
- Windows特定要求：
- 确保你的Windows版本满足要求（Windows 10 64位：专业版、企业版或教育版， 版本号至少为1903）。
- 必须开启“Hyper-V”和“容器”Windows功能。Docker Desktop安装程序通常会提示并帮你启用。
- 对于Windows 10家庭版，需要先安装WSL 2（Windows Subsystem for Linux 2），然后Docker Desktop会基于WSL 2运行。
- 运行安装程序：双击下载的安装包，按照向导完成安装。安装完成后，需要重启电脑。
- 启动与验证：重启后，在开始菜单找到“Docker Desktop”并启动。首次启动需要接受服务条款，并等待Docker引擎启动完成（系统托盘会出现鲸鱼图标）。
- 测试安装：打开命令行终端（PowerShell， CMD或终端），运行以下命令验证安装是否成功：
如果两个命令都能正确输出版本号，说明安装docker --version docker-compose --version