可視化配置工具nginxWebUI v2.4.9官方版

nginxWebUI是一款強大的nginx可視化配置工具，本項目可以使用WebUI配置nginx的各項功能,可管理多個nginx服務器集群, 隨時一鍵切換到對應服務器上進行nginx配置，有需要的朋友趕緊下載吧。

功能說明

本項目可以使用WebUI配置nginx的各項功能, 包括http協議轉發, tcp協議轉發, 反向代理, 負載均衡, ssl證書自動申請、續簽、配置等, 最終生成nginx.conf文件並覆蓋nginx的默認配置文件, 完成nginx的最終功能配置。

本項目可管理多個nginx服務器集群, 隨時一鍵切換到對應服務器上進行nginx配置, 也可以一鍵將某台服務器配置同步到其他服務器, 方便集群管理。

nginx本身功能複雜, 本項目並不能涵蓋nginx所有功能, 隻能配置常用功能, 更高級的功能配置仍然需要在最終生成的nginx.conf中進行手動編寫。

部署此項目後, 配置nginx再也不用上網各種搜索, 再也不用手動申請和配置ssl證書, 隻需要在本項目中進行增刪改查就可方便的配置nginx。

技術說明

本項目是基於springBoot的web係統, 數據庫使用sqlite, 因此服務器上不需要安裝任何數據庫。

其中orm使用了本人自己開源的sqlHelper項目作為orm, 使用sqlite作為數據庫, 項目啟動時會釋放一個.sqlite.db到係統用戶文件夾中, 注意進行備份。

sqlHelper是一個可以像 mongodb 一樣使用 sql 數據庫的 orm, 解放開發者對sql數據庫表結構的維護工作, 支持sqlite, mysql, postgresql三種數據庫, 有興趣的可以了解一下 https://gitee.com/cym1102/sqlHelper。

本係統通過Let's encrypt申請證書, 使用acme.sh腳本進行自動化申請和續簽, 開啟續簽的證書將在每天淩晨 2 點進行續簽, 隻有超過 60 天的證書才會進行續簽. 隻支持在linux下簽發證書。

因為申請證書必須要使用 80 端口, 因此在申請和續簽的時候 nginx 將會短暫關閉，請注意。

添加tcp/ip轉發配置支持時, 一些低版本的 nginx 可能需要重新編譯，通過添加–with-stream參數指定安裝stream模塊才能使用, 但在ubuntu 18.04下, 官方軟件庫中的nginx已經帶有stream模塊, 不需要重新編譯. 本係統如果配置了tcp轉發項的話, 會自動引入ngx_stream_module.so的配置項, 如果沒有開啟則不引入, 最大限度優化ngnix配置文件。

jar 安裝說明

以Ubuntu操作係統為例, 以下命令請使用root賬戶權限執行

注意：本項目需要在root用戶下運行係統命令，極容易被黑客利用，請一定修改密碼為複雜密碼

1. 安裝java運行環境和nginx

apt install openjdk-8-jdkapt install nginx1

2. 下載最新版發行包jar

wget http://www.nginxwebui.cn/download/nginxWebUI-2.1.6.jar1

有新版本隻需要修改路徑中的版本即可

3. 啟動程序

nohup java -jar -Xmx64m nginxWebUI-2.1.6.jar --server.port=8080 --project.home=/home/nginxWebUI/ > /dev/null &1

參數說明 (都是非必填)

-Xmx64m 最大分配內存數

--server.port 占用端口, 默認以 8080 端口啟動

--project.home 項目配置文件目錄，存放數據庫文件，證書文件，日誌等, 默認為/home/nginxWebUI/

注意命令最後加一個&號, 表示項目後台運行

docker安裝說明

本項目製作了docker鏡像, 同時包含nginx和nginxWebUI在內, 一體化管理與運行nginx.

1. 安裝docker容器環境

apt install docker.io1

2. 下載鏡像:

docker pull registry.cn-hangzhou.aliyuncs.com/cym1102/nginxwebui:2.1.61

啟動容器:

