安装

安装

NJET官方提供centos,ubuntu,cloudOS,麒麟,龙芯等多个版本的2进制安装包及软件源,但不支持Windows系统。其中支持的有:

OS 架构 当前版本 下载链接
Kylin Linux Advanced Server release V10(SP1) x86_64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet-3.3.1.1-1.ky10.x86_64.rpm
Anolis OS 8.10​​ loongarch64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet-3.3.1.1-1.an8.loongarch64.rpm
Kylin Linux Advanced Server V10(SP3) aarch64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet-3.3.1.1-1.ky10.aarch64.rpm
Centos7.x x86_64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet-3.3.1.1-1.el7.x86_64.rpm
Ubuntu18.04 x86_64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet_3.3.1.1-1~ubuntu.18.04~bionic_amd64.deb
Ubuntu20.04 x86_64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet_3.3.1.1-1~ubuntu.18.04~bionic_amd64.deb
Ubuntu22.04 x86_64 3.3.1.1 https://gitee.com/njet-rd/njet/releases/download/v3.3.1.1/njet_3.3.1.1-1~ubuntu.18.04~bionic_amd64.deb

二进制安装包,可以从gitee的主仓库选择对应的版本进行下载,或通过软件源的方式自动获得后续的 更新,目前支持centos及ubuntu的软件源配置。

1. 二进制安装​

OpenNJet 提供多个版本操作系统下的二进制安装文件,二进制包安装后,所有OpenNJet 相关的文件 都在 /usr/local/njet 目录下, 并在 /usr/lib/systemd/system 目录下添加service 文件。

1.1 RPM 安装​

  1. 从 gitee https://gitee.com/njet-rd/njet/releases上下载对应操作系统的rpm 格式安装包​

  2. 使用 yum 进行安装 例如下载的安装包是njet-3.3.1-1.el7.x86_64.rpm,

yum localinstall ./njet-3.3.1-1.el7.x86_64.rpm​
  1. 安装后,使用命令 systemctl start njet 启动服务​

  2. 使用命令 systemctl stop njet 停止服务​

1.2 DEB 安装​

  1. 从 gitee https://gitee.com/njet-rd/njet/releases 上下载对应操作系统的deb 格式安装包​

  2. 使用 dpkg 进行安装 例如下载的安装包是,njet_3.3.1-1~ubuntu.18.04bionic_amd64.deb

dpkg -i ./njet_3.3.1-1~ubuntu.18.04~bionic_amd64.deb​
  1. 安装后,使用命令 systemctl start njet 启动服务​
  2. 使用命令 systemctl stop njet 停止服务​

1.3 docker方式安装​

  1. 拉取NJET 镜像
docker pull tmlake/njet:latest
  1. 启动NJET
docker run  -d --rm --privileged  tmlake/njet:latest

2. 安装发行版

2.1 centos发行版​

现在 NJET 支持yum源安装了,目前只支持 centos 7 和 x86_64架构。​ 具体安装方式如下:

  1. 生成njet.repo
 echo "
 [OpenNJet]
    name=OpenNJet
 baseurl=https://njet.org.cn/download/linux/centos/$releasever/$basearch/
    enabled=1
    gpgcheck=1
 gpgkey=https://njet.org.cn/download/linux/centos/RPM-GPG-KEY-OpenNJet
 " > /etc/yum.repos.d/njet.repo
  1. 更新yum 缓存
yum clean all
yum makecache #类似于 apt update​
  1. 安装 njet 或 njet-otel
yum install njet
yum install njet-otel
  1. 启动NJET服务​
systemctl start njet

2.2 ubuntu发行版​

目前支持Ubuntu 18.04/20.04/22.04 amd64 架构的操作系统通过APT源直接安装二进制软件包​ 具体安装方式如下:

  1. 添加gpg 文件​
 sudo apt-get update
 sudo apt-get install ca-certificates curl gnupg
 sudo install -m 0755 -d /etc/apt/keyrings
 curl -fsSL https://njet.org.cn/download/linux/ubuntu/gpg | sudo gpg --dearmor -
