• jnpf3.6私有化部署

    文件内容

    project

            

    web


    >

    1.  特别说明：源码、JDK、MySQL、Redis等安装或存放路径禁止包含中文、空格、特殊字符等
    2.  
    3. ## 一 技术栈
    4.  
    5. - 主框架：`Spring Boot` + `Spring Framework`
    6. - 持久层框架：`MyBatis-Plus`
    7. - 数据库连接池：`Alibaba Druid`
    8. - 多数据源：`Dynamic-Datasource`
    9. - 数据库兼容： `MySQL`(默认)、`SQLServer`、`Oracle`、`PostgreSQL`、`达数据库`、`人大金仓数据库`
    10. - 分库分表解决方案：`Apache ShardingSphere`
    11. - 权限认证框架：`Sa-Token`+`JWT`
    12. - 代码生成器：`MyBatis-Plus-Generator`
    13. - 模板引擎：`Velocity`
    14. - 任务调度：`XXL-JOB`
    15. - 分布式锁：`Lock4j`
    16. - JSON序列化: `Jackson`&`Fastjson`
    17. - 缓存数据库：`Redis`
    18. - 校验框架：`Validation`
    19. - 分布式文件存储：兼容`MinIO`及多个云对象存储，如阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS等
    20. - 工具类框架：`Hutool`、`Lombok`
    21. - 接口文档：`Knife4j`
    22. - 项目构建：`Maven`
    23.  
    24. ## 二 环境要求
    25.  
    26. ### 2.1 开发环境
    27.  
    28. | 类目 | 版本说明或建议                                                                                                                                                       |
    29. | --- |---------------------------------------------------------------------------------------------------------------------------------------------------------------|
    30. | 电脑配置 | 建议开发电脑I3及以上CPU，内存16G及以上                                                                                                                                       |
    31. | 操作系统 | Windows 10/11，MacOS                                                                                                                                           |
    32. | JDK | 建议使用`1.8.0_281`及以上版本，可使用`Eclipse Temurin JDK 8`、`Alibaba Dragonwell 8`、`BiSheng JDK 8`等                                                                       |
    33. | Maven | `3.6.3`及以上版本                                                                                                                                                  |
    34. | 数据缓存 | Redis `3.2.100`(Windows)/`4.0.x`+ (Linux,Mac)  或  TongRDS `2.2.x`                                                                                             |
    35. | 数据库 | 兼容`MySQL 5.7.x/8.0.x`(默认)、`SQLServer 2012+`、`Oracle 11g`、`PostgreSQL 12+`、`达梦数据库(DM8)`、`人大金仓数据库(KingbaseES_V8R6)`                                             |
    36. | 后端开发 | `IDEA2020`及以上版本、`Eclipse` 、 `Spring Tool Suite`等                                                                                                              |
    37. | 前端开发 | `Node.js` v16.15.0(某些情况下可能需要安装 `Python3`)及以上版本；
      `Yarn` v1.22.x 版本；
      `pnpm` v8.10及以上版本；
      浏览器推荐使用`Chrome` 90及以上版本；
      `Visual Studio Code`(简称VSCode) |
    38. | 移动端开发 | `Node.js` v12/v14/v16(某些情况下可能需要安装 Python3)；
      HBuilder X(最新版)                                                                                               |
    39. | 文件存储 | 默认使用本地存储，兼容 `MinIO` 及多个云对象存储，如`阿里云 OSS`、`华为云 OBS`、`七牛云 Kodo`、`腾讯云 COS`等                                                                                       |
    41. ### 2.2 运行环境
    43. > 适用于测试或生产环境
    45. | 类目 | 版本说明或建议                                                                                                           |
    46. | --- |-------------------------------------------------------------------------------------------------------------------|
    47. | 服务器配置 | 最低配置要求：4c/16G/50G；                                                                                                |
    48. | 操作系统 | 推荐使用`Ubuntu 18.0.4`及以上版本，兼容 `统信UOS`，`OpenEuler`，`麒麟服务器版`等国产信创环境；                                                  |
    49. | JRE | 建议使用`1.8.0_281`及以上版本，如`Eclipse Temurin JRE 8/11/17`、`Alibaba Dragonwell 8/11/17`、`BiSheng JRE 8/11/17`；           |
    50. | 数据缓存 | Redis `4.0.x+` 或 TongRDS `2.2.x`                                                                                  |
    51. | 数据库 | 兼容`MySQL 5.7.x/8.0.x`(默认)、`SQLServer 2012+`、`Oracle 11g`、`PostgreSQL 12+`、`达梦数据库(DM8)`、`人大金仓数据库(KingbaseES_V8R6)` |
    52. | 中间件(可选) | 东方通 `Tong-web`、金蝶天燕-应用服务器`AAS` v10；                                                                               |
    53. | 文件存储 | 默认使用本地存储，兼容`MinIO`及多个云对象存储，如阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS等                                                     |
    54. | 前端服务器 | Nginx 建议使用`1.18.0`及以上版本  或 TongHttpServer `6.0`                                                                   |
    56. ## 三 IDEA插件
    58. - `Lombok`(必须)
    59. - `Alibaba Java Coding Guidelines`
    60. - `MybatisX`
    62. ## 四 Maven私服配置
    64. > Apache Maven 3.6.3及以上版本
      解决以下依赖无法从公共Maven仓库下载的问题
    66. - com.dm:DmJdbcDriver18:1.8.0
    67. - com.kingbase8:kingbase8-jdbc:2.0
    68. - dingtalk-sdk-java:taobao-sdk-java-source:1.0
    69. - dingtalk-sdk-java:taobao-sdk-java:1.0
    71. 打开Maven安装目录中的 `conf/settings.xml` 文件，
    72. 在 `` 中添加如下内容
    74. ```xml
    76.   maven-releases
    77.   jnpf-user
    78.   HLrQ0MA%S1nE
    80. ```
    81. 在 `` 中添加
    83. ```xml
    85.   maven-releases
    86.   *
    87.   maven-releases
    88.   https://repository.jnpfsoft.com/repository/maven-public/
    90. ```
    92. ## 五 配套项目
    94. | 项目 | 分支 | 分支（Coding） | 说明 |
    95. | --- | --- | --- | --- |
    96. | **后端** |  |  |  |
    97. | jnpf-common | v3.6.x | v3.6.x-stable | java基础依赖项目源码 |
    98. | jnpf-file-core-starter | v3.6.x | v3.6.x-stable | 文件基础依赖项目源码 |
    99. | jnpf-scheduletask | v3.6.x | v3.6.x-stable | 任务调度客户端依赖及服务端项目源码 |
    100. | jnpf-datareport | v3.6.x | v3.6.x-stable | 报表后端项目源码 |
    101. | jnpf-file-preview | v3.6.x | v3.6.x-stable | 本地文档预览项目源码 |
    102. | **前端** |  |  |  |
    103. | jnpf-web | v3.6.x | v3.6.x-stable | 前端主项目(Vue2)源码 |
    104. | jnpf-web-vue3 | v3.6.x | v3.6.x-stable | 前端主项目(Vue3)源码 |
    105. | jnpf-web-datascreen | v3.6.x | v3.6.x-stable | 大屏前端项目(Vue2)源码 |
    106. | jnpf-web-datascreen-vue3 | v3.6.x | v3.6.x-stable | 大屏前端项目(Vue3)源码 |
    107. | jnpf-web-datareport | v3.6.x | v3.6.x-stable | 报表前端项目源码 |
    108. | **移动端** |  |  |  |
    109. | jnpf-app | v3.6.x | v3.6.x-stable | 移动端项目(Vue2)源码 |
    110. | jnpf-app-vue3 | v3.6.x | v3.6.x-stable | 移动端项目(Vue3)源码 |
    111. | **静态资源** |  |  |  |
    112. | jnpf-resources | v3.6.x | v3.6.x-stable | 静态资源 |
    113. | **数据库** |  |  |  |
    114. | jnpf-database | v3.6.x | v3.6.x-stable | 数据库脚本或文件 |
    116. ## 六 开发环境
    118. ### 6.1 导入数据库脚本
    120. > 以 MySQL数据库为例
      字符集：utf8mb4
      排序规则：utf8mb4_general_ci
    122. #### 6.1.1 创建平台数据库
    124. 在MySQL创建 `jnpf_init` 数据库，并将 `jnpf-database/MySQL/jnpf_init.sql` 以【新建查询】方式导入
    126. #### 6.1.2 创建系统调度数据库
    128. 在MySQL创建 `jnpf_xxjob` 数据库，并将 `jnpf-database/MySQL/jnpf_xxjob_init.sql` 以【新建查询】方式导入
    130. ### 6.2 导入依赖
    132. #### 6.2.1 基础依赖
    134. 详见 `jnpf-common` 项目中的 `README.md` 文档说明
    136. #### 6.2.2 文件基础依赖
    138. 详见 `jnpf-file-starter` 项目中的 `README.md` 文档说明
    140. #### 6.2.3 导入系统调度服务端
    142. 详见 `jnpf-scheduletask` 项目中的 `README.md` 文档说明
    144. ### 6.3 项目配置
    146. 打开编辑 `jnpf-admin/src/main/resources/application.yml`
    148. #### 6.3.1 指定环境配置
    150. - `application-dev.yml`  开发环境(默认)
    151. - `application-test.yml`  测试环境
    152. - `application-preview.yml` 预发布环境
    153. - `application-pro.yml` 生产环境
    155. ```yaml
    156. # application.yml第5行,可选值：dev(默认)|test|pro|preview
    157. active: dev
    158. ```
    159. #### 6.3.2 配置域名
    160. 打开编辑 `jnpf-admin/src/main/resources/application.yml` ，修改以下配置
    162. ```yaml
    163.   PreviewType: kkfile #文件预览方式 （1.yozo 2.kkfile）默认使用kkfile
    164.   kkFileUrl: http://127.0.0.1:30090/FileServer/ #kkfile文件预览服务地址
    165.   ApiDomain: http://127.0.0.1:30000 #后端域名(文档预览中使用)
    166.   FrontDomain: http://127.0.0.1:3000 #前端域名(文档预览中使用)
    167.   AppDomain: http://127.0.0.1:8080 #app/h5端域名配置(文档预览中使用)
    168. ```
    170. #### 6.3.3 数据源配置
    172. 打开编辑 `jnpf-admin/src/main/resources/application-dev.yml`，修改以下配置
    173. > 具体配置说明参考：[https://jnpfsoft.coding.net/p/jnpf-docs/wiki/2165](https://jnpfsoft.coding.net/p/jnpf-docs/wiki/2165)
    175. ```yaml
    176.   datasource:
    177.     db-type: MySQL #数据库类型(可选值 MySQL、SQLServer、Oracle、DM8、KingbaseES、PostgreSQL，请严格按可选值填写)
    178.     host: 192.168.0.213
    179.     port: 3306
    180.     username: root
    181.     password: a26d27e6a6cd4538
    182.     db-name: java_boot_test
    183.     db-schema: #金仓达梦选填
    184.     prepare-url: #自定义url
    185. ```
    186. #### 6.3.4 Redis配置
    188. 打开编辑 `jnpf-admin/src/main/resources/application-dev.yml`，修改以下配置
    189. > 支持单机模式和集群模式，配置默认为单机模式
    191. **Redis单机模式**
    193. ```yaml
    194.   redis:
    195.     database: 200 #缓存库编号
    196.     host: 192.168.0.213
    197.     port: 6379
    198.     password: ucfbVgZgyB0dBQdh  # 密码为空时，请将本行注释
    199.     timeout: 3000 #超时时间(单位：秒)
    200.     lettuce: #Lettuce为Redis的Java驱动包
    201.       pool:
    202.         max-active: 8 # 连接池最大连接数
    203.         max-wait: -1ms  # 连接池最大阻塞等待时间（使用负值表示没有限制）
    204.         min-idle: 0 # 连接池中的最小空闲连接
    205.         max-idle: 8 # 连接池中的最大空闲连接
    206. ```
    208. **Redis集群模式**
    210. ```yaml
    211.  redis:
    212.    cluster:
    213.      nodes:
    214.        - 192.168.0.225:6380
    215.        - 192.168.0.225:6381
    216.        - 192.168.0.225:6382
    217.        - 192.168.0.225:6383
    218.        - 192.168.0.225:6384
    219.        - 192.168.0.225:6385
    220.    password: 123456 # 密码为空时，请将本行注释
    221.    timeout: 3000 # 超时时间(单位：秒)
    222.    lettuce: #Lettuce为Redis的Java驱动包
    223.      pool:
    224.        max-active: 8 # 连接池最大连接数
    225.        max-wait: -1ms  # 连接池最大阻塞等待时间（使用负值表示没有限制）
    226.        min-idle: 0 # 连接池中的最小空闲连接
    227.        max-idle: 8 # 连接池中的最大空闲连接
    228. ```
    229. #### 6.3.5 静态资源配置
    231. 打开编辑 `jnpf-admin/src/main/resources/application-dev.yml` ，修改以下配置
    232. > 默认使用本地存储，兼容`MinIO`及多个云对象存储，如阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS等
    234. ```yaml
    235.   # ===================== 文件存储配置 =====================
    236.   file-storage: #文件存储配置，不使用的情况下可以不写
    237.     default-platform: local-plus-1 #默认使用的存储平台
    238.     thumbnail-suffix: ".min.jpg" #缩略图后缀，例如【.min.jpg】【.png】
    239.     local-plus: # 本地存储升级版
    240.       - platform: local-plus-1 # 存储平台标识
    241.         enable-storage: true  #启用存储
    242.         enable-access: true #启用访问（线上请使用 Nginx 配置，效率更高）
    243.         domain: "" # 访问域名，例如：“http://127.0.0.1:8030/”，注意后面要和 path-patterns 保持一致，“/”结尾，本地存储建议使用相对路径，方便后期更换域名
    244.         base-path: D:/project/jnpf-resources/ # 基础路径
    245.         path-patterns: /** # 访问路径
    246.         storage-path:  # 存储路径
    247.     aliyun-oss: # 阿里云 OSS ，不使用的情况下可以不写
    248.       - platform: aliyun-oss-1 # 存储平台标识
    249.         enable-storage: false  # 启用存储
    250.         access-key: ??
    251.         secret-key: ??
    252.         end-point: ??
    253.         bucket-name: ??
    254.         domain: ?? # 访问域名，注意“/”结尾，例如：https://abc.oss-cn-shanghai.aliyuncs.com/
    255.         base-path: hy/ # 基础路径
    256.     qiniu-kodo: # 七牛云 kodo ，不使用的情况下可以不写
    257.       - platform: qiniu-kodo-1 # 存储平台标识
    258.         enable-storage: false  # 启用存储
    259.         access-key: ??
    260.         secret-key: ??
    261.         bucket-name: ??
    262.         domain: ?? # 访问域名，注意“/”结尾，例如：http://abc.hn-bkt.clouddn.com/
    263.         base-path: base/ # 基础路径
    264.     tencent-cos: # 腾讯云 COS
    265.       - platform: tencent-cos-1 # 存储平台标识
    266.         enable-storage: false  # 启用存储
    267.         secret-id: ??
    268.         secret-key: ??
    269.         region: ?? #存仓库所在地域
    270.         bucket-name: ??
    271.         domain: ?? # 访问域名，注意“/”结尾，例如：https://abc.cos.ap-nanjing.myqcloud.com/
    272.         base-path: hy/ # 基础路径
    273.     minio: # MinIO，由于 MinIO SDK 支持 AWS S3，其它兼容 AWS S3 协议的存储平台也都可配置在这里
    274.       - platform: minio-1 # 存储平台标识
    275.         enable-storage: true  # 启用存储
    276.         access-key: Q9jJs2b6Tv
    277.         secret-key: Thj2WkpLu9DhmJyJ
    278.         end-point: http://192.168.0.207:9000/
    279.         bucket-name: jnpfsoftoss
    280.         domain:  # 访问域名，注意“/”结尾，例如：http://minio.abc.com/abc/
    281.         base-path:  # 基础路径
    282. ```
    283. #### 6.3.6 第三方登录配置
    285. 打开编辑 `jnpf-admin/src/main/resources/application-dev.yml` ，修改以下配置
    286. > 配置默认关闭
    288. ```yaml
    289. socials:
    290.   # 第三方登录功能开关(false-关闭，true-开启)
    291.   socials-enabled: false
    292.   config:
    293.     - # 微信
    294.       provider: wechat_open
    295.       client-id: your-client-id
    296.       client-secret: your-client-secret
    297.     - # qq
    298.       provider: qq
    299.       client-id: your-client-id
    300.       client-secret: your-client-secret
    301.     - # 企业微信
    302.       provider: wechat_enterprise
    303.       client-id: your-client-id
    304.       client-secret: your-client-secret
    305.       agentId: your-agentId
    306.     - # 钉钉
    307.       provider: dingtalk
    308.       client-id: your-client-id
    309.       client-secret: your-client-secret
    310.       agentId: your-agentId
    311.     - # 飞书
    312.       provider: feishu
    313.       client-id: your-client-id
    314.       client-secret: your-client-secret
    315.     - # 小程序
    316.       provider: wechat_applets
    317.       client-id: your-client-id
    318.       client-secret: your-client-secret
    319. ```
    320. #### 6.3.7 任务调度配置
    322. 打开编辑 `jnpf-admin/src/main/resources/application-dev.yml` ，修改以下配置，调整 xxl.job.admin.addresses 地址
    324. ```yaml
    325. xxl:
    326.   job:
    327.     accessToken: ''
    328.     i18n: zh_CN
    329.     logretentiondays: 30
    330.     triggerpool:
    331.       fast:
    332.         max: 200
    333.       slow:
    334.         max: 100
    335.     # xxl-job服务端地址
    336.     admin:
    337.       addresses: http://127.0.0.1:30020/xxl-job-admin/
    338.     executor:
    339.       address: ''
    340.       appname: xxl-job-executor-sample1
    341.       ip: ''
    342.       logpath: /data/applogs/xxl-job/jobhandler
    343.       logretentiondays: 30
    344.       port: 9999
    345.   # rest调用xxl-job接口地址
    346.   admin:
    347.     register:
    348.       handle-query-address: ${xxl.job.admin.addresses}api/handler/queryList
    349.       job-info-address: ${xxl.job.admin.addresses}api/jobinfo
    350.       log-query-address: ${xxl.job.admin.addresses}api/log
    351.       task-list-address: ${xxl.job.admin.addresses}api/ScheduleTask/List
    352.       task-info-address: ${xxl.job.admin.addresses}api/ScheduleTask/getInfo
    353.       task-save-address: ${xxl.job.admin.addresses}api/ScheduleTask
    354.       task-update-address: ${xxl.job.admin.addresses}api/ScheduleTask
    355.       task-remove-address: ${xxl.job.admin.addresses}api/ScheduleTask/remove
    356.       task-start-or-remove-address: ${xxl.job.admin.addresses}api/ScheduleTask/updateTask
    357. ```
    358. ## 七 启动项目
    360. 找到`jnpf-admin/src/main/java/JnpfAdminApplication.java`，右击运行即可。
    362. ## 八 项目发布
    364. - 在IDEA中，双击右侧Maven中 `jnpf-java-boot` > `Lifecycle` > `clean` 清理项目
    365. - 在IDEA中，双击右侧Maven中 `jnpf-java-boot` > `Lifecycle` > `package` 打包项目
    366. - 打开 `jnpf-java-boot\jnpf-admin\target`，将 `jnpf-admin-3.5.0-RELEASE.jar` 上传至服务器
    368. ## 九 接口文档
    370. - `http://localhost:30000/doc.html`

    运行后结果：

  • 相关阅读:
    Ajax系列之文件上传进度展示
    【黑马-SpringCloud技术栈】【02】服务拆分及远程调用_服务提供者与消费者
    MyBatis实现MySQL表字段及结构的自动增删
    成为会带团队的技术人 在管理艺术中寻找确定性的“工程逻辑”
    Typescript的declare 关键字
    tomcat 7 任意文件上传漏洞（信息搜集与漏洞探测）
    北京化工大学数据结构2022/11/3作业 题解
    .mxdown-V-XXXXXXXX勒索病毒感染后的下一步：恢复您的文件
    Tomcat
    BI系统打包Docker镜像及部署的技术难度和实现
  • 原文地址：https://blog.csdn.net/weixin_42575806/article/details/137278781