nginxWebUI-Pro

# 安装步骤

本系统分为主控与节点，分开进行部署。主控主要负责nginx配置文件的编辑与生成，证书申请与上传，html静态页面的上传，nginx日志收集及统计。节点主要负责nginx的运行与配置文件接受，采集日志并传回主控。

主控采用docker方式部署，节点可使用docker或jar方式部署，主控暂不提供jar部署方式。docker的部署可最大程度保证程序的兼容性，在任何Linux系统上均有一致的体验。

# 配置要求

# 主控配置要求：

CPU：2核以上（推荐8核）

内存：4G以上（推荐16G）

硬盘：100G以上（依照日志保存天数与数据量决定）

系统：Linux 内核5.4以上

# 节点配置要求

CPU：1核以上（根据实际负载调整）

内存：2G以上（根据实际负载调整）

硬盘：20G以上

系统：Linux 内核5.4以上

# 安装docker环境

Ubuntu:

apt install docker.io
1

Centos:

yum install docker
1

# 主控docker方式安装步骤

执行命令：

docker run -itd \
  -v /home/nginxWebUI-Pro:/home/nginxWebUI-Pro \
  -p 8000:8000 \
  -p 8123:8123 \
  --restart=always \
  --name=nginxWebUI-Pro \
  registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-pro:latest
1
2
3
4
5
6
7

完成安装后，访问http://127.0.0.1:8000/，注册管理员账号

注意：8123为clickhouse数据库的访问端口，如果不需要从外部访问clickhouse，可不需要映射此端口

如果需要使用外部mysql数据库, 请添加容器启动参数

-e BOOT_OPTIONS="--spring.database.type=mysql --spring.datasource.url=jdbc:mysql://ip:port/nginxwebui --spring.datasource.username=root --spring.datasource.password=pass"
1

# 主控docker方式升级或重装步骤

执行命令：

docker rm -f nginxWebUI-Pro

docker rmi -f registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-pro:latest

docker run -itd \
  -v /home/nginxWebUI-Pro:/home/nginxWebUI-Pro \
  -p 8000:8000 \
  -p 8123:8123 \
  --restart=always \
  --name=nginxWebUI-Pro \
  registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-pro:latest
1
2
3
4
5
6
7
8
9
10
11

升级后只要保持/home/nginxWebUI-Pro文件夹不动，数据不会丢失

# 节点docker方式安装步骤

执行命令：

docker run -itd \
  -v /home/nginxWebUI-Client:/home/nginxWebUI-Client \
  --net=host \
  --restart=always \
  --name=nginxWebUI-Client \
  registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-client:latest
1
2
3
4
5
6

完成安装后，在主控管理界面中，可通过添加节点，将节点纳入管理。注意：为纳入管理的节点是完全对外开放的，有一定的不安全性，请安装好节点程序后尽快将节点纳入管理。

# 节点docker方式升级或重装步骤

执行命令：

docker rm -f nginxWebUI-Client

docker rmi -f registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-client:latest

docker run -itd \
  -v /home/nginxWebUI-Client:/home/nginxWebUI-Client \
  --net=host \
  --restart=always \
  --name=nginxWebUI-Client \
  registry.cn-hangzhou.aliyuncs.com/cym19871102/nginxwebui-client:latest
1
2
3
4
5
6
7
8
9
10

升级后只要保持/home/nginxWebUI-Client文件夹不动，数据不会丢失

# 节点jar方式安装步骤

1.请先通过apt yum或源码安装的方式安装nginx，并注册为系统命令，确保可以从任何路径直接运行nginx、nginx -t等命令

2.下载并解压安装包：

cd /home

wget -O nginxWebUI-Client.tar.gz http://upyun.nginxwebui.cn/nginxWebUI-Client.tar.gz

tar -vxf nginxWebUI-Client.tar.gz

rm nginxWebUI-Client.tar.gz
1
2
3
4
5
6
7

3.进入/home/nginxWebUI-Client路径，执行./start.sh

4.要停止应用程序，执行./stop.sh

# 节点jar方式升级或重装步骤

/home/nginxWebUI-Client/stop.sh

cd /home

wget -O nginxWebUI-Client.tar.gz http://upyun.nginxwebui.cn/nginxWebUI-Client.tar.gz

tar -vxf nginxWebUI-Client.tar.gz

rm nginxWebUI-Client.tar.gz

/home/nginxWebUI-Client/start.sh
1
2
3
4
5
6
7
8
9
10
11

# 找回密码步骤

如果忘记管理员密码，可直接执行以下命令，重置管理员密码为nginxWebUI

docker exec -it nginxWebUI-Pro reset.sh
1