TDuckX 信创环境适配与部署指南

1. 文档概述

1.1 文档目的

本文档用于说明 TDuckX 在国产化信创环境中的软硬件兼容情况、部署要求以及相关配置说明，为系统实施、部署和运维人员提供参考。

1.2 适用范围

本文档适用于以下部署场景：

• 国产服务器环境
• 国产操作系统环境
• 国产数据库环境
• 企业内网/隔离网络环境
• 私有化部署环境

---

2. 系统架构与技术基础

2.1 后端技术架构

TDuckX 后端采用：

• Java
• Spring Boot
• MyBatis Plus
• Spring Security

基于 Java 跨平台特性，可运行于：

• Linux
• 国产 Linux 操作系统
• Windows Server

支持：

• 单节点部署
• 多节点部署
• Nginx 负载均衡

2.2 前端技术架构

前端采用：

• Vue3
• TypeScript
• Vite
• UniApp

支持：

• PC Web端
• H5移动端
• 微信小程序（根据版本支持）

兼容：

• Chrome
• Edge
• 国产双核浏览器

---

3. 信创软硬件兼容说明

3.1 服务器环境

类别	支持情况
CPU架构	x86、ARM64
服务器类型	通用服务器、国产服务器
部署方式	物理机、虚拟机、云服务器

理论支持国产服务器平台：

• 鲲鹏
• 飞腾
• 海光
• 兆芯

---

3.2 操作系统兼容

支持：

操作系统	状态
CentOS	支持
Ubuntu	支持
麒麟高级服务器操作系统	兼容
统信UOS服务器版	兼容
EulerOS	兼容

---

3.3 数据库适配

TDuckX 支持主流关系型数据库。

数据库	适配状态
MySQL 5.7/8.0	默认支持
达梦 DM8	适配支持
人大金仓 KingbaseES	适配支持

国产数据库适配说明

针对国产数据库环境：

• 提供对应 JDBC 驱动支持
• 支持数据库连接配置切换
• 支持基础业务表结构迁移

部分业务组件可能需要根据数据库版本进行兼容调整。

---

4. 部署环境支持

4.1 Docker 部署

支持 Docker 容器化部署。

推荐环境：

• Docker
• Docker Compose
• Nginx

适用于：

• 云服务器
• 私有云
• 内网服务器

---

4.2 离线环境部署

针对政企隔离网络环境：

支持：

• 离线安装包部署
• 静态资源本地化部署

部署流程：

准备服务器环境
        ↓
导入安装包
        ↓
配置数据库
        ↓
启动服务
        ↓
完成初始化

---

5. 身份认证与生态集成

5.1 单点登录

支持：

• CAS
• OAuth2.0

可与企业统一身份认证平台集成。

5.2 企业协同平台

支持：

• 企业微信
• 钉钉
• 飞书

能力：

• 组织架构同步
• 登录认证
• 消息通知
• 审批提醒

---

6. 数据交换与开放能力

TDuckX 提供开放接口能力：

6.1 WebHook

支持：

• 表单提交事件推送
• 数据变更通知

6.2 Open API

支持：

• 数据查询
• 数据同步
• 第三方系统调用

---

7. 信创环境业务能力支持

7.1 流程审批

支持：

• 可视化流程设计
• 节点审批
• 条件分支
• 部门负责人自动流转

7.2 在线考试与测评

支持：

• 在线考试
• 360评估
• 量表测评
• 自动评分

7.3 AI辅助能力

支持：

• AI创建表单
• AI生成校验规则
• DSL逻辑辅助生成

---

8. 常见问题排查

8.1 数据库切换问题

检查：

• JDBC驱动
• 数据库连接配置
• 字段类型兼容

8.2 文件存储问题

检查：

• 文件路径配置
• 存储权限
• OSS/对象存储配置

8.3 第三方登录问题

检查：

• Client ID
• Secret
• 回调地址

---

9. 版本适配说明

能力	支持情况
国产数据库	√
国产操作系统	√
Docker部署	√
内网部署	√
SSO认证	√
企业生态集成	√