【实战教程】新手入门｜部署XX一网统管开源版本（全方案全步骤指南）

本文为"实战教程"系列，面向零基础开发者与开发团队，提供最小化、可复现的一键部署指南，同时补充开发规范、项目结构等核心内容，让你在30分钟内完成本地部署，并快速上手项目开发。本文内容严格对照项目官方文档，结合实际报错信息优化排查方案，规避链接失效、信息偏差等问题。

一、开头

做智慧城市项目，还在为技术选型踩坑、架构从零搭建、多领域适配棘手而头疼？这里有一款开源免费、开箱即用的智慧城市一网统管AI平台，集成诺依框架、芋道源码、ThingsBoard物联网平台、Flowable流程引擎及AI大模型，下载代码即可免费搭建城市治理数字中枢，让开发效率直接翻倍！

该平台覆盖城管住建、水利水务、生态环保等17大政府治理全领域核心应用场景，以及电子商城、CRM、ERP等企业应用系统，提供完整部署脚本、开发规范与二次开发手册，Apache License 2.0授权允许商业使用。借助XX科技开源的部署脚本，你只需要简单操作就能在本地跑起全套微服务，包括前端大屏、后端API、数据库、消息队列等20+个组件，无论你是学生、开发者还是项目调研者，都能轻松上手。

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

在开始部署前，请确保你的本地或服务器环境满足以下要求，避免部署过程中踩坑（所有要求均结合官方规范与实际部署经验）。

1. 硬件与软件基础

操作系统：推荐 openEuler 24.03 LTS SP1 x86_64，兼容 CentOS 7+/Ubuntu 20.04+（Windows系统建议使用WSL2）。
内存：≥ 8GB（若启用AI模块，建议16GB以上；生产环境Worker节点建议32GB内存；4GB内存会直接卡死，无法正常运行）。
磁盘空间：≥ 50GB，用于存放Docker镜像、数据与日志；生产环境存储节点建议3TB数据盘（Ceph分布式存储）。
网络：可访问互联网以下载Docker镜像，关键端口（80、8848、3306、6379、8080-9000系列）未被占用。

2. 核心依赖与版本建议

平台运行依赖以下中间件与运行环境，建议使用指定版本，避免版本兼容问题：

JDK：17 或 21（LTS版本，推荐17，适配多数生产环境）
Nacos：2.4.x（推荐2.4.2，与平台脚本完美适配）
MySQL：8.0（稳定版，避免使用5.7及以下版本，防止表结构兼容问题）
Redis：6/7（推荐7，性能更优，支持更多新特性）

3. 部署目标与快速检查

部署目标

本地或服务器一键准备好中间件与 Java 运行环境，JAR包按依赖顺序启动：yudao-gateway → yudao-module-system-server → yudao-module-bpm-server → gc-module-datacenter-server → gc-module-industry-server

快速检查

端口占用排查：重点检查 8848（Nacos）、3306（MySQL）、6379（Redis）、8080-9000（各服务），避免端口冲突。
hosts配置建议：将本机或服务器的 hosts 配置指向中间件（如 127.0.0.1 nacos mysql redis），简化服务调用配置。

4. 核心依赖安装（两种方式可选）

方式1：Docker一键安装（适合快速测试，推荐新手）

Docker & Docker Compose：这是部署的基石，执行以下命令一键安装并启动（必做步骤），参考Docker官方安装脚本规范：

复制代码

# 下载Docker安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
# 执行安装（需root或sudo权限）
sudo sh get-docker.sh
# 安装Docker Compose（原链接报错"link dead"，替换为稳定安装方式）
sudo curl -L "https://get.daocloud.io/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
# 安装后启动Docker，并设置开机自启（避免重启后无法使用）
sudo systemctl start docker
sudo systemctl enable docker

