NIUCLOUD官方文档 | NIUCLOUD-ADMIN 一款快速开发多应用多插件通用管理系统后台框架

linux 环境部署

前期准备

准备所需软件

运行环境	要求版本	推荐版本
JDK	== 17.0	17.0
MYSQL	>= 5.7	5.7
Redis	必须启用	5.x
Node.js	18.0	18.0
Nginx

安装宝塔面板，如果对 linux 命令行比较熟悉也可通过命令行安装，目的是实现上述软件安装运行

Centos 安装脚本

bash

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

Ubuntu/Deepin 安装脚本

bash

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

Debian 安装脚本

bash

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh

Fedora 安装脚本

bash

wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh

安装过程中有需要确认的地方敲回车，或者输入 y 再敲回车即可。

系统安装后按照提示安装初始化，选择 java 环境，初始化安装 nginx 、 java 、 mysql5.7 等环境

redis 安装之后可配置相应的密码

站点部署

java 相关

软件安装之后添加 java 站点，查看 java 环境，选择17版本

添加 java 环境添加 java 软连接创建软连接链接至 JDK 17.0.8 版本的 bin 目录的 java 可执行文件

项目启动命令（用上述默认启动命令也可以，这样主要可以记录日志）:

bash

 nohup java -jar web-app-boot-exec.jar & tail -f nohup.out

将本地 webroot 代码压缩上传到 linux 服务器

导入数据库

创建数据库，设置用户名、密码

导入数据，导入的数据库位于 webroot 下的 sql 文件夹下

配置 MySQL 连接

找到配置文件： webroot/jar/application-prod.yml

yaml

    url: jdbc:mysql://127.0.0.1:3306/niucloud_admin_java?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456

配置 Redis 连接

找到配置文件：webroot/jar/application-prod.yml

配置

yaml

database: 配置数据库1-16
host: 连接地址
port: 服务端口
password: 如果Redis服务有密码也需要进行配置

域名管理

为 Java 项目绑定外网访问域名找到安装 nginx 的地方的配置文件

配置nginx伪静态以及反向代理

点击设置 -> 配置文件 -> nginx配置文件

这里配置反向代理，这里的域名以及端口配置的是项目配置的内网域名以及端口，默认是127.0.0.1，端口是8080，配置之后可以外网域名访问。这里是图片对应伪静态的映射，如果配置文件中没有就要加上

下面是一个nginx配置的完整实例，根据实际情况配置

nginx

server
{
    listen 80;
    listen 443 ssl http2 ;
    server_name  java.niucloud-admin.com java.niucloud.com;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/java.niucloud-admin.com/webroot/public;
    #CERT-APPLY-CHECK--START
    # 用于SSL证书申请时的文件验证相关配置 -- 请勿删除
    include /www/server/panel/vhost/nginx/well-known/b2b2c.test.java.niucloud.com.conf;
    #CERT-APPLY-CHECK--END

    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    #HTTP_TO_HTTPS_START
    if ($server_port !~ 443){
        rewrite ^(/.*)$ https://$host$1 permanent;
    }
    #HTTP_TO_HTTPS_END
    ssl_certificate    /www/server/panel/vhost/cert/b2b2c.test.java.niucloud.com/fullchain.pem;
    ssl_certificate_key    /www/server/panel/vhost/cert/b2b2c.test.java.niucloud.com/privkey.pem;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";
    error_page 497  https://$host$request_uri;

    #SSL-END

    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END

    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-80.conf;
    #PHP-INFO-END

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/b2b2c.test.java.niucloud.com.conf;
    #REWRITE-END

    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|\.svn|\.project|LICENSE|README.md)
    {
        return 404;
    }

    #一键申请SSL证书验证目录相关设置
    location ~ \.well-known{
        allow all;
    }

    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }
     location / {
      proxy_pass http://127.0.0.1:8080;
      proxy_pass_header Content-Range;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
    {
        proxy_pass http://127.0.0.1:8080;
        expires      30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*\.(js|css)?$
    {
        expires      12h;
        error_log /dev/null;
        access_log /dev/null;
    }
    access_log  /www/wwwlogs/b2b2c.test.java.niucloud.com.log;
    error_log  /www/wwwlogs/b2b2c.test.java.niucloud.com.error.log;
}