Jacksen的技术博客

本文是H-ZERO 安装部署笔记，出于学习研究目的，刚开始按照开放平台->社区与合作伙伴->文档中心- 《HZERO 轻量版》技术文档进行部署实践，选择快速开始->微服务版进行安装； 但作为初学者， 水平太低， 由于轻量版合并了多个微服务，要改各种配置，过程中遇到多个困难，没有搞定🙂， 后来按照 开放平台->社区与合作伙伴->文档中心- 《HZERO汉得企业级PaaS平台》 技术文档进行 标准版（没有合并微服务的版本） 安装部署实践 ，安装部署成功了。本系列文章记录了这个过程。

需要说明的是，如果不是出于学习研究目的，是不需要这么麻烦的，技术中心有发发行版，可以一键安装，一小时不到可以全部安装完成。

本文是出于学习研究目的，按照技术文档从制品库里面拿各种零件进行组装，所以过程会比较繁琐，供学习研究参考。

实践系统环境：windows自带的Linux虚拟机 WSL ，linux版本在微软应用商店选择 Ubuntu22.04

一、基础环境搭建

  产品组说 HZERO 轻量版技术文档未来得及更新，按照HZERO指导手册->部署配置->服务部署 章节的版本要求进行部署；

安装Git

安装Git之前先执行如下命令检查服务器上是否已经安装了Git，若已经安装了Git环境则可跳过此步骤（若服务器上Git版本过低建议删除原Git重新安装）。

1. git –version

root@desktop-jacksen:/d02/hzero# git –version
git version 2.34.1
root@desktop-jacksen:/d02/hzero#

系统中已经有git, 版本2.34.1 ，高于安装要求，满足要求；

安装Maven

安装Maven之前先执行下面的命令检查环境中是否已经安装Maven，若已经安装了Maven则可跳过此步骤（若Maven版本过低建议删除后重新安装）。

1. mvn -v

root@desktop-jacksen:/d02/hzero# mvn -v
Command ‘mvn’ not found, but can be installed with:
apt install maven

root@desktop-jacksen:/d02/hzero# apt install maven
Reading package lists… Done
Building dependency tree… Done
Reading state information… Done
The following additional packages will be installed:

0 upgraded, 44 newly installed, 0 to remove and 20 not upgraded.
Need to get 54.8 MB of archives.
After this operation, 196 MB of additional disk space will be used.
Do you want to continue? [Y/n] y

……

done.
done.
root@desktop-jacksen:/d02/hzero#

root@desktop-jacksen:/d02/hzero# mvn -v
Apache Maven 3.6.3
Maven home: /usr/share/maven
Java version: 11.0.27, vendor: Ubuntu, runtime: /usr/lib/jvm/java-11-openjdk-amd64
Default locale: en, platform encoding: UTF-8
OS name: “linux”, version: “5.15.167.4-microsoft-standard-wsl2”, arch: “amd64”, family: “unix”

系统中原来没有Maven, 按提示用 apt install maven 命令安装完成，版本3.6.3 高于安装要求，满足要求。（注意这里安装时因为默认链接国外网站获取来源，所以要把Windows Host机上的翻墙软件代理比如Clash打开）

安装Node

之前看HzeroJs技术手册->快速开始部分，是先安装nvm(一个Node 版本管理工具), 再安装Node，yarn 的

安装nvm

# 设置国内加速地址

export NVM_SOURCE=https://gitee.com/mirrors/nvm.git

export NVM_NODEJS_ORG_MIRROR=https://cdn.npmmirror.com/binaries/node

curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash

# 永久保存环境变量

echo ‘export NVM_SOURCE=https://gitee.com/mirrors/nvm.git’ >> ~/.bashrc

echo ‘export NVM_NODEJS_ORG_MIRROR=https://cdn.npmmirror.com/binaries/node’  >> ~/.bashrc

root@desktop-jacksen:/d02/hzero# nvm -v
0.40.3

通过nvm 再安装 Node

nvm install 20

nvm use 20

备注： Node版本20 ，高于安装要求， HzeroJS 手册上，快速开始部分说：

【node 18 和 node 20 ， 在比较低的 hzerojs 版本会有报错