补充说明：若Docker安装脚本执行失败，可添加镜像参数重试：sudo sh get\-docker\.sh \-\-mirror Aliyun，支持Aliyun、AzureChinaCloud两个镜像源（参考Docker官方脚本规范）。

方式2：手动安装中间件（适合开发环境，可精准配置）

创建启动脚本（save as start-middlewares.sh，按需修改密码），执行脚本即可完成中间件安装与初始化：

复制代码

#!/usr/bin/env bash
set -eux

# 变量（按需修改密码）
MYSQL_ROOT_PW="Root@123456"
REDIS_PW="YourRedisPass"
DB_NAME="nacos"
NACOS_DIR="/opt/nacos"
REDIS_CONF="/etc/redis.conf"

# 关闭防火墙与 SELinux（快速启动场景，生产环境需谨慎）
systemctl stop firewalld && systemctl disable firewalld
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

# 关闭交换分区，提升性能
swapoff -a
sed -i '/\sswap\s/s/^/#/' /etc/fstab

# 安装基础工具
dnf update -y
dnf install -y wget unzip vim net-tools lsof

# 安装JDK 17
dnf install -y java-17-openjdk-devel
java -version

# 安装MySQL 8.0
dnf install -y @mysql:8.0
systemctl enable --now mysqld
# 查看MySQL临时密码（首次登录需使用）
grep 'temporary password' /var/log/mysqld.log
# 初始化MySQL，创建数据库并修改密码
mysql -uroot -p -e "
  CREATE DATABASE IF NOT EXISTS ${DB_NAME} CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '${MYSQL_ROOT_PW}';
  FLUSH PRIVILEGES;
"
echo "[mysql] OK"

# 安装Redis 7
dnf install -y redis
# 备份Redis配置文件
cp ${REDIS_CONF} ${REDIS_CONF}.bak
# 配置Redis（允许远程访问、设置密码）
cat > ${REDIS_CONF} <<EOF
bind 0.0.0.0
port 6379
appendonly yes
requirepass ${REDIS_PW}
daemonize no
pidfile /var/run/redis_6379.pid
EOF
systemctl enable --now redis
# 验证Redis启动成功
redis-cli -a ${REDIS_PW} ping && echo "Redis OK" || echo "Redis FAIL"

# 安装Nacos 2.4.2（避免版本兼容问题）
curl -O https://github.com/alibaba/nacos/releases/download/2.4.2/nacos-server-2.4.2.tar.gz
tar -xzf nacos-server-2.4.2.tar.gz -C /opt && ln -s /opt/nacos-server-2.4.2 /opt/nacos
mkdir -p /opt/nacos/logs

# 导入 Nacos 库（MySQL 已内置 schema，此处仅示例，按需执行）
# mysql -uroot -p${MYSQL_ROOT_PW} ${DB_NAME} < /opt/nacos/conf/mysql-schema.sql

# 配置 Nacos 外置库（按需配置，默认使用内置 Derby 数据库）
# sed -i "/^db.url.0=/c\db.url.0=jdbc:mysql://127.0.0.1:3306/${DB_NAME}?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai" /opt/nacos/conf/application.properties
# sed -i "/^db.user.0=/c\db.user.0=root" /opt/nacos/conf/application.properties
# sed -i "/^db.password.0=/c\db.password.0=${MYSQL_ROOT_PW}" /opt/nacos/conf/application.properties

# 启动 Nacos（单机模式）
/opt/nacos/bin/startup.sh -m standalone
tail -f /opt/nacos/logs/start.out

echo "All done. Access Nacos: http://127.0.0.1:8848/nacos (nacos/nacos)"

脚本执行说明：赋予脚本执行权限 chmod \+x start\-middlewares\.sh，执行 \./start\-middlewares\.sh，全程自动完成中间件安装与启动，无需手动干预。

5. 代码仓库获取（解决"link dead"报错）

XX一网统管平台采用前后端分离架构，需获取前后端代码，由于部分仓库链接报错"link dead"，提供两种获取方式：