docker run -itd -v /home/nginxWebUI:/home/nginxWebUI -e BOOT\_OPTIONS="--變量名=變量值 --變量名2=變量值2" --privileged=true --net=host  registry.cn-hangzhou.aliyuncs.com/cym1102/nginxwebui:2.1.6 /bin/bash1

注意:

啟動容器時請使用--net=host參數, 直接映射本機端口, 因為內部nginx可能使用任意一個端口, 所以必須映射本機所有端口.

容器需要映射路徑/home/nginxWebUI:/home/nginxWebUI, 此路徑下存放項目所有數據文件, 包括數據庫, nginx配置文件, 日誌, 證書等, 升級鏡像時, 此目錄可保證項目數據不丟失. 請注意備份.

-e BOOT_OPTIONS 參數可填充java啟動參數, jar安裝教程中的參數均可使用, 可以靠此項參數修改端口號等

日誌默認存放在/home/nginxWebUI/log/nginxWebUI.log

docker-compose安裝說明

博主整理出了docker-compsoe安裝此 nginx 可視化界麵的文件。

docker-compose.yaml文件如下

version: '3' services:  nginxwebui:    image: registry.cn-hangzhou.aliyuncs.com/cym1102/nginxwebui:2.1.6    container_name: nginxwebui    restart: always    volumes:      - ./data:/home/nginxWebUI    environment:      - BOOT_OPTIONS==-Xmx64m      - TZ=Asia/shanghai    privileged: true    network_mode: "host"12345678910111213

注意：項目下所有數據儲存在yaml文件同目錄下的data文件夾中。

使用說明

打開 http://xxx.xxx.xxx.xxx:8080 進入主頁

登錄頁麵, 第一次打開會要求初始化管理員賬號

進入係統後, 可在管理員管理裏麵添加修改管理員賬號

在http參數配置中可以配置nginx的http項目, 進行http轉發, 默認會給出幾個常用配置, 其他需要的配置可自由增刪改查. 可以勾選開啟日誌跟蹤, 生成日誌跟蹤配置項, 每天 0 點時刻可生成上一天的日誌分析報告. 由於日誌文件access.log文件過大, 默認隻保留 7 天的log文件, 但分析報告可一直保留.

在 TCP 參數配置中可以配置nginx的steam項目參數, 大多數情況下可不配.

在反向代理中可配置nginx的反向代理即server項功能, 可開啟ssl功能, 可以直接從網頁上上傳pem文件和key文件, 或者使用係統內申請的證書, 可以直接開啟http轉跳https功能，也可開啟http2協議

在負載均衡中可配置nginx的負載均衡即upstream項功能, 在反向代理管理中可選擇代理目標為配置好的負載均衡

在html靜態文件上傳中可直接上傳html壓縮包到指定路徑, 上傳後可直接在反向代理中使用, 省去在Linux中上傳html文件的步驟

在證書管理中可添加證書, 並進行簽發和續簽, 開啟定時續簽後, 係統會自動續簽即將過期的證書。

注意: 證書的簽發是用的acme.sh的dns模式, 需要配合阿裏雲的aliKey和aliSecret來使用. 請先申請好aliKey和aliSecret

備份文件管理, 這裏可以看到nginx.cnf的備份曆史版本, nginx出現錯誤時可以選擇回滾到某一個曆史版本

最終生成conf文件, 可在此進行進一步手動修改, 確認修改無誤後, 可覆蓋本機conf文件, 並進行效驗和重啟, 可以選擇生成單一nginx.conf文件還是按域名將各個配置文件分開放在conf.d下

log管理, 在http配置中如果開啟了log監控的話, 會每天在這裏生成日誌分析報告.

遠程服務器管理, 如果有多台nginx服務器, 可以都部署上nginxWebUI, 然後登錄其中一台, 在遠程管理中添加其他服務器的ip和用戶名密碼, 就可以在一台機器上管理所有的nginx服務器了.

提供一鍵同步功能, 可以將某一台服務器的數據配置和證書文件同步到其他服務器中

找回密碼

如果忘記了登錄密碼，可按如下教程找回密碼

安裝sqlite3命令

apt install sqlite31

讀取sqlite.db文件

sqlite3 /home/nginxWebUI/sqlite.db1

查找admin表

select \* from admin;1

退出sqlite3

quit