零基础也能部署：HUIZHI-ChargeOS-cloud Docker一键部署实战教程
【免费下载链接】HUIZHI-ChargeOS-cloud⚡️慧知开源充电平台全套源码⚡️;⚡️完整业务流程⚡️； ①SpringCloud、MySQL、Netty、uniapp、云快充协议1.5 云快充协议1.6、互联互通协议、多租户、分时计费。 ②小程序、管理后台、多商户、模拟桩。 ③充电平台技术解决方案。项目地址: https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud
想快速拥有一套属于自己的充电桩运营平台吗？慧知开源充电平台（HUIZHI-ChargeOS-cloud）基于 SpringCloud 微服务架构，内置云快充协议1.5/1.6、互联互通协议、多租户、分时计费等完整业务流程，而借助项目自带的 Docker 部署方案，即使零基础也能轻松跑起来。本文就带你走一遍 HUIZHI-ChargeOS-cloud 的 Docker 一键部署全过程，从环境准备、脚本打包到服务验证，一步不落。
HUIZHI-ChargeOS-cloud 是什么？
这是一套全开源的充电平台技术解决方案，包含运营管理后台、微信小程序、多商户、模拟充电桩等模块，前后端分离、二次开发友好。平台层覆盖充电站/桩管理、分时费率、订单充值、告警管理等业务，底层则支持直流桩、交流桩等多种设备接入。
项目仓库自带完整的docker/部署目录，里面已经准备好了编排文件、基础镜像配置和启动脚本，你不需要手工搭建 Nacos、MySQL、Redis 等基础环境，一条命令即可拉起全部服务。🚀
Docker部署前的环境准备
在动手之前，先确认你的服务器满足以下条件：
| 项目 | 要求 |
|---|---|
| 操作系统 | CentOS / Ubuntu 等主流 Linux |
| Docker | 已安装 Docker 及 docker-compose |
| JDK / Maven | 如需本地打包源码需 JDK 1.8+、Maven 3.6+ |
| Node.js | 如需本地编译前端需 Node 14+ |
| 磁盘空间 | 建议预留 20GB 以上 |
| 内存 | 建议 8GB 以上（微服务较多） |
如果服务器上没有 Docker，可先执行
curl -fsSL https://get.docker.com | sh安装，并确认docker-compose version能正常输出版本号。
第一步：获取充电平台源码
部署前先把源码克隆到服务器本地：
git clone https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud进入项目目录后，你会看到docker/文件夹，后续所有部署操作都围绕它进行。
第二步：一键打包并复制资源
如果你拿到了源码想自己构建镜像，可以运行项目自带的打包脚本。Linux 下执行 docker/copy.sh，Windows 下执行copy.bat，脚本会自动完成以下动作：
- 编译后端各微服务模块，生成 jar 包并复制到对应的
docker/hcp/*/jar/目录； - 编译前端管理后台，把
dist产物复制到docker/nginx/html/dist/； - 把
sql/hcp_cloud.sql、sql/hcp_config.sql数据库脚本复制到docker/mysql/db/，实现首次启动自动建库初始化。
cd docker sh copy.sh脚本执行完毕后，所有镜像构建所需的素材就已就位。当然，如果你只想快速体验，也可以直接基于现有的 dockerfile 与编排文件构建运行。
第三步：认识 Docker Compose 服务编排
打开 docker/docker-compose.yml，可以看到整个充电平台被拆分成了十几个服务，它们共用cloud-net网络，通过固定 IP 相互通信：
| 服务 | 容器名 | 对外端口 | 作用 |
|---|---|---|---|
| hcp-mysql | hcp-mysql | 3306 | 关系数据库，自动执行初始化 SQL |
| hcp-redis | hcp-redis | 6379 | 缓存与分布式锁 |
| hcp-nacos | hcp-nacos | 8848/9848 | 注册中心与配置中心 |
| hcp-nginx | hcp-nginx | 8001 | 前端静态资源与反向代理 |
| hcp-gateway | hcp-gateway | 38080 | 网关统一入口 |
| hcp-auth | hcp-auth | 39200 | 认证服务 |
| hcp-system | hcp-system | 39201 | 系统管理服务 |
| hcp-gen / hcp-file / hcp-job 等 | - | 39202/39300/39204 | 代码生成、文件、定时任务等模块 |
各微服务的 Dockerfile 均以openjdk:8-jre为基础镜像，将 jar 包复制进容器后通过java -jar启动，逻辑清晰、易于二次定制。
第四步：开始 Docker 一键部署
部署脚本 docker/deploy.sh 提供了五个常用命令，分别是port、base、modules、stop、rm，使用方式非常简单：
1. 开启防火墙端口
如果服务器开启了防火墙，先放行相关端口（网关 38080、前端 8001、Nacos 8848、MySQL 3306、Redis 6379 等）：
sh deploy.sh port2. 启动基础环境
先拉起 MySQL、Redis、Nacos 三个基础服务，等待它们初始化完成（首次启动 MySQL 会自动导入数据库脚本，需要一些时间）：
sh deploy.sh base可通过docker ps观察容器状态，确保三个基础容器均为Up状态再继续下一步。
3. 一键启动全部业务模块
接着一条命令拉起网关、认证、系统、文件、任务等全部微服务以及前端 Nginx：
sh deploy.sh modules等待 1~2 分钟让各服务完成注册后，打开浏览器访问：
- 管理后台：
http://服务器IP:8001 - 网关入口：
http://服务器IP:38080
看到下面这个熟悉的登录界面，就说明部署成功了！🎉
第五步：验证部署结果
登录管理后台后，可以从几个方面确认系统运行正常：
- 运营管理：查看总收益、订单总数、充电次数、设备总数等实时经营数据；
- 充电桩管理：在设备列表中查看各充电桩的编号、运行状态、电流电压功率；
- 模拟充电桩：平台内置模拟桩模块，无需真实硬件即可体验实时监控与充电流程。
常用运维命令速查
日常维护中这几个命令最常用：
# 查看所有容器运行状态 docker ps # 查看某个服务日志 docker logs -f hcp-gateway # 停止所有服务 sh deploy.sh stop # 清理所有容器 sh deploy.sh rm # 重新构建镜像后启动 docker-compose up -d --build常见问题与排障技巧
1. 前端页面能打开，但接口报错？检查 Nginx 配置中的代理地址是否正确，前端请求会经/prod-api/转发到hcp-gateway:38080，见 docker/nginx/conf/nginx.conf。
2. Nacos 启动失败？确认 MySQL 已先启动完成，Nacos 依赖数据库存储配置，且docker/nacos/conf/application.properties中的数据库连接信息与编排文件一致。
3. 数据没有初始化？检查docker/mysql/db/下是否有hcp_cloud.sql和hcp_config.sql，MySQL 容器只在数据目录为空时执行docker-entrypoint-initdb.d下的初始化脚本。
4. 微服务注册不上？各服务通过环境变量NACOS_HOST、NACOS_PORT定位注册中心，确认这些变量指向172.18.0.6:8848对应的 Nacos 容器即可。
结语
到这里，一套完整的慧知充电平台就已经通过 Docker 一键部署成功运行了。从拉取源码、执行打包脚本，到base+modules两条命令拉起全部服务，整个过程完全不需要手工配置复杂环境，对新手非常友好。接下来你就可以在管理后台里体验多租户、分时计费、云快充协议、模拟充电桩等丰富功能，也可以基于微服务架构开始自己的二次开发之旅。快去试试吧！⚡️
【免费下载链接】HUIZHI-ChargeOS-cloud⚡️慧知开源充电平台全套源码⚡️;⚡️完整业务流程⚡️； ①SpringCloud、MySQL、Netty、uniapp、云快充协议1.5 云快充协议1.6、互联互通协议、多租户、分时计费。 ②小程序、管理后台、多商户、模拟桩。 ③充电平台技术解决方案。项目地址: https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