方式1：Git克隆（网络正常时优先）

复制代码

# 先回到用户根目录（确保两个仓库平级）
cd ~

# 克隆后端核心服务（Java + SpringCloud Alibaba）
git clone https://gitee.com/genchuan/genchuan-smart-city.git

# 克隆前端大屏界面（Vue 3 + Element Plus）
git clone https://gitee.com/genchuan/genchuan-smart-city-ui.git

复制代码

方式2：手动下载（克隆报错时使用）

若克隆失败提示"link dead"，请直接访问Gitee仓库手动下载代码压缩包，解压后按平级目录存放：

后端仓库：https://gitee.com/genchuan/genchuan-smart-city（点击"下载ZIP"）
前端仓库：https://gitee.com/genchuan/genchuan-smart-city-ui（点击"下载ZIP"）

三、部署实战（两种部署方式，按需选择）

方式1：Docker一键部署（适合新手，快速启动）

步骤1：部署后端微服务（约10分钟）

进入后端目录，执行内置的部署脚本，脚本会自动完成所有中间件启动和服务部署：

复制代码

cd genchuan-smart-city
# 给部署脚本添加执行权限
chmod +x scripts/deploy.sh
# 一键启动后端（单机模式，适合本地测试）
./scripts/deploy.sh --mode standalone

脚本自动完成的工作：

拉取 Nacos 2.4.x（注册中心）、MySQL 8.0（数据库）、Redis 6/7（缓存）、RocketMQ（消息队列）等中间件的Docker镜像。
初始化数据库表结构，严格遵循官方"六层结构"设计，包括 sys_（基础信息层）、biz_（业务数据层）、rel_（关联关系层）、stat_（分析统计层）、gen_（行业应用层）、view_（大屏总览层）等200+张表。
按依赖顺序启动 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，若提示"invalid link"（参考报错信息），请检查Nacos是否启动成功，可通过命令 docker ps \| grep nacos 查看容器状态；启动成功后，使用默认账号密码登录：nacos / nacos，登录后可看到所有微服务已注册。
补充：Nacos官方下载地址为 https://github.com/alibaba/nacos/releases/download/2.4.2/nacos-server-2.4.2.tar.gz，若脚本拉取失败，可手动下载解压至/opt/nacos目录，手动启动。

步骤2：部署前端大屏（约5分钟）

进入前端目录，使用预构建的Docker镜像快速启动，无需手动安装前端依赖：

复制代码

# 回到根目录，进入前端仓库
cd ~/genchuan-smart-city-ui
# 确认docker-compose配置文件存在（避免路径错误）
ls docker-compose.yml
# 一键启动前端（后台运行）
docker-compose up -d

复制代码

前端技术栈说明：

Vue 3 + Vite：极速构建，开发体验流畅。
Element Plus + TypeScript：企业级UI组件与类型安全。
Pinia：替代Vuex的轻量状态管理。
Vue Router：实现路由控制与权限拦截。
补充：前端还集成ECharts/Leaflet用于大屏图表与GIS地图展示，适配指挥中心场景。

访问验证（确认前端启动成功）：

打开浏览器，输入 http://localhost:80，应看到平台登录界面。
若 80 端口被占用（提示"无法访问此网站"），修改前端 docker-compose.yml 中端口映射为 `81:80`，再重新执行 `docker-compose up -d`，访问 http://localhost:81。

方式2：手动部署（适合开发环境，便于调试）

步骤1：中间件启动（已通过脚本完成，跳过此步）

参考"二、准备工作 - 4. 核心依赖安装 - 方式2"，执行start-middlewares.sh脚本，完成JDK、MySQL、Redis、Nacos的安装与启动。

步骤2：平台服务启动

下载并解压平台代码包（参考"二、准备工作 - 5. 代码仓库获取"），进入后端代码目录。
按依赖顺序启动 JAR 包（需确保中间件已正常运行）：

