1. 先搞清楚“悟空 AICRM”和 Docker 部署到底解决什么问题如果你正在找一个开源的、带 AI 能力的客户关系管理系统并且希望用最省事的方式把它跑起来那“悟空 AICRM”的 Docker 部署方案值得你花时间看看。它本质上是一个打包好的 Java 项目集成了 CRM 的核心功能并宣称具备 AI 能力比如智能线索分析、客户画像等。而 Docker 部署就是把项目本身以及它依赖的 MySQL、Redis、Nginx、Elasticsearch 等一堆组件全部用容器封装好让你通过几条命令就能拉起一个可用的环境。这解决了两个核心痛点一是环境配置复杂传统部署需要逐个安装、配置数据库、中间件版本兼容性是个大坑二是环境一致性开发、测试、生产环境难以统一Docker 镜像能保证“在我这能跑在你那也能跑”。但别急着执行命令。在动手前你得先明确这个方案适合谁它最适合想快速体验或搭建内部 CRM 系统的团队或个人开发者尤其是那些对 Java 微服务架构它用了 Nacos、Seata 等不太熟悉但又需要一个完整、可用的系统来评估或使用的场景。如果只是想学习 Docker或者需要一个超轻量级的 CRM这可能不是最优选因为它默认集成的组件较多对服务器资源有一定要求。2. 部署前的核心准备环境、资源和关键决策点在运行任何docker-compose up -d之前准备工作决定了部署是顺利还是踩坑。根据官方 Wiki 的建议和常见实践你需要关注以下几点。2.1 服务器与系统环境要求官方建议的配置是4核16G及以上。这是一个比较宽松的“建议配置”意味着低于这个配置也能跑但性能体验和并发能力会受限。对于个人学习或小团队内部试用2核4G或2核8G的服务器通常也能启动并运行基础功能但处理大量数据或高并发操作时可能会比较慢。系统方面它支持 Linux、Windows、macOS。但生产环境部署强烈建议使用 Linux 服务器如 CentOS 7/8、Ubuntu 20.04/22.04。原因有三一是 Docker 在 Linux 上原生运行性能损耗最小二是后续的运维、日志查看、资源监控都更成熟三是绝大多数生产服务器都是 Linux 环境。如果你的本地开发机是 Windows 或 macOS可以先用 Docker Desktop 进行体验但最终上线时还是建议在 Linux 服务器上操作。2.2 Docker 与 Docker Compose 版本这是基础中的基础。你需要确保服务器上已经安装了 Docker 引擎和 Docker Compose。Docker: 版本建议在 20.10.0 及以上。太老的版本可能不支持docker-compose.yml中的某些语法或特性。Docker Compose: 如果你用的是 Docker DesktopWindows/macOSCompose 通常已集成。在 Linux 上你可能需要单独安装。建议使用 Docker Compose V2命令通常是docker compose而不是docker-compose但项目提供的脚本可能用的是旧语法需要留意。项目自带的docker-install.sh脚本可以帮你安装 Docker 和 Compose但在生产环境我一般会先检查现有版本并倾向于使用操作系统官方的包管理器如yum或apt进行安装以便于后续管理。2.3 网络与端口的规划这个 Docker Compose 方案会启动多个容器每个容器都会映射端口到宿主机。你需要提前检查这些端口是否被占用。 常见的端口映射包括80: Nginx 的 HTTP 端口用于访问 CRM 系统。3306: MySQL 数据库端口。6379: Redis 端口。8848: Nacos配置中心端口。9200: Elasticsearch 端口。在运行前使用netstat -tlnp | grep 端口号或ss -tlnp | grep 端口号命令检查冲突。如果端口被占用你有两个选择一是停止占用端口的服务二是修改docker-compose.yml文件将容器端口映射到宿主机其他空闲端口例如将80:80改为8080:80。2.4 一个关键决策使用自带组件还是外接已有服务这是部署前最重要的一个选择。项目docker-compose.yml默认包含了 MySQL、Redis、Elasticsearch、Nacos 等全套组件。这很方便但可能不适合你的情况。场景一全新环境快速启动如果你是在一台干净的服务器上部署或者就是为了体验那么直接使用自带的组件是最简单的。所有数据库、缓存、索引都保存在容器内或映射的宿主机目录./data管理简单。场景二已有数据库或中间件服务如果你的服务器上已经运行着公司统一的 MySQL、Redis 集群那么把 CRM 系统接入现有服务是更规范的做法。这时你需要在docker-compose.yml中注释掉mysql、redis等服务定义。修改 CRM 项目配置文件通常在./conf或./workspace目录下映射进去将数据库连接地址、密码等指向你的外部服务。确保 CRM 容器网络能访问到这些外部服务通常使用host网络模式或确保网络互通。我建议新手第一次部署时先用默认的自带组件跑通理解整个流程和数据流转。等需要迁移或集成时再考虑外接。3. 从零开始的完整部署实操步骤假设我们在一台全新的 CentOS 7 服务器上操作。以下步骤结合了官方指南和实际踩坑经验。3.1 第一步获取项目代码与目录审视首先通过 Git 拉取项目代码。如果服务器没有 Git先安装它yum install -y git。# 克隆项目到本地可以指定目录这里我们放到 /opt 下 cd /opt git clone 项目Git仓库地址 wukong-crm cd wukong-crm克隆完成后不要急着运行脚本。先花两分钟看看docker目录的结构这对后续排查问题至关重要。tree ./docker -L 2你会看到类似如下的结构基于搜索材料docker ├── conf/ # 各组件配置文件Nginx, MySQL, Nacos等 ├── data/ # 数据库数据、ES插件、初始化脚本 ├── log/ # 各组件的日志目录 ├── workspace/ # 核心CRM服务本身、Seata等映射到容器内 ├── docker-compose.yml ├── docker-install.sh ├── start.sh └── ... (其他.sh脚本)conf/: 这里面的配置决定了组件如何运行。例如改域名就要动conf/nginx/conf.d/wkcrm.conf。data/:你的业务数据MySQL和搜索索引ES最终都存在这里。务必确保这个目录有足够的磁盘空间和正确的权限Docker 进程可写。workspace/: 这是悟空 CRM 后端 Java 服务的“家”所有业务代码和配置都在里面。*.sh脚本是辅助脚本但理解它们做了什么比直接运行更重要。3.2 第二步安装 Docker 与 Docker Compose如果你确定服务器没有 Docker可以运行项目自带的安装脚本cd /opt/wukong-crm/docker chmod x docker-install.sh ./docker-install.sh但我更建议手动安装以便控制版本和后续升级。以 CentOS 7 为例# 1. 卸载旧版本如有 sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 2. 安装依赖包 sudo yum install -y yum-utils device-mapper-persistent-data lvm2 # 3. 设置稳定的仓库使用阿里云镜像加速 sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo # 4. 安装 Docker Engine sudo yum install -y docker-ce docker-ce-cli containerd.io # 5. 启动 Docker 并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 6. 安装 Docker Compose (这里以 V2 为例) # 下载最新稳定版请从 GitHub Release 页面获取最新版本号 sudo curl -L https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose # 7. 验证安装 docker --version docker-compose --version安装完成后建议配置 Docker 镜像加速器如阿里云、腾讯云镜像加速以提升拉取镜像的速度。3.3 第三步可选修改配置以适应你的环境在启动前根据你的需求调整配置。1. 修改访问域名/IP重要默认配置可能直接用服务器 IP。如果你想用域名访问或者 IP 不是默认的需要修改 Nginx 配置vi ./docker/conf/nginx/conf.d/wkcrm.conf找到server_name配置项将后面的 IP 或域名改成你的服务器公网 IP 或域名例如server_name your-server-ip-or-domain;保存退出。2. 检查并调整资源限制可选打开docker-compose.yml你可以看到每个服务的定义。如果服务器内存较小比如只有 4G你可能需要调低某些容器的内存限制例如 Elasticsearch 比较吃内存。找到类似mem_limit: 1024m的配置根据实际情况调整。但注意调太低可能导致服务启动失败或运行不稳定。3.4 第四步启动所有容器服务这是最关键的一步。在docker目录下运行启动命令# 确保你在 /opt/wukong-crm/docker 目录下 docker-compose up -d-d参数表示在后台运行。执行后Docker 会开始拉取镜像MySQL、Redis、Nginx 等镜像并启动容器。第一次运行会花费一些时间取决于你的网络速度。不要以为命令执行完就万事大吉了。你需要观察启动日志确认所有服务都健康启动。# 查看所有容器的状态 docker-compose ps # 或者用 docker 原生命令 docker ps你应该看到mysql,redis,nacos,nginx,wkcrm(可能叫别的服务名),elasticsearch等容器的状态都是Up。更重要的是查看启动日志尤其是wkcrm核心服务# 查看某个容器的实时日志不加 -f 则查看历史 docker-compose logs -f wkcrm你需要关注日志中是否有Started Application in XX seconds这样的成功启动信息或者是否有连续的报错如数据库连接失败、配置中心连接失败。3.5 第五步访问系统与初始化当所有容器状态为Up并且核心服务日志显示启动成功后就可以通过浏览器访问了。在浏览器地址栏输入http://你的服务器IP如果你修改了 Nginx 的server_name且配置了域名解析也可以用域名。如果一切正常你应该能看到悟空 CRM 的登录或初始化页面。首次访问系统可能会引导你进行一些初始配置如创建管理员账号、设置公司信息等。按照页面提示操作即可。4. 部署后的验证、管理与常见问题排查成功访问登录页只是第一步确保系统真正可用还需要做以下几件事。4.1 基础功能验证清单部署完成后不要马上投入业务使用先跑一个简单的验证流程登录与权限用初始管理员账号登录检查是否能正常进入后台。核心模块访问依次点击“客户管理”、“销售线索”、“合同管理”等主要菜单看页面是否能正常加载无404或500错误。数据操作尝试创建一个测试客户、一条销售线索。检查是否能成功保存并在列表中显示。搜索功能如果集成了 Elasticsearch在客户列表尝试搜索关键字看是否能返回结果。定时任务检查后台是否有定时任务如线索回收看其状态是否正常。4.2 日常运维与管理命令你需要熟悉几个基本的 Docker Compose 命令来管理这个 CRM 系统停止所有服务docker-compose down。这会停止并删除所有容器但不会删除data目录下的数据。重启某个服务如修改了 CRM 代码docker-compose restart wkcrm。查看所有服务日志docker-compose logs。进入容器内部用于排查或执行命令docker-compose exec mysql bash # 进入 MySQL 容器 docker-compose exec wkcrm sh # 进入 CRM 后端容器备份数据最重要的就是./docker/data/mysql目录里面是数据库文件。定期备份这个目录即可。可以使用docker-compose exec mysql mysqldump -u root -p[密码] wkcrm backup.sql进行逻辑备份。4.3 高频问题与排查思路即使按照教程操作也可能会遇到问题。以下是几个常见坑点及排查顺序问题一访问http://服务器IP显示502 Bad Gateway或连接被拒绝。排查顺序检查 Nginx 容器docker-compose logs nginx。看 Nginx 是否成功启动以及wkcrm.conf配置是否被正确加载。常见错误是 upstream后端服务配置的地址或端口不对。检查后端 CRM 服务docker-compose logs -f wkcrm。核心看 Java 应用是否启动成功。如果启动失败最常见的原因是数据库连接失败检查 MySQL 容器是否正常 (docker-compose ps)CRM 配置文件中的数据库 IP、端口、用户名、密码是否正确。配置文件通常在workspace目录映射进去的位置。配置中心Nacos连接失败同样检查 Nacos 容器状态以及 CRM 服务配置中 Nacos 的地址。端口冲突CRM 服务本身或依赖的组件端口被占用。检查网络确保所有容器在同一个 Docker 网络内docker-compose.yml中定义。使用docker network ls和docker network inspect [网络名]查看。问题二系统运行一段时间后变得非常卡顿。排查顺序检查服务器资源使用top或htop命令看 CPU、内存是否耗尽。重点怀疑 Elasticsearch 和 Java 应用。检查容器资源占用docker stats可以实时查看每个容器的 CPU、内存使用率。检查日志是否有大量错误docker-compose logs --tail100 wkcrm查看最近日志是否有数据库连接超时、Redis 超时、频繁 Full GC 等错误。检查磁盘空间df -h尤其是./docker/data和./docker/log所在的磁盘分区是否已满。日志文件可能快速增长。问题三如何更新到新版本这是 Docker Compose 部署的优势之一。拉取最新的项目代码git pull origin main。如果docker-compose.yml或镜像版本有更新需要重新构建或拉取镜像docker-compose pull。重启服务docker-compose up -d。重要数据库结构变更通常由项目内部的初始化脚本或 Flyway/Liquibase 处理但大版本升级前务必备份./docker/data/mysql目录。问题四AI 功能没有生效或找不到。理解开源版本的“AI能力”可能是指集成了一些规则引擎、简单预测或预留了接口。它可能不是一个完整的、开箱即用的大语言模型服务。排查查看项目文档或代码明确 AI 功能的具体实现方式是调用外部 API 还是内置算法。检查相关服务的配置和日志看是否有调用 AI 服务的记录或报错。如果是调用外部 API确保服务器网络能够访问该 API 地址。5. 从“能用”到“好用”的进阶考量当你成功部署并验证基础功能后如果计划用于正式环境还需要考虑以下几点。5.1 数据持久化与备份策略默认的docker-compose.yml通常已经通过卷映射volumes将数据挂载到了宿主机的./data目录这保证了容器删除后数据不丢失。但你还需要定期备份编写脚本定期将./data/mysql目录打包备份到其他存储如对象存储、另一台服务器。考虑数据库分离对于正式环境强烈建议将 MySQL、Redis 等有状态服务部署到更专业、高可用的云服务或自建集群中而不是放在应用容器里。这样可以获得更好的性能、可靠性和备份恢复能力。5.2 性能调优与监控JVM 参数CRM 的 Java 服务可能需要调整 JVM 堆内存参数。你可以在docker-compose.yml中wkcrm服务的environment部分或启动脚本里设置JAVA_OPTS例如-Xms2g -Xmx4g。Elasticsearch 调优ES 对内存和磁盘 I/O 敏感。如果数据量大需要专门为 ES 容器分配更多内存并考虑使用 SSD 磁盘。接入监控使用cAdvisorPrometheusGrafana监控 Docker 容器和宿主机的资源使用情况CPU、内存、网络、磁盘设置告警。5.3 安全加固修改默认密码docker-compose.yml和conf/下的配置文件中MySQL、Redis 等组件都有默认密码。在公网部署前必须修改成强密码。限制访问通过服务器防火墙如firewalld、iptables或云安全组只开放必要的端口如 80/443。不要将 MySQL 的 3306、Redis 的 6379 等管理端口暴露到公网。Nginx 配置 HTTPS在conf/nginx/conf.d/wkcrm.conf中配置 SSL 证书启用 HTTPS保护数据传输安全。定期更新镜像关注基础镜像如 MySQL、Redis的安全更新定期重建和部署容器。5.4 自定义开发与扩展如果你需要二次开发你的代码应该放在workspace目录对应的源码位置。修改代码后需要重新打包 Java 应用通常使用项目内的 Maven 或 Gradle 脚本然后重启wkcrm服务docker-compose restart wkcrm。更规范的做法是将你的代码构建成新的 Docker 镜像然后修改docker-compose.yml中wkcrm服务的image标签指向你的新镜像。最后记住 Docker 部署的最大价值是环境标准化和快速交付。对于悟空 AICRM 这类复杂系统它帮你跳过了最繁琐的环境搭建环节。但真正要让它稳定、可靠地运行后续的监控、备份、安全、性能优化才是更考验运维功底的地方。建议先从默认配置跑起来理解整个架构和数据流再根据实际需求和资源情况一步步进行优化和加固。
悟空AICRM Docker部署全攻略：从环境准备到生产级运维
发布时间：2026/7/28 11:37:06
1. 先搞清楚“悟空 AICRM”和 Docker 部署到底解决什么问题如果你正在找一个开源的、带 AI 能力的客户关系管理系统并且希望用最省事的方式把它跑起来那“悟空 AICRM”的 Docker 部署方案值得你花时间看看。它本质上是一个打包好的 Java 项目集成了 CRM 的核心功能并宣称具备 AI 能力比如智能线索分析、客户画像等。而 Docker 部署就是把项目本身以及它依赖的 MySQL、Redis、Nginx、Elasticsearch 等一堆组件全部用容器封装好让你通过几条命令就能拉起一个可用的环境。这解决了两个核心痛点一是环境配置复杂传统部署需要逐个安装、配置数据库、中间件版本兼容性是个大坑二是环境一致性开发、测试、生产环境难以统一Docker 镜像能保证“在我这能跑在你那也能跑”。但别急着执行命令。在动手前你得先明确这个方案适合谁它最适合想快速体验或搭建内部 CRM 系统的团队或个人开发者尤其是那些对 Java 微服务架构它用了 Nacos、Seata 等不太熟悉但又需要一个完整、可用的系统来评估或使用的场景。如果只是想学习 Docker或者需要一个超轻量级的 CRM这可能不是最优选因为它默认集成的组件较多对服务器资源有一定要求。2. 部署前的核心准备环境、资源和关键决策点在运行任何docker-compose up -d之前准备工作决定了部署是顺利还是踩坑。根据官方 Wiki 的建议和常见实践你需要关注以下几点。2.1 服务器与系统环境要求官方建议的配置是4核16G及以上。这是一个比较宽松的“建议配置”意味着低于这个配置也能跑但性能体验和并发能力会受限。对于个人学习或小团队内部试用2核4G或2核8G的服务器通常也能启动并运行基础功能但处理大量数据或高并发操作时可能会比较慢。系统方面它支持 Linux、Windows、macOS。但生产环境部署强烈建议使用 Linux 服务器如 CentOS 7/8、Ubuntu 20.04/22.04。原因有三一是 Docker 在 Linux 上原生运行性能损耗最小二是后续的运维、日志查看、资源监控都更成熟三是绝大多数生产服务器都是 Linux 环境。如果你的本地开发机是 Windows 或 macOS可以先用 Docker Desktop 进行体验但最终上线时还是建议在 Linux 服务器上操作。2.2 Docker 与 Docker Compose 版本这是基础中的基础。你需要确保服务器上已经安装了 Docker 引擎和 Docker Compose。Docker: 版本建议在 20.10.0 及以上。太老的版本可能不支持docker-compose.yml中的某些语法或特性。Docker Compose: 如果你用的是 Docker DesktopWindows/macOSCompose 通常已集成。在 Linux 上你可能需要单独安装。建议使用 Docker Compose V2命令通常是docker compose而不是docker-compose但项目提供的脚本可能用的是旧语法需要留意。项目自带的docker-install.sh脚本可以帮你安装 Docker 和 Compose但在生产环境我一般会先检查现有版本并倾向于使用操作系统官方的包管理器如yum或apt进行安装以便于后续管理。2.3 网络与端口的规划这个 Docker Compose 方案会启动多个容器每个容器都会映射端口到宿主机。你需要提前检查这些端口是否被占用。 常见的端口映射包括80: Nginx 的 HTTP 端口用于访问 CRM 系统。3306: MySQL 数据库端口。6379: Redis 端口。8848: Nacos配置中心端口。9200: Elasticsearch 端口。在运行前使用netstat -tlnp | grep 端口号或ss -tlnp | grep 端口号命令检查冲突。如果端口被占用你有两个选择一是停止占用端口的服务二是修改docker-compose.yml文件将容器端口映射到宿主机其他空闲端口例如将80:80改为8080:80。2.4 一个关键决策使用自带组件还是外接已有服务这是部署前最重要的一个选择。项目docker-compose.yml默认包含了 MySQL、Redis、Elasticsearch、Nacos 等全套组件。这很方便但可能不适合你的情况。场景一全新环境快速启动如果你是在一台干净的服务器上部署或者就是为了体验那么直接使用自带的组件是最简单的。所有数据库、缓存、索引都保存在容器内或映射的宿主机目录./data管理简单。场景二已有数据库或中间件服务如果你的服务器上已经运行着公司统一的 MySQL、Redis 集群那么把 CRM 系统接入现有服务是更规范的做法。这时你需要在docker-compose.yml中注释掉mysql、redis等服务定义。修改 CRM 项目配置文件通常在./conf或./workspace目录下映射进去将数据库连接地址、密码等指向你的外部服务。确保 CRM 容器网络能访问到这些外部服务通常使用host网络模式或确保网络互通。我建议新手第一次部署时先用默认的自带组件跑通理解整个流程和数据流转。等需要迁移或集成时再考虑外接。3. 从零开始的完整部署实操步骤假设我们在一台全新的 CentOS 7 服务器上操作。以下步骤结合了官方指南和实际踩坑经验。3.1 第一步获取项目代码与目录审视首先通过 Git 拉取项目代码。如果服务器没有 Git先安装它yum install -y git。# 克隆项目到本地可以指定目录这里我们放到 /opt 下 cd /opt git clone 项目Git仓库地址 wukong-crm cd wukong-crm克隆完成后不要急着运行脚本。先花两分钟看看docker目录的结构这对后续排查问题至关重要。tree ./docker -L 2你会看到类似如下的结构基于搜索材料docker ├── conf/ # 各组件配置文件Nginx, MySQL, Nacos等 ├── data/ # 数据库数据、ES插件、初始化脚本 ├── log/ # 各组件的日志目录 ├── workspace/ # 核心CRM服务本身、Seata等映射到容器内 ├── docker-compose.yml ├── docker-install.sh ├── start.sh └── ... (其他.sh脚本)conf/: 这里面的配置决定了组件如何运行。例如改域名就要动conf/nginx/conf.d/wkcrm.conf。data/:你的业务数据MySQL和搜索索引ES最终都存在这里。务必确保这个目录有足够的磁盘空间和正确的权限Docker 进程可写。workspace/: 这是悟空 CRM 后端 Java 服务的“家”所有业务代码和配置都在里面。*.sh脚本是辅助脚本但理解它们做了什么比直接运行更重要。3.2 第二步安装 Docker 与 Docker Compose如果你确定服务器没有 Docker可以运行项目自带的安装脚本cd /opt/wukong-crm/docker chmod x docker-install.sh ./docker-install.sh但我更建议手动安装以便控制版本和后续升级。以 CentOS 7 为例# 1. 卸载旧版本如有 sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 2. 安装依赖包 sudo yum install -y yum-utils device-mapper-persistent-data lvm2 # 3. 设置稳定的仓库使用阿里云镜像加速 sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo # 4. 安装 Docker Engine sudo yum install -y docker-ce docker-ce-cli containerd.io # 5. 启动 Docker 并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 6. 安装 Docker Compose (这里以 V2 为例) # 下载最新稳定版请从 GitHub Release 页面获取最新版本号 sudo curl -L https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose # 7. 验证安装 docker --version docker-compose --version安装完成后建议配置 Docker 镜像加速器如阿里云、腾讯云镜像加速以提升拉取镜像的速度。3.3 第三步可选修改配置以适应你的环境在启动前根据你的需求调整配置。1. 修改访问域名/IP重要默认配置可能直接用服务器 IP。如果你想用域名访问或者 IP 不是默认的需要修改 Nginx 配置vi ./docker/conf/nginx/conf.d/wkcrm.conf找到server_name配置项将后面的 IP 或域名改成你的服务器公网 IP 或域名例如server_name your-server-ip-or-domain;保存退出。2. 检查并调整资源限制可选打开docker-compose.yml你可以看到每个服务的定义。如果服务器内存较小比如只有 4G你可能需要调低某些容器的内存限制例如 Elasticsearch 比较吃内存。找到类似mem_limit: 1024m的配置根据实际情况调整。但注意调太低可能导致服务启动失败或运行不稳定。3.4 第四步启动所有容器服务这是最关键的一步。在docker目录下运行启动命令# 确保你在 /opt/wukong-crm/docker 目录下 docker-compose up -d-d参数表示在后台运行。执行后Docker 会开始拉取镜像MySQL、Redis、Nginx 等镜像并启动容器。第一次运行会花费一些时间取决于你的网络速度。不要以为命令执行完就万事大吉了。你需要观察启动日志确认所有服务都健康启动。# 查看所有容器的状态 docker-compose ps # 或者用 docker 原生命令 docker ps你应该看到mysql,redis,nacos,nginx,wkcrm(可能叫别的服务名),elasticsearch等容器的状态都是Up。更重要的是查看启动日志尤其是wkcrm核心服务# 查看某个容器的实时日志不加 -f 则查看历史 docker-compose logs -f wkcrm你需要关注日志中是否有Started Application in XX seconds这样的成功启动信息或者是否有连续的报错如数据库连接失败、配置中心连接失败。3.5 第五步访问系统与初始化当所有容器状态为Up并且核心服务日志显示启动成功后就可以通过浏览器访问了。在浏览器地址栏输入http://你的服务器IP如果你修改了 Nginx 的server_name且配置了域名解析也可以用域名。如果一切正常你应该能看到悟空 CRM 的登录或初始化页面。首次访问系统可能会引导你进行一些初始配置如创建管理员账号、设置公司信息等。按照页面提示操作即可。4. 部署后的验证、管理与常见问题排查成功访问登录页只是第一步确保系统真正可用还需要做以下几件事。4.1 基础功能验证清单部署完成后不要马上投入业务使用先跑一个简单的验证流程登录与权限用初始管理员账号登录检查是否能正常进入后台。核心模块访问依次点击“客户管理”、“销售线索”、“合同管理”等主要菜单看页面是否能正常加载无404或500错误。数据操作尝试创建一个测试客户、一条销售线索。检查是否能成功保存并在列表中显示。搜索功能如果集成了 Elasticsearch在客户列表尝试搜索关键字看是否能返回结果。定时任务检查后台是否有定时任务如线索回收看其状态是否正常。4.2 日常运维与管理命令你需要熟悉几个基本的 Docker Compose 命令来管理这个 CRM 系统停止所有服务docker-compose down。这会停止并删除所有容器但不会删除data目录下的数据。重启某个服务如修改了 CRM 代码docker-compose restart wkcrm。查看所有服务日志docker-compose logs。进入容器内部用于排查或执行命令docker-compose exec mysql bash # 进入 MySQL 容器 docker-compose exec wkcrm sh # 进入 CRM 后端容器备份数据最重要的就是./docker/data/mysql目录里面是数据库文件。定期备份这个目录即可。可以使用docker-compose exec mysql mysqldump -u root -p[密码] wkcrm backup.sql进行逻辑备份。4.3 高频问题与排查思路即使按照教程操作也可能会遇到问题。以下是几个常见坑点及排查顺序问题一访问http://服务器IP显示502 Bad Gateway或连接被拒绝。排查顺序检查 Nginx 容器docker-compose logs nginx。看 Nginx 是否成功启动以及wkcrm.conf配置是否被正确加载。常见错误是 upstream后端服务配置的地址或端口不对。检查后端 CRM 服务docker-compose logs -f wkcrm。核心看 Java 应用是否启动成功。如果启动失败最常见的原因是数据库连接失败检查 MySQL 容器是否正常 (docker-compose ps)CRM 配置文件中的数据库 IP、端口、用户名、密码是否正确。配置文件通常在workspace目录映射进去的位置。配置中心Nacos连接失败同样检查 Nacos 容器状态以及 CRM 服务配置中 Nacos 的地址。端口冲突CRM 服务本身或依赖的组件端口被占用。检查网络确保所有容器在同一个 Docker 网络内docker-compose.yml中定义。使用docker network ls和docker network inspect [网络名]查看。问题二系统运行一段时间后变得非常卡顿。排查顺序检查服务器资源使用top或htop命令看 CPU、内存是否耗尽。重点怀疑 Elasticsearch 和 Java 应用。检查容器资源占用docker stats可以实时查看每个容器的 CPU、内存使用率。检查日志是否有大量错误docker-compose logs --tail100 wkcrm查看最近日志是否有数据库连接超时、Redis 超时、频繁 Full GC 等错误。检查磁盘空间df -h尤其是./docker/data和./docker/log所在的磁盘分区是否已满。日志文件可能快速增长。问题三如何更新到新版本这是 Docker Compose 部署的优势之一。拉取最新的项目代码git pull origin main。如果docker-compose.yml或镜像版本有更新需要重新构建或拉取镜像docker-compose pull。重启服务docker-compose up -d。重要数据库结构变更通常由项目内部的初始化脚本或 Flyway/Liquibase 处理但大版本升级前务必备份./docker/data/mysql目录。问题四AI 功能没有生效或找不到。理解开源版本的“AI能力”可能是指集成了一些规则引擎、简单预测或预留了接口。它可能不是一个完整的、开箱即用的大语言模型服务。排查查看项目文档或代码明确 AI 功能的具体实现方式是调用外部 API 还是内置算法。检查相关服务的配置和日志看是否有调用 AI 服务的记录或报错。如果是调用外部 API确保服务器网络能够访问该 API 地址。5. 从“能用”到“好用”的进阶考量当你成功部署并验证基础功能后如果计划用于正式环境还需要考虑以下几点。5.1 数据持久化与备份策略默认的docker-compose.yml通常已经通过卷映射volumes将数据挂载到了宿主机的./data目录这保证了容器删除后数据不丢失。但你还需要定期备份编写脚本定期将./data/mysql目录打包备份到其他存储如对象存储、另一台服务器。考虑数据库分离对于正式环境强烈建议将 MySQL、Redis 等有状态服务部署到更专业、高可用的云服务或自建集群中而不是放在应用容器里。这样可以获得更好的性能、可靠性和备份恢复能力。5.2 性能调优与监控JVM 参数CRM 的 Java 服务可能需要调整 JVM 堆内存参数。你可以在docker-compose.yml中wkcrm服务的environment部分或启动脚本里设置JAVA_OPTS例如-Xms2g -Xmx4g。Elasticsearch 调优ES 对内存和磁盘 I/O 敏感。如果数据量大需要专门为 ES 容器分配更多内存并考虑使用 SSD 磁盘。接入监控使用cAdvisorPrometheusGrafana监控 Docker 容器和宿主机的资源使用情况CPU、内存、网络、磁盘设置告警。5.3 安全加固修改默认密码docker-compose.yml和conf/下的配置文件中MySQL、Redis 等组件都有默认密码。在公网部署前必须修改成强密码。限制访问通过服务器防火墙如firewalld、iptables或云安全组只开放必要的端口如 80/443。不要将 MySQL 的 3306、Redis 的 6379 等管理端口暴露到公网。Nginx 配置 HTTPS在conf/nginx/conf.d/wkcrm.conf中配置 SSL 证书启用 HTTPS保护数据传输安全。定期更新镜像关注基础镜像如 MySQL、Redis的安全更新定期重建和部署容器。5.4 自定义开发与扩展如果你需要二次开发你的代码应该放在workspace目录对应的源码位置。修改代码后需要重新打包 Java 应用通常使用项目内的 Maven 或 Gradle 脚本然后重启wkcrm服务docker-compose restart wkcrm。更规范的做法是将你的代码构建成新的 Docker 镜像然后修改docker-compose.yml中wkcrm服务的image标签指向你的新镜像。最后记住 Docker 部署的最大价值是环境标准化和快速交付。对于悟空 AICRM 这类复杂系统它帮你跳过了最繁琐的环境搭建环节。但真正要让它稳定、可靠地运行后续的监控、备份、安全、性能优化才是更考验运维功底的地方。建议先从默认配置跑起来理解整个架构和数据流再根据实际需求和资源情况一步步进行优化和加固。