升级相关依赖 下面依赖或以上版本，就不会报错

 “@hzerojs/preset-hzero”: “~1.2.23”,

 “hzero-front”:”~1.11.14-alpha.0″,

】

root@desktop-jacksen:/d02/hzero# node -v
v20.19.3

nvm alias default 20 # 设置默认 nvm 的 node 版本

再安装pnpm 和yarn

npm install -g pnpm yarn

lerna（用于管理具有多个package的JavaScript项目的工具。）

• 执行如下命令全局安装：$ npm install –global lerna

root@desktop-jacksen:/d02/hzero# npm install –global lerna

added 566 packages in 26s

79 packages are looking for funding
run `npm fund` for details
root@desktop-jacksen:/d02/hzero# lerna –version

8.2.2
root@desktop-jacksen:/d02/hzero#

关于lerna请参考https://lernajs.io/
请注意安装完lerna,在linux服务器可能需要执行如下链接命令,才能使lerna生效

root@desktop-jacksen:/d02/hzero# which yarn
/root/.nvm/versions/node/v20.19.3/bin/yarn
root@desktop-jacksen:/d02/hzero# which lerna
/root/.nvm/versions/node/v20.19.3/bin/lerna
root@desktop-jacksen:/d02/hzero# ln -s /root/.nvm/versions/node/v20.19.3/bin/yarn /usr/local/bin/yarn
root@desktop-jacksen:/d02/hzero# ln -s /root/.nvm/versions/node/v20.19.3/bin/lerna /usr/local/bin/lerna

安装JDK

在安装JDK之前需执行下面的命令来检查服务器上是否已经安装过Java环境，若已经安装过17版本的Java则可跳过JDK安装。若版本较低则需卸载历史版本的Java环境，重新安装。

复制

1. java -version

root@desktop-jacksen:/d02/hzero# java -version
openjdk version “11.0.27” 2025-04-15
OpenJDK Runtime Environment (build 11.0.27+6-post-Ubuntu-0ubuntu122.04)
OpenJDK 64-Bit Server VM (build 11.0.27+6-post-Ubuntu-0ubuntu122.04, mixed mode, sharing)

默认是Java 11不符合安装要求，下载JDK17

https://download.oracle.com/otn/java/jdk/17.0.15%2B9/4f092786cec841d58ae21840b10204d7/jdk-17.0.15_linux-x64_bin.tar.gz

将下载好的JDK安装包上传到服务器的/usr/local/src目录下，上传完成后解压。

tar -zxvf jdk-17.0.15_linux-x64_bin.tar.gz

将解压好的JDK移动到/usr/local下

mv  jdk-17.0.15 /usr/local

配置环境变量

vim /etc/profile

在最后添加如下环境变量配置后保存并退出：

export JAVA_HOME=/usr/local/jdk-17.0.15
export JRE_HOME=/usr/local/jdk-17.0.15/jre
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib

执行如下命令使配置文件生效：

root@desktop-jacksen:/usr/local/src# source /etc/profile

验证JDK安装情况：

root@desktop-jacksen:/usr/local/src# java -version
java version “17.0.15” 2025-04-15 LTS
Java(TM) SE Runtime Environment (build 17.0.15+9-LTS-241)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.15+9-LTS-241, mixed mode, sharing)

安装Nginx

root@desktop-jacksen:/usr/local/src# nginx -v
Command ‘nginx’ not found, but can be installed with:
apt install nginx-core # version 1.18.0-6ubuntu14.6, or
apt install nginx-extras # version 1.18.0-6ubuntu14.6
apt install nginx-light # version 1.18.0-6ubuntu14.6
root@desktop-jacksen:/usr/local/src# apt install nginx-extras

……

root@desktop-jacksen:/usr/local/src# nginx -v
nginx version: nginx/1.18.0 (Ubuntu)
root@desktop-jacksen:/usr/local/src#

系统中原来没有Nginx, 按提示用 apt install nginx-extras 命令安装完成，版本1.18.0 高于安装要求，满足要求。

检查Nginx服务状态：

root@desktop-jacksen:/usr/local/bin# sudo systemctl status nginx
● nginx.service – A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2025-06-26 11:31:59 CST; 5h 23min ago

浏览器访问：