启动网关（首要启动，所有服务依赖网关）

java -jar yudao-gateway.jar

启动系统服务

java -jar yudao-module-system-server.jar

启动流程引擎服务

java -jar yudao-module-bpm-server.jar

启动数据中枢服务

java -jar gc-module-datacenter-server.jar

启动行业应用服务

java -jar gc-module-industry-server.jar

提示：建议使用后台运行命令（如 nohup java \-jar yudao\-gateway\.jar &），避免终端关闭后服务停止。

步骤3：前端部署（手动启动）

进入前端代码目录，安装依赖并启动：

复制代码

cd ~/genchuan-smart-city-ui
# 安装前端依赖（需提前安装Node.js 16+）
npm install
# 启动前端开发环境
npm run dev

启动成功后，访问 http://localhost:3000，即可看到平台登录界面。

平台登录与功能验证（两种部署方式通用）

使用默认账号密码登录平台，快速熟悉核心功能：

登录信息（重点高亮，避免找不到）：

复制代码

访问地址：Docker部署访问 [http://localhost:80](http://localhost:80)（或81端口）；手动部署访问 [http://localhost:3000](http://localhost:3000)

默认账号：**admin**

默认密码：**admin123**

推荐体验路径（结合官方核心功能，快速熟悉平台能力）：

数据中枢（核心能力）：点击左侧菜单 "数据中枢" ，体验地理编码管理（支持2000国家大地坐标系/WGS84）、网格划分（省-市-县-街道-社区层级）、设备接入（基于ThingsBoard CE版）、预警告警（分域预警、派单处置）等16大核心功能模块。
业务领域（横向覆盖）：进入 "城管住建" 模块，查看市政设施监测、市容秩序监管、违建管理等细分场景；或进入"水利水务"模块，体验水资源监测、供水漏损监测等功能，了解平台"横向到边、纵向到底"的覆盖能力。
AI赋能：若部署时启用了GPU节点，可在 "人工智能" 模块尝试图像识别（摄像头违规检测）、异常检测（管网压力异常）等AI能力，体验预判准确率85%+的智能治理效果，平台支持接入豆包、通义千问等AI大模型。
大屏总览：查看城市全局总览、分域专属大屏（如城管住建大屏、水利水务大屏），体验"一屏观全城、一网管全域"的可视化效果。

四、常见问题排查（结合实际报错，新手必看）

问题现象	可能原因	解决方案
端口冲突（如80、8080被占）	本地已有服务占用相同端口	修改 docker-compose.yml 中端口映射（如前端81:80），或停止冲突服务（sudo systemctl stop 冲突服务名）；重点检查8848（Nacos）、3306（MySQL）、6379（Redis）端口
内存不足（容器频繁重启）	内存低于8GB，或同时运行其他占用内存的程序	关闭非必要容器/程序，或增加虚拟内存（Linux系统可通过swap命令配置）；启用AI模块需确保内存≥16GB
数据库连接失败	MySQL容器启动慢，或防火墙拦截网络，或数据库密码配置错误	等待2分钟后重试；关闭防火墙（sudo systemctl stop firewalld），或开放对应端口；检查脚本中MySQL密码配置是否正确
前端大屏无法加载、提示"接口异常"	后端API服务未完全就绪，或前后端网络不通，或前端接口地址配置错误	查看后端服务日志（docker-compose logs -f），确保所有微服务状态为"UP"；检查前端配置中的后端接口地址是否正确；确认Nacos中服务已正常注册
仓库克隆失败（link dead）	网络问题或链接失效	检查网络连接，或直接访问Gitee仓库手动下载代码压缩包，解压后按平级目录存放
Nacos访问提示invalid link	Nacos容器未启动或启动失败	通过命令 `docker ps \
Docker Compose安装报错"link dead"	原下载链接失效	使用替代链接：`sudo curl \-L \&\#34;https://get\.daocloud\.io/docker/compose/releases/download/v2\.24\.5/docker\-compose\-$$uname \-s$\-$$uname \-m$\&\#34; \-o /usr/local/bin/docker\-compose`

补充：常用操作命令（新手必备，结合官方运维规范）

复制代码

# 1. 停止后端服务（Docker部署）
cd ~/genchuan-smart-city
docker-compose down

# 2. 停止前端服务（Docker部署）
cd ~/genchuan-smart-city-ui
docker-compose down

# 3. 查看后端服务日志（排查报错）
cd ~/genchuan-smart-city
docker-compose logs -f

# 4. 重启后端服务（Docker部署）
cd ~/genchuan-smart-city
docker-compose restart

# 5. 重启前端服务（Docker部署）
cd ~/genchuan-smart-city-ui
docker-compose restart

# 6. 查看Nacos容器状态
docker ps | grep nacos

# 7. 手动启动Nacos（单机模式）
/opt/nacos/bin/startup.sh -m standalone

# 8. 停止手动部署的后端服务
ps -ef | grep java | grep -v grep | awk '{print $2}' | xargs kill -9

# 9. 查看端口占用情况（排查端口冲突）
lsof -i:8848  # 查看Nacos端口
lsof -i:3306  # 查看MySQL端口
lsof -i:6379  # 查看Redis端口

五、参考文档与后续操作

5.1 参考文档

《系统部署架构设计文档》：docs/deployment/系统部署架构-20251018.md
《ThingsBoard 配置指南》：docs/guide/ThingsBoard_CE配置手册.md
《芋道源码集成指南》：docs/guide/芋道源码二次开发手册.md

5.2 从测试到生产（补充官方生产部署规范）

本地测试通过后，若想将平台投入实际环境，参考官方生产部署指南，建议：

生产环境硬件配置（引自官方）：
- Control 节点：3 台，16 核 CPU+16GB 内存 + 500GB 数据盘；
- Worker 节点：3 台（通用）+3 台（GPU，AI 场景），8 核 CPU+32GB 内存 + 500GB 数据盘；
- 存储节点：4 台，4 核 CPU+16GB 内存 + 3TB 数据盘（Ceph分布式存储）。
生产部署方案：项目README中提供了 KubeKey + KubeSphere 的集群化部署方案，支持 3个Control节点高可用、GPU Worker节点弹性伸缩、OpenEBS+Ceph存储，兼顾稳定、安全与成本优化。
参与开源社区：在 Gitee Issue区提交遇到的问题或改进建议，遵循官方分支管理与提交规范（feat新增功能、fix修复问题、docs文档更新），与核心开发者协同优化。
二次开发定制：基于平台 Apache 2.0 协议，可自由修改代码，适配本地政务系统与业务场景；参考官方开发规范，遵循数据库六层结构、RESTful接口设计等要求。

六、开发指南

6.1 开发规范

导航菜单设计：扁平化三级结构，避免列表操作（增删改查）作为菜单，符合 "基础 - 常用 - 核心" 原则；
数据库表命名：严格遵循六层前缀，英文名称蛇形命名（如sys_user），长度≤30 字符；
接口设计：RESTful 风格，统一前缀/api/v1/，如/api/v1/data-center/asset/list；
前端开发：基于 Vue3+Element Plus，复用芋道组件，大屏使用 ECharts+GIS 组件。

6.2 团队分工

参考附件《开发团队分工指南》，核心分工如下：

数据中枢组：负责地理编码、网格管理、设备 / 资产管理模块开发；
行业应用组：按领域分工（如城管住建组、水利水务组），开发行业特化功能；
大屏开发组：负责全局 / 领域大屏的可视化设计与开发；
AI 集成组：负责大模型接入（豆包 / 通义千问）、AI 识别功能开发；
运维组：负责集群部署、监控告警、数据备份。

6.3 AI 大模型接入

支持接入多类 AI 模型，以 "豆包" 为例，接入步骤如下：

在sys_ai_model_registry表注册模型信息；
开发模型调用接口（src/ai/model/client/DoubaoClient.java）；
集成到 AI 监测识别模块（如违章停车图像识别）；
配置模型性能监控（sys_ai_model_mon表记录调用日志）。

七、项目目录结构

后端采用模块化的架构，按照功能拆分成多个 Maven Module，提升开发与研发的效率，带来更好的可维护性。一共有四类 Maven Module，具体说明如下：

Maven Module	作用
yudao-dependencies	Maven 依赖版本管理
yudao-framework	Java 框架拓展
gc-module-xxx	XXX 功能的 Module 模块
yudao-server	管理后台 + 用户 App 的服务端

1. yudao-dependencies

该模块是一个 Maven Bom，只有一个 pom.xml 文件，定义项目中所有 Maven 依赖的版本号，解决依赖冲突问题。

详细的解释，可见《微服务中使用 Maven BOM 来管理你的版本依赖》文章。

从定位上来说，它和 Spring Boot 的 spring-boot-starter-parent 和 Spring Cloud 的 spring-cloud-dependencies 是一致的。

虽然说，直接在根目录 pom.xml 管理依赖版本会更加方便，也符合绝大多数程序员的认知。但是要额外考虑一个场景，如果每个 yudao-module-xxx 模块都维护在一个独立的 Git 仓库，那么 yudao-dependencies 就可以在多个 yudao-module-xxx 模块下复用。

2. yudao-framework

该模块是 yudao-cloud 项目的框架封装，其下的每个 Maven Module 都是一个组件，分成两种类型：

① 技术组件：技术相关的组件封装，例如说 MyBatis、Redis 等等。

Maven Module	作用
yudao-common	定义基础 pojo 类、枚举、工具类等
yudao-spring-boot-starter-web	Web 封装，提供全局异常、访问日志等
yudao-spring-boot-starter-websocket	WebSocket 封装，提供 Token 认证、WebSocket 集群广播、Message 监听
yudao-spring-boot-starter-security	认证授权，基于 Spring Security 实现
yudao-spring-boot-starter-mybatis	数据库操作，基于 MyBatis Plus 实现
yudao-spring-boot-starter-redis	缓存操作，基于 Spring Data Redis + Redisson 实现
yudao-spring-boot-starter-mq	消息队列，基于 Redis 实现，支持集群消费和广播消费
yudao-spring-boot-starter-job	定时任务，基于 Quartz 实现，支持集群模式
yudao-spring-boot-starter-protection	服务保障，提供幂等、分布式锁、限流、熔断等功能
yudao-spring-boot-starter-excel	Excel 导入导出，基于 EasyExcel 实现
yudao-spring-boot-starter-monitor	服务监控，提供链路追踪、日志服务、指标收集等功能
yudao-spring-boot-starter-test	单元测试，基于 Junit + Mockito 实现
yudao-spring-boot-starter-file 【已合并】	文件客户端，支持将文件存储到 S3（MinIO、阿里云、腾讯云、七牛云）、本地、FTP、SFTP、数据库等
yudao-spring-boot-starter-captcha 【已合并】	验证码 Captcha，提供滑块验证码
yudao-spring-boot-starter-flowable 【已合并】	工作流，基于 Flowable 实现

友情提示：

yudao-spring-boot-starter-file 组件：自 2.0.1 版本，合并到 yudao-module-infra-server 模块的 framework/file 包下，一方面减少 starter 提升编译速度，一方面只有 infra 模块使用到。
yudao-spring-boot-starter-captcha 组件：自 2.0.1 版本，合并到 yudao-module-system-server 模块的 framework/captcha 包下，一方面减少 starter 提升编译速度，一方面只有 system 模块使用到。
yudao-spring-boot-starter-flowable 组件：自 2.0.1 版本，合并到 yudao-module-bpm-server 模块的 framework/flowable 包下，一方面减少 starter 提升编译速度，一方面只有 bpm 模块使用到。

② 业务组件：业务相关的组件封装，例如说数据字典、操作日志等等。如果是业务组件，名字会包含 biz 关键字。

Maven Module	作用
yudao-spring-boot-starter-biz-tenant	SaaS 多租户
yudao-spring-boot-starter-biz-data-permission	数据权限
yudao-spring-boot-starter-biz-operatelog 【已合并】	操作日志
yudao-spring-boot-starter-biz-pay 【已合并】	支付客户端，对接微信支付、支付宝等支付平台
yudao-spring-boot-starter-biz-ip	地区 & IP 库

友情提示：

yudao-spring-boot-starter-biz-operatelog 组件：自 2.1.0 版本，合并到 yudao-spring-boot-starter-security 组件的 operatelog 包下，主要减少 starter 提升编译速度。
yudao-spring-boot-starter-biz-pay 组件：自 2.5.1 版本，合并到 yudao-module-pay 模块的 framework/pay 包下，因为只有它会使用到，更加聚焦收敛。

每个组件，包含两部分：

core 包：组件的核心封装，拓展相关的功能。
config 包：组件的 Spring Boot 自动配置。

八、结尾引导

恭喜！你已成功在本地部署了XX一网统管开源平台，并初步了解了项目的开发规范、目录结构与团队分工。该平台以"横向到边、纵向到底、上下对应、内外衔接"为设计原则，构建"监测-预警-决策-指挥-监督-服务-评价"的全流程闭环，破解城市治理"部门孤岛、数据割裂、响应滞后"痛点。

如需进一步了解平台技术细节、开发规范或二次开发指南，请查看官网或直接访问 Gitee仓库阅读源码。下期教程将带你深入《案例纪实｜某县级市一网统管平台落地：3个月实现城市治理效率提升40%》，看看这套架构在真实项目中如何创造价值。

https://gitcode.com/genchuankeji/genchuan-smart-city

【实战教程】新手入门｜部署XX一网统管开源版本（全方案全步骤指南）

一、开头

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

1. 硬件与软件基础

2. 核心依赖与版本建议

3. 部署目标与快速检查

部署目标

快速检查

4. 核心依赖安装（两种方式可选）

方式1：Docker一键安装（适合快速测试，推荐新手）

方式2：手动安装中间件（适合开发环境，可精准配置）

5. 代码仓库获取（解决"link dead"报错）

方式1：Git克隆（网络正常时优先）

方式2：手动下载（克隆报错时使用）

三、部署实战（两种部署方式，按需选择）

方式1：Docker一键部署（适合新手，快速启动）

步骤1：部署后端微服务（约10分钟）

步骤2：部署前端大屏（约5分钟）

方式2：手动部署（适合开发环境，便于调试）

步骤1：中间件启动（已通过脚本完成，跳过此步）

步骤2：平台服务启动

启动网关（首要启动，所有服务依赖网关）

启动系统服务

启动流程引擎服务

启动数据中枢服务

启动行业应用服务

步骤3：前端部署（手动启动）

平台登录与功能验证（两种部署方式通用）

四、常见问题排查（结合实际报错，新手必看）

补充：常用操作命令（新手必备，结合官方运维规范）

五、参考文档与后续操作

5.1 参考文档

5.2 从测试到生产（补充官方生产部署规范）

六、开发指南

6.1 开发规范

6.2 团队分工

6.3 AI 大模型接入

七、项目目录结构

1. yudao-dependencies

2. yudao-framework

① 技术组件：技术相关的组件封装，例如说 MyBatis、Redis 等等。

② 业务组件：业务相关的组件封装，例如说数据字典、操作日志等等。如果是业务组件，名字会包含 biz 关键字。

八、结尾引导