跳至主要內容

安装手册

王金城大约 4 分钟

必读！必读！此页必读！

  • 原生支持单租户和多租户两种模式，根据您的实际需求，选择适合您的模式，下载不同版本的建库脚本。
  • 是否启用多租户模式取决于 datasource.yaml 配置文件中的 simperfect.datasource.dynamic.enabled 参数。
  • 如果您是新手，那么请按照 快速开始 进行安装。快速上手目录下内容您可用按照顺序进行查询。

安装步骤，帮您理清要先安装什么。

  1. 安装 Nginx、JDK、数据库、Redis、搜索引擎等基础模块
  2. 安装 Nacos 服务，使用 MySQL 数据库来存储配置信息
  3. 在 Nacos 中创建命名空间。详见：命名空间管理。
  4. 在 Nacos 中创建通用配置文件。详见：配置管理。
  5. 安装前端静态资源文件。详见：前端应用部署
  6. 安装后端服务。详见：后端服务部署

警告

  1. 必须保证服务器的时间同步，否则会导致用户无法登录。
  2. 必须保证服务器时区为东八区（GMT+8），如果需要在国外部署联系研发团队协助。
  3. 服务器时间必须第一时间调整后再部署，不可发生时间回拨，因为部分模块使用了雪花算法。

警告

由于 Oracle JDK 商用并非免费授权，所以我们可以使用以下 JDK 替换。

  1. 华为 毕昇 JDK，对操作系统的要求是 glibc 版本不低于 2.18。目前测试 CentOS 7.9 并未自带此版本，Ubuntu 24.04 支持，无 Windows 版本。
  2. 阿里 Dragonwell JDK，有 Windows 版本，其中 Dragonwell 21 就是 JDK 21。

提示

可以使用 basic-paper-tools 工具来生成 RSA 密钥对。该工具也支持生成随机字符串，后续会继续完善，可持续关注。

系统架构

安装之前我们先了解一下架构，这样有利于您理解我们应该如何进行安装。

架构图

配置要求

最低系统要求

注意

以下是部署 BasicPaperCloud Server 的最低系统要求（不包含数据库、Redis、Nacos 等中间件）。如果您的环境无法满足系统最小要求，可能会导致无法部署和启动 BasicPaperCloud Server。

JDK21
CPU16 核及以上
内存64G 及以上
硬盘无最小要求，根据保留日志自行调整
操作系统Linux (推荐), Windows
Nacosv2.4.3+
Redisv7.4.0+
MySQLv8.0.39+
Nginxv1.26.2+

重大变化

由于架构的改变，我们的安装形式也将发生重大变化。

  1. Java 依赖环境我们升级为 JDK 21，请前往官网下载安装。
  2. 前端静态页面需要单独使用 Nginx 部署，详见 前端应用部署。
  3. 有部分配置文件在 Nacos 中，配置文件会有单独章节详细介绍。
  4. 所有的接口请求都要通过 basic-paper-gateway（架构图中的 spring cloud gateway）。

基础模块介绍

模块名称必要说明
Nacos✔️注册中心、配置中心，这是应用依赖的必要模块
数据库✔️存储数据，这是应用依赖的必要模块
Redis✔️数据缓存，这是应用依赖的必要模块
ElasticSearch（搜索引擎）❌全文检索，目前只有 IVR、知识库使用此模块，并可以设置为关闭，所以此模块为选装模块
消息队列❌消息订阅、推送中间件，目前没有使用，无需安装
任务调度❌定时任务管理模块，目前没有使用，无需安装