【实战教程】新手入门｜3步部署亘川一网统管开源版本，快速搭建本地测试环境

本文为"实战教程"系列首篇，面向零基础开发者，提供最小化、可复现的一键部署指南，让你在30分钟内体验完整的智慧城市治理平台。

一、首先

想体验覆盖 17大业务领域 的智慧城市一网统管平台，却担心部署复杂、环境配置繁琐？其实，借助亘川科技开源的 Docker Compose 一键部署脚本 ，你只需要 3步操作 就能在本地跑起全套微服务，包括前端大屏、后端API、数据库、消息队列等 20+个组件。本文将以最简化的方式，手把手带你完成从零到一的部署全过程，无论你是学生、开发者还是项目调研者，都能轻松上手。

二、准备工作：环境与资源清单

在开始部署前，请确保你的本地或服务器环境满足以下要求：

1. 硬件与软件基础（引自项目README部署指南）

• 操作系统

  ：推荐 openEuler 24.03 LTS SP1 x86_64，兼容 CentOS 7+/Ubuntu 20.04+。

• 内存

  ：≥ 8GB（若启用AI模块，建议16GB以上）。

• 磁盘空间

  ：≥ 50GB，用于存放镜像、数据与日志。

• 网络

  ：可访问互联网以下载Docker镜像，关键端口（8080-9000系列）未被占用。

2. 核心依赖安装

• Docker & Docker Compose：这是部署的基石。执行以下命令一键安装：

  curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.shsudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

• Git：用于拉取最新代码。

  sudo yum install -y git  # CentOS/RHELsudo apt install -y git  # Ubuntu/Debian

3. 代码仓库克隆

亘川一网统管平台采用 前后端分离架构，需分别克隆两个仓库：

# 后端核心服务（Java + SpringCloud）git clone https://gitee.com/genchuan/genchuan-smart-city.gitcd genchuan-smart-city# 前端大屏界面（Vue 3 + Element Plus）git clone https://gitee.com/genchuan/genchuan-smart-city-ui.gitcd genchuan-smart-city-ui

三、三步部署实战

步骤一：一键启动后端微服务（约10分钟）

进入后端目录，执行内置的部署脚本：

cd genchuan-smart-citychmod +x scripts/deploy.sh./scripts/deploy.sh --mode standalone

脚本会自动完成以下工作（引自项目README）：

1. 拉取 Nacos（注册中心）、MySQL（数据库）、Redis（缓存）、RocketMQ（消息队列） 等中间件的Docker镜像。

2. 初始化数据库表结构，包括 sys_（系统层）、biz_（业务层）、gen_（行业层） 等 六层结构 的 200+张表。

3. 按依赖顺序启动 yudao-gateway（网关）、yudao-module-system-server（系统服务）、yudao-module-bpm-server（流程引擎）、gc-module-datacenter-server（数据中枢）、gc-module-industry-server（行业服务） 等 10+个微服务。

关键检查点：

• 所有服务日志中出现 "Started ... in ... seconds" 表示启动成功。

• 访问 **http://localhost:8848/nacos**（账号/密码：nacos/nacos）确认服务注册正常。

步骤二：快速构建前端大屏（约5分钟）

进入前端目录，使用预构建的Docker镜像快速启动：

cd genchuan-smart-city-uidocker-compose up -d

前端技术栈说明（引自项目README）：

• Vue 3 + Vite

  ：极速构建，开发体验流畅。

• Element Plus + TypeScript

  ：企业级UI组件与类型安全。

• Pinia

  ：替代Vuex的轻量状态管理。

• Vue Router

  ：实现路由控制与权限拦截。

访问验证：

• 打开浏览器，输入 http://localhost:80，应看到登录界面。

• 使用默认账号 admin/admin123 登录，即可进入 城市全局总览大屏。

步骤三：平台功能初体验（约15分钟）

登录后，建议按以下路径快速熟悉平台核心能力：

1. 数据中枢

   ：点击左侧菜单 "数据中枢" ，体验 地理编码管理、网格划分、设备接入（基于ThingsBoard）、预警告警 等 16大核心功能模块（引自解决方案PDF）。

2. 行业应用

   ：进入 "城管住建" 模块，查看 市政设施监测、市容秩序监管、环境卫生管理 等细分场景，了解平台如何实现 "横向到边、纵向到底" 的覆盖。

3. AI赋能

   ：若部署时启用了GPU节点，可在 "人工智能" 模块尝试 图像识别（摄像头违规检测）、异常检测（管网压力异常） 等AI能力，体验 预判准确率85%+ 的智能治理效果。

四、常见问题排查

问题现象	可能原因	解决方案
端口冲突（如8080被占）	本地已有服务占用相同端口	修改 docker-compose.yml 中端口映射，或停止冲突服务。
内存不足（容器频繁重启）	默认配置要求 ≥8GB	关闭非必要容器，或增加虚拟内存。
数据库连接失败	MySQL容器启动慢或网络隔离	等待2分钟后重试，检查防火墙规则。
前端大屏无法加载	后端API服务未完全就绪	查看后端服务日志，确保所有微服务状态为"UP"。

五、下一步：从测试到生产

本地测试通过后，若想将平台投入实际环境，建议：

1. 阅读生产部署指南

   ：项目README中提供了 KubeKey + KubeSphere 的集群化部署方案，支持 3个Control节点高可用 、GPU Worker节点弹性伸缩 、Ceph分布式存储（引自解决方案PDF）。

2. 参与开源社区

   ：在 Gitee Issue区 提交遇到的问题或改进建议，与核心开发者协同优化。

3. 二次开发定制

   ：基于平台 Apache 2.0 协议，可自由修改代码，适配本地政务系统与业务场景。

六、结尾

恭喜！你已成功在本地部署了 亘川一网统管开源平台 ，并初步体验了其 17大领域覆盖 、微服务架构 、AI赋能 的核心价值。如需进一步了解平台技术细节，请查看 【官网】http://genchuan.cn/ 或直接访问 Gitee仓库 阅读源码。下期教程将带你深入 《案例纪实｜某县级市一网统管平台落地：3个月实现城市治理效率提升40%》，看看这套架构在真实项目中如何创造价值。

---

关注我们：获取更多实战教程与部署技巧。

加入社区：前往 Gitee 参与开源项目，共建智慧城市生态。