o /etc/apt/keyrings/njet.gpg
 sudo chmod a+r /etc/apt/keyrings/njet.gpg
  1. 添加APT 源​
 echo \

"deb [arch=$(dpkg --print-architecture) signed-
by=/etc/apt/keyrings/njet.gpg] https://njet.org.cn/download/linux/ubuntu \
 $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
 sudo tee /etc/apt/sources.list.d/njet.list > /dev/null
 sudo apt-get update
  1. 安装及启动
 sudo apt-get install njet
 sudo systemctl start njet

3. 源码安装

3.1 下载 OpenNJet 源码​

如果要下载特定tag的源码,如v2.0.0,则执行:

git clone -b v2.0.0 git@gitee.com:njet-rd/njet.git

如果要下载最新源码,则执行:

git clone git@gitee.com:njet-rd/njet.git

如果要下载特定branch(比如dynconf)的源码,则执行:

git clone git@gitee.com:njet-rd/njet.git --branch=dynconf

如果要下载特定branch(比如dynconf)的特定commit (ca5eaf057a5709a615a4873a1558c6d9fe1cc213)的源码,则执行:

git clone <remote_repository> --branch=<branch_name> --single-branch --depth=1
commit/ca5eaf057a5709a615a4873a1558c6d9fe1cc213

如果要下载特定commit(ca5eaf057a5709a615a4873a1558c6d9fe1cc213)源码,则执行:

git clone -b ca5eaf057a5709a615a4873a1558c6d9fe1cc213 git@gitee.com:njet-rd/njet.git

3.2 编译:

提供两种编译方法:

  1. dockerfile快速编译,不用宿主机安装依赖的编译环境以及软件

    依赖:docker 环境(需要在编译机器安装docker并启动docker)

    docker build -t njet_main:v1.0 .

    docker run -v `pwd`:/njet_main njet_main:v1.0 /bin/bash -c "cd /njet_main &&
    ./build_cc.sh conf make"
  1. 宿主机安装依赖环境以及软件 centos7系统请安装如下软件:
    gcc gcc-c++
    libtool libtool-ltdl cmake3
    make cmake perl perl-CPAN
    zlib-devel cmake perl-IPC-Cmd
    pkgconfig make vim-common
    sudo m4 deltarpm openssl-devel
    automake autoconf pcre2-devel
    yum-utils rpm-build

ubuntu系统请安装如下软件:

    gcc g++ make cmake libpcre2-dev
    libpcre3-dev libssl-dev zlib1g-dev
    perl m4  libtool  automake 
    autoconf vim-common unzip  libcap2-bin

银河麒麟系统请安装如下软件:

gcc g++ make cmake pcre2-devel perl-IPC-Cmd  vim-common libtool libtool-ltdl perl perl-CPAN zlib-devel perl-IPC-Cmd pkgconfig vim-common m4 deltarpm openssl-devel automake autoconf

编译命令:

    ./build_cc.sh conf make

3.3 安装:

• 将 /usr/local/lib 目录添加到 /etc/ld.so.conf 文件,并使用 make install 安装编译后的依赖库,可 执行文件,动态模块及默认配置文件。

sudo bash -c 'echo "/usr/local/lib" >> /etc/ld.so.conf'
sudo ./build_cc.sh install

4. 启动

4.1 手工起停

  1. 通过源码编译安装的,可执行文件及相关的配置文件将安装到目录/usr/local/njet
 cd /usr/local/njet
 sbin/njet

4.2 通过systemctl起停​

使用 rpm 或 deb 二进制安装后,会在 /usr/lib/systemd/system/ 目录下添加 service文件。​

使用 sudo systemctl start njet 启动服务。​

使用 sudo systemctl stop njet 停止服务​

5. 验证

通过浏览器或curl/wget访问部署机器的8080地址​

curl http localhost:8080/
Caution

禁止手动复制 NJET 二进制文件** NJET 安装过程中通过 setcap设置了特殊 Linux Capabilities,手动复制会导致权限丢失。