# V8环境规划和安装部署指南
致远互联软件股份有限公司
2026年5月更新
# 1. V8部署架构
V8 PaaS平台提供基于SpringCloud生态框架开发的统一微服务基础框架支撑体系，包括微服务框架、持久化及数据源、对象存储、缓存、消息、事件、日志、线程池、分布式锁、脚本引擎等组件。
V8 PaaS平台支持部署在私有云、公有云或混合云环境，整套部署方案采用主流的云原生架构：
- 使用Kubernetes容器平台，运行和管理所有V8微服务应用程序，提高了应用的可扩展性和弹性。
- 使用Nginx，作为V8应用的HTTP请求入口，提供负载均衡与反向代理服务。
- 使用关系型数据库（如MySQL），用于存储和维护V8应用的结构化数据，保证数据的一致性和安全性。
- 使用Nacos，进行V8的统一配置管理和服务注册与发现，支持动态配置并简化服务治理。
- 使用对象存储（如MinIO），存储和管理V8应用的非结构化数据（例如附件、前端静态文件），以满足大规模数据的存储需求。
- 使用Redis分布式缓存服务，缓存V8的热点数据，提升数据访问速度并降低数据库负载。
- 使用Kafka消息中间件，实现V8消息的生产和消费，确保消息处理的高效性和可靠性。
- 使用ElasticSearch（ES）搜索引擎，提供强大的全文搜索功能、数据分析和可视化支持，尤其适用于实时日志分析、监控和复杂查询。
- 使用ClickHouse列式数据库，进行报表的实时数据分析和处理，支持大规模数据的高性能查询。
- 使用Gitlab进行代码版本管理，维护UDC低代码平台建设的程序代码。低代码平台生成的镜像由V8中的沙箱微服务完成编译，沙箱中集成了Maven、NodeJS等工具。
- 使用Harbor，管理所有V8微服务的镜像，包括UDC低代码平台自建的镜像，保障镜像存储的安全和效率。
- 使用 NFS 或 PVC 为V8 PaaS平台K8S提供共享存储，实现日志持久化挂载，同时满足多容器、多服务间的文件共享和集中管理需求（主要是日志文件集中）。
# 2. 单点和高可用部署模式
V8部署方案除了支持单点部署，还提供了高可用部署。
单点部署指在云原生架构下所有服务均只是单例模式运行，一旦挂掉则整个体系都受影响。单点部署 ≠ 传统的单体架构，单点部署同样需要部署k8s、若干微服务、nginx、nacos、redis、es等等一系列服务（只是每个服务只提供1个实例）。通常POC环境、开发/测试/实施环境可用单点部署；如客户生产环境在线人数低（3000以内），且资源有限，愿意承担单点故障风险，也可以酌情选择单点部署模式。
高可用（High Availability, HA）指的是一个系统或组件在正常和故障情况下能够持续运行并提供可接受性能水平的能力。高可用性的重要性在于确保系统在大多数情况下能够不间断地提供服务，从而减少停机时间对业务和用户的影响。
我们推荐V8生产环境（尤其3000在线以上）采用高可用部署方案，以获得稳定、快速和可靠的服务体验，但高可用部署所需服务器资源更多。
下面简单介绍两个最常见的高可用场景：
数据库高可用：数据库单机即可供V8应用进行读写使用，但如果数据库服务器硬件损坏会因为V8读不到数据从而导致系统全面不可用。为了防止数据库单台服务器故障（俗称单点故障）引发的全面异常，可以使用2台数据库主备模式运行，当1台主数据库故障后，另1台数据库服务还能继续供V8连接使用，从而确保了服务的可用性。
K8S 微服务 多副本高可用：微服务单实例即可为 V8 平台提供业务能力，但如果该容器实例异常、节点宕机或版本发布重启，会造成对应功能不可访问。为避免单实例单点故障，K8S 可对微服务配置多副本部署，同一服务同时运行多个容器实例；当其中某一个副本故障时，其余正常副本可继续承接业务请求，平台调度自动分流流量，保障 V8 整体业务不中断、持续可用。
# 3. V8服务建设整体步骤
基于V8微服务部署架构规则，如需部署并启动V8服务，需要完成如下步骤：
第一步，规划部署方案：确定用户的V8使用需求，再依据需求整理出所需资源和部署方案（详见[V8规划部署方案]章节）。
第二步，部署中间件：待客户准备与之匹配的资源后，根据V8架构要求部署产品所需中间件（所需中间件详见[V8依赖中间件]章节）。
第三步，部署V8应用程序：下载V8安装工具，使用工具连接已部署的中间件服务，进行V8程序安装和初始化。
第四步，登录系统：登录V8系统，进行租户初始化、沙箱创建等操作后即可使用。
第五步，重复第二步到第四步部署第二套，甚至第三套环境（部署多套环境原因见“规划部署方案”章节）。
# 4. 规划部署方案
# 规划部署方案工具和关键步骤
部署方案可参考《COP-V8服务器资源评估 (opens new window)》工具中的模板进行规划评估，关键步骤为：
第一步，参考“资源沟通参考模板”调研客户环境情况，并根据客户环境做整体方案预设计
第二步，参考“服务推送关系模板”以及用户需求，规划客户需要几套环境，以及环境推送关系
第三步，参考“精简云和标准云部署模式”评估给客户提供哪种模式资源
第四步，参考“微服务部署资源”以及第一步预计在线人数，初步评估服务器所需资源
第五步，参考“微服务清单（模板）”以及用户需求，规划每套环境需要使用哪些微服务，再根据所需资源测算及校正K8S资源
第六步，参考“服务器资源确认清单（模板）”以及前几步的综合评估，汇总最终部署方案
# 规划第一步：资源沟通
规划部署方案第一步：收集客户的环境信息和需求。参考《COP-V8服务器资源评估 (opens new window)》工具中的“资源沟通参考模板”页签与客户进行逐个需求沟通，主要沟通内容和目的：
注：V8能在什么CPU芯片、什么操作系统、什么数据库下运行？V8支持哪些信创Web中间件？ 详见《V8非功能性兼容支持情况 (opens new window)》
| 沟通事项 | 目的 |
|---|---|
| 基础设施平台和架构 | 调研客户使用什么CPU架构、什么云平台（比如信创ARM则要考虑资源是X86的1.2倍） |
| 操作系统要求 | 调研客户使用什么操作系统：信创麒麟？RedHat系列？Euler系列？（部分偏门系统可能导致部署不兼容） |
| 中间件要求 | 1、调研需要自建哪些中间件，是否存在高可用需求，单机和高可用所需资源不同 2、微服务依赖的Web中间件，默认内嵌开源Tomcat，如客户使用信创东方通等内嵌版，要告知客户这个需联系信创厂商购买 |
| 数据库类型要求 | 调研客户使用什么数据库：默认社区版MySQL，如客户使用信创达梦、金仓，要告知客户这个需联系信创厂商购买 |
| 服务器网络要求 | 调研客户服务器群的网络情况，需要确保后台服务在同一局域网 |
| V8环境套数 | 非常关键：调研客户是否使用UDC低代码或表单搭建，如使用则标准需要两套环境，并设置推送关系（实施/开发→生产） |
| 计划部署的V8微服务数量 | 调研客户需要使用哪些产品功能：协同？公文？公告？功能越多所需服务器资源越高，需要根据需求做精准测算 |
| V8在线用户数 | 调研客户峰值在线人数，以便根据在线人数参考手册给服务器整体推荐 |
| 需要使用哪些第三方服务 | 调研客户使用哪些第三方服务：在线预览？在线编辑？OCIP？AI？这些服务都需要额外的资源申请（不在V8默认资源范围内） |
| 其它特殊要求 | 调研客户是否使用域名管理、是否https等等，以便做统一规划 |
模板示例截图：
# 规划第二步：环境标识和推送设计
规划部署方案第二步：参考《COP-V8服务器资源评估 (opens new window)》工具“服务推送关系模板”确定客户环境数量和推送关系。
如仅做POC环境演示，则只需准备一套开发实施POC环境即可。
如客户仅使用标品应用，无定制应用需求，则只需一套生产环境，此类客户极少，大部分都会做应用定制。
如使用应用定制-UDC低代码或表单搭建，V8必须有两套环境： 第一套开发实施环境，第二套生产环境，意味着给客户报服务器资源的时候需要报开发和生产两份资源。
UDC低代码开发设计和测试在第一套开发实施环境进行，测试充分后将编译包推送到生产环境，第二套生产环境直接使用设计好的低代码应用。
详细评估需要使用几套环境，不同环境的作用参考文档：
V8多套环境设计和推送规则视频：协同云-赋能中心-致远学院，搜索“V8多套环境设计”
V8 5.x版本多套环境推送解决方案 https://docs.qq.com/slide/DS25tY0hKSWFScW5w
V8 5.x版本多套环境推送操作文档： https://docs.qq.com/doc/DS05EbmJKYWNLcGt1
V8 5.x版本环境分配规则逻辑图：
# 规划第三步：选择部署模式-精简/标准
参考资料《部署模式-精简云和标准云原生简介 (opens new window)》。
纯云原生模式所需服务器资源较高，不是所有客户都有足够服务器资源支持，基于此场景，V8自V5.3.0版本开始推出了标准云原生部署和精简云原生部署两种模式，以面向不同客户群体：
- 标准云原生：标准云原生架构，每个业务独立微服务运行，微服务数量多，所需资源较高，适用于中大型客户
- 精简云原生：将多个相似服务合并为一个微服务，微服务数量成倍减少，所需资源降低，适用于POC和中小型客户（不推荐6000在线以上客户使用）
规划思路：
- 所有POC项目：推荐精简云原生-POC资源最低限度部署
- （5000在线以内）中小型客户：推荐精简云原生-按对应在线评估资源
- （5000在线以上）中大型客户：推荐标准云原生-按对应在线评估资源
注意事项：
- 不支持精简云+标准云 混合模式，即 [开发/实施环境精简云 + 生产环境标准云 → 不支持]，仅支持[开发/实施环境精简云 + 生产环境精简云] 或 [开发/实施环境标准云 + 生产环境标准云]
- 不支持精简云转标准云，即前期[精简云环境] 不支持后期转 [标准云环境]，反之亦然！
# 规划第四步：初步评估部署资源
规划部署方案第四步：参考《COP-V8服务器资源评估 (opens new window)》工具“微服务部署资源”以及客户预计在线人数，规划服务器所需资源：
- 如果是POC演示，不涉及压测，则只需要取精简云模式下的POC资源列。
- 如果是正式环境资源申请，则要结合前三步的资源沟通和环境规划来判定选择精简云还是标准云。
注意：
- 这一步只是整体资源的预估，在完成整体资源预估后，还需要结合后续步骤进行精准测算微调资源！
- 除数据库外，其余服务默认按照超融合虚拟机方案进行服务器推荐，即按需给服务器配备一定的硬件资源！云原生架构推荐基于专业虚拟化平台维护，以达到资源的合理分配和充分利用。
- 如客户采用物理实体机维护，理论也可行，但部署和维护难度会提高（处理端口冲突、高可用方案分配问题），并且资源利用不一定最大化。
以POC场景为例： 按标准方案，直接找“精简云原生”页签-POC环境这一部分，根据实际情况做资源的推荐：
以5000在线用户数为例： 按标准方案可以选择精简和标准两种，如客户服务器资源充足，则我们推荐标准云原生 - 从“标准云原生”页签进入，提供实施/开发环境+生产环境两套资源 （为什么两套资源？ 在 [环境表示和推送设计] 章节有明确解释）。
扩展说明：
- 当前资源推荐不是绝对的，项目上可根据情况灵活调整，比如客户有自己的对象存储服务，则不需要申请MinIO资源
- K8S Worker节点最占资源，文档中的默认推荐是基于“部署V8全部标品应用”的测算值，实际不同客户所需标品应用不同，还涉及若干UDC搭建，所需资源差异更大，需要基于下一步做微服务资源的精细测算！
- 资源表格中存在多个服务（如Nacos、Redis、Kafka）占用1台服务器的场景，表示这三个服务可以部署在同一台服务器
- 1副本表示每个微服务在K8S下仅存活一个pod，2副本表示每个服务在K8S下存活两个pod，多副本能实现V8的高可用，但对硬件资源要求也是成倍增加
- 多副本测算标准：3000在线1副本、6000在线2副本、9000在线3副本，以此类推。
- 大于1000在线用户后，一般推荐核心服务实现高可用，高可用所需资源更多。客户可以不采纳建议，但要告知客户单点故障风险
- 当前资源采用X86硬件测算，如果是信创环境，需要考虑增加20%以上的硬件资源。参考资料：【信创服务器海光和鲲鹏差异化及性能测试对比分析 (opens new window)】（信创海光和鲲鹏处理器在TPS性能上相较Intel处理器有40%~50%性能差距）
# 规划第五步，测算微服务资源占用
规划部署方案第五步，参考《COP-V8服务器资源评估 (opens new window)》工具“微服务清单（模板）”以及用户需求，填写每套环境需要使用哪些微服务，再根据所需资源测算及校正K8S资源：
- 微服务均在K8S的Worker节点下运行，注意微服务测算资源总和不能超过K8S的Worker节点服务器资源总和的80%（留20%做紧急资源借调）
- V8微服务主要分三类：平台类、标品应用、UDC低代码。表格中有“是否必装”，其中平台类是必装，其它类是根据客户需求可选安装，安装越多资源要求越高。
- 如果涉及UDC低代码应用，需要测算低代码应用数量，建议至少5个以上，每个低代码应用就是一个微服务（一个pod），故需要充分预估低代码占用资源
- 在线工具最终能生成总资源，将资源总和÷80%就是最终K8S Worker节点服务器的资源，此时可以修正第三步初评估的K8S Worker节点资源。
- 测算微服务资源工具非常关键，用户问“为什么要这么多K8S资源”时，就可以拿着这个测算明细做依据进行沟通！
# 规划第六步，输出资源评估报告
规划部署方案第六步：参考《COP-V8服务器资源评估 (opens new window)》工具“服务器资源确认清单（模板）”以及前几步的综合评估，给出最终的资源评估报告：
- 填写服务器架构、操作系统、CPU核心数、内存、数据盘大小、服务器用途、推荐版本、参数要求
- 其中每个中间件要求的版本和参数要求，参考《COP-V8服务器资源评估 (opens new window)》工具“中间件版本和参数要求”里面的说明，尤其是客户自己维护中间件场景，需要将要求发给客户
- 如存在多套环境，每套环境的要求均列出来
- 通过一页内容完成资源汇总和报告，同时汇总报告也可以作为后续部署维护参考材料（后期加上服务器IP、连接帐号密码）
生成评估报告示例：
# V8安装部署方案
# V8依赖中间件服务
V8部署需要哪些依赖服务？ 以下为V8云原生微服务平台部署所需中间件：
| 编号 | 开源中间件 | 作用 |
|---|---|---|
| 1 | Nginx | 反向代理、负载均衡、请求统一入口 |
| 2 | Kubernetes | 容器平台，所有V8基础代码及低代码应用在平台里运行 |
| 3 | MySQL | 数据库，存储V8所有业务结构化数据 |
| 4 | Nacos | 配置中心、服务注册发现，管理V8配置及服务 |
| 5 | MinIO | 对象存储，存储V8所有业务非结构化数据 |
| 6 | Redis | 缓存数据库，存储V8缓存数据 |
| 7 | Kafka | 分布式消息中间件，实现V8消息生产消费高效管理 |
| 8 | ElasticSearch | 检索数据库 |
| 9 | ClickHouse | 列式数据库，用于报表实时数据分析处理 |
| 10 | Gitlab | 代码仓库，用于低代码平台代码版本管理 |
| 11 | Harbor+Docker | 镜像仓库 |
注意：
- 以上为私有化部署自建中间件推荐，均采用主流的开源组件，具体推荐的中间件版本见《外部依赖服务清单 (opens new window)》
- 中间件依赖必要的服务器资源，不同需求不同在线用户数所需服务器数量和配置不同，默认推荐详见《微服务部署资源 (opens new window)》
- 所有服务可以单机部署运行，也可以高可用部署运行
- 如客户在公有云或混合云运行，可使用云服务商提供的与开源组件相匹配的中间件解决方案
- 相关中间件服务默认由客户提供和维护，标准产品不提供开源中间件的安装包
- 标准产品提供的物料：V8应用程序安装升级工具和V8微服务程序镜像包，相关物料需要在以上中间件运行的前提下才能使用
- 开放平台《基础设施安装维护 (opens new window)》提供了开源中间件的部署指导手册可供参考
不同服务实现高可用的方案如下：
| 编号 | 开源中间件 | 高可用方案 |
|---|---|---|
| 1 | Nginx | 2台服务器，每台均部署nginx+keepalived，如没有前置LB服务则需要准备VIP地址 |
| 2 | K8S Master | 3台K8S Master节点实现高可用 |
| 3 | K8S Worker | N台K8S Worker节点存放微服务应用，每个应用2副本可实现微服务应用的高可用 |
| 4 | MySQL | 数据库按厂商专业意见为准，比如主备模式两台服务器 |
| 5 | Nacos | 3台服务器，每台部署Nacos，并且集群模式Nacos依赖MySQL数据库做数据存储，可以复用客户数据库环境下的MySQL服务（如客户不是MySQL，则在数据库服务器部署一个低配置MySQL供Nacos使用） |
| 6 | MinIO | 最低4个节点高可用，每个节点最少2块相同大小磁盘（纠删码要求），最好使用大厂自带的OSS、OBS |
| 7 | Redis | 3台服务器，每台部署两个Redis，通过三主三从实现高可用 |
| 8 | Kafka | 3台服务器，每台部署Kafka实现高可用 |
| 9 | ElasticSearch | 3台服务器，每台部署ES实现高可用 |
| 10 | ClickHouse | 3台服务器，每台部署ClickHouse实现高可用 |
| 11 | Gitlab | 该服务生产环境不涉及，故无需高可用，并且也没有高可用方案 |
| 12 | Harbor+Docker | 该服务正常也不涉及高可用 |
# V8微服务部署步骤
一、V8微服务整体部署步骤为：
在确保所有中间件服务部署完成后，再参考《V8微服务安装部署手册 (opens new window)》进行V8微服务程序的安装部署及启动。
第一步，部署安装工具：将安装工具部署包上传至服务器、解压并启动，通过WEB浏览器可视化操作安装工具页面
第二步，设定环境基础信息和定义环境标识（名词解释详见“环境标识”相关章节）
第三步，联系商务/运营获取license并配置许可证书
第四步，V8制品准备：将V8制品包上传至安装工具所在服务器并初始化（制品即V8微服务相关程序镜像包）
第五步，按需选择标品应用并配置K8S及中间件信息
第六步，部署安装工具自动检查所需中间件连通性和配置信息，检查通过后自动部署应用
二、V8微服务部署安装工具执行核心逻辑：
- 可视化配置、检查V8依赖的所有中间件服务信息
- 可视化管理V8标品微服务镜像，并自动发布到K8S容器平台
- 将V8每个标品微服务作为一个POD在K8S Node下运行，实现服务自动发布
# V8方案规划经验总结
规划总结分享视频：协同云-赋能中心-致远学院，搜索“V8环境规划火种分享”，建议详细学习。
V8一般要求2套环境，每套环境都需要部署对应中间件和微服务
“微服务部署资源”表格仅仅是不同在线用户数通用配置参考，为了精确测算资源还应利用“微服务清单（模板）”
测算微服务资源时一定要预留UDC资源！
资源推荐也并非绝对，用户的使用习惯不同所需资源也不同，在上线前最好做一次压力测试，以便发现环境潜在风险
前期资源申请建议多提一点，用户会有砍资源的习惯，但最低限度要保留，避免减配后服务出现问题
所有中间件原则是客户提供，标品出厂不带中间件程序，项目组自建需要跟客户谈建设维护成本，避免后续不必要的麻烦
每个V8微服务均内置了开源的Tomcat中间件，如客户有信创需求需要自行采购信创Web中间件Springboot内嵌版，注意信创中间件一般按套数计费，V8下运行了多少个微服务就要多少套中间件！
产品适配在线预览和在线编辑服务最全面的是金山WebOffice中
V8支持多租户，多租户下挑数据库，一般MySQL、金仓MySQL模式、达梦MySQL模式可用
所有涉及到微服务的资源评估时，都需要预留一部分空闲资源，用于pod切换拉起以及预估低代码要生成的应用数的规模。例如预留服务器资源的1/3左右。
K8S只要是高可用，必须3、5、7台单数，避免脑裂，这个专业术语是加分项，可以AI了解详情
部署模式的选型应该在规划阶段就明确下来，例如二进制部署、容器化部署。poc可考虑全容器化（docker）部署，生产环境考虑二进制（native）部署。
对于操作系统、中间件、数据库的版本推荐，不要写中间件官方最新版，最新的没评估测试过的，一定是用稳定测试版本。
数据库尽可能要求厂商实施部署或使用云服务产品。
minio对象存储也可随时扩容，扩容方式包括lvm逻辑卷、节点扩容、磁盘扩容。但是，如果客户有现成类似OSS、OBS、ceph之类的，建议直接使用。
NFS文件共享，从性能或高可用考虑，可使用客户提供的，或使用ceph提供的。
如果满足客户合规要求，在不影响性能的情况下，部分服务可以考虑复用。例如harbor、NFS等。
可能大家没注意到内外网访问和域名访问的情况。这部分需要提前与客户沟通规划，避免部署实施时随意变动影响项目推进。
根据实际场景把拓扑图画出来，不能仅使用v8的那个架构关系图。才便于清晰的理清理顺整个系统的架构、数据流向。
总之，要从整套v8业务系统的全局观、总体性、系统性等方面进行考虑，基于 实际业务需求+客户客观条件 来进行规划设计。
快速跳转
