From c85550ffde115c6db481760b0da818762df37fa0 Mon Sep 17 00:00:00 2001
From: tangweijie <877588133@qq.com>
Date: Thu, 26 Mar 2026 18:42:53 +0800
Subject: [PATCH] docs: add integrated deployment planb doc and docx
---
.../08_Integrated_Deployment_Design_PlanB.md | 653 ++++++++++++++++++
...grated_Deployment_Design_PlanB_含图表.docx | Bin 0 -> 409761 bytes
2 files changed, 653 insertions(+)
create mode 100644 docs/design/03_Technical_Design/08_Integrated_Deployment_Design_PlanB.md
create mode 100644 output/08_Integrated_Deployment_Design_PlanB_含图表.docx
diff --git a/docs/design/03_Technical_Design/08_Integrated_Deployment_Design_PlanB.md b/docs/design/03_Technical_Design/08_Integrated_Deployment_Design_PlanB.md
new file mode 100644
index 0000000..45f2cd3
--- /dev/null
+++ b/docs/design/03_Technical_Design/08_Integrated_Deployment_Design_PlanB.md
@@ -0,0 +1,653 @@
+---
+doc_id: TC-08-INTEGRATED-DEPLOYMENT
+doc_role: supplemental_document
+authority: secondary
+scope: 方案二整体部署
+source_of_truth: false
+last_reviewed: 2026-03-26
+retrieval_priority: P1
+---
+
+# 福建水务营收系统整体部署方案说明书
+
+## 文档信息
+| 项目信息 | 详情 |
+|---------|------|
+| **项目名称** | 福建水务营收系统 |
+| **文档类型** | 技术专题说明 |
+| **方案定位** | 已采纳 PostgreSQL 16 方案二作为数据库部署方案后的整体部署方案 |
+| **文档版本** | v1.0 |
+| **编写日期** | 2026-03-26 |
+| **文档状态** | ✅ 正式建议稿 |
+
+## 目录
+
+1. 编制目的
+2. 方案前提
+3. 整体部署原则
+4. 软件拓扑图
+5. 主机部署图
+6. 数据库访问链路图
+7. 备份恢复链路图
+8. 网络拓扑图
+9. 主机角色与部署内容
+10. 资源配置建议
+11. 资源审批汇总表
+12. 基础软件与版本清单
+13. 部署方式说明
+14. 网络需求
+15. 网络开通清单
+16. 访问控制与端口建议
+17. 实施步骤
+18. 验收标准
+19. 部署结论
+
+## 编制目的
+
+本文档用于在已采纳 PostgreSQL 16 方案二作为数据库部署方案的前提下，形成覆盖前端、后端、中间件、静态存储及数据库的一体化整体部署方案，作为甲方进行主机、网络、存储与基础软件资源审批的依据。
+
+## 方案前提
+
+本方案以以下前提为基础：
+
+1. 数据库部署方案已采纳 `docs/design/03_Technical_Design/07_PostgreSQL16_DR_Resource_Application.md` 中的方案二，即“同城双可用区主备容灾方案”。
+2. 前端继续采用 `Nginx + Vue3` 的静态部署模式。
+3. 对外访问经甲方或第三方管理的公网入口进行薄转发，不纳入本方案主机资源范围。
+4. 内网 `Nginx` 单独部署，负责将开放 API 端点负载到两台业务应用节点。
+5. 两台业务应用节点内均部署 `Spring Boot Gateway`，作为微服务集群统一接入入口，并同时承载业务服务。
+6. 中间件集中部署在 1 台主机上。
+7. 数据库控制组件与中间件部署在同一台主机上。
+8. `MinIO` 作为静态存储与对象存储统一入口，与中间件同机部署。
+9. 一期口径下，原“数据与中间件节点”和“文件存储节点”合并为 1 台综合节点。
+10. 银行文件交换采用独立 `SFTP/FTP` 文件交换服务器，作为银行送盘、回盘、对账文件交换专用前置机。
+11. 当前已知可用于本方案的业务与基础设施主机资源如下：
+ - 内网 Nginx 入口节点：8 核 CPU / 16 GB 内存 / 300 GB 存储，共 1 台
+ - 业务应用节点（主）：32 核 CPU / 64 GB 内存 / 300 GB 存储，共 2 台
+ - 数据、中间件与文件存储综合节点：16 核 CPU / 32 GB 内存 / 2300 GB 存储，共 1 台
+ - 银行文件交换服务器：2 核 CPU / 8 GB 内存 / 200 GB 存储，共 1 台
+ - 另行配置 PostgreSQL 主库与热备库各 1 台
+
+## 整体部署原则
+
+整体部署遵循以下原则：
+
+1. 前后端逻辑分层部署，避免数据库节点与业务节点混部。
+2. 中间件集中部署，降低主机数量和运维复杂度。
+3. 数据库主备分离部署，避免与中间件、应用节点混部。
+4. 数据库控制组件集中部署，通过统一代理地址屏蔽主备切换细节。
+5. 网络按公网接入区、内网接入区、应用区、中间件与文件存储区、银行文件交换区、数据区分层隔离。
+6. 在现有主机数量约束下，优先复用现有业务应用节点、内网入口节点及综合节点资源。
+
+## 软件拓扑图
+
+**图 4-1 访问与应用软件拓扑图**
+
+```mermaid
+flowchart LR
+ classDef source fill:#ecfeff,stroke:#0891b2,stroke-width:1.2px,color:#083344;
+ classDef access fill:#fff7ed,stroke:#ea580c,stroke-width:1.4px,color:#7c2d12;
+ classDef app fill:#eff6ff,stroke:#2563eb,stroke-width:1.4px,color:#1e3a8a;
+
+ U1[PC 端用户]:::source
+ U2[移动端用户]:::source
+ U3[第三方系统]:::source
+ G1[公网入口薄转发]:::access
+ G2[内网 Nginx]:::access
+
+ subgraph APP1[业务应用节点 1]
+ direction TB
+ A1G[Spring Boot Gateway]:::app
+ A1B[业务服务]:::app
+ end
+
+ subgraph APP2[业务应用节点 2]
+ direction TB
+ A2G[Spring Boot Gateway]:::app
+ A2B[业务服务]:::app
+ end
+
+ U1 -->|内网访问| G2
+ U2 -->|HTTPS 443| G1
+ U3 -->|接口访问| G1
+ G1 -->|开放 API 转发| G2
+ G2 -->|负载到节点 1| A1G
+ G2 -->|负载到节点 2| A2G
+ A1G --> A1B
+ A2G --> A2B
+```
+
+图说明：
+
+1. PC 端用户通过内网直接访问内网 Nginx。
+2. 移动端用户和第三方系统先经公网入口薄转发，再由公网入口转发到内网 Nginx。
+3. 内网 Nginx 将开放 API 端点负载到两台业务应用节点。
+4. 两台业务应用节点内均部署 Spring Boot Gateway，作为微服务集群统一接入入口。
+5. 每台业务应用节点内的 Gateway 再向本节点业务服务转发请求。
+
+**图 4-2 综合服务软件拓扑图**
+
+```mermaid
+flowchart TB
+ classDef app fill:#eff6ff,stroke:#2563eb,stroke-width:1.4px,color:#1e3a8a;
+ classDef service fill:#f5f3ff,stroke:#7c3aed,stroke-width:1.4px,color:#4c1d95;
+
+ A1[业务应用节点 1
Gateway + Biz]:::app
+ A2[业务应用节点 2
Gateway + Biz]:::app
+
+ subgraph M[综合节点]
+ direction TB
+ M2[Redis / Nacos / MinIO]:::service
+ M3[HAProxy / PgBouncer / Patroni]:::service
+ end
+
+ A1 -->|缓存 配置 文件访问| M2
+ A2 -->|缓存 配置 文件访问| M2
+ A1 -->|数据库代理访问| M3
+ A2 -->|数据库代理访问| M3
+```
+
+图说明：
+
+1. 综合节点承接缓存、配置、对象存储及数据库控制组件。
+2. 两台业务应用节点统一访问综合节点，不直接连接数据库。
+
+**图 4-3 数据与备份软件拓扑图**
+
+```mermaid
+flowchart LR
+ classDef service fill:#f5f3ff,stroke:#7c3aed,stroke-width:1.4px,color:#4c1d95;
+ classDef data fill:#ecfdf5,stroke:#059669,stroke-width:1.4px,color:#064e3b;
+ classDef backup fill:#fffbeb,stroke:#d97706,stroke-width:1.4px,color:#78350f;
+ classDef bank fill:#fef2f2,stroke:#dc2626,stroke-width:1.4px,color:#7f1d1d;
+
+ M2[MinIO / 附件文件]:::service
+ M3[HAProxy / PgBouncer / Patroni]:::service
+ F1[SFTP / FTP 文件交换服务器]:::bank
+ D1[(PostgreSQL 主库)]:::data
+ D2[(PostgreSQL 热备)]:::data
+ B1[备份归档存储]:::backup
+
+ M3 -->|数据库访问| D1
+ M3 -->|状态感知| D2
+ D1 -->|同步复制| D2
+ D1 -->|基础备份 WAL 归档| B1
+ D2 -->|备份副本| B1
+ M2 -->|对象存储归档| B1
+ F1 -->|银行文件归档| B1
+```
+
+图说明：
+
+1. 数据库控制组件经由主库提供数据库访问能力。
+2. 主库与热备之间通过同步复制保持一致性。
+3. 银行文件交换服务器承接送盘、回盘、对账文件交换能力。
+4. MinIO 与银行文件交换服务器分别将各自数据归档到备份归档存储。
+
+## 主机部署图
+
+**图 4-4 主机部署总览图**
+
+```mermaid
+flowchart LR
+ classDef gateway fill:#fff7ed,stroke:#ea580c,stroke-width:1.2px,color:#7c2d12;
+ classDef app fill:#eff6ff,stroke:#2563eb,stroke-width:1.2px,color:#1e3a8a;
+ classDef middle fill:#f5f3ff,stroke:#7c3aed,stroke-width:1.2px,color:#4c1d95;
+ classDef data fill:#ecfdf5,stroke:#059669,stroke-width:1.2px,color:#064e3b;
+
+ GW[内网 Nginx 入口节点]:::gateway
+ APP1[业务应用节点 1
内含 Gateway]:::app
+ APP2[业务应用节点 2
内含 Gateway]:::app
+ MID[综合节点]:::middle
+ FTP[SFTP / FTP 文件交换服务器]:::middle
+ DB1[(数据库主库服务器)]:::data
+ DB2[(数据库热备服务器)]:::data
+
+ GW --> APP1
+ GW --> APP2
+ APP1 --> MID
+ APP2 --> MID
+ APP1 --> FTP
+ APP2 --> FTP
+ MID --> DB1
+ MID --> DB2
+ DB1 --> DB2
+```
+
+图说明：
+
+1. 内网 Nginx 入口节点作为我方统一接入入口，承接 API 转发与内部负载均衡能力。
+2. 业务应用节点 1 和业务应用节点 2 组成应用主机集群，节点内同时部署 Spring Boot Gateway 与核心业务服务。
+3. 综合节点集中承载 Redis、Nacos、MinIO、HAProxy、PgBouncer、Patroni，并同时访问数据库主库与热备服务器。
+4. 独立的 SFTP/FTP 文件交换服务器承接银行送盘、回盘、对账文件交换，并由业务应用节点直接访问。
+5. 数据库主库服务器与数据库热备服务器独立部署，满足数据库高可用要求。
+
+主机部署细化说明：
+
+1. 内网 Nginx 入口节点部署 `Nginx`，负责开放 API 转发和内部负载均衡。
+2. 两台业务应用节点分别部署 `Spring Boot Gateway` 与业务服务实例。
+3. 综合节点部署 `Redis`、`Nacos`、`MinIO`、`HAProxy`、`PgBouncer`、`Patroni`，并负责访问数据库主库与热备服务器。
+4. SFTP/FTP 文件交换服务器部署银行文件交换服务及送盘、回盘、对账目录，由业务应用节点直接访问。
+5. 数据库主库服务器部署 PostgreSQL 主库实例，数据库热备服务器部署 PostgreSQL 热备实例。
+
+## 数据库访问链路图
+
+**图 4-5 数据库访问链路图**
+
+```mermaid
+flowchart LR
+ A1[业务应用节点 1]
+ A2[业务应用节点 2]
+ P[PgBouncer]
+ H[HAProxy]
+ M[(主库)]
+ S[(热备)]
+ T[Patroni]
+
+ A1 -->|统一代理地址| P
+ A2 -->|统一代理地址| P
+ P -->|连接池复用| H
+ H -->|写流量| M
+ H -.热备探测 / 状态访问.-> S
+ M -->|同步复制| S
+ T -.主备状态管理.-> H
+```
+
+图说明：
+
+1. 业务应用不直接连接数据库主机。
+2. PgBouncer 负责连接池。
+3. HAProxy 负责数据库入口代理。
+4. Patroni 负责主备状态管理与切换控制。
+5. 综合节点侧的数据库控制组件会同时访问主库和热备，用于探测、控制和切换。
+
+## 备份恢复链路图
+
+**图 4-6 备份恢复链路图**
+
+```mermaid
+flowchart LR
+ DB1[(PostgreSQL 主库)] --> BK[备份归档存储]
+ DB2[(PostgreSQL 热备)] --> BK
+ MID[综合节点 / MinIO] --> BK
+ BK --> REC[恢复与演练入口]
+```
+
+图说明：
+
+1. 主库和热备均向备份归档存储输出备份数据。
+2. 综合节点中的 MinIO 文件数据也纳入备份范围。
+3. 备份归档存储作为数据库恢复与文件恢复的统一入口。
+
+## 网络拓扑图
+
+**图 4-7 网络拓扑图**
+
+```mermaid
+flowchart TB
+ classDef user fill:#ecfeff,stroke:#0891b2,stroke-width:1.2px,color:#083344;
+ classDef access fill:#fff7ed,stroke:#ea580c,stroke-width:1.2px,color:#7c2d12;
+ classDef app fill:#eff6ff,stroke:#2563eb,stroke-width:1.2px,color:#1e3a8a;
+ classDef ext fill:#fef3c7,stroke:#d97706,stroke-width:1.2px,color:#78350f;
+ classDef middle fill:#f5f3ff,stroke:#7c3aed,stroke-width:1.2px,color:#4c1d95;
+ classDef data fill:#ecfdf5,stroke:#059669,stroke-width:1.2px,color:#064e3b;
+ classDef backup fill:#fdf2f8,stroke:#db2777,stroke-width:1.2px,color:#831843;
+
+ subgraph U[访问来源]
+ direction LR
+ PC[PC 端用户]
+ M[移动端用户]
+ T[第三方系统]
+ end
+
+ subgraph A[接入层]
+ direction TB
+ PGW[公网入口薄转发]
+ IGW[内网 Nginx]
+ end
+
+ subgraph B[应用层]
+ direction LR
+ APP1[业务应用节点 1
Spring Boot Gateway]
+ APP2[业务应用节点 2
Spring Boot Gateway]
+ end
+
+ subgraph E[外部交换区]
+ direction TB
+ FX[SFTP/FTP 文件交换服务器]
+ end
+
+ subgraph C[综合服务层]
+ direction TB
+ MID[综合节点]
+ end
+
+ subgraph D[数据层]
+ direction LR
+ DBM[(PostgreSQL 主库)]
+ DBS[(PostgreSQL 热备)]
+ end
+
+ subgraph BK[备份归档层]
+ direction TB
+ STORE[备份归档存储]
+ end
+
+ PC -->|内网访问| IGW
+ M -->|公网 HTTPS| PGW
+ T -->|公网 HTTPS/接口| PGW
+ PGW -->|转发| IGW
+
+ IGW -->|负载均衡| APP1
+ IGW -->|负载均衡| APP2
+
+ APP1 -->|文件交换| FX
+ APP2 -->|文件交换| FX
+
+ APP1 -->|业务访问| MID
+ APP2 -->|业务访问| MID
+
+ MID -->|数据库访问| DBM
+ MID -->|状态感知/只读访问| DBS
+ DBM -->|主备同步| DBS
+
+ DBM -->|备份/WAL 归档| STORE
+ DBS -->|备份副本| STORE
+ MID -->|文件归档| STORE
+
+ class PC,M,T user;
+ class PGW,IGW access;
+ class APP1,APP2 app;
+ class FX ext;
+ class MID middle;
+ class DBM,DBS data;
+ class STORE backup;
+```
+
+图说明：
+
+1. PC 端用户通过内网直接访问内网 Nginx，移动端用户和第三方系统通过公网入口薄转发，再转发至内网 Nginx。
+2. 内网 Nginx 统一负载到两台业务应用节点，两台节点内部均部署 Spring Boot Gateway。
+3. 业务应用节点一方面直接访问 SFTP/FTP 文件交换服务器，另一方面访问综合节点获取缓存、配置、文件和数据库代理能力。
+4. 综合节点访问 PostgreSQL 主库与热备，数据库主备及综合节点均接入备份归档存储。
+
+## 主机角色与部署内容
+
+| 层级 | 主机角色 | 数量 | 主要部署内容 | 说明 |
+|---|---|---:|---|---|
+| 接入层 | 内网 Nginx 入口节点 | 1 台 | Nginx、API 转发、内部负载均衡 | 作为我方统一内网接入入口，承接开放 API 转发 |
+| 应用层 | 业务应用节点（主） | 2 台 | Spring Boot Gateway、Spring Boot 业务服务 | 承载微服务集群接入与表务、抄表、收费、账务、发票、报表等核心应用服务 |
+| 综合支撑层 | 数据、中间件与文件存储综合节点 | 1 台 | Redis、Nacos、MinIO、HAProxy、PgBouncer、Patroni | 中间件、数据库控制与文件存储同机部署 |
+| 银行交换层 | SFTP/FTP 文件交换服务器 | 1 台 | SFTP/FTP 服务、送盘目录、回盘目录、对账目录、归档目录 | 作为银行文件交换专用前置机 |
+| 数据库层 | PostgreSQL 主库服务器 | 1 台 | PostgreSQL 16 Primary | 部署在可用区 A |
+| 数据库层 | PostgreSQL 热备服务器 | 1 台 | PostgreSQL 16 Standby | 部署在可用区 B |
+| 备份层 | 备份归档存储 | 1 套 | 基础备份、WAL 归档、恢复副本 | 独立备份空间 |
+
+## 资源配置建议
+
+| 主机角色 | 数量 | 建议配置 | 备注 |
+|---|---:|---|---|
+| 内网 Nginx 入口节点 | 1 台 | 8 核 CPU / 16 GB 内存 / 300 GB 存储 | 承载内网 Nginx、API 转发和内部负载均衡 |
+| 业务应用节点（主） | 2 台 | 32 核 CPU / 64 GB 内存 / 300 GB 存储 | 承载 Spring Boot Gateway 及表务、抄表、收费、账务、发票、报表等核心应用服务 |
+| 数据、中间件与文件存储综合节点 | 1 台 | 16 核 CPU / 32 GB 内存 / 2300 GB 存储 | 承载缓存、配置治理、数据库控制、图片、附件等非结构化数据 |
+| SFTP/FTP 文件交换服务器 | 1 台 | 2 核 CPU / 8 GB 内存 / 200 GB 存储 | 承载银行送盘、回盘、对账、归档文件交换，建议独立部署 |
+| PostgreSQL 主库服务器 | 1 台 | 24 核 CPU / 48 GB 内存 / 1 TB NVMe SSD | 生产写入节点，不计入上述已知 4 类业务主机 |
+| PostgreSQL 热备服务器 | 1 台 | 24 核 CPU / 48 GB 内存 / 1 TB NVMe SSD | 正式切换接管节点，不计入上述已知 4 类业务主机 |
+| 备份归档存储 | 1 套 | 可用空间 4 TB 至 6 TB | 存放全量备份与 WAL 归档 |
+
+### 银行文件交换服务器容量估算
+
+按 20 万用户、5 年保留期估算，银行文件交换服务器主要承载代扣、托收、对账等批次文件，不承载全量业务明细数据库。
+
+估算依据如下：
+
+1. 银行代扣、托收、对账文件以批次文件为主，不是每位用户每天形成独立文件。
+2. 按“仅覆盖银行代扣/托收用户，且按月批次送盘/回盘一次”的业务节奏估算，单个批次文件大小通常在 `10 MB ~ 40 MB` 量级。
+3. 按每月送盘、回盘、对账共 `3` 类核心文件估算，月文件量约为：
+ - `30 MB ~ 120 MB / 月`
+4. 按 1 年估算，原始批次文件总量约为：
+ - `0.36 GB ~ 1.44 GB / 年`
+5. 考虑归档副本、异常重传、中间文件和运行日志，按 `10 ~ 15` 倍放大后，5 年总量通常约为：
+ - `20 GB ~ 110 GB`
+
+因此，按最节约的一期规划，银行文件交换服务器可按 `2 核 CPU / 8 GB 内存 / 200 GB 存储` 配置满足送盘、回盘、对账文件交换与 5 年留存需要；如后续银行通道数量增加、并发文件交换增加或保留策略扩大，再扩容至 `4 核 / 8 GB / 500 GB` 即可。建议设置 `70%` 容量预警，并预留扩容机制。
+
+## 资源审批汇总表
+
+以下汇总表用于甲方进行主机、存储、网络及基础软件部署范围审批。
+
+| 序号 | 资源名称 | 数量 | 规格 | 部署内容 | 用途说明 | 建议口径 |
+|---|---:|---:|---|---|---|---|
+| 1 | 内网 Nginx 入口节点 | 1 台 | 8 核 CPU / 16 GB 内存 / 300 GB 存储 | Nginx、API 转发、内部负载均衡 | 我方统一内网接入入口 | 可利旧优先 |
+| 2 | 业务应用节点（主） | 2 台 | 32 核 CPU / 64 GB 内存 / 300 GB 存储 | Spring Boot Gateway、Spring Boot 核心业务服务 | 承载微服务接入与核心业务服务 | 现有资源纳入正式方案 |
+| 3 | 数据、中间件与文件存储综合节点 | 1 台 | 16 核 CPU / 32 GB 内存 / 2300 GB 存储 | Redis、Nacos、MinIO、HAProxy、PgBouncer、Patroni | 承载缓存、配置治理、数据库控制、图片、附件、导出文件等能力 | 现有资源纳入正式方案 |
+| 4 | SFTP/FTP 文件交换服务器 | 1 台 | 2 核 CPU / 8 GB 内存 / 200 GB 存储 | SFTP/FTP 服务、送盘/回盘/对账目录、归档目录 | 承载银行文件交换与目录隔离 | 按最节约一期规划建议新增或单独利旧 |
+| 5 | PostgreSQL 主库服务器 | 1 台 | 24 核 CPU / 48 GB 内存 / 1 TB NVMe SSD | PostgreSQL 16 Primary | 承载生产写入 | 建议单独配置 |
+| 6 | PostgreSQL 热备服务器 | 1 台 | 24 核 CPU / 48 GB 内存 / 1 TB NVMe SSD | PostgreSQL 16 Standby | 承载正式切换接管 | 建议单独配置 |
+| 7 | 备份归档存储 | 1 套 | 可用空间 4 TB 至 6 TB | 基础备份、WAL 归档、恢复副本 | 保障恢复与审计追溯 | 可利旧或新增存储空间 |
+
+### 审批建议
+
+1. 业务应用节点、综合节点、内网 Nginx 入口节点可优先按现有资源纳入实施范围。
+2. SFTP/FTP 文件交换服务器建议单独审批，以满足银行文件交换隔离和安全要求。
+3. PostgreSQL 主库与热备库建议作为单独审批项，避免与现有业务节点混部。
+4. 备份归档存储建议作为单独资源项审批，避免后期因备份空间不足影响正式上线。
+
+## 基础软件与版本清单
+
+| 类别 | 软件名称 | 建议版本 | 部署位置 | 说明 |
+|---|---|---|---|---|
+| 操作系统 | Linux 发行版 | openEuler 20.03+ / CentOS 7.9+ | 全部服务器 | 按甲方基础环境标准选定 |
+| 运行环境 | JDK | 17 | 业务应用节点 | Spring Boot 运行环境 |
+| 接入层 | Nginx | 1.20+ | 内网 Nginx 入口节点 | 内网 API 转发、内部负载均衡 |
+| 网关服务 | Spring Boot Gateway | 3.x | 业务应用节点 | 微服务集群统一接入 |
+| 业务服务 | Spring Boot | 3.x | 业务应用节点 | 核心业务服务框架 |
+| 银行文件交换 | SFTP/FTP 服务 | 稳定版 | SFTP/FTP 文件交换服务器 | 银行送盘、回盘、对账文件交换 |
+| 数据库 | PostgreSQL | 16 | 主库、热备库 | 主备数据库部署 |
+| 缓存 | Redis | 6.2+ | 综合节点 | 缓存、会话、轻量级消息能力 |
+| 配置中心 | Nacos | 2.x | 综合节点 | 配置治理与注册管理 |
+| 对象存储 | MinIO | RELEASE 稳定版 | 综合节点 | 图片、附件、导出文件存储 |
+| 数据库代理 | HAProxy | 2.x | 综合节点 | 数据库读写入口代理 |
+| 连接池 | PgBouncer | 1.2x+ | 综合节点 | 统一数据库连接池 |
+| 高可用控制 | Patroni | 稳定版 | 综合节点 | 主备状态管理与切换 |
+
+## 部署方式说明
+
+### 总体部署原则
+
+本方案的部署方式遵循以下原则：
+
+1. 入口代理类组件优先采用 `Docker` 部署，并可优先评估 `host` 网络模式。
+2. 业务应用优先采用 `Docker` 部署，但不建议使用 `host` 网络模式。
+3. 数据库主备优先采用物理机或虚拟机直接部署，不建议容器化承载 PostgreSQL 主备本体。
+4. 数据库控制组件如需容器化，应优先选择轻量代理组件容器化，高可用控制组件仍以直接部署为优先。
+
+### 组件部署方式建议
+
+| 组件 | 部署节点 | 建议部署方式 | 是否建议 `host` 模式 | 说明 |
+|---|---|---|---|---|
+| 内网 Nginx | 内网 Nginx 入口节点 | Docker 部署 | 是，优先建议 | 作为我方统一接入入口，便于端口管理与转发 |
+| Spring Boot Gateway | 业务应用节点（主） | Docker 部署 | 否 | 作为微服务统一接入入口，建议与业务服务同节点部署 |
+| Spring Boot 应用 | 业务应用节点（主） | Docker 部署 | 否 | 便于发布、回滚、扩容，保留容器网络隔离 |
+| SFTP/FTP 服务 | SFTP/FTP 文件交换服务器 | 物理机/虚拟机直接部署 | 否 | 作为银行文件交换专用服务，建议独立部署并做目录隔离 |
+| Redis | 综合节点 | Docker 部署 | 可选 | 可采用普通容器网络，必要时可评估 `host` |
+| Nacos | 综合节点 | Docker 部署 | 可选 | 默认容器网络即可，便于配置治理 |
+| HAProxy | 综合节点 | Docker 部署 | 是，优先建议 | 作为数据库代理入口，适合 `host` 模式 |
+| PgBouncer | 综合节点 | Docker 部署 | 是，优先建议 | 作为数据库连接池入口，适合 `host` 模式 |
+| Patroni | 综合节点 | 物理机/虚拟机直接部署 | 否 | 建议与系统服务集成，便于运维与切换控制 |
+| MinIO | 综合节点 | Docker 部署 | 否 | 更关注数据盘挂载与对象存储目录管理 |
+| PostgreSQL 主库 | 主库服务器 | 物理机/虚拟机直接部署 | 否 | 核心数据库本体不建议容器化 |
+| PostgreSQL 热备 | 热备服务器 | 物理机/虚拟机直接部署 | 否 | 高可用数据库本体不建议容器化 |
+
+### 优先采用 Docker 且可使用 `host` 模式的组件
+
+结合当前资源结构，建议优先采用 `Docker + host` 模式的组件如下：
+
+1. `内网 Nginx`
+2. `HAProxy`
+3. `PgBouncer`
+
+采用 `host` 模式的主要原因如下：
+
+1. 直接监听固定服务端口，减少端口映射复杂度。
+2. 更便于与主机防火墙、域名、VIP、健康检查配合。
+3. 对于入口类与代理类组件，运维体验更接近直接部署。
+
+### 不建议采用 `host` 模式的组件
+
+以下组件不建议采用 `Docker + host` 模式：
+
+1. `Spring Boot` 业务应用：应保留容器网络隔离，便于扩容和端口治理。
+2. `MinIO`：应以存储挂载与数据目录管理为重点，不依赖 `host` 模式。
+3. `PostgreSQL 主库 / 热备`：数据库本体优先直接部署，不建议容器化。
+4. `Patroni`：建议直接部署，便于与数据库高可用控制链路协同。
+
+## 网络需求
+
+### 1. 网络分区要求
+
+| 网络分区 | 部署对象 | 访问要求 |
+|---|---|---|
+| 公网接入区 | 公网入口薄转发 | 对外提供 HTTPS 访问，不纳入我方主机资源 |
+| 应用区 | 业务应用节点 | 仅允许内网接入区与运维区访问 |
+| 中间件与文件存储区 | Redis、Nacos、MinIO、数据库控制组件 | 仅允许业务应用节点与运维区访问 |
+| 银行文件交换区 | SFTP/FTP 文件交换服务器 | 仅允许业务应用节点、银行专线或授权外联链路访问 |
+| 数据区 | PostgreSQL 主库、热备库、备份存储 | 严格限制，仅允许中间件控制主机和运维区访问 |
+
+### 2. 带宽与时延要求
+
+| 网络链路 | 建议要求 | 说明 |
+|---|---|---|
+| 公网入口薄转发到内网 Nginx | 千兆网络 | 满足公网入口转发 |
+| 内网 Nginx 到业务应用 | 千兆网络 | 满足开放 API 转发与网关接入 |
+| 业务应用到综合节点 | 千兆网络 | 满足缓存、配置治理、文件访问与数据库代理访问 |
+| 业务应用到 SFTP/FTP 服务器 | 千兆网络 | 满足送盘、回盘、对账文件交换 |
+| 银行链路到 SFTP/FTP 服务器 | 千兆网络或专线 | 满足银行文件交换与目录投递 |
+| 综合节点到数据库 | 千兆网络以上 | 满足数据库代理与健康检查 |
+| 主备复制链路 | 不低于 10 Gbps | 支撑同步复制 |
+| 同城主备时延 | 建议低于 2 ms | 支撑稳定同步复制 |
+| 数据库到备份存储 | 千兆网络以上 | 满足基础备份与 WAL 归档传输 |
+| 综合节点到备份存储 | 千兆网络以上 | 满足文件数据备份与归档传输 |
+
+### 3. 网络开通要求
+
+| 类别 | 开通要求 | 说明 |
+|---|---|---|
+| 对外访问 | 开通 443 端口 | 提供统一 HTTPS 入口 |
+| 公网入口薄转发访问内网 Nginx | 开通公网入口到内网 Nginx 的转发端口 | 仅授权链路访问 |
+| 内网 Nginx 访问应用 | 开通内网 Nginx 到业务应用的 API / 网关端口 | 仅内网访问 |
+| 应用访问综合节点 | 开通 Redis、Nacos、MinIO、PgBouncer 相关端口 | 仅应用区访问 |
+| 业务应用访问 SFTP/FTP 服务器 | 开通 SFTP/FTP 相关端口 | 用于银行文件送盘、回盘、对账交换 |
+| 银行链路访问 SFTP/FTP 服务器 | 开通 FTP/SFTP 服务端口 | 仅银行授权链路访问 |
+| 综合节点访问数据库 | 开通 PostgreSQL 5432 及健康检查相关端口 | 仅综合节点访问 |
+| 运维访问 | 开通运维区到各层必要管理端口 | 用于巡检、发布、恢复、切换 |
+
+## 网络开通清单
+
+| 源区域/源主机 | 目标区域/目标主机 | 协议/端口 | 用途 | 开通要求 |
+|---|---|---|---|---|
+| 外部用户 | 公网入口薄转发 | HTTPS/443 | 页面访问、接口入口 | 对外开放 |
+| 公网入口薄转发 | 内网 Nginx 入口节点 | HTTP/HTTPS/转发端口 | 公网访问转入内网入口 | 授权链路放通 |
+| 内网 Nginx 入口节点 | 业务应用节点（主） | HTTP/HTTPS/网关端口 | 内网 API 转发与微服务接入 | 内网放通 |
+| 业务应用节点（主） | 综合节点 | TCP/6379 | Redis 访问 | 内网放通 |
+| 业务应用节点（主） | 综合节点 | TCP/8848 | Nacos 访问 | 内网放通 |
+| 业务应用节点（主） | 综合节点 | TCP/6432 | PgBouncer 访问 | 内网放通 |
+| 业务应用节点（主） | 综合节点 | TCP/9000,9001 | MinIO 文件访问 | 内网放通 |
+| 业务应用节点（主） | SFTP/FTP 文件交换服务器 | TCP/21 或 22 | 银行送盘、回盘、对账文件交换 | 内网放通 |
+| 银行专线或授权外联链路 | SFTP/FTP 文件交换服务器 | TCP/21 或 22 | 银行文件目录投递与回收 | 仅授权链路放通 |
+| 综合节点 | PostgreSQL 主库服务器 | TCP/5432 | 数据库代理与控制访问 | 内网放通 |
+| 综合节点 | PostgreSQL 热备服务器 | TCP/5432 | 数据库代理、状态探测与控制访问 | 内网放通 |
+| PostgreSQL 主库服务器 | PostgreSQL 热备服务器 | TCP/5432 | 主备同步复制 | 高带宽、低时延专用链路 |
+| PostgreSQL 主库/热备库 | 备份归档存储 | TCP/存储协议端口 | 基础备份与 WAL 归档 | 内网放通 |
+| 综合节点 | 备份归档存储 | TCP/存储协议端口 | 文件归档与备份 | 内网放通 |
+| 运维管理终端 | 各节点 | SSH/22 及必要管理端口 | 运维、巡检、发布、恢复 | 仅运维区放通 |
+
+## 访问控制与端口建议
+
+| 服务 | 典型端口 | 访问范围 |
+|---|---|---|
+| Nginx/HTTPS | 443 | 对外开放 |
+| Spring Boot Gateway / 业务应用端口 | 项目自定义端口 | 仅内网 Nginx 与内网调用 |
+| Redis | 6379 | 仅业务应用与运维可访问 |
+| Nacos | 8848 | 仅业务应用与运维可访问 |
+| MinIO | 9000/9001 | 仅业务应用与运维可访问 |
+| SFTP/FTP 服务 | 21 或 22 | 仅业务应用节点、运维和银行授权链路可访问 |
+| PgBouncer | 6432 | 仅业务应用可访问 |
+| HAProxy | 5000 或项目定义端口 | 仅 PgBouncer 与运维可访问 |
+| PostgreSQL | 5432 | 仅数据库控制主机与运维可访问 |
+
+## 实施步骤
+
+### 1. 基础资源准备
+
+1. 确认内网 Nginx 入口节点、业务应用节点、综合节点是否为利旧资源。
+2. 完成 SFTP/FTP 文件交换服务器、PostgreSQL 主库服务器、热备服务器及备份归档存储审批。
+3. 完成各网络分区、IP、域名、SSL 证书、路由及防火墙策略准备。
+
+### 2. 基础软件安装
+
+1. 安装操作系统并完成安全基线加固。
+2. 在业务应用节点安装 JDK、部署业务运行环境。
+3. 在内网 Nginx 入口节点安装 Nginx。
+4. 在综合节点安装 Redis、Nacos、HAProxy、PgBouncer、Patroni、MinIO。
+5. 在 SFTP/FTP 文件交换服务器安装 SFTP/FTP 服务并配置目录结构。
+6. 在数据库主备节点安装 PostgreSQL 16。
+
+### 3. 数据库主备部署
+
+1. 初始化 PostgreSQL 主库。
+2. 初始化 PostgreSQL 热备库并建立同步复制。
+3. 配置 Patroni、HAProxy、PgBouncer 联动。
+4. 配置基础备份与 WAL 归档。
+5. 配置业务应用节点到 SFTP/FTP 文件交换服务器的文件交换目录映射。
+
+### 4. 应用与存储部署
+
+1. 在业务应用节点部署 Spring Boot Gateway 和业务应用服务。
+2. 在内网 Nginx 入口节点配置 API 转发和内部负载均衡规则。
+3. 在综合节点初始化 MinIO 存储桶和访问策略。
+4. 在 SFTP/FTP 文件交换服务器配置送盘、回盘、对账、归档目录。
+5. 配置业务应用到 Redis、Nacos、PgBouncer、MinIO 的连接参数。
+
+### 5. 联调与演练
+
+1. 完成前后端联调。
+2. 完成中间件访问验证。
+3. 完成数据库主备同步验证。
+4. 完成文件上传、下载、归档验证。
+5. 完成主备切换演练与回切演练。
+
+### 6. 上线准备与正式投产
+
+1. 完成上线前巡检与问题清零。
+2. 确认监控、日志、备份、告警正常。
+3. 完成上线窗口审批。
+4. 按上线顺序切换生产流量。
+
+## 验收标准
+
+| 验收项 | 验收标准 | 说明 |
+|---|---|---|
+| 对外访问 | 用户可通过统一域名正常访问系统 | 公网入口薄转发与内网 Nginx 链路正常 |
+| 业务应用可用性 | 表务、抄表、收费、账务、发票、报表等核心服务正常 | 业务主流程可执行 |
+| Redis 可用性 | 缓存读写正常 | 中间件能力正常 |
+| Nacos 可用性 | 配置下发正常 | 配置治理能力正常 |
+| MinIO 可用性 | 图片、附件上传下载正常 | 文件存储能力正常 |
+| SFTP/FTP 文件交换 | 送盘、回盘、对账目录读写正常 | 银行文件交换能力正常 |
+| 数据库连接能力 | 业务应用可通过 PgBouncer 正常连接数据库 | 代理接入正常 |
+| PostgreSQL 主备同步 | 主备复制正常，无严重延迟 | 高可用基础正常 |
+| 数据库切换演练 | 主备切换成功，业务恢复正常 | 高可用能力可验证 |
+| 备份归档 | 基础备份与 WAL 归档正常 | 恢复能力可验证 |
+| 运维监控 | 关键节点监控、日志、告警正常 | 运维可观测性正常 |
+
+## 部署结论
+
+在已采纳 PostgreSQL 16 方案二作为数据库部署方案的前提下，建议福建水务营收系统采用“前后端分层部署 + 中间件集中部署 + 数据库主备分离部署”的整体部署模式。
+
+本方案的最终结论如下：
+
+1. 公网入口薄转发不纳入我方主机资源；我方实际部署的统一接入入口为内网 Nginx 入口节点。
+2. 2 台业务应用节点作为核心业务集群，节点内同时部署 Spring Boot Gateway 和业务服务，承接微服务统一接入与核心业务处理。
+3. 综合节点集中承载 Redis、Nacos、MinIO 及数据库控制组件，进一步压缩一期主机数量并降低部署复杂度。
+4. 新增 1 台 SFTP/FTP 文件交换服务器，作为银行送盘、回盘、对账文件交换专用前置机。
+5. PostgreSQL 16 采用同城双可用区 1 主 1 热备部署，满足高可用要求。
+6. 网络采用公网接入区、内网接入区、应用区、中间件与文件存储区、银行文件交换区、数据区分层隔离模式，以满足安全性、可维护性和资源审批要求。
diff --git a/output/08_Integrated_Deployment_Design_PlanB_含图表.docx b/output/08_Integrated_Deployment_Design_PlanB_含图表.docx
new file mode 100644
index 0000000000000000000000000000000000000000..ffac4fff87c3337f16779b5377079eb444e6ba8d
GIT binary patch
literal 409761
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