nginxWebUI是一款图形化管理nginx配置的工具,可以使用网页来快速配置nginx的各项功能,包括http协议转发、tcp协议转发、反向代理、负载均衡、静态html服务器、ssl证书自动申请、续签、配置等。配置好后可一键生成nginx.conf文件,同时可控制nginx使用此文件进行启动与重载,完成对nginx的图形化控制闭环。
nginxWebUI也可管理多个nginx服务器集群, 随时一键切换到对应服务器上进行nginx配置,也可以一键将某台服务器配置同步到其他服务器,方便集群管理。
nginx本身功能复杂, nginxWebUI并不能涵盖nginx所有功能,但能覆盖nginx日常90%的功能使用配置,平台没有涵盖到的nginx配置项,可以使用自定义参数模板,在conf文件中生成配置独特的参数。
部署此项目后,配置nginx再也不用上网各种搜索配置代码,再也不用手动申请和配置ssl证书,只需要在本项目中进行增删改查就可方便的配置和启动nginx。
技术说明
本项目是基于solon的web系统,数据库使用h2,因此服务器上不需要安装任何数据库。
本系统通过Let's encrypt申请证书,使用acme.sh脚本进行自动化申请和续签,开启续签的证书将在每天凌晨2点进行续签, 只有超过60天的证书才会进行续签,只支持在linux下签发证书。
添加tcp/ip转发配置支持时,一些低版本的nginx可能需要重新编译,通过添加–with-stream参数指定安装stream模块才能使用,但在ubuntu 18.04下,官方软件库中的nginx已经带有stream模块,不需要重新编译。本系统如果配置了tcp转发项的话,会自动引入ngx_stream_module.so
的配置项,如果没有开启则不引入,最大限度优化ngnix配置文件。
1.安装
ubuntu 20.04 安装
1.安装java运行环境和nginx
apt update
apt install openjdk-11-jdk
apt install nginx
centos 7 安装
yum install java-11-openjdk
yum install nginx
2.下载最新版发行包jar
建立存放目录
mkdir /home/nginxWebUI/
下载最新jar包到/home/nginxWebUI/
wget -O /home/nginxWebUI/nginxWebUI.jar http://file.nginxwebui.cn/nginxWebUI-3.4.4.jar
3.启动程序
nohup java -jar -Dfile.encoding=UTF-8 /home/nginxWebUI/nginxWebUI.jar --server.port=18080 --project.home=/home/nginxWebUI/ > /dev/null &
参数说明(都是非必填)
--server.port 占用端口, 默认以8080端口启动
--project.home 项目配置文件目录,存放数据库文件,证书文件,日志等, 默认为/home/nginxWebUI/
--spring.database.type=mysql 使用其他数据库,不填为使用本地h2数据库,可选mysql
--spring.datasource.url=jdbc:mysql://ip:port/nginxwebui 数据库url
--spring.datasource.username=root 数据库用户
--spring.datasource.password=pass 数据库密码
说明:
有新版本发布 3.4.6
更新内容:
1.修改一些bug
jar下载地址: http://file.nginxwebui.cn/nginxWebUI-3.4.6.jar
docker地址: cym1102/nginxwebui:3.4.6
2.docker方式安装说明
1.安装docker容器环境
ubuntu 安装
apt install docker.io
centos 安装
yum install docker
2.拉取镜像:
docker pull cym1102/nginxwebui:latest
3.启动容器
docker run -itd \
-v /home/nginxWebUI:/home/nginxWebUI \
-e BOOT_OPTIONS="--server.port=8080" \
--privileged=true \
--net=host \
cym1102/nginxwebui:latest
注意:
1.启动容器时请使用--net=host参数,直接映射本机端口,因为内部nginx可能使用任意一个端口,所以必须映射本机所有端口。
2.容器需要映射路径/home/nginxWebUI:/home/nginxWebUI,此路径下存放项目所有数据文件,包括数据、nginx配置文件、日志、证书等,升级镜像时此目录可保证项目数据不丢失,请注意备份。
3.-e BOOT_OPTIONS 参数可填充java启动参数,可以靠此项参数修改端口号。--server.port 占用端口,不填默认以8080端口启动。
4.日志默认存放在/home/nginxWebUI/log/nginxWebUI.log
3.添加开机自启动
1.编辑service配置
vim /etc/systemd/system/nginxwebui.service
如下
[Unit]
Description=NginxWebUI
After=syslog.target
After=network.target
[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/home/nginxWebUI
ExecStart=/usr/bin/java -jar /home/nginxWebUI/nginxWebUI.jar
Restart=always
[Install]
WantedBy=multi-user.target
2.刷新服务 并添加开机启动
systemctl daemon-reload
systemctl enable nginxwebui.service
systemctl start nginxwebui.service
4.使用nginxWebUI说明
打开 http://xxx.xxx.xxx.xxx:18080
进入主页
登录页面,第一次打开会要求初始化管理员账号 (自行设置一个)
之后用设置的用户名密码登